Welcome to Trakkit.org
Trakkit.org is the front-end for a track rendering engine for leisure and offshore sailing.
It lets you:
- Create, view, and share navigation tracks.
- Embed them into applications or websites.
- Share tracks via a simple internet link.
- Allow real-time tracking via automatic email (e.g. with Iridium Go), or automatic upload of NMEA or GPX files.
⚠️ Trakkit.org does not collect any personal data. You are responsible for what you choose to share online.
🚀 Quick Start
- Create an account (free)
- Create a boat (only the boat name is required)
- A set of sample data and a test track has been automatically created.
- Test the sample track by visiting:
https://<boatname>.trakkit.org
- Upload your own data using a
.GPX
file: DATA > Upload - Create a track: TRACK > Add Track to choose which part of the data you want to display
- A TTR ID is assigned, and the track can be shared at:
https://trakkit.org/ttr/<TRACK-ID-TTR>
NB: The sample data set is automatically deleted as soon as you start uploading your own data.
🔧 How does it work?
It’s essential to understand that in Trakkit, data is not tied to tracks. Data can be sent continuously. Tracks simply define date ranges within which the corresponding data is visible. Deleting a track does not affect the data. Data is only visible if a track is defined to make it visible. The same data can appear in multiple tracks.
- Send your GPS positions to spool@trakkit.org (e.g., via Iridium Go)
- Define a track with a start and end date
- Share the link:
https://trakkit.org/ttr/<YOUR_TTR>
(Replace<YOUR_TTR>
with your track ID, available in your track list) - Optionally, upload a full GPX or NMEA file after your trip
Note: Trakkit was originally designed for Iridium Go, but any device capable of sending GPS emails is supported.
📚 General Documentation
Everything in Trakkit.org revolves around three objects:
- Boat
- Data
- Track
Data is linked to a boat. A track is a segment of data between two dates.
Basic structure:
- 1 user may have several boats
- 1 boat belongs to 1 user only
- 1 boat can have as many tracks as needed
- Multiple tracks may use the same data
🛥️ Boat
Creating a boat is the first step required to import data and associate tracks.
⚙️ Default Behavior
When a new boat is created: - A test track is automatically generated. - A set of sample data is associated with this track.
This allows you to quickly verify the boat’s parameters and visualization.
Note: This test track and its data will be automatically deleted upon the first import of real data.
📝 Available Fields
- Name (required): Identifies the boat.
- Maxspeed: Used to detect potential GPS point anomalies (e.g., unrealistic speeds).
- Info: An optional, purely informational field.
- Active livetrack: Enables real-time tracking with past track.
A dedicated track must be created beforehand via the Track menu, then selected here. To be eligible for Live Track, the track must have an end date in the future (e.g., 1/1/2050). - Direct URL: A public web address providing direct access to the boat’s current position, and its livetrack if defined.
📈 Data
Once a Boat has been created, you can feed Trakkit.org with data for this Boat.
Data is a collection of GPS points and optional sensor info (AWA, AWS, etc.) for a boat.
How to send DATA
One of the simplest ways is to go to DATA>UPLOAD and upload your .GPX tracks exported from a tablet or a GPS tracker. Most navigation apps support this.
For any automatic Data sending by companion app, email, sFTP, you must first create a Tag or associate an email with this Boat by going to BOAT > Mails & Tag
Some apps, like Navionics Boating, also allow you to share tracks by email. In that case, simply send the track from the app to spool@trakkit.org after linking your email to the boat in BOATS > Mails & Tags.
You can send Data in different ways at different times. At sea, you might use a device like Iridium Go to send a position every 5 minutes for live tracking. Once in port, you can upload your saved NMEA data or simply email the full track from Navionics Boating.
So, Data:
- May come from different sources
- Can be manually uploaded on DATA>UPLOAD or sent to spool@trakkit.org
- Can be automatically sent via email, companion app, or sFTP
- You can associate multiple email addresses or Tags with a single boat.
- An email address or Tag cannot be linked to more than one boat.
- Tracks are a view of data (no strong link)
- Deleting a track does not delete data
If you have an internet connection at sea, you can send data in real time. If not, simply save a .GPX file from your GPS or navigation system and upload it later when you’re back online. You can also save your full NMEA 0183 data stream and send it afterwards.
What is DATA?
DATA can take several forms:
- A
.gpx
file generated by a GPS device or exported from apps like Navionics Boating - A file capturing NMEA 0183 traffic, recorded using apps like OpenCPN or QtVlm or a companion app.
- Or refers to regular text containing GPS position information, such as those sent by email with devices like Iridium Go:
I am here Lat+28.851240 Lon-13.794377 Alt+009ft GPS Sats seen 10 2023-01-17 00:34UTC
- Whatever upload method you choose, all Data can be compressed in: ZIP, GZip, Z, XZ, 7z, TAR
✉️ Emailing DATA:
Assignment Rules:
- If the sender's email is linked to a BOAT on Trakkit.org, the DATA will be assigned to that boat.
- If a TAG alias is specified in the Subject line of the email, the DATA will be assigned to the boat associated with that TAG.
- In case of conflicting information, the email address takes priority over the alias.
Accepted Formats:
- DATA can be included as:
- Attachments (recommended)
- Plain text in the body of the email
- Compressed or archived files are accepted: Z, ZIP, 7z, GZIP, TAR
🗑️ Deleting Data
Deleting a track does not delete the data.
To delete data:
- Use the Data > Delete menu
- Delete by date range or BatchID
- Every upload has a BatchID; removing a batch only deletes that data chunk
🏷️ Tags
Tags are alternative aliases used to identify a boat. A tag’s main purpose is to grant access to a specific group of people. Deleting a tag will remove access for that group, but anyone using a different tag will still have access.
Typically, you create a separate tag for each system that feeds data to the boat. If access to a system becomes corrupted or unavailable, simply delete the associated tag.
To feed data via companion devices or to use the sFTP server, you need to create a tag with a password. Be sure to remember this password, as it cannot be recovered. If it’s lost, you’ll need to delete the tag and create a new one.
- You can create as many tags as you like for a given boat.
- Tags can be shared with groups or individuals to grant access.
- A tag can be deleted at any time.
- Tags can be used to send data by email from any email address, by simply putting the tag in the subject line. In this case, do not share the tag with anyone.
🗺️ TRACKS:
Unlike other navigation systems, a Track in Trakkit is simply a named slice of time within a set of Data.
You define the start and end times and give it a name.
Trakkit will check if any corresponding Data is available for that interval and display it if so.
If no data is available, nothing will be shown. Later, if Data matching the track’s interval is uploaded, the Track will be automatically updated.
A Track can also be manually updated via TRACK > Regen
.
- BoatName: The boat to which the track should be associated.
- TrackName: Displayed name of the track.
- Color: Choose a color or choose Random color for each update of the Track.
- WPO: Interval in minutes for the progress points (the orange points).
- WPP: Interval in seconds for the track points (Track precision).Warning: setting too high a precision can slow down track loading and visualization. Use common sense and adjust the precision based on the type of track: “10 for regattas, 60 for coastal navigation, 300 for offshore navigation” are good guidelines
- Published: Check this if you want to list the track in the "TRACK LIST" visible on your boat page at https://boatname.trakkit.org
- Reminder: Deleting a track does not delete the data.
Visualizing Your Track
Once data has been uploaded, you can visualize your track. Tracks are stored statically and are only generated when the data is updated or manually triggered by clicking Tracks > Regen.
You can view a track in two ways:
- Directly via its link: https://trakkit.org/ttr/<TRACK-ID>
- On trakkit.org by entering the TRACK-ID
.
If you have set up a track for real-time tracking, you can access it directly using the chosen URL (usually the boat name), for example: https://boatname.trakkit.org
.
💻 Companion
A companion app is a third-party application that collects and sends data to Trakkit.
It can be developed by you or any other party.
This is the preferred solution for real-time tracking.
The Python base code of "JoliCompanion," Trakkit's standard companion, is freely available and can be adapted to your setup.
An SFTP tag with a password is required for sending data.