Skip to content

Command Line Glossary

As the new command line has just been re-written into an actual language, it's going to take some time to get all of the new commands in.

Update

Update is the process of updating your Looks or updating your Favorites. Press Update to open the popup.

Record

Record enables you to create Looks, Favorites, Effects, and Groups. See the relevant sections for detailed information.

Go

To be implemented.

Look

Keyword for the component. Right now, you can use this like so:

js
Fix 1 recall from Look 4 Enter

This recalls the information that Fixture 1 was at in Look 4 into the current Look you are in. They will become red values as they are now manual values so that you can save them somewhere.

Group

Keyword for the component. Select a Group from the Command Keypad. Example:

js
Group 7 "Color Temperature" at 5600 Enter

Macro

To be implemented.

Favorite

To be implemented.

Effect

To be implemented.

Fader

To be implemented.

Col Temp/Tint/Col Xfd

Convenience keys for quick control of common film attributes. Examples:

js
Fixture 1 Thru 20 "Color Temperature" at 5600 Enter
Fixture 1 "Tint" at -20 Enter
Fixture 302 "Color Crossfade" at 100 Enter

Copy

Keyword to copy to another target. Example:

js
Fixture 1 Copy To Fixture 2 Enter

If not filtered, this will copy all parameters. To filter:

js
Fixture 1 Color Copy To Fixture 2 Enter
Fixture 101 Copy To Fixture 201 thru 208 if "Pan" Enter

Recall

Like Copy to, but in reverse selection order. It will recall parameters from another fixture or destination. Examples:

js
Fixture 1 Recall From Fixture 2 Enter
Fixture 1 Recall From Look 7 Enter

Swap

To be implemented.

/

A key to tell Blackout to multiply/divide a value, and when double pressed to input a direct DMX value. Examples:

js
Fixture 1 Thru 10 at /50 Enter

Takes the Fixtures to half their current value(s).

js
Fixture 1 Thru 10 at /200 Enter

Takes the Fixtures to twice their current value(s).

js
Fixture 1 at //235 Enter

Takes the Fixture to the DMX value 235.

+

Keyword to select items out of order. When double pressed + will jump the current value by 5% (this value can be customized in Settings). Examples:

js
Fixture 1 + 237 + 501 Enter

Selects these Fixtures.

js
Group 1 + Fixture 301 ++

Raises the current values by 5 points.

-

Keyword to exclude Fixtures from a range or subtract from a value. When double pressed, - will lower the current value by 5% (this value can be customized in Settings). Examples:

js
Fixture 1 Thru 10 - Fixture 8 at Full Enter

Selects Fixtures 1 thru 7 and 9 thru 10 and brings them to full.

js
Group 1 - -

Lowers the current values of Group 1 by 5 points.

Fixture 1 At -10 Enter

Lowers the current value of Fixture 1 by 10%.

Thru

Keyword to select a range of items. Examples:

js
Fixture 1 Thru 10 Enter

You can also spread a range of values across a selection. If you have an Astera Titan Tube in 16 pixel mode you could do:

js
Fix 201 .. at 0 thru 100 thru 50 thru 75

This would put a wave of values across your tube.

At

At is the most important keyword as it separates your selection from your target or value.

js
Fix 1 at 50 Enter

This sets the value to 50%.

Home

Home will home the values to their default.

js
Fix 1 at home enter

This will bring all of the NIPs (non-intensity parameters) to their default values. Intensity will stay the same. It's most used to reset a fixture to its default state or color.

js
Fix 101 Color Home Enter

Release

Release will release the values to whatever has control of it - usually a Look, but could be a separate Fader.

js
Fix 1 at release time 5 enter

This will release all manual values on Fixture 1 to whatever has control of it over 5 seconds.

Out

Quick way to take a parameter to its lowest or minimum value.

js
Fix 1 "Red" at Out Enter

This will put the Red parameter to 0.

Full

Quick way to take a parameter to its highest or maximum value.

js
Fix 1 "Red" at Full Enter

This will put the Red parameter to 100.

Freeze

To be implemented.

Select

To be implemented.

if

if is a way to filter your command.

js
Fix 201 recall from 204 if Color Enter

This will copy all of the Color category parameters from Fixture 204 into Fixture 201.

Time

Time, with a value, sets the value over a given time.

js
Fix 201 .. at 50 Time 0 thru 3 Enter

This would take all of the cell intensities from Fixture 201 to 50%, but it would do the first cell in 0 time (snap on) spread through to the last cell which would come on over 3 seconds.

Time, without a value, will set the timing for that selection to be recorded into a Look.

js
Fix 201 .. Time 0 thru 3 Enter

This would put a red T flag in the upper right hand corner of the pillbox showing that this has an individual Fixture timing. You will then need to record or update the Look in order for this to be saved. Next time you go to that Look, the Fixture will use this timing instead of what is in the Look timing.

To release an individual timing use the command:

js
Fix 201 .. Time Home Enter

Don't forget to update your Look which will now remove the T flag from the upper right hand corner.

Delete

Deletes one keyword at a time from the command line if you made a mistake and need to revise your command.

Offset

Offsets your selection so you can easily create Groups or sections of your lights quickly. If you have a grid of Fixtures you can easily create columns/rows/patterns very quickly for your Effects to run across or to separate out into Groups for quick control.

More documentation coming. Checkout this video for a video explanation.

Align

To be implemented.

ON

To be implemented.

Clear

Clears the command line entirely. Quick one button press.

Enter

Enter a selecton to go into a "Selection Mode". You can now Next and Last your way through the selection to easily edit Fixtures.