Numbering

You are reading the documentation for version 1.0.2. Go to the current version (1.1.6)

This chapter has not changed since version 1.0.1.

This page explains the numbers in the first column. Where they come from, why they change by themselves, and why some lines have no number at all. Worth reading once, because the numbers are what you and a colleague use to talk about the show — “we are at 3.2” has to mean the same thing to both of you.

The numbers follow the structure

Where the line sitsNumber
Top level1, 2, 3
Inside a group3.1, 3.2
Inside a sub-group3.1.1

Move a line, add one, delete one, and the whole list renumbers itself immediately. You never type a number, and you cannot: the column is not editable.

That is deliberate. Numbers that you maintain by hand go wrong exactly once — during the show, when someone inserted a line and everything below it now means something else.

Sorting is numeric, not alphabetical

Each part of the number is compared as a number, so the order is

11.11.21.10210.

Sorted as text, 1.10 would land between 1.1 and 1.2, and cue 10 would come before cue 2. On a list of twelve items that is a nuisance; on a list of sixty it is a broadcast that plays in the wrong order.

Anything that is not a plain number falls back to text, so a 3a still sorts sensibly next to 3.

Lines without a number

Three kinds of line have no number, and each for the same reason: they are not a step in the running order.

LineWhy it has no number
The archive folder and everything in itIt never plays. A number would suggest it takes a turn.
A go-to cueIt is a reference to another line, not a step of its own. It does not shift the numbering around it either.
A part set to “count on with the list”Its number would sit between two numbers that already follow each other.

What the number is not

The number is not an identity. It changes whenever the list changes shape, so nothing inside the program refers to a cue by its number — links between playouts and go-to cues point at the cue itself. That is why moving a block around never breaks a jump or a link, and why the column can be recalculated freely.

If you need something that stays put no matter what, use the title. That is yours and the program never touches it.