FAQ
This page is about what goes into Voyarc (typed routes, CSV files of legs, flown-track files) and what comes back out in the logbook export. Every file is read in your browser and never uploaded.
How do I type a route list?
A route is three-letter IATA airport codes joined by dashes, and the box takes as many routes as you like:
SYD-LAX-JFK, SYD-LHR MEL-PER SYD-MEL x40
-
Routes are separated by a comma, a semicolon or a new line. Case does not
matter:
syd-melisSYD-MEL. -
Stops inside one route are separated by a hyphen, an en or em dash, a slash or
a space:
SYD-LAX-JFK,SYD/LAX/JFKandSYD LAX JFKare the same three-airport itinerary, drawn as two legs. -
Direction is part of the route:
SYD-MELandMEL-SYDare two different routes. - The order you type them in is the order Voyarc flies them, and it picks the opening show: a list that reads as one trip, each leg starting where the last one landed, opens as a Journey. Anything else opens as a Network: an airline's routes, an airport's, or the same trip typed out of order. A flown track opens Race, or Trace if it lands where it took off.
-
A repeat count says how many times you flew it. Write it
SYD-MEL x40;×40,*40,(40)and[40]are read the same way, and the bracketed forms need no space. A barexmust not be glued to a code:SYD-LAX40is a typo, not forty flights. The largest count is 9999. -
The same route typed twice is one route with the counts added, so
SYD-MEL, SYD-MELisSYD-MEL x2.
A count changes the figures, not the picture: the map draws each route once and the show flies it once, while the totals count every flight.
If you do not know a code, the search box under the route box finds an airport by city or name, and picking a result adds its code to the end of the list.
Which CSV files can I import as routes?
Import CSV in the panel reads a table of flights and turns it into routes. Most spreadsheets already qualify; the first row decides how the file is read.
The one rule: a from column and a to column
Any CSV whose header names an origin column and a destination column imports.
Origin is from, origin, dep,
departure, orig, source or
start; destination is to, dest,
destination, arr, arrival or
end. Every other column is ignored, so a file with too much in it
costs nothing.
from,to,notes SYD,MEL,commute JFK,LHR,holiday
Three variations on the same file are read too:
-
A single route column named
route,routes,pathoritinerary, holding a whole itinerary (SYD-LHRorSYD LHR DXB), with an optionalcountcolumn for how many times it was flown. - A headerless two-column file, where the first two cells of every row are airport codes and nothing else needs to be said.
- Voyarc's own routes export, which is just a from/to file with extra columns: it carries a route column as well, and the from/to pair wins, because that is the leg the map drew.
A Flightradar24 "My Flights" export
The account export, unchanged: nineteen columns, every cell quoted. Voyarc reads
three of them, From, To and Date. Airline,
flight number, registration, aircraft, seat and the rest are ignored.
Date,Flight number,From,To,Dep time,Arr time,Duration,Airline,Aircraft,Registration,Seat number,Seat type,Flight class,Flight reason,Note,Dep_id,Arr_id,Airline_id,Aircraft_id "2026-01-04","ZZ101","Sydney / Kingsford Smith (SYD/YSSY)","Melbourne / Tullamarine (MEL/YMML)","06:00:00","07:35:00","01:35:00","Nowhere Air (ZZ/ZZZ)","Boeing 737-800 (ZZ-ZZA)","ZZ-ZZA","12A","1","1","1","","3286","2452","0","B738" "2026-01-06","ZZ202","Melbourne / Tullamarine (MEL/YMML)","Sydney / Kingsford Smith (SYD/YSSY)","17:00:00","18:30:00","01:30:00","Nowhere Air (ZZ/ZZZ)","Airbus A320-200 (ZZ-ZZB)","ZZ-ZZB","4C","2","1","1","","2452","3286","0","A320"
Nothing to import yet? Download the sample logbook: a whole file in this shape, three years of flying for an airline that does not exist, out of airports that do.
The rules that apply to all of them
- The delimiter is detected from the first row: comma, semicolon or tab. A leading byte-order mark is ignored.
-
Quoted cells may hold the delimiter, a doubled
""for a literal quote, and a line break. -
An ICAO code beside the IATA one is dropped:
Sydney (SYD/YSSY),Sydney (SYD)andSYDall read as SYD. - A leg that appears on several rows becomes one route with a count on it.
- A row with no pair of codes, or with a code we don't have an airport for, is skipped and named in the report under the route box.
- One import maps at most 500 unique legs, on every tier: past that it is a database, not a map.
- The free tier maps the first 25 unique legs of an import; Pro maps the whole logbook. Routes are never split: an itinerary longer than the cap still maps completely. See Pricing.
Repeats inside a CSV come from the file, not from the route box's
x40 suffix, which is not read inside a cell. A count
column carries them, and so does the same row appearing again. Five rows of
MEL-SYD, or one row with a count of 5, fold into one leg marked
×5: one arc on the map, and one leg of the cap. Direction counts,
so MEL-SYD and SYD-MEL are two legs.
Narrowing a logbook to one year
If your file has a date column (Date, Flight date,
Departure date, Dep date, Departed,
Flown, When or Year), Voyarc reads the
date off each row. When a logbook spans more than one year the
import report gains a Year picker: choose a year to map just those legs, or "All
years" to bring the whole logbook back. Either way the file is already read, so
there is nothing to import again.
The date stays in the panel: the year and the month feed the picker and the Year in review show. Your routes, the link you share and the map itself carry no dates. With Pro, Add to my logbook is the one thing that saves dates, and only when you press it.
Can I make a year in review?
Yes: import a logbook with dates and another show, Year, joins Journey and Network in the panel's Show row. It replays one year a month at a time. Every flight in a month takes off together, a caption names it, and the lines stay up as the year fills in. It closes on a card of the flights, routes, airports and distance you flew. The Guide's year in review section covers which year it picks and how long one runs.
With Pro you can file a dated import into your saved logbook and open that logbook on the map whenever you like, so the review runs again without the file.
Which files can I import as a flown track?
Track, in the panel's Map row, takes the path an aircraft actually flew and draws it in grape, replacing your route list. An A-to-B track keeps the great circle it flew as a dashed reference; a round trip is drawn on its own. One track per file: several track segments in one file are joined into a single line.
Files are read in your browser and never uploaded. Import only tracks you have the right to use: your own recordings, or exports whose terms allow it. Check your source's terms. Nothing here is for navigation.
A FlightAware "Google Earth" export
Open any flight's page on FlightAware and its track history offers
Export to Google Earth. That link downloads a .kml file,
and Voyarc reads it as it comes. There is nothing to convert.
Inside, the file is a <gx:Track> or a
<LineString> in a Placemark. Airport pins
(<Point> Placemarks) are ignored, so the map draws the flight
and not a straight line between the two airports.
<Placemark><name>ZZZ101</name><gx:Track> <when>2026-08-22T05:17:53Z</when><gx:coord>151.17439 -33.94003 -38</gx:coord> <when>2026-08-22T05:20:19Z</when><gx:coord>151.20206 -34.01930 1257</gx:coord> </gx:Track></Placemark>
KMZ is not read: it is a zipped KML, so unzip it and import the
.kml inside. Any other KML with a
<LineString> or a <gx:Track> works the same
way.
GPX
The open standard: phone loggers, Flighty, ForeFlight and most trackers export
it. Any GPX with a track works: the <trkpt> points are read
in order, whichever way round their lat and lon
attributes are written.
<trkseg> <trkpt lat="-33.946" lon="151.177"><ele>10</ele></trkpt> <trkpt lat="-33.500" lon="151.500"><ele>3600</ele></trkpt> </trkseg>
A Flightradar24 flight CSV
The per-flight download from a flight's playback page (not the My Flights export
above). The header must contain a Position column, and each position
cell is a quoted "lat,lon" pair:
Timestamp,UTC,Callsign,Position,Altitude,Speed,Direction 1725000000,2026-08-30T08:00:00Z,ZZ101,"-33.946,151.177",0,0,0 1725000300,2026-08-30T08:05:00Z,ZZ101,"-33.500,151.500",12000,320,30
What the comparison shows
The track card prints the distance actually flown, the great circle between the two nearest airports to its ends, and the difference between them in your units and as a percentage. Fly it as a Race and the two paths leave together at the same speed, so the longer real one lands later; Journey and Network fly the reference pair the import left in the route box, with the track drawn under it. A track that lands where it took off, or within a few kilometres of it, is a round trip with no great circle to race, so Voyarc picks Trace instead: it flies the flown path and draws it as it goes, with the camera held on the whole picture. The path we draw is a great circle; the distances beside it are measured on the WGS84 ellipsoid, the slightly flattened shape the earth really has.
What is in the logbook CSV?
Export CSV sits beside the logbook line under Collections, in the panel's Saved row. The file is one row per leg, with the day in front:
date,route,from,to,bearing_deg,distance_km,count 2026-01-04,SYD-MEL,SYD,MEL,232,706,3 2026-03-15,SYD-KUL,SYD,KUL,298,6579,1
-
distance_kmfollows the units you are working in: it isdistance_miordistance_nminstead when you switch. -
bearing_degis the initial course of that leg, the same figure the legs table prints. -
countis the day's count folded into the route's own repeat, so the file adds up to the flying it records. - The same routes logged twice on the same date are one entry with the counts added.
- It re-imports through Import CSV as routes: it has both a route column and a from/to pair, and the pair is the leg that gets drawn.
What happens to my saved data if I cancel?
Your collections and logbook are kept for 30 days after a subscription ends. For those 30 days you can still open them, download the logbook as a CSV, and delete everything yourself from the panel. You just cannot add to them. After that the record is deleted automatically, and there is nothing left to restore; the details are in the Privacy Policy.
Questions this page does not answer: [email protected].