iOS Open GPX Tracker

GPS Tracker app for iOS + WatchOS. Log your tracks without limits and share them; Open source GPX tracker app written in Swift

merlos

426

114

Swift

Open GPX Tracker for iOS + WatchOS

Open GPX Tracker is a GPS logger for iOS (iPhone, iPad, iPod) with offline map cache support. Track your location, add waypoints and send your logs by email as GPX files.

This app has no annoying time restrictions, no ads and no in-app-purchases. You can create unlimited GPX traces 😃.

If you are goint to track without Internet… don’t worry! Before you go offline, browse the area where you’ll be tracking and it will be cached and available offline.

We care about your privacy, all the data recorded using the application is kept in your phone (or in your iCloud), wherever you store it. The app does not share any GPS data with us or any other 3rd pary. For more information see the Privacy Policy

Requires iOS 11.0 or above. Open GPX tracker is an open source app.

You can use Open GPX tracker for:

Creating routes and waypoints for editing Open Street Map.
Publishing Open Street Map Traces.
Creating GPX files for testing your iOS apps in Xcode.
Use it as GPS companion when you take pictures with your reflex camera.

Main Features

Displays tracking route in a map
Supports Apple Map Kit, Open Street Map, and Carto DB as map sources
Offline maps support (of browsed areas)
Pause / Resume tracking
Add waypoint to user location
Add waypoint to any place in the map with a long press
Edit waypoint name
Drag & Drop waypoint pin
Remove waypoint
Load on map a saved session and continue tracking
Displays current location and altitude
Displays tracked time
Displays user heading (device orientation)
Displays location accuracy
Displays tracked distance (total and current segment)
GPX files can be imported from any other app using the share option
Share GPX files with other apps
File sharing through iTunes
Settings
- Offline cache On/Off
- Clear cache
- Select the map server.
Darkmode
Multi-language support (thanks to volunteers): German, English, Spanish, Finnish, French, Italian, Dutch, Portuguese (Brazil), Russian, Ukranian Chinese (simplified)

Apple Watch Features (since 1.6.0)

Create GPX Files on your Apple Watch
Pause/Resume tracking
Save into GPX File
Add waypoint to user location
Send file to your paired device iPhone/iPad
Display GPS Signal strength
View current location information (speed, latitude, longitude, altitude)

Install

The app is available on the App Store, available since May 2015.

Another option to install the app is to download the source code and compile it by yourself using Xcode and the iOS simulator. If you want to run it on a iOS device, you also need an Apple developer account.

Translate Open GPX Tracker

Open GPX tracker supports language translations (since 1.7.0). See list of supported languages and how to translate the app into your language.

Development

This application is written in Swift. To download the code run this command in a console:

 git clone https://github.com/merlos/iOS-Open-GPX-Tracker.git

Then, to test it open the file OpenGpxTracker.xcworkspace with XCode.

Although the application uses some Cocoapods, all the pods are already included in our repo. So no need to run pod install.

Please note the limitations of using Open Street Maps Tile Servers

Add a custom tile server

Adding a tile server is easy, just edit the file GPXTileServer.swift, uncomment the lines with AnotherMap and modify the templateUrl to point to the new tile server.

You have a list of tile servers in Open Street Map Wiki

Reference documentation

The application is being documented using jazzy and following NSHipster tutorial on swift documentation.

Read Source code documentation

Contribute

You can contribute by forking and submitting a pull request (PR).

Some conditions for a PR to be accepted:

Text displayed in the application shall be internationalized.

To do that use NSLocalizedString. Search on the code to see examples of usage.
Add the keys of the localized string to all the lproj files. Keep this files organized in the same way (~ same line).

Use ChatGPT or DeepL to translate them to other languages. For example, for ChatGPT you can use a prompt similar to:

  You are a language translator that is in the process of translating an mobile application for getting GPX traces in an iOS device. 
  
  Please provide the translation to the following languages:
  German (de), Spanish (es), Chinese Simplified (zh-Hans), Ukranian (uk), Finnish (fi-FI), Russian (ru),French (fr), Dutch (nl), Portuguese Brazil (pt-BR), Italian (it) 

  of the following strings:

  "TEXT_KEY" = "This is the text";
  "TEXT_KEY" = "This is the text";
  ```

You need to install swiftlint and ensure you’re not introducing additional lint warnings.
You need to document the classes and methods that you create explaining what do they do from a blackbox perspective. We use jazzy for the documentation. To install jazzy run:
```
gem install jazzy
```
Then, to view the documentation run
```
jazzy
```
Note that it will generate the documents in the ../gh-pages/docs.

PR License
Note that though the source code is licensed under GPL 3.0 by submitting a pull request you are also providing me (Juan M. Merlos) the rights to distribute those changes on the binary app published on the App Store (which is released under Apple’s Standard License Agreement)

GPL License

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/.

Please note that this source code was released under the GPL license. So any change on the code shall be made publicly available and distributed under the GPL license (this does not apply to the pods included in the project which have their own license).

This app uses:

CoreGPX Framework, a SWIFT library for using GPX files. Created by @vincentneo

Entry on the Open Street Maps Wiki