Software Documentation

Exporting a firing system scriptDocumentation

Integration IntermediateLast updated: March 2, 2022

1 ActionBase

To create and export a script for the ActionBase firing system, please follow these steps:

  1. Address the show (“Addressing > Address show”).
  2. Export the script (“File > Export > Export firing scripts“).

Step 2 creates the script file, which is a standard format CSV file with a “CSV” extension. The file format details are described in this section.


Figure 1 – ActionBase firing system


Table 1 – File format and encoding

File formatExtensionText encodingField delimiterEnd-of-line
Text.TXTCode Page 1252TabCRLF

The script contains rows for the firing events, i.e., unique combinations of module, pin, and ignition-time. Multiple effects can be combined on a single cue. The special characteristics of the script are shown in the following table:


Table 2 – Special characteristics

Special characteristicsDescription
Sort order of rowsRows sorted ascending by event time, then by module number, then by pin number.
What rows representEach row represents a unique firing event, a module/pin/event-time combination. For example, a chain of five shells will be one row, not five. A pair of shells shot together from the same position will be one row, not two, even if the shells are different effects. A flight of shells shot together from multiple positions with the same module-pin using scab wire is still one row.
HeaderThe file does not contain a header.
Time resolutionThe ActionBase system supports hundredth of a second resolution.
Special charactersThe TXT file allows all Code Page 1252 characters except control characters like linefeed and tab, which are filtered out. There is no escaping or quoting facility.

Each row in the script has a number of fields separated by the tab character. The names of the fields and their descriptions are the following:

Table 3 – Specifications of script fields

Field nameDescription
Event TimeTime of ignition in the format H:MM:SS.DD.
Module NumberModule number, starting with 1.
Pin NumberPin number, starting with 1.
DescriptionDescription. If the row represents multiple effects, the description begins with the number of effects in parentheses, continues with the first effect name, and ends with elipsis (…) as an indication the row represents more than is being displayed in this single field.

An example script containing six (11) shells across nine (9) firing rows is shown in Figure 1 and included for download in Table 4. In this script, the last two rows each represent two effects ignited from the same pin.

0:00:02.76	1	1	2"	Green Chrysanthemum
0:00:02.86	2	1	2"	Green Chrysanthemum
0:00:02.96	3	1	2"	Green Chrysanthemum
0:00:03.06	4	1	2"	Green Chrysanthemum
0:00:03.16	5	1	2"	Green Chrysanthemum
0:00:03.26	6	1	2"	Green Chrysanthemum
0:00:03.36	7	1	2"	Green Chrysanthemum
0:00:03.46	8	1	2"	(2) Green Chrysanthemum ...
0:00:03.56	9	1	2"	(2) Green Chrysanthemum ...

Figure 1 – Example ActionBase script


Table 4 – Example files

Download linkExplanation
test_actionbase.finExample show file
test_actionbase.txtExample exported file (TXT)