Trakkit.org Documentation

Trakkit.org is a rendering interface for sailing tracks (both coastal and offshore).

It allows you to:
- Create, view, and share sailing tracks
- Integrate them into applications or websites
- Share them with a simple internet link
- Enable real-time tracking via automatic emails (e.g. Iridium Go) or automatic upload of NMEA or GPX files

⚠️ Trakkit.org does not collect personal data.
You are responsible for what you share online.

🚀 Quick Start

1. Create a (free) account
2. Create a boat (only the name is required)
3. A dataset and a test track are automatically generated
4. View the test track: https://<boatname>.trakkit.org
5. Import your data using a .GPX file (DATA > Upload)
6. Create a track (TRACK > Add Track)
7. Share it: https://trakkit.org/ttr/<TRACK-ID>

👉 Test data is automatically deleted once you upload your own.

🔧 How It Works

• Data is independent from Tracks
• A Track is just a date interval defined on a dataset
• Deleting a track does not delete the data
• The same data can be used in multiple tracks

📚 Main Objects

• Boat
• Data (GPS positions + sensors)
• Track (time slice defined on data)

Relationships:
- 1 user ➝ multiple boats
- 1 boat ➝ one user
- 1 boat ➝ multiple tracks
- Several tracks can share the same data

🛥️ Boat

Default Behavior

When a boat is created:
- A test track and example data are generated
- They are removed when the first real data is uploaded

Fields

• Name (required)
• Maxspeed (used to filter anomalies)
• Info (optional)
• Active livetrack (real-time mode; requires a track with a future end date, e.g. 2050)
• Direct URL (public link showing current position and live track)

📈 Data

Data can come from:
- GPX files
- NMEA 0183 files (OpenCPN, QtVlm, etc.)
- Emails containing GPS positions (Iridium Go, Navionics, etc.)
- Plain text in the format:

LAT LON YYYY-MM-DD HH:MM:SS UTC [AWA:XXX AWS:XX.X COG:XXX SOG:XX.X]

Valid format exemple:

-38.1052 -12.277 20210210 102345  # UTC implicit 
46.238 -0.5687 2021-02-10 10:23:45 UTC 
-38.1052 -12.277 20210210 102345 UTC+2  # If for some reason your nav system isn't in UTC 
46.238 -0.5687 2021-02-10 10:23:45 UTC AWA:120 AWS:23.5 COG:125 SOG:9.2 

Supported formats

.gpx, .nmea, .zip, .gzip, .xz, .7z, .tar, .tgz

How to send data

• Manual upload (DATA > Upload)
• Email to spool@trakkit.org
• Automatic upload via companion app or SFTP

📡 Sending by SFTP

You can send your files to our SFTP server, which is the recommended method for automated data transfers.

Credentials & server address are provided when you request a tag password.

Accepted file formats: - Data files: .gpx, .nmea, .txt - Compressed archives: .tar, .zip, .z, .xz, .7z, .gz

Restrictions (fair use policy): - Maximum upload frequency: 1 file every 5 minutes - Maximum file size: 20 MB per upload

Uploaded files must follow this format:

TAG_YYYYMMDD_HHMMSS.ext

Note: TAG must match the one used for the connection.

➡️ It is strongly recommended to first upload the file with the extension .part
and then rename it to .ok once the transfer is complete.

This ensures the file will not be processed before the upload is fully finished.

Sending by Email

• A tag must be provided in the subject
• Or sender address must be linked to a boat
• If both exist ➝ the sender address takes priority
• You can send the data as a file attachment or write it in the message body

🗑️ Deleting Data

• Deleting a track does not remove the underlying data
• To remove data:
• Use DATA > Delete by date range or BatchID
• Each upload is identified by a BatchID

🏷️ Tags

A tag is an alias that identifies a boat.

• Useful to manage multiple data sources (e.g. one tag per system sending data)
• Can be deleted at any time
• Can be associated with a password for sFTP
• One email ➝ one boat (but a boat may have multiple emails/tags)

⚠️ The sFTP password of a tag cannot be retrieved. If lost, create a new tag.

🗺️ Tracks

A track = a time interval applied to data.

• BoatName: associated boat
• TrackName: display name
• Color: fixed or random color
• WPO: waypoint output interval (minutes)
• WPP: waypoint precision (seconds)
• Published: makes the track visible on boatname.trakkit.org

👉 Recommended settings:
- Regatta ➝ 10 s precision
- Coastal ➝ 60 s precision
- Offshore ➝ 300 s precision
- Always set start and end to avoid exposing exact departure/arrival

👀 Visualization

• Direct link: https://trakkit.org/ttr/<TRACK-ID>
• From the home page with the TRACK-ID
• In real time: https://<boatname>.trakkit.org
• Tracks are rendered statically and only refreshed when:
• New data is imported
• Or manually regenerated (TRACK > Regen)

💻 Companion

A companion app is a third-party program that pushes data to Trakkit.

• Can be freely developed
• Best solution for real-time tracking
• Example: JoliCompanion (Python-based starter provided)
• Requires an SFTP tag with password