Getting Started

Setting up Entangler on your Mac

In order to control your Mac, the Entangler app must be installed and running on your Mac. If you haven’t installed it already, it is available from the Mac App Store. On first launch, Entangler for your Mac will walk you through some initial set up. After the set up is complete, Entangler is available in your menu bar:

EntanglerMenuBarIcon

Clicking the Entangler icon will pop open a window, which is probably empty at this point. The window lists all of the Entangler Actions you have installed. An Entangler Action can be any file which OS X is able to run out of your Application Scripts folder, currently Automator Workflows, Applescripts, and Unix shell scripts. There are a few ways to install new Entangler Actions:

  • If you have an Entangler Action Archive (an .entangler file), such as one downloaded from the Action Gallery, you can simply double click on the file and Entangler will open it.
  • Clicking on the + button at the bottom left of the Entangler window will open a file browser which will allow you to select any supported file, including Automator Workflows, Applescripts, Unix shell scripts, and Entangler Action Archives. Select one or more actions you wish to install and click Open.
  • You can also just drop the action into the
    ~/Library/Application Scripts/com.amolloy.ottosantenna/
    folder. Entangler will notice and add the action.

A few moments after an action has been added to Entangler on your Mac, it should show up in Entangler on your iOS devices. If you declined to allow push notifications on your iOS device, you will need to manually refresh the list of actions by pulling down until the refresh icon appears and starts spinning. Once it does show up, go ahead and tap it to give it a try. You should see the action executed on your Mac a few moments later. How long it takes depends on a number of factors. If your iOS device and Mac are both connected to the same local network, it may be instantaneous. If they aren’t, then it could take several seconds. Either way, Entangler will display a notification on your Mac once the action has been completed.

Arguments

If you have an action that you would like to pass arguments to, you can press and hold on the action for a few seconds in Entangler on your iOS device. A dialog will appear asking you to supply arguments. Entangler’s argument parsing is not as sophisticated as a typical Unix shell, but it does know how to do things like group quoted strings as a single argument.

While editing the arguments, you will also see a row of buttons above the keyboard. These are shortcuts which can be inserted into your arguments. Shortcuts whose name ends in an ellipsis (…) have variations that you can choose from by pressing and holding on the button. A popup will appear with the variations. Just like with special characters on the keyboard, drag your finger to the variation you wish to use before lifting your finger off the screen.

The currently available shortcuts are:

ShortcutDescription
Device NameThe name of the iOS device used to trigger the action. For example, "Andy's iPhone".
DateThe current date. By default, it will format the date using the ISO 8601 combined date and time standard (20150924T08:13:11Z). Other options include Full Date (November 23, 1937), Medium Date (Nov 23, 1937), and Short Date (11/23/37). These are locale-aware and will use the date format your iOS device is configured to use.
TimeThe current time. Options include Full Time (3:30:42 PM Pacific Standard Time), Medium Time (3:30:32 PM), and Short Time (3:30 PM). These are locale-aware and will use the date format your iOS device is configured to use. Short Time is the default.