## {icon bus} About Libre BusTO
Libre BusTO, or simply **[[https://f-droid.org/packages/it.reyboz.bustorino/|BusTO]]**, is your Android app that gives you arrival times for all public transport in Turin and its outskirts. Type in the number of the bus stop and get all the information about scheduled and real arrival times of every 5T/GTT's vehicle stopping there.
Some features:
* Simple interface
* Search by number
* Search by name
* Position suggestions
* Save favorite stops
And not obviously:
* No binary blob files
* No tracking
* No ads
* Fairly light
Do not confuse this app with other proprietary software made by some other people.
## {icon download} How to download BusTO
We actually distribute the app only from [[https://f-droid.org/|F-Droid]] because the maintainer has not the Play Store.
Just download F-Droid and then search "BusTO", or download the apk from here:
https://f-droid.org/packages/it.reyboz.bustorino/
## {icon share-alt} How to get News
* We have a public [Telegram channel](https://t.me/busto_fdroid)
* Here is a non-exclusive list of blogs with RSS support you can subscribe:
* https://blog.reyboz.it/tag/busto/
## {icon users} How to meet BusTO developers
You can easily get in touch with us:
* We have a public [Telegram development group](https://t.me/librebusto_dev)
* We meet us in person, each Wednesday, at the [[https://informaticalibera.info/| Officina Informatica Libera ]] (Torino) from 18:45 to 20:00.
* You can drop us an e-mail writing to `gtt@succhia.cz`
## {icon bug} How to create a Bug / Feature request
You can do this in 5 minutes:
1. [[https://gitpull.it/w/|Register to this amazing website]]!
2. [[https://gitpull.it/maniphest/task/edit/form/3/|Create a Task!]]
Or you can just drop an e-mail to:
```
gtt+bugged.again@succhia.cz
```
## {icon git-square} How to hack BusTO
You can clone the [[https://gitpull.it/source/libre-busto/|BusTO source code repository]] with:
```
git clone https://gitpull.it/source/libre-busto.git
```
## {icon code-fork} How to submit a Patch to BusTO ("pull request")
**We hate GitHub** so don't create pull requests in GitHub. Open your mind and follow these simple instructions:
1. Do some small changes
2. Install the amazing `arcanist` package (`sudo apt install arcanist`)
3. Run `arc diff` inside the project directory
4. Read the instructions
Done!
Or instead, if you are lazy, or like to get technical:
1. Do some small changes
2. Do some commits
3. Generate a patch with (assuming you're keeping the branches name)
```
git format-patch -k --stdout origin/master..master > my-patch.diff
```
4. Upload your file `my-patch.diff` here: https://gitpull.it/differential/diff/create/
Done!
Or instead, if you are an asshole:
1. Just do your pull request in GitHub, but then don't expect to receive a present from Santa.
In any case: we love small commits with small changes!
## External resources
Paper with technical specifications related to the Torino public transport:
* https://webthesis.biblio.polito.it/6736/1/tesi.pdf
## {icon heart} Credits
You can think that this is just a small project, but trust me, there are hundred of nightly hours of work behind it.
Thanks to all the heroes under this small Free as in Freedom project. Here, for the centuries, some of them in order of appearance:
* **Fabio Mazza**: rockstar developer since 2016
* Silviu Chiriac: designer of the 2021 logo
* Virginia Foti: our new Lady Factotum designer
* Andrea Ugo: our new talented junior developer since 2020
* Ludovico Pavesi: rockstar developer 2016–2018
* Marco Gagino: graphical improvements and great beta testing 2015-2016
* Antonio Cavuoto: very appreciated whishlist contributor since 2014
* All the beta testers, bug hunters, and everyone who poured ideas on the developers
* you, since now!
Thank you to everyone my friends! By me ([[ https://boz.reyboz.it/ | Valerio Bozzolan ]]) author and current maintainer since 2014. Your philanthropist maintainer, infrastructure provider and truly modest friend {icon heart} asd
## {icon gavel} License and Disclaimer
BusTO is copyright © 2014, 2015, 2016, 2017, 2018, 2019, 2020 of its contributors. We hope this software may be useful but it's a **Free as in freedom** project and it comes with **ABSOLUTELY NO WARRANTY**. You have to respect the terms of the **[[https://www.gnu.org/licenses/gpl-3.0.html|GNU General Public License v3+]]**.
Dear GTT/5T lawyers: even if the GTT/5T data is provided only for personal usage, the BusTO developers are **NOT** infringing your copyright. We are not using/changing/distributing your contents for non-personal usage in any-way. "Our" users are the people who request your data directly from their devices, in person, and for personal usage. We do not track these users, we do not host any data-related service, we do not even know who is using our software, so do not break our balls and leave us hacking with the Turin public transport to make it better and accessible to the people.
Why we precise this? See [this interesting story about another similar app](https://www.wired.it/lifestyle/mobilita/2019/07/29/trenitalia-trenit-dati-treni/).