This is an old revision of the document!
Lists are the basic container for controlling and organizing Units in XTension. The Master List is always available and will always display all your Units. You can open the Master List by selecting it from the Lists menu or using the Command-0 keyboard shortcut. You can create new lists by selecting the New List menu item from the File menu. You can create any number of Lists, each one must have a unique name.
The list can be sorted by clicking in the headers as is normal. You can also manually change the order of the units in the list by selecting and then dragging them up and down. After creating a new list you can drag units from any other list into it. You can also add units to a list by selecting them and control or right clicking on the selection then selecting “add selected units to list…” You can re-arrange the columns and resize them similar to how the Finder or any other OS app behaves.
By performing a control or right click in the headers of the list you can perform quite a bit of other customization. Any column in the List can be hidden by control clicking on it and selecting to Hide it. You can also hide the headers entirely for the list. You can re-enable them by control clicking in the content area of the list and selecting to show headers there. If any columns have previously been hidden you’ll be given the option of re-showing them under the Insert Column menu item.
If at any time you get columns resized to invisibility or can’t reach other settings because of dragging a column size so far off the window you can reset a list window to it’s default settings by holding the option key as you open the List from the List menu.
Double clicking a Unit will toggle it’s state. Clicking the Unit Indicator or Icon in the Name column brings up the Popup Unit Control Window you can also bring this window up without the mouse by pressing the left arrow key with a Unit selected in the list.
You can also send an ON/OFF command for unit from the Contextual menu. Control or right click on a Unit and select “Turn ON” or “Turn OFF”.
You can jump directly to the selected units Edit Window by pressing the right arrow key or selecting “Edit” from the Contextual menu.
Control or right clicking brings up the Contextual menu for the selected Unit:
The Flags column of a List window displays some useful information and offers several shortcuts for editing.
The first flag shows whether the Unit is Blocked or not. Clicking on the icon toggles the blocked state of the unit.
The next 2 icons indicate if the Unit has an ON script or OFF script. Clicking on them will open the Edit Script window for the Unit if the script already exists, or create a new script if it does not exist yet.
The last icon displays the battery level of the device, or is greyed out if the device does not support sending battery levels or doesn’t have a battery. Depending on the device there will be different amounts of information here. For X10 security devices or Oregon temp sensors that include the low battery flag if their battery starts to get low there are only 2 states, all green or all red. For more modern devices like ZWave battery sensors that send a percentage value that will be reflected in the drawing of the green portion of the battery in order to graphically give some more information.
If you mouse over the battery display a tool tip will popup showing you the actual percentage of the battery remaining if applicable.
Sorting the Flags column results in the various flags being grouped together so you could find all the low battery Units in a list easily that way. You can also get a list of units with the low battery flag set via the All Of Class Verb.