tracman-android/README.md

54 lines
3.0 KiB
Markdown

# <img align="left" src="https://www.tracman.org/static/img/icon/by/48.png" alt="[]" title="The Tracman Logo">Tracman for Android
###### v 0.6.1
Android app to upload a user's GPS location to the [tracman server](https://github.com/tracman-org/Server).
## This project is deprecated.
##### Since Google increased the cost of their maps API, it no longer made financial sense to keep it running. I might revive or remix the project in the future.
## Installation
Install from the [Google Play Store](https://play.google.com/store/apps/details?id=us.keithirwin.tracman) or with `adb`/Android Studio.
## Usage
In order to apply changes to settings, you need to hit the back button and return to the main menu (where it just says "General settings"). Don't hit back again, or you will be logged out. This will be fixed as [#9](https://github.com/Tracman-org/Android/issues/9) someday...
The app will switch between "realtime updates" (Every second, or whatever interval you set up in the settings) and "occasional updates", depending on if there are visitors to your map. This prevents the app from draining your battery when nobody's looking at your location anyway.
More information is available on the [help page](https://www.tracman.org/help#android).
## Contributing
Tracman for Android is in perpetually poor condition. I don't do much work with Android. This project would benefit greatly from being torn down and rebuilt from scratch. Feel free to check out the [issues marked help wanted](https://github.com/Tracman-org/Android/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) (or [any issues](https://github.com/Tracman-org/Android/issues), really) or [contact me](https://www.keithirwin.us/contact) about getting involved.
## Changelog
#### v0.6.1
* Updated server URLs
#### v0.6.0
* [#1](https://github.com/Tracman-org/Android/issues/1) Deals with lost connections
* [#6](https://github.com/Tracman-org/Android/issues/6) Loads on boot
* [#7](https://github.com/Tracman-org/Android/issues/7) Added email/password login
* [#8](https://github.com/Tracman-org/Android/issues/8) Doesn't log back in after logging out
#### v0.5.0
* Fixed compatibility issues with TLS
## License
###### see [LICENSE.md](https://github.com/Tracman-org/Android/blob/master/LICENSE.md)
Tracman: GPS tracking app for android
Copyright © 2018 [Keith Irwin](https://www.keithirwin.us/)
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <[http://www.gnu.org/licenses/](http://www.gnu.org/licenses/)>.