X-Callback-URL

Note: X-Callback-URL support is disabled in Entangler 2.0, but it is fixed in Entangler 2.0.1, which is now available from the App Store.

Entangler is all about making things happen. You can make things happen with a tap. You can make things happen from your Watch. And you can make things happen from certain other apps using X-Callback-Url.

Entangler exports its functionality to other apps via a simple command, which will trigger a specified action. The URL looks like this:

otto://x-callback-url/action?computer=[Computer Name]&action=[Action Name]

(The otto scheme is from Entangler’s original name, which was Otto’s Remote).

Entangler will try to find an action matching the given action name for the given computer name, and if it succeeds will fire the action. Neither the computer name nor the action name are case sensitive.

You can also pass arguments on to your action via the arguments* parameters:

otto://x-callback-url/action?computer=[Computer Name]&action=[Action Name]&argument1=[arg1]&argument2=[arg2]...

Entangler supports any number of arguments. They will be passed to your action in numeric order, regardless of what order they actually appear in in the URL. The argument numbers are not required to be contiguous.

There are also a number of shortcuts you can include in your arguments, which will be replaced by Entangler when the action is executed:

ShortcutDescription
[[device]]The name of the iOS device Entangler is running on. For example, "Andy's iPhone".
[[date:short]]The current date in a short format, such as "11/23/37". Depends on the locale settings on your iOS device.
[[date:medium]]The current date in a medium format, such as "Nov 23, 1937". Depends on the locale settings on your iOS device.
[[date:full]]The current date in a full length format, such as "Tuesday, April 12, 1952 AD". Depends on the locale settings on your iOS device.
[[date:ISO8601]]The current date in ISO-8601 combined date and time format, such as "20150924T08:13:11Z". Does not depend on the locale settings on your iOS device.
[[time:short]]The current time in a short format, such as "3:30 PM". Depends on the locale settings on your iOS device.
[[time:medium]]The current time in a medium format, such as "3:30:32 PM". Depends on the locale settings on your iOS device.
[[time:full]]The current time in a full format, such as "3:30:42 PM Pacific Standard Time". Depends on the locale settings on your iOS device.

You can also include the standard x-callback-url success and failure parameters and Entangler will open them in the appropriate case after attempting to complete the action.

It is also possible to specify the action by its UUID, which is the method used by X-Callback-URL Entanglements. In this case, the URL’s format is:

otto://x-callback-url/action?actionUUID=[Action UUID]

Unfortunately as of now the only way to determine an action’s UUID is by creating an X-Callback-URL Entanglement with it and looking at the generated URL. This shortcoming will be addressed in a future update.