CSV File Formats

Native CSV exports supported by ChartedSails and the unit-explicit generic CSV format for custom integrations.

ChartedSails can import native CSV exports from supported sailing instruments and apps. Upload the original export whenever possible: do not rename its columns or convert its units. ChartedSails detects the source format and performs the required conversions automatically.

If you generate data yourself, use the unit-explicit generic format below.

Supported native CSV exports

ChartedSails currently recognizes native CSV exports from:

• B&G Triton Edge / Njord
• Expedition
• Yacht Devices routers and voyage recorders
• Sailmon
• Cyclops Marine
• RaceGeek
• TruSail
• Sailteck
• Vakaros
• Surlo
• Kwindoo
• CS Coach / RaceBox
• SensorLog
• SaillCN track and wind exports

Native formats are recognized from their original header names. Extra columns are fine. Because vendors sometimes change their exports, please contact us and attach a short sample if an unmodified file is not recognized.

Generic CSV v1

Use this format for spreadsheets, scripts, and systems without a native converter. Column names include their units so the file is unambiguous.

Required columns

• timestamp — ISO 8601 timestamp with timezone, preferably UTC with Z
• latitude_deg — WGS84 latitude in decimal degrees
• longitude_deg — WGS84 longitude in decimal degrees
• sog_mps — speed over ground in meters per second
• cog_deg — true course over ground in degrees, from 0 inclusive to 360 exclusive

Optional columns

• heading_deg — true heading in degrees
• boat_speed_mps — boat speed through the water in meters per second
• tws_mps, twd_deg — true wind speed and true direction
• twa_deg — signed true wind angle: negative on port tack, positive on starboard tack
• aws_mps — apparent wind speed
• awa_deg — signed apparent wind angle: negative on port tack, positive on starboard tack
• heel_deg, trim_deg — boat attitude in degrees
• depth_m — depth in meters
• water_temperature_c — water temperature in degrees Celsius

Use commas as separators, a period as the decimal separator, and UTF-8 text. Keep rows in chronological order. Optional values may be blank, but every imported row needs a timestamp and GPS position.

Download a generic CSV example.

timestamp,latitude_deg,longitude_deg,sog_mps,cog_deg,heading_deg,boat_speed_mps
2026-09-09T15:50:03.718Z,37.806633,-122.445967,2.94,285.89,292.60,2.98
2026-09-09T15:50:04.717Z,37.806643,-122.446024,3.04,285.98,292.48,2.78

Legacy ChartedSails CSV

Files using the older internal headers time,longitude,latitude,sog,cog remain supported for compatibility. In that format speeds are meters per second and course values are radians. New integrations should use Generic CSV v1 instead.

Troubleshooting

• Start from the original export instead of renaming columns in a spreadsheet.
• Keep the file extension as .csv.
• Make sure the first row contains column headers.
• Make sure the file contains timestamps plus latitude and longitude positions.
• If importing a generic file, check that the five required headers match exactly and timestamps include a timezone.

If the file still fails, contact us with the original export or a 20–30 row sample. Please include the device or app name and software version when known.