Shion features a modest AppleScript interface that allows the application to be controlled using other programs and scripts.

Manipulating Devices

To control devices via AppleScript, Shion must be running. The following commands will launch the program if it is not running.

To activate a device by name, use the following code:

	tell application "Shion"
		activate device named "Lava Lamp"
	end tell

The deactivate command may be substituted for the opposite effect.

To brighten or dim a continuous device:

	tell application "Shion"
		set the level of the device named "Lava Lamp" to 4
	end tell

Levels range from 0 to 8.

To fetch a property of a device:

	tell application "Shion"
		return the level of the device named "Lava Lamp"
	end tell

or:

	tell application "Shion"
		return the state of the device named "Lava Lamp"
	end tell

Activating Snapshots

To activate a snapshot:

	tell application "Shion"
		activate snapshot named "All Off"
	end tell

Other Commands

Commands for other operations such as adding and removing devices are available. To see these commands and their syntax, open the Shion AppleScript dictionary from Script Editor.

In the future, we will continue to extend Shion's AppleScript features. If you have a command or other scripting feature that you would like included, please post a request on the Shion UserVoice forum.