Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/merlos/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
https://github.com/merlos/iOS-Open-GPX-Tracker

gpx gpx-files ios ios-app ios-swift iphone offline-maps osm xcode

Last synced: about 2 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/merlos/iOS-Open-GPX-Tracker
Owner: merlos
License: gpl-3.0
Created: 2014-09-30T20:45:05.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2023-06-11T03:22:23.000Z (over 1 year ago)
Last Synced: 2024-06-03T00:32:49.675Z (4 months ago)
Topics: gpx, gpx-files, ios, ios-app, ios-swift, iphone, offline-maps, osm, xcode
Language: Swift
Homepage: http://www.merlos.org/iOS-Open-GPX-Tracker/
Size: 6.74 MB
Stars: 579
Watchers: 41
Forks: 145
Open Issues: 67
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Awesome Lists containing this project

README

        Open GPX Tracker for iOS + WatchOS

===============================================

[![Available on the app store](https://merlos.github.io/iOS-Open-GPX-Tracker/images/download-app-store.svg)](https://itunes.apple.com/app/open-gpx-tracker/id984503772)

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](https://github.com/merlos/iOS-Open-GPX-Tracker/wiki/Privacy-Policy)

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

![GPS Tracker logs](https://merlos.github.io/iOS-Open-GPX-Tracker/images/open-gpx-tracker-4-screenshots.png)

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](https://medium.com/@merlos/how-to-simulate-locations-in-xcode-b0f7f16e126d).

 - 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](http://wiki.openstreetmap.org/wiki/Tile_usage_policy), and [Carto DB](http://www.cartodb.com) 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](https://itunes.apple.com/app/open-gpx-tracker/id984503772), available since May 2015.

Another option to install the app is to download the source code and compile it by yourself using [Xcode](https://developer.apple.com/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](https://github.com/merlos/iOS-Open-GPX-Tracker/wiki/How-to-translate-Open-GPX-Tracker-into-my-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](http://wiki.openstreetmap.org/wiki/Tile_usage_policy)

### 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](http://wiki.openstreetmap.org/wiki/Tile_servers)

## Reference documentation

The application is being documented using [jazzy](https://github.com/realm/jazzy) and following [NSHipster tutorial on swift documentation](https://nshipster.com/swift-documentation/).

![Documentation Status](https://www.merlos.org/iOS-Open-GPX-Tracker/docs/badge.svg)

**[Read Source code documentation](https://www.merlos.org/iOS-Open-GPX-Tracker/docs/index.html)**

## Contribute

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

Some conditions for a PR to be accepted:

1) Text displayed in the application shall be internationalized.

   - To do that use [NSLocalizedString](https://developer.apple.com/documentation/foundation/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](https://chat.openai.com) or [DeepL](https://www.deepl.com/translator) 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";

          ```

2) You need to install [swiftlint](https://github.com/realm/SwiftLint) and ensure you're not introducing additional lint warnings.

3) You need to document the classes and methods that you create explaining what do they do from a blackbox perspective. We use [jazzy](https://github.com/realm/jazzy) for the documentation. To install jazzy run:

    ```shell

    gem install jazzy

    ```

    Then, to view the documentation run 

    ```shell

    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

Open GPX Tracker app for iOS. Copyright (C) 2014-2023  Juan M. Merlos (@merlos) & Contributors

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 .

----

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](https://github.com/vincentneo/CoreGPX), a SWIFT library for using GPX files. Created by [@vincentneo](http://github.com/vincentneo)

Entry on the [Open Street Maps Wiki](https://wiki.openstreetmap.org/wiki/OpenGpxTracker)

See also:

- [Avenue GPX Viewer](https://github.com/vincentneo/Avenue-GPX-Viewer), a GPX viewer based on some of the codes used in this project. A side project by collaborator [@vincentneo](http://github.com/vincentneo).