Skip to content

Versions and Compatibility

Every .thrl file names its format version in version, currently "1.12". Since 1.9, new versions have only added optional fields, so software that reads 1.12 reads every file from 1.9 on. Throughline itself opens every .thrl file ever written.

version is the format version of the file. minVersion is the oldest version that reads it completely, currently "1.6". Compare versions number by number: 1.10 is newer than 1.9.

If a file is newer than your software knows, read the fields you know and ignore the rest. You might miss a newer feature, so it’s fair to tell the user.

If a file is older than 1.9, it has no storyOrder and no guide block, and it can still contain fields that later versions dropped. The easy fix is the writer’s: when Throughline opens an old file, it asks before it saves it in the current version and keeps the original in the autosaves folder.

VersionWhat changed
1.0The first format: project, Beats, Characters, Settings (worlds), Structure Cards, Sparks and the recycling bin.
1.1Dialogue numbering, and minVersion.
1.2Scene numbers: beat.sceneNumber.
1.3The first Arc view, replaced in 1.4.
1.4The arcs array.
1.5Self-contained Arcs, with their own names, colors, poles and beatIds.
1.6The Constellation: relationships and Character positions.
1.7Spacer cards, removed again in 1.9.
1.8Relationships and positions that change from Beat to Beat: overrides and startBeatId.
1.9Files that explain themselves: the guide block and storyOrder. Older fields that had been replaced are no longer written.
1.10Stacked Settings.
1.11Deleted Beats keep their Arc and Constellation data (shapeRefs).
1.12Writer Assignment (project.people, beat.assignedTo, savedBy) and the Replace All history (project.replacements).

Older files can contain fields that a later version replaced. The legacy fields list names them all, and every file repeats it in guide.legacyFieldsIgnore. Ignore them.