Git Product home page Git Product logo

trackbook's Introduction

README

Trackbook - Movement Recorder for Android

Version 1.0.x ("Astronomy Domine")

Trackbook is a bare bones app for recording your movements. Trackbook is great for hiking, vacation or workout. Once started it traces your movements on a map. The map data is provided by OpenStreetMap (OSM).

Trackbook is free software. It is published under the MIT open source license. Trackbook uses osmdroid to display the map, which is also free software published under the Apache License. Want to help? Please check out the notes in CONTRIBUTE.md first.

Install Trackbook

You install it via Google Play and F-Droid - or you can go and grab the latest APK on GitHub.

How to use Trackbook

Start recording movements

Press the big blue button to start recording your movements. Trackbook will continuously drop markers onto the map.

Stop recording movements

To stop your recording press the big blue button again or use the stop button in the Trackbook's notification. You can look at the recorded movements on the map afterwards.

Save last recording

Stop the recording and then tap again on the big blue button. It will offer an option to "Save and Clear". Trackbook stores saved recordings as plaintext JSON files in the directory /Android/data/org.y20k.trackbook/files/tracks.

Clear main map

Stop the recording and then tap again on the big blue button. Chose the option "Clear", if you just want to clear the map without saving your recording.

Statistics and Last Tracks

Peek into Trackbook's notification to see the distance and duration of your current recording. Switch to the "Last Tracks" view to review your last recordings - up to 25 tracks. Pull up the statistics to see distance and duration of that recording, as well as the steps taken.

GPX Export

Saved recordings can be exported as GPX (GPS Exchange Format) from the "Last Tracks" view. Just tap the export icon next to the track selection menu.

How does Trackbook measure distance?

Trackbook calculates the distance between markers and adds them up.

Which Permissions does Trackbook need?

Permission "INTERNET"

Trackbook needs to download map data from OpenStreetMap servers and therefore needs access to the internet.

Permission "ACCESS_NETWORK_STATE" and "ACCESS_WIFI_STATE"

Trackbook uses osmdroid to draw its maps. osmdroid needs to know the current state of your device’s connectivity - see Prerequisites.

Permission "ACCESS_COARSE_LOCATION" and "ACCESS_FINE_LOCATION"

Trackbook needs accurate GPS location data to be able to record your movements. If the GPS data is not available or not accurate enough Trackbook uses location data from cell tower and WiFi triangulation.

Permission "WRITE_EXTERNAL_STORAGE"

Trackbook uses osmdroid, which caches map tiles on Android's external storage. You can find the map cache in the osmdroid folder on the top level of the user-facing file system.

Screenshots

trackbook's People

Contributors

y20k avatar naofum avatar vistaus avatar comradekingu avatar weblate avatar

Watchers

JamesLinus avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.