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 and minVersion
Section titled “version and minVersion”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.
What each version added
Section titled “What each version added”| Version | What changed |
|---|---|
| 1.0 | The first format: project, Beats, Characters, Settings (worlds), Structure Cards, Sparks and the recycling bin. |
| 1.1 | Dialogue numbering, and minVersion. |
| 1.2 | Scene numbers: beat.sceneNumber. |
| 1.3 | The first Arc view, replaced in 1.4. |
| 1.4 | The arcs array. |
| 1.5 | Self-contained Arcs, with their own names, colors, poles and beatIds. |
| 1.6 | The Constellation: relationships and Character positions. |
| 1.7 | Spacer cards, removed again in 1.9. |
| 1.8 | Relationships and positions that change from Beat to Beat: overrides and startBeatId. |
| 1.9 | Files that explain themselves: the guide block and storyOrder. Older fields that had been replaced are no longer written. |
| 1.10 | Stacked Settings. |
| 1.11 | Deleted Beats keep their Arc and Constellation data (shapeRefs). |
| 1.12 | Writer 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.