Triggers

 





Triggers

Active Network Type

The trigger Active Network Type executes a flow when the active network type changes to another type.

Settings
Network type changed to
Defines for what network types the trigger should be executed
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
network_type
the network type as number (None=-1, Mobile=0, WiFi=1, WiMAX=6, Bluetooth=7, Ethernet=9)
network_type_name
the name of the network as string like WIFI or MOBILE
network_subtype
the network subtype as number
network_subtype_name
the network subtype as number
network_state
the network state (CONNECTING, CONNECTED, SUSPENDED, DISCONNECTING, DISCONNECTED, UNKNOWN)
network_detailed_state
the detailed network state (IDLE, SCANNING, CONNECTING, AUTHENTICATING, OBTAINING_IPADDR, CONNECTED, SUSPENDED, DISCONNECTING, DISCONNECTED, FAILED, BLOCKED, VERIFYING_POOR_LINK, CAPTIVE_PORTAL_CHECK)
network_extra_info
additional info as string (like SSID), when available
network_reason
the reason of a failure, when available
Top

Activity Ended

The trigger Activity Ended is executed when an activity is moved to the background.

Settings
Package Name
The package name of the app or comma separated list. Glob patterns are supported.
Class Name
The class name of the activity or comma separated list. Glob patterns are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
package_name
the name of the package
app_name
the display name of the app
activity_class
the class of the activity
activity_name
the display name of the activity
Top

Activity Started

The trigger Activity Started is executed when an activity is moved to the foreground.

 

Examples:
  • Increase the display brightness when Google Maps is started.
Settings
Method
How the activity should be determined. Method Usage statistics can be delayed on some devices.
Package Name
The package name of the app or comma separated list. Glob patterns are supported.
Class Name
The class name of the activity or comma separated list. Glob patterns are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
package_name
the name of the package
app_name
the display name of the app
activity_class
the class of the activity
activity_name
the display name of the activity
Top

Airplane Mode

The trigger Airplane Mode is executed when the airplane mode is turned on or off.

 

Example:
  • Disable all flows that are downloading data when the airplane mode is turned on.
Settings
Airplane Mode On/Off
Whether the trigger should be executed when the airplane mode is turned on or off.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Android Wear Device Connected/Disconnected

The trigger Android Wear Device is executed when an Android Wear device is connected or disconnected from the main device.

 

Examples:
  • Play an alert sound when the Wear watch is disconnected from the main device.
Settings
Android Wear device
The target device.
Device connected/disconnected
Whether the trigger should be executed when the device is connected or disconnected.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
node_id
the ID of the Wear node
Top

App Package Event

The trigger App Package Event is executed when a app/package is installed, updated or removed.

 

Examples:
  • Write the date and time of an app update to a log file for reference
Settings
Event
The event type:
  • Added: A new package has been installed
  • Changed: A component of a package has been enabled/disabled
  • Data cleared: The data of the app has been cleared
  • Replaced: A package has been updated
  • Restarted: A package has been restarted and all processes of the package have been killed
  • Removed: A package was removed or is in the process of being updated
  • Fully removed: A package has been uninstalled (and data deleted) (Android 4)
Package Name
The list of package names to check. Glob patterns are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
package_name
the name of the package
app_name
the display name of the app
uid
the UID assigned to the package
replacing
true when the package is updated (only set for event Added and Removed)
changed_component_name_list
the list of changed components (only set for event Changed)
dont_kill_app
true when the app should not be killed (only set for event Changed)
data_removed
true when also the data has been removed (only set for event Removed)
Top

App Task Ended

The trigger App Task Ended is executed when an application is moved to the background or closed respectively the user moved the focus to another app.
The application might still be running in the background or the process hosting the application might still be in memory.

 

Examples:
  • Raise the media volume back to normal when you leave the browser
  • Change the display brightness back to normal when you don't use Google Maps anymore
Settings
Method
How the app should be determined. Method Usage statistics can be delayed on some devices.
Package Name
Enter the name of the package of the application or use the button to show a list of available applications. Glob patterns (*, ?) can be used to match apps with similar names. A single *-character matches all apps.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
package_name
the name of the package
app_name
the display name of the app
Top

App Task Started

The trigger App Task Started is executed when an application is moved to the foreground or opened respectively the user moved the focus to this app.

 

Examples:
  • Lower the media volume when you open the browser
  • Raise the display brightness when you start using Google Maps
Settings
Method
How the app should be determined. Method Usage statistics can be delayed on some devices.
Package Name
Enter the name of the package of the application or use the button to show a list of available applications. Glob patterns (*, ?) can be used to match apps with similar names. A single *-character matches all apps.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
package_name
the name of the package
app_name
the display name of the app
Top

Assist

The trigger Assist is executed when the home button is long-pressed or dragged upwards (Galaxy Nexus) or the home button is long-pressed and the middle icon is selected (S3).

Warning: This function requires Android 4.1+ and is not officially supported by Android.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Audio Volume

The trigger Audio Volume is executed when the volume of the device has been changed. Some devices report the volume change slightly delayed.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Vibrate whenever the volume is changed
Settings
Sound Type
The type of the audio stream to check.
Condition
Whether the condition should check if the volume is above or below the volume level.
Volume
The volume value to check.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Auto Sync State

The trigger Auto Sync State is executed when the auto sync setting is changed to on or off.

 

Examples:
  • Turn an hourly executed download flow off when auto sync is disabled.
Settings
Auto Sync
On
Execute the flow when the auto sync has been turned on.

Off
Execute the flow when the auto sync has been turned off.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Automagic Notification Selected

The trigger Automagic Notification Selected executes a flow when the Automagic-wand notification available in the statusbar is selected.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Automagic SMS Delivery Report Received

The trigger Automagic SMS Delivery Report Received is executed when an asynchronous delivery report was received.

Note: Multiple delivery reports can be received per SMS, for example a status 48 (delivery pending) and later status 0 (OK) when the SMS was delivered.

 

Examples:
  • Send an SMS one more time when the delivery report indicates an error
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
sms_receiver
the original receiver of the SMS
sms_text
the original text of the SMS
sms_delivery_report_status
the status code (0-31=OK, 32-63=delivery pending, >64=error)
Top

Automagic Startup

The trigger Automagic Startup is executed when the Automagic service is completely started and the flows have been loaded.

 

Examples:
  • Initialise global variables to default values when Automagic started.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Battery Level

The trigger Battery Level is executed whenever the battery level changes and the built in condition about the level holds true.

 

Examples:
  • Lower the display brightness when the battery level falls below 50%
  • Turn off WiFi when the battery level falls below 30%
Settings
Battery Level
Defines the condition that must be met to execute the flow:

becomes lower than
Executes the flow when the last reported percentage was above the defined level and the current percentage is below the defined level

becomes higher than
Executes the flow when the last reported percentage was below the defined level and the current percentage is above the defined level

becomes equal to
Executes the flow when the last reported percentage was different than the defined level and the current percentage equals the defined level

becomes full
Executes the flow when the last reported battery status was not full and is now full

lower than
Executes the flow whenever the reported percentage by the system is below the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last percentage has been the same.

higher than
Executes the flow whenever the reported percentage by the system is above the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last percentage has been the same.

exactly
Executes the flow whenever the reported percentage by the system is exactly on the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last percentage has been the same.

full
Executes the flow whenever the reported battery status by the system is full. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last status has been already full.
Level Percentage
Defines the level percentage.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
battery_level
the charging level of the battery
battery_percentage
the charging percentage
battery_plugged
whether the battery is plugged (1=AC adapter, 2=USB, 4=Wireless) or not (0=not plugged)
battery_present
whether the battery is present or not
battery_scale
the maximum battery level
battery_status
the status of the battery (1=unknown, 2=charging, 3=discharging, 4=not charging, 5=full)
battery_technology
the technology of the battery
battery_temperature
the temperature of the battery (in tenths of degree Celsius)
battery_voltage
the current battery voltage
battery_health
the health of the battery (1=unknown, 2=good, 3=overheat, 4=dead, 5=over voltage, 6=unspecified failure, 7=cold)
battery_charge_counter (Android 5+)
Battery capacity in microampere-hours. null when not available
battery_current_now (Android 5+)
Instantaneous battery current in microamperes (positive values=charging, negative values=discharging). null when not available
battery_current_average (Android 5+)
Average battery current in microamperes (positive values=charging, negative values=discharging). null when not available
battery_energy_counter (Android 5+)
Battery remaining energy in nanowatt-hours. null when not available
Top

Battery Level (Android Wear)

The trigger Battery Level (Android Wear) is executed whenever the battery level changes and the built in condition about the level holds true.

 

Examples:
  • Lower the display brightness when the battery level falls below 50%
  • Turn off WiFi when the battery level falls below 30%
Settings
Android Wear device
The target device.
Battery Level
Defines the condition that must be met to execute the flow:

becomes lower than
Executes the flow when the last reported percentage was above the defined level and the current percentage is below the defined level

becomes higher than
Executes the flow when the last reported percentage was below the defined level and the current percentage is above the defined level

becomes equal to
Executes the flow when the last reported percentage was different than the defined level and the current percentage equals the defined level

becomes full
Executes the flow when the last reported battery status was not full and is now full

lower than
Executes the flow whenever the reported percentage by the system is below the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last percentage has been the same.

higher than
Executes the flow whenever the reported percentage by the system is above the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last percentage has been the same.

exactly
Executes the flow whenever the reported percentage by the system is exactly on the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last percentage has been the same.

full
Executes the flow whenever the reported battery status by the system is full. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last status has been already full.
Level Percentage
Defines the level percentage.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
battery_level
the charging level of the battery
battery_percentage
the charging percentage
battery_plugged
whether the battery is plugged (1=AC adapter, 2=USB, 4=Wireless) or not (0=not plugged)
battery_present
whether the battery is present or not
battery_scale
the maximum battery level
battery_status
the status of the battery (1=unknown, 2=charging, 3=discharging, 4=not charging, 5=full)
battery_technology
the technology of the battery
battery_temperature
the temperature of the battery (in tenths of degree Celsius)
battery_voltage
the current battery voltage
battery_health
the health of the battery (1=unknown, 2=good, 3=overheat, 4=dead, 5=over voltage, 6=unspecified failure, 7=cold)
node_id
the ID of the Wear node
Top

Battery Low Condition

The trigger Battery Low Condition is executed when the battery level becomes low or when the battery level becomes OK again after it was low.

 

Examples:
  • Lower the display brightness when the battery level becomes low
  • Turn off WiFi when the battery level becomes low
  • Turn on WiFi when the battery level becomes OK again
Settings
Battery Condition
low
The battery level becomes low (the exact value can differ between different devices).

OK
The battery level becomes OK again (the exact value can differ between different devices).

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Battery Saver Mode

The trigger Battery Saver Mode is executed when the battery saving mode of the device is changed (Android 5+).
Warning: This function does not work for manufacturer specific battery saving modes like Samsungs (Ultra-)energy saving mode or Sony and HTC specific modes. Please use action System Setting Changed on such devices.

 

Examples:
  • Turn off a few flows when the battery saver is activated.
Settings
Turned On or Off
Whether to execute the flow when the mode was turned on or off.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Bluetooth Device Connected

The trigger Bluetooth Device Connected is executed when a bluetooth device is connected.

 

Examples:
  • Turn down the volume when a bluetooth headset is connected
Settings
Bluetooth Device
Defines whether the trigger should be executed for all devices or only for a specific device.
Bluetooth Device Address
The address of the bluetooth device.
Bluetooth Device Name
The name of the bluetooth device.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
name
the name of the device
address
the address of the device
bluetooth_class
the bluetooth class of the device
bond_state
the bonding state of the device
Top

Bluetooth Device Disconnected

The trigger Bluetooth Device Disconnected is executed when a bluetooth device is disconnected.

 

Examples:
  • Turn up the volume when a bluetooth headset is disconnected
Settings
Bluetooth Device
Defines whether the trigger should be executed for all devices or only for a specific device.
Bluetooth Device Address
The address of the bluetooth device.
Bluetooth Device Name
The name of the bluetooth device.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
name
the name of the device
address
the address of the device
bluetooth_class
the bluetooth class of the device
bond_state
the bonding state of the device
Top

Bluetooth State

The trigger Bluetooth State is executed when the bluetooth adapter of the device is turned on or off depending on the settings used.

 

Examples:
  • Enable some flows using the bluetooth adapter as soon as the bluetooth is turned on.
Settings
Bluetooth state
Defines the bluetooth states to trigger the flow. Selecting multiple states triggers the flow once for each state.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
previous_bluetooth_state
the state of the bluetooth adapter before
bluetooth_state
the current state of the bluetooth adapter
Top

Calendar

The trigger Calendar is executed on the defined date and time.

 

Examples:
  • Send a reminder mail on the last Friday of each month
  • Export and mail your time tracking data on the first Monday of each month
Note: You can use the trigger Time to execute a flow on every weekday or on every Monday.
Settings
Date/Time
Defines the date and time when the flow should be executed or the first time a flow should be executed when this is a repeating trigger.
Repeats
Defines when this trigger should repeat.
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Calendar Event

The trigger Calendar Event is executed when an event on the calendar starts or ends.

 

Examples:
  • Mute the ringer when a meeting starts
  • Vibrate 5 minutes before a meeting starts
  • Start recording a task in Gleeo Time Tracker when a meeting starts
Settings
Trigger at Event Start
Whether the trigger should execute at the start of the event. The duration specifies whether the trigger should execute a certain amount of time before or after the event begins.
Trigger at Event End
Whether the trigger should execute at the end of the event. The duration specifies whether the trigger should execute a certain amount of time before or after the event ends.
Calendars
A comma separated list of calendar names that should be checked for events. The names can contain glob pattern characters like * and ?.
Titles
A comma separated list of event titles to match. The titles can contain glob pattern characters like * and ?.

Examples:
  • Plan* matches titles like Planning, Plan B etc.
Descriptions
A comma separated list of event descriptions to match. The descriptions can contain glob pattern characters like * and ?.
Locations
A comma separated list of event locations to match. The locations can contain glob pattern characters like * and ?.
Event Type
Whether the trigger should consider all day events or regular events (not all day) or both.
Event Availability
Whether the trigger should consider events marked as free, busy or tentative.
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
event_calendar
the name of the calendar of the event
event_title
the title of the event
event_description
the description of the event
event_location
the location of the event
event_start
the start time of the event
event_end
the end time of the event
event_all_day
boolean indicating if the event is all day or not
event_availability
FREE, BUSY or TENTATIVE depending on the availability of the event
event_id
the ID of the event
Top

Car UI Mode

The trigger Car UI Mode is executed when the device is put into car UI mode when placed in a car dock.

 

Examples:
  • Raise the audio volume when the device is put into the car dock.
Settings
Enter or Exit car UI mode
Enter
When selected executes the flow when the device is put into car UI mode.

Exit
When selected executes the flow when the car UI mode has been ended.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Clipboard Changed

The trigger Clipboard Changed is executed when the content of the clipboard changes.
Use the action Copy Text from Clipboard to access the content of the clipboard.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
clip_data
the text of the clipboard
Top

Command Output

The trigger Command Output is executed when a command prints a line containing a specific text.

Settings
Command
The command to execute. The command is passed to /bin/sh to be interpreted or to su when as root is checked.
SE Context
The SE context to use to execute the command. This setting is often required when using Android 5+ or any other device that set SELinux to enforcing. Requires su that allows to switch SE context (like SuperSU v1.97+).
Working Directory
The path the command is executed in.
Output trigger condition
The text which needs to be contained in the output to trigger.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
stdout
the last 10 lines written to stdout
stderr
the last 10 lines written to stderr
output
the triggering line
output_type
the string stdout when the triggering line was written to stdout, stderr otherwise
Top

Compass

The trigger Compass executes the flow when the device changes its orientation.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

 

Examples:
  • Play a beep sound when the device is heading north.
Settings
Type
The type of the trigger.

  • Periodic: executes the flow in periodic time intervals
  • On Change: executes the flow when the orientation changed for at least some degrees.
  • On Relative Sector Change: Remembers the device orientation when this trigger is enabled first, divides the orientation into the specified number of equal sectors and executes the flow whenever the device stays in a different sector.
Frequency
Defines the frequency between flow executions.
Tolerance in Degrees
The minimum amount of change in the device orientation required to execute the flow.
trigger when steady
Executes the flow only when the device does not change the direction for a short period of time anymore.
Number of Sectors
The number of equal sectors to divide the orientation of the device. The sectors are numbered starting at 1 and incrementing in clockwise order.

Example:
When 4 sectors are desired the 360° possible degrees are divided into 4 sectors with an opening angle of 90° each. The sectors are relative to the initial device orientation when the trigger was enabled.
  • Sector 1: 315° to 45°
  • Sector 2: 45° to 135°
  • Sector 3: 135° to 225°
  • Sector 4: 225° to 315°
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
azimuth
the azimuth in degrees
pitch
the pitch in degrees
roll
the roll in degrees
azimuth_sector (On Relative Sector Change only)
the azimuth sector (1 to Number of Sectors)
pitch_sector (On Relative Sector Change only)
the pitch sector (1 to Number of Sectors)
roll_sector (On Relative Sector Change only)
the roll sector (1 to Number of Sectors)
Top

Content Provider Changed

The trigger Content Provider Changed is executed whenever the content provider was changed for the specified URI. Note that not all content providers support this feature.

 

Examples:
  • Get notified whenever the MMS database changes to you can check if there's a new message.
Settings
Content URI
The URI to get changes for (including ancestors).
Notify for descendants
Whether changes in descendant URIs should also be detected.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
content_uri
the actual URI for the change
Top

CyanogenMod Quick Settings Tile Selected

The trigger CyanogenMod Quick Settings Tile Selected creates a quick settings tile and is executed when the tile is selected/clicked.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Create a QS tile to send an SMS with the current location.
Settings
Label
Icon
Collapse panel
Whether or not the quick settings area should be closed when the tile is selected/clicked.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Daydream State

The trigger Daydream State is executed when the daydream of the system starts or stops.

 

Settings
Daydream Started/Stopped
Whether to trigger on the daydream start or the stop.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Desk UI Mode

The trigger Desk UI Mode is executed when the device is put into desk UI mode when placed in a desk dock.

 

Examples:
  • Raise the audio volume when the device is put into the desk dock.
Settings
Enter or Exit desk UI mode
Enter
When selected executes the flow when the device is put into desk UI mode.

Exit
When selected executes the flow when the desk UI mode has been ended.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Device Idle/Doze Mode

The trigger Device Idle/Doze Mode is executed when the device falls into idle/doze mode or is woken up from this mode.

 

Examples:
  • Deactivate some less important flows when the device enters idle/doze mode.
Settings
Turned On or Off
Whether the trigger should be executed when the idle/doze mode is turned on or off.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Device Orientation

The trigger Device Orientation executes the flow when the device is moved to the defined orientation.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

 

Examples:
  • Reduce the ringer volume when the device screen is facing down.
Settings
Device Orientation
The desired orientation of the device.

  • Face down: The display of the device is facing down for example when lying on a table with the display towards the table.
  • Face up: The display of the device is facing up for example when lying on a table with the display facing away from the table.
  • Face left: The display faces to the left with the longer side lying on a table when the upper edge of the device is pointing away from you.
  • Face right: The display faces to the right with the longer side lying on a table when the upper edge of the device is pointing away from you.
  • Standing upright: The device is standing upright on a table.
  • Standing upside-down: The device is standing upside-down on a table.
Negate
Whether the condition should be negated or not.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Device Storage Space Low

The trigger Device Storage Space Low executes the flow when the internal device storage space becomes low or the free storage space is back to a normal level.

Note: The amount of free space to consider as low is defined by the device manufacturer.
Standard Android considers less than 10% of free internal memory as low.

Example:
  • Play a warning sound when the device storage space is low.
Settings
Device Storage Space
becomes low
Executes the flow when the storage space becomes low.

becomes OK
Executes the flow when the storage space is back to a normal level.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Display State

The trigger Display State is executed when the display is turned on or off.

 

Examples:
  • Turn on WiFi when you turn the display on. Turn WiFi off when you turn the display off.
  • Count how many times a day you turn your display on.
  • Remind you with a sound alert when you are recording your time and you are starting to use the device.
Settings
Display On/Off
On
Execute the flow when the display has been turned on.

Off
Execute the flow when the display has been turned off.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Dock Event

The trigger Dock Event is executed when the device is put into a dock (car, desk, some external hardware keyboard).

The dock type can be distinguished using a condition Dock State.

 

Examples:
  • Raise the audio volume when the device is put into a dock.
Settings
Docked/Undocked
Docked
When selected executes the flow after the device has been put into a dock.

Undocked
When selected executes the flow after the device has been removed from a dock.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
dock_state
the state/dock type
Top

File Observer

The trigger File Observer is executed when a path of interest on the filesystem is accessed or changed.

 

Examples:
  • Create a copy of a file after it has been modified.
  • Upload a new image to Dropbox when a new subfile is created in folder /sdcard/DCIM/Camera/.
Settings
Paths to Observe
A comma separated list of files or directories to observe. Variables are supported (replaced when trigger is activated).
Event Types
The type of events to observe.
  • File accessed: Data was read from a file
  • Modify: Data was written to a file
  • Metadata changed: Metadata (permissions, owner, timestamp) was changed explicitly
  • Writable file closed: Someone had a file or directory open for writing, and closed it
  • Unwritable file closed: Someone had a file or directory open read-only, and closed it
  • File opened: A file or directory was opened
  • File moved from: A file or subdirectory was moved from the monitored directory
  • File moved to: A file or subdirectory was moved to the monitored directory
  • Subfile created: A new file or subdirectory was created under the monitored directory
  • Subfile deleted: A file was deleted from the monitored directory
  • Delete Self: The monitored file or directory was deleted; monitoring effectively stops
  • Self moved: The monitored file or directory was moved; monitoring continues
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
registered_path
the path of the observed file or directory
event
the event represented as a number:
  • File accessed: 1 (0x00000001)
  • Modify: 2 (0x00000002)
  • Metadata changed: 4 (0x00000004)
  • Writable file closed: 8 (0x00000008)
  • Unwritable file closed: 16 (0x00000010)
  • File opened: 32 (0x00000020)
  • File moved from: 64 (0x00000040)
  • File moved to: 128 (0x00000080)
  • Subfile created: 256 (0x00000100)
  • Subfile deleted: 512 (0x00000200)
  • Delete Self: 1024 (0x00000400)
  • Self moved: 2048 (0x00000800)
path
the path of the file or directory which triggered the event, relative to the main monitored file or directory
Top

General Broadcast

The trigger General Broadcast dynamically registers a broadcast receiver at runtime with the specified intent filter.
Please also see the Android Developer Documentation.

 

Examples:
  • Receive the current WiFi signal strength (only when the display is turned on):
    Action: android.net.wifi.RSSI_CHANGED
    Access Intent Extras: value=getInt("newRssi", 0);
  • Receive a message from NMA (https://www.notifymyandroid.com/):
    Action: com.usk.app.notifymyandroid.NEW_NOTIFICATION
    Access Intent Extras:
    app=getString("app");
    event=getString("event");
    desc=getString("desc");
    prio=getInt("prio", 0);
    url=getString("url");
Settings
Action
The action to use in the intent filter.
Category List
The list of categories to use in the intent filter.
Data Scheme List
The list of data schemes to use in the intent filter. (like http, content etc.).
Data Authority List
The list of data authorities to use in the intent filter (host:port).
Data Path Literal List
The list of data paths to use in the intent filter (the specified pattern has to match the entire path)
Data Path Prefix List
The list of data paths to use in the intent filter (the specified pattern has to match the prefix of the path)
Data Path Glob List
The list of data paths to use in the intent filter (the specified glob pattern has to match the entire path)
Data Type List
The list of MIME types to use in the intent filter.
Access Intent Extras
Script to access the extras in the received intent.
Following functions are supported:
  • getString(String key)
  • getChar(String key, String defaultValue)
  • getBoolean(String key, Boolean defaultValue)
  • getFloat(String key, Number defaultValue)
  • getDouble(String key, Number defaultValue)
  • getByte(String key, Number defaultValue)
  • getShort(String key, Number defaultValue)
  • getInt(String key, Number defaultValue)
  • getLong(String key, Number defaultValue)
  • getBundle(String key)
  • getUri(String key)
  • getBooleanArray(String key)
  • getByteArray(String key)
  • getShortArray(String key)
  • getCharArray(String key)
  • getIntArray(String key)
  • getIntegerArrayList(String key)
  • getLongArray(String key)
  • getFloatArray(String key)
  • getDoubleArray(String key)
  • getStringArray(String key)
  • getUriArray(String key)
  • getUriArrayList(String key)
  • getParcelableAsString(String key)
  • getParcelableArrayAsString(String key)
  • getParcelableArrayListAsString(String key)

Examples:
    value = getString("key1");
    value = getBoolean("key2", true);
    value = getDouble("key3", 1.23);
    value = getInt("key4", 42);
    value = getInt("key5", a+4*b);
        
Data of intents wrapped in a Bundle-extra can be accessed using function getBundle(String name).
Values contained in a bundle can be accessed with the functions used to accessed regular extras but by additionally specifying the bundle.

Example:
    bundle = getBundle("key1");
    value = getString(bundle, "key2");
        
compact form:
    value = getString(getBundle("key1"), "key2");
        
Example to access the track info of PowerAMP:
    track_info = getBundle("track");

    artist = getString(track_info, "artist");
    album = getString(track_info, "album");
    title = getString(track_info, "title");
    path = getString(track_info, "path");
    duration = getInt(track_info, "dur", 0);
        
Initial Sticky Broadcast
Whether to ignore the initial broadcast sent for a sticky broadcast or not.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
action
the action of the received intent
data_string
the data of the received intent as a string
categories
the list of categories
scheme
the scheme of the received intent
type
the explicitly set MIME type of the received intent
Top

Gleeo Recording Started

The trigger Gleeo Recording Started is executed when a task in Gleeo Time Tracker has been started.

Settings
Domain Filter List
A comma separated list of the domains to accept.
Project Filter List
A comma separated list of the projects to accept.
Task Filter List
A comma separated list of the tasks to accept.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
domain_name
contains the name of the domain
project_title
contains the title of the project
task_name
contains the name of the task
start
contains the start date and time of the recording entry
Top

Gleeo Recording Stopped

The trigger Gleeo Recording Stopped is executed when a task in Gleeo Time Tracker has been stopped.

Settings
Domain Filter List
A comma separated list of the domains to accept.
Project Filter List
A comma separated list of the projects to accept.
Task Filter List
A comma separated list of the tasks to accept.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
domain_name
contains the name of the domain
project_title
contains the title of the project
task_name
contains the name of the task
start
contains the start date and time of the entry
end
contains the end date and time of the entry
Top

Global Variable

The trigger Global Variable is executed when a different value is assigned to a global variable. The trigger is not executed when the same value is assigned to the variable again.

 

Examples:
  • Show a reminder when you sent more than 10 SMS in one day
Settings
Global Variable
The name of the global variable to watch.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
old_name_of_the_global_variable
contains the old value of the global variable before it has been updated
Top

Global Variable Date/Time

The trigger Global Variable Date/Time is executed when the point of time stored in the global variable is reached.

 

Examples:
  • Execute a flow daily on sunrise/sunset
  • Execute a flow in irregular intervals
Settings
Global Variable
The name of the global variable containing the point of time.
Trigger immediately on missed events
Execute the trigger when the point in time stored in the variable has passed and the trigger did not yet execute the trigger for this point in time (for example when the device was turned off at the date/time specified in the variable or when a past date is assigned to the global variable)
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Gmail Unread Conversation Count

The trigger Gmail Unread Conversation Count is executed when the count of unread conversations in the Gmail app on the device changes.

 

Examples:
  • Play a notification sound, when more unread conversations are available
Settings
Accounts
The accounts to check. The sum of unread conversations is checked when multiple accounts are specified.
Increasing Unread Count
When checked only executes the trigger when the unread conversation count increases.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
count
the number of unread conversations
old_count
the number of unread conversations before
Top

GPS Status Event

The trigger GPS Status Event is executed, when the system start or stops to use GPS.

 

Examples:
  • Vibrate when the system begins to use GPS for information purposes
Settings
GPS Status Event
The type of the event:
  • Started: executes the trigger when the system starts to use GPS
  • Stopped: executes the trigger when the system stops to use GPS
  • First fix received: executes the trigger when the system uses GPS and the first fix has just been determined
  • Satellite status changed: executes the trigger when the satellite status changes (usually very frequent)
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
gps_event_type
typ of the event (1=started, 2=stopped, 3=first fix, 4=satellite status)
satellites
list containing strings each containing the information of one satellite
time_to_first_fix
number of milliseconds between turning on GPS and receiving the first fix, contains 0 or the last value when no fix was determined yet
Top

Hardware Keyboard State

The trigger Hardware Keyboard State is executed when the hardware keyboard is opened or closed.

 

Examples:
  • Vibrate when the hardware keyboard is opened.
Settings
Opened or Closed
Whether the trigger should be executed when the keyboard is opened or closed.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
keyboard_type
the type of keyboard (1=unavailable, 2=QWERTY, 3=12-keys)
Top

Hardware Keyboard Type

The trigger Hardware Keyboard Type is executed when the type of hardware keyboard changes to one of the selected types.

 

Examples:
  • Increase the display timeout when a hardware keyboard is connected.
Settings
Keyboard type changed to
The type of keyboard.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
keyboard_type
the type of keyboard (1=unavailable, 2=QWERTY, 3=12-keys)
Top

HTTP Request (Experimental)

The trigger HTTP Request (Experimental) is executed when a HTTP request is received using the specified path and port.

Note: The built-in webserver is neither fast nor should you try to upload large files. Please don't use it to run webshops, corporate websites or sites like Slashdot on your phone.

 

Examples:
  • Send an SMS from your Phone using your PC when the URL http://192.168.1.XX:8080/sms?receiver=12345&text=test is requested
  • Return a page with the list of files on the SD card when the URL http://192.168.1.XX:8080/files/xyz is requested
Settings
Path
The path to handle by this trigger. Glob patterns (*, ?) are supported.
Examples:
  • /automagic/test
  • /automagic/files/* to handle all paths that start with /automagic/files/
The trigger with the longest path is preferred when multiple triggers match requested path since only one response can be written.
Examples: The first trigger is preferred when two triggers with paths /automagic/test and /automagic/* are available.
Port
The port of the server.
Keep WiFi awake
Whether to keep the WiFi radio awake, otherwise the WiFi radio might turn off to save battery and a connection to your device is no longer possible.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
remote_host
the name or IP of the remote host
remote_port
the port of the remote host
request_path
the decoded path of the request (e.g. /automagic/test)
method
the HTTP method (e.g. GET, POST, PUT)
header_*
All values of the headers. The name of the variable is built using the prefix header_ and the name of the header by replacing dash with underscore and converting the name to lowercase.
Examples:
  • Header Accept is stored in variable header_accept
  • Header Accept-Encoding is stored in variable header_accept_encoding
Headers leading to an invalid variable name are ignored.
param_*
All values of the request parameters. The name of the variable is built using the prefix param_ and the name of the parameter by converting the name to lowercase.
Example:
  • Parameter test is stored in variable param_test
Parameters leading to an invalid variable name are ignored.
file_*
All paths of the uploaded files. The name of the variable is built using the prefix file_ and the name of the parameter by converting the name to lowercase.
Example:
  • Parameter File is stored in a variable file_file
Parameters leading to an invalid variable name are ignored.
Top

Incoming Call

The trigger Incoming Call is executed when a call is received depending on the criteria defined in the options.

 

Examples:
  • Start recording in Gleeo Time Tracker when your employer calls.
  • Send a mail containing the callers number and time to your mail account.
Settings
Incoming callnumbers
The list of callnumbers when the flow should be executed. Multiple numbers can be separated by comma.
Glob patterns (*, ?) can be used to filter on similar numbers like corporate number ranges:

Examples:
  • +17001111111
  • +17001111111,+17002222222
  • *70033311*
  • *70033311*,*70033?22*
Special characters like +, - and . are removed before comparing the number.

Warning: The formatting of the incoming number depends on the operator in use. Some operators format the number as an international callnumber like +17001111111, local fixed line network numbers often use the local format.
You have to check the log file to see the exact formatting used or you can add an action Notification on Screen with text {incoming_number} to see the actual number.
Phone state
Defines the state of the call to trigger the flow. Selecting multiple states triggers the flow once for each state.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
incoming_number
the number of the calling party or null when suppressed
call_state
the state of the call (IDLE, RINGING, OFFHOOK)
call_missed_rejected
true or false whether or not the call has been missed or rejected when the phone enters the idle state
contact_name
the name of the contact if available
contact_company
the company of the contact if available
contact_title
the title of the contact if available
contact_note
the note of the contact if available
contact_nickname
the nickname of the contact if available
contact_email
an email address of the contact if available
contact_groups
the list of groups of the contact if available
Top

Interruptions Mode

The trigger Interruptions Mode is executed when the device switches to the desired interruption mode.

 

Examples:
  • Disable some flows when no interruptions are allowed.
Settings
Interruptions Mode
The desired interruption mode.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

K-9 Mail Received

The trigger K-9 Mail Received is executed when K-9 Mail receives a mail.

 

Examples:
  • Play an alert sound when you receive a mail from the boss.
Settings
K9 Account List
The comma separated list of accounts to consider (case insensitive). Glob patterns (*, ?) are supported.
Sender List
The comma separated list of sender mail addresses to consider (case insensitive). Glob patterns (*, ?) are supported.
Subject List
The comma separated list of subjects to consider (case insensitive). Glob patterns (*, ?) are supported.
Receiver List
The comma separated list of receiver mail addresses to consider (case insensitive). Glob patterns (*, ?) are supported.
CC List
The comma separated list of CC-mail addresses to consider (case insensitive). Glob patterns (*, ?) are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
k9_account
the K-9 Mail account of the mail
k9_folder
the K-9 folder of the mail
k9_to
the recipients of the mail
k9_from
the sender of the mail
k9_from_self
whether or not the mail was sent by yourself (only set on newer versions of K-9)
k9_subject
the subject of the mail
k9_sent_date
the date the mail has been sent
k9_cc
the cc of the mail
k9_bcc
the bcc of the mail
Top

Light Sensor

The trigger Light Sensor is executed when the measured surrounding light intensity passes the defined value.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

Settings
Sensitivity
The sensitivity of the slider to define the light level.
Light Level
Whether the trigger should execute when the illuminance passes above or below a certain value and the level to use.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
light_level
the effective illuminance in lux
Top

Locale Adjusted

The trigger Locale Adjusted is executed when the locale has been changed in the system.

 

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
locale
the new locale
Top

Location

The trigger Location is executed when the location is entering the defined region or exiting the defined region.
The accuracy of the location depends heavily on the available location provider.

Tip: Enabling GPS in the phone settings can yield much better location accuracy but might use more battery. Locations with WiFi access points might work accurate enough and GPS can be disabled in the global phone settings to reduce battery strain.

 

Examples:
  • Start recording in Gleeo Time Tracker when you are in the office, stop recording when you leave.
  • Switch the ringer to vibrate when you are at your office.
  • Turn off the ringer in the church. (Do it manually when it is important!)
  • Send an SMS when you are home.

Note: The location is usually checked every 4 minutes when the device is not actively used and the classic method is used. This can result in the GPS icon on the statusbar being visible every 4 minutes. Entering/exiting a location can be missed when you are moving fast through a location with a small radius and the 4 minute check misses the location. Locations can be reported more often when the device is active or another application also uses the location features (for example when using Google Maps).

Settings
Method
The method used to detect the geofence.
Modern uses the new geofence API provided by Google and should be tuned to use only a minimum amount of battery power.
The algorithms to detect the locations are not known and can vary depending on device model. Please experiment with both methods to see what works best for you.
Location
The location used by this trigger.
Location Name
The name to use for this location. This name is used in the trigger name and to select an existing location on the map.
Radius
The radius around the location in meters.
Entering/Exiting
Whether to execute the flow when the location within the defined radius is entered or exited.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
location
the configured location
location_name
the name of the location
entering
whether the location has been entered or not
Top

Location Provider State

The trigger Location Provider State is executed when a location provider (GPS or Network) is enabled or disabled.

 

Examples:
  • Deactivate a flow that uses GPS when GPS is turned off.
Settings
Location Provider
The location provider to monitor (GPS or Network)
Enabled/Disabled
Whether to trigger when the provider was enabled or disabled.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Login Attempt

The trigger Login Attempt is executed, whenever someone unsuccessfully tries to login to the device respectively tries to unlock the device.

 

Examples:
  • Take a picture with the front camera when someone enters the wrong PIN code three times.
Settings
Failed/Successful after failed
  • Failed: executes the trigger when the login attempt fails
  • Successful after failed: executes the trigger when the login attempt was successful after it failed one or multiple times before
When
  • On every failed attempt: executes once for every failed attempt
  • On the Nth failed attempt: executes the trigger exactly once when the number of failed login attempts reach the specified amount of times
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
failed_login_attempt
the number of failed login attempts
Top

Magnetic Field Sensor

The trigger Magnetic Field Sensor is executed when the measured magnetic field strength passes the defined value.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

 

Examples:
  • Execute a flow when the device is placed near a magnet.
Settings
Sensitivity
The sensitivity of the slider to define the light level.
Magnetic Field Strength
Whether the trigger should execute when the illuminance passes above or below a certain value and the level to use.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
magnetic_field_strength
the measured strength in micro Tesla
Top

Media Button Event (Experimental)

The trigger Media Button Event (Experimental) executes a flow when the system detects a media button event, for example when the play-button is pressed on a headset.

Warning: When an audio player is launched, future events are usually sent to the audio player and not to Automagic anymore. If this is not the desired behaviour, Automagic has to be registered to receive the events again using an action Reregister Media Button Receiver.

Settings
Events
Whether the trigger should be executed for all media button events or only for a specific button.
Specific event
The Event/Button that should be reacted upon.
Wired headsets usually generate the event Headset Hook.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
key_code
the numeric keycode
key_code_name (Android 3.1+)
the name of the keycode
key_duration
the duration of the event in milliseconds
key_source_device_id
the ID of the sending device
Top

Media Session Changed (Experimental)

The trigger Media Session Changed (Experimental) is executed when the media session of the specified player changes (new track is played, media image is loaded etc.). A regular change in position alone does not invoke the trigger.

 

Examples:
  • Show the title of the current track in an overlay widget.
Settings
Package Names
The name of the media player to monitor. Glob patterns (*, ?) are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
playback_state
current state (0=none, 1=stopped, 2=paused, 3=playing, 4=fast forwarding, 5=rewinding, 6=buffering, 7=error, 8=connecting, 9=skip to previous, 10=skip to next, 11=skip to item in queue)
playback_position
current position in ms
title
the title
subtitle
the subtitle
description
the description
icon
the current image
icon_uri
the URI to load the image
media_duration
duration of the track in ms
Top

Mobile Datanetwork Type

The trigger Mobile Datanetwork Type is executed when the network type switches to one selected in the list.

 

Examples:
  • Play an alert sound when the network switches to GPRS
Settings
Network Type
The network types to execute the trigger.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
previous_mobile_network_type
the type of the network before
mobile_network_type
the type of the network (0=Unknown, 1=GPRS, 2=EDGE, 3=UMTS, 4=CDMA, 5=CDMA - EvDo rev. 0, 6=CDMA - EvDo rev. A, 7=CDMA - 1xRTT, 8=HSDPA, 9=HSUPA, 10=HSPA, 11=iDEN, 12=CDMA - EvDo rev. B, 13=LTE, 14=CDMA - eHRPD, 15=HSPA+)
Top

Next Alarm

The trigger Next Alarm is executed when the next alarm set in the Android alarm app is reached.

Warning: This function is not officially supported by Android < 5.0 and might not work on all devices.

 

Examples:
  • Start the coffee machine when you are woken up in the morning.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

NFC State

The trigger NFC State is executed when the NFC adapter of the device is turned on or off depending on the settings used.

Settings
NFC state
Defines the NFC states to trigger the flow. Selecting multiple states triggers the flow once for each state.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
nfc_state
the current state of the NFC adapter
Top

NFC Tag

The trigger NFC Tag executes the flow when an NFC tag is detected.
You can either write a special ID to the NFC tag that will be used to identify the tag and execute the flow (this is the recommended option to use when you have a writable NFC tag) or you can also read the ID of an existing NFC tag. This is especially useful for read-only NFC tags like the ones often found in credit cards or read-only NFC tags (Live Tags, Smart Tags etc.) of some device manufacturers. Please also check the Tip in the settings section of this page.

Note: Not all NFC tags are supported.

 

Examples:
  • Turn on the airplane mode when an NFC tag in the bedroom is scanned
Settings
Tag Type
Whether an NFC tag is written using a specific ID defined in Automagic (recommended) or an existing NFC tag should be used (does not work with all tags, some devices show an app selection list when other apps are installed that also handle NFC tags).
Tag IDs
A comma separated list of tag IDs. Glob patterns can be used to match multiple tag IDs.
Write ID to NFC tag
Opens a screen to write the specified IDs to an NFC tag. The NFC tag must be writable and must be able to contain NDEF formatted data.
Multiple IDs can be written to the tag but the tag IDs must contain only regular characters, underscore and numbers.

Option Write alternate tag information on the writer screen allows to define whether or not different type of information should be written to the NFC tag. Some devices show a warning dialog when a regular Automagic NFC tag is scanned since the tag contains a Web-URL. Writing an alternate tag uses a different URL that avoids this warning message.

Android 4+: Option Include Android Application Record on the writer screen allows to define whether or not an additional AAR (Android Application Record) should be written to the tag. An AAR uses slightly more space on the NFC tag but ensures that the tag is preferably handled by Automagic and not by another app.
Read ID from NFC Tag
Opens a screen to read the ID of an existing NFC tag. Glob patterns can be used to match multiple tag IDs.

Tip: Some devices contain apps that can handle generic NFC tags and are shown in a selection list when an NFC tag is scanned. Uninstall or deactivate unused apps when the selection dialog bugs you. You can deactivate apps in the system settings on an Android 4+ device (System settings->Apps->All, Select the app->Deactivate).
For example, you can disable the app Tags on a Galaxy Nexus to prevent the selection list from showing.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
nfc_tag_ids
the scanned tag ID or a comma separated list when the tag contained multiple IDs
Top

Notification on Screen Displayed

The trigger Notification on Screen Displayed is executed when a notification is displayed on the screen.

Note: At least Android 4.0 (ICS) is required.

 

Examples:
  • Read out the text of a notification
Settings
Package Name
The comma separated list of apps that displayed the notification. Glob patterns can be used to match multiple packages.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
notification_message
the text of the displayed notification
package_name
the name of the package that displayed the notification
app_name
the display name of the app
Top

Notification on Statusbar Displayed

The trigger Notification on Statusbar Displayed is executed when a notification is displayed in the statusbar.

 

Examples:
  • Turn the screen on when Gmail app receives a mail
Settings
Package Name
The comma separated list of apps that displayed the notification. Glob patterns can be used to match multiple packages.
Filter
Defines the text that must be contained in one of the available fields.
Ignore regular events
Defines whether or not the trigger should execute the flow for regular events.
A notification is considered regular when the notification is not marked as ongoing by the posting app.
Ignore ongoing events
Defines whether or not the trigger should execute the flow for ongoing events.
A notification is marked as an ongoing event by the application that posts the notification and is usually set when a notification shows some progress like a file download, an app is playing a sound, or an app is running as a foreground service.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
title
the title of the displayed notification
content_title
the title of the content displayed by the notification
content_title_big
the title of the big content displayed by the notification
notification_text (This function is not officially supported by Android and does not work with all notifications)
the textual content of the notification
notification_text_big (Android 4.1+, This function is not officially supported by Android and does not work with all notifications)
the textual content of the big, expanded view of the notification
notification_large_icon (Android 4.1+, This function is not officially supported by Android and does not work with all notifications)
the large icon of the notification, when available
notification_when
the time shown in the notification
notification_number
number shown in the notification, when available
notification_vibrate_default
whether the notification vibrates using the default pattern
notification_vibrate_pattern
vibration pattern as a list of numbers (pause duration in ms, vibrate duration in ms, ...), when available
notification_sound_default
whether the notification should play the default notification sound
notification_sound_uri
the URI of the sound to play, when available
notification_people (Android 4.4+)
a list of relevant people of the notification (list of URIs), when available
notification_info_text (Android 4.4+)
the info text displayed by the notification, when available
notification_sub_text (Android 4.4+)
the sub text displayed by the notification, when available
notification_summary_text (Android 4.4+)
the summary text displayed by the notification, when available
notification_progress (Android 4.4+)
the current progress shown by the notification, when available
notification_progress_max (Android 4.4+)
the maximum progress, when available
notification_progress_indeterminate (Android 4.4+)
whether the progress is indeterminate, when available
notification_text_lines (Android 4.4+)
the text lines shown by the notification, when available
notification_background_image_uri (Android 5+)
the URI of the background image to show, when available
notification_category (Android 5+)
the category of the notification, when available
notification_accent_color (Android 5+)
the accent color of the notification, when available
notification_ticker_text
the scrolling text shown by the notification
notification_visibility (Android 5+)
the visibility of the notification (-1=secret, 0=private, 1=public)
notification_ongoing
whether this is an ongoing event
notification_foreground_service
whether this notification is used to mark a foreground service
notification_local_only
whether the notification should be displayed on the local device only
notification_group (Android 7+)
the group key of the notification
notification_is_group_summary (Android 7+)
whether the notification is the group summary
package_name
the name of the package that displayed the notification
app_name
the display name of the app
id (Android 4.3+)
the id of the notification
buttons (Android 4.1+, This function is not officially supported by Android and does not work with all notifications)
the list of buttons available on the big, expanded notification
wearable_actions (Android 4.4+, This function is not officially supported by Android and does not work with all notifications)
the list of actions displayed on Android Wear
Top

Notification on Statusbar Removed

The trigger Notification on Statusbar Removed is executed when a notification is removed from the statusbar.

 

Examples:
  • Disable mobile data access when a music app displaying a notification is stopped
Settings
Package Name
The comma separated list of apps that displayed the notification. Glob patterns can be used to match multiple packages.
Filter
Defines the text that must be contained in one of the available fields.
Ignore regular events
Defines whether or not the trigger should execute the flow for regular events.
A notification is considered regular when the notification is not marked as ongoing by the posting app.
Ignore ongoing events
Defines whether or not the trigger should execute the flow for ongoing events.
A notification is marked as an ongoing event by the application that posts the notification and is usually set when a notification shows some progress like a file download, an app is playing a sound, or an app is running as a foreground service.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
title
the title of the displayed notification
content_title
the title of the content displayed by the notification
content_title_big
the title of the big content displayed by the notification
notification_text (This function is not officially supported by Android and does not work with all notifications)
the textual content of the notification
notification_text_big (Android 4.1+, This function is not officially supported by Android and does not work with all notifications)
the textual content of the big, expanded view of the notification
notification_when
the time shown in the notification
notification_number
number shown in the notification, when available
notification_vibrate_default
whether the notification vibrates using the default pattern
notification_vibrate_pattern
vibration pattern as a list of numbers (pause duration in ms, vibrate duration in ms, ...), when available
notification_sound_default
whether the notification should play the default notification sound
notification_sound_uri
the URI of the sound to play, when available
notification_people (Android 4.4+)
a list of relevant people of the notification (list of URIs), when available
notification_info_text (Android 4.4+)
the info text displayed by the notification, when available
notification_sub_text (Android 4.4+)
the sub text displayed by the notification, when available
notification_summary_text (Android 4.4+)
the summary text displayed by the notification, when available
notification_progress (Android 4.4+)
the current progress shown by the notification, when available
notification_progress_max (Android 4.4+)
the maximum progress, when available
notification_progress_indeterminate (Android 4.4+)
whether the progress is indeterminate, when available
notification_text_lines (Android 4.4+)
the text lines shown by the notification, when available
notification_background_image_uri (Android 5+)
the URI of the background image to show, when available
notification_category (Android 5+)
the category of the notification, when available
notification_accent_color (Android 5+)
the accent color of the notification, when available
notification_ticker_text
the scrolling text shown by the notification
notification_visibility (Android 5+)
the visibility of the notification (-1=secret, 0=private, 1=public)
notification_ongoing
whether this is an ongoing event
notification_foreground_service
whether this notification is used to mark a foreground service
notification_local_only
whether the notification should be displayed on the local device only
notification_group (Android 7+)
the group key of the notification
notification_is_group_summary (Android 7+)
whether the notification is the group summary
package_name
the name of the package that displayed the notification
app_name
the display name of the app
id (Android 4.3+)
the id of the notification
Top

Notification on Statusbar Selected

The trigger Notification on Statusbar Selected executes the flow when a notification is selected that was previously shown using action Notification on Statusbar.

Example:
  • Show a notification when the airplane mode is enabled by a flow. Turn airplane mode manually off when the notification in the statusbar is selected.
Settings
Notification
Create own Notification
Creates a new notification on the statusbar.

Trigger on Notification from Action
Trigger the flow when a notification supplied by action Notification on Statusbar was selected.

Icon
The icon to use for this notification.

Custom icons are supported starting with Android 6.
Note: Android will usually show all non-transparent parts as white so it's recommended to create custom PNG images with a transparent background and a white color to paint the contents.
Note: Option 'Custom icon' can lead to crashes on some devices with Android 6.0.
Title
The title of the notification.
Message
The message of the notification.
Play Sound
Plays the default notification sound when checked.
Vibrate
Vibrates when checked.
Flash LED
Flash the notification LED using the supplied color and blink rate. Notification LED and user defined colors are not supported on all devices.
Accent color
The color used by the device for in the notification (usually the background color of the icon in the expanded statusbar).
Ongoing
Flags this notification as an ongoing event and prevents the removal of this notification from the statusbar. A notification ID is mandatory when this option is selected.
Category (Android 5+, Premium)
The category of the notification. The category defines if a notification is allowed to pass the interruptions filter.
Priority (Android 4.1+)
Defines the priority of the notification. A notification with a low priority might be displayed in the expanded statusbar only (depends on Android version).
Visibility (Android 5+, Premium)
Whether notifications are secret, private or public which defines whether the notifications are displayed on the lock screen or not. The Lock screen must also be configured appropriately.
Notification IDs
Whether the trigger should be executed for one specific ID or for all notifications. The ID can be defined in the action Notification on Statusbar.
Big Message (Android 4.1+, Premium)
Defines a big message that will be displayed when the notification is expanded (by swiping down on the notification). The notification usually also shows the big message when the notification is displayed as the topmost notification on the notification drawer. You can affect the ordering of the notifications by using the priority setting.
Large Icon (Android 3+, Premium)
Defines whether a large icon should be displayed in the notification.
Group (Android 7+, Premium)
Defines the group of this notification.
Group summary (Android 7+, Premium)
Defines whether this notification is the group summary for this group.
Actions (Android 4.1+, Premium)
Up to three actions displayed as buttons when the notification is expanded (by swiping down on the notification). The notification usually also shows the action buttons when the notification is displayed as the topmost notification on the notification drawer. You can affect the ordering of the notifications by using the priority setting.

Tip: Use action Execute Flows to execute a complex flow consisting of multiple actions and conditions.

Following variables are supplied to the executed action:
  • action_number: contains the number of the action (1, 2 or 3)
  • action_text: the text label of the selected action button on the notification
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
notification_title
the title of the notification
notification_message
the message of the notification
notification_id
the ID of the selected notification
Top

Outgoing Call

The trigger Outgoing Call is executed when an outgoing call is made and the criteria defined in the options match.

 

Examples:
  • Start recording in Gleeo Time Tracker when you call your employer.
  • Send a mail containing the called number and time to your mail account.
Settings
Called Callnumber List
The list of callnumbers when the flow should be executed. Multiple numbers can be separated by comma.
Glob patterns (*, ?) can be used to filter on similar numbers like corporate number ranges:

Examples:
  • +17001111111
  • +17001111111,+17002222222
  • *70033311*
  • *70033311*,*70033?22*
Special characters like +, - and . are removed before comparing the number.

Warning: Verify that the called number is formatted to your expectations.
You have to check the log file to see the exact formatting used or you can add an action Notification on Screen with text {called_number} to see the actual number.
Phone state
Defines the state of the call to trigger the flow. Selecting multiple states triggers the flow once for each state.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
called_number
the number of the called party
call_state
the state of the call (IDLE, OFFHOOK)
contact_name
the name of the contact if available
contact_company
the company of the contact if available
contact_title
the title of the contact if available
contact_note
the note of the contact if available
contact_nickname
the nickname of the contact if available
contact_email
an email address of the contact if available
contact_groups
the list of groups of the contact if available
Top

Periodic Location Update

The trigger Periodic Location Update is executed in periodic intervals and delivers a location to the executed flow.
The accuracy of the location heavily depends on the selected location provider.

Tip: The higher the time interval between updates the less battery will be used. A frequency of about 4 minutes is recommended.

 

Examples:
  • Record the location every 5 minutes to a file.
  • Send an SMS with your location every hour to someone.
Settings
Location Provider
The location provider to use.

Network
This provider uses the location provided by the cell tower and Wi-Fi signals. Depending on environment this provider can deliver location of about 60 meters of accuracy. Locations found using the cell tower can be very inaccurate (up to several kilometers or miles).

Passive
This provider delivers the location from the currently active provider (Network or GPS) without activating one of the providers by itself. This might result in very infrequent location updates.

GPS
This provider delivers the location using the GPS receiver. This provider usually uses more battery than the network provider.

High Accuracy (Experimental)
This provider delivers the finest available location using different sensors available on the device.

Balanced Power/Accuracy (Experimental)
This provider delivers the a location with an accuracy of about 100m and uses less battery than the high accuracy provider.

Low Power (Experimental)
This provider delivers the a location with an accuracy of about 10km.

No Power (Experimental)
This provider will only deliver locations when another app on the device has requested locations.

Frequency
The desired time between location updates. The actual time between location updates depends on the location provider when Enforce Exact Frequency is not checked.
A location provider (for example GPS) can ignore the specified frequency and deliver updates every few seconds.
Enforce Exact Frequency
Ensures that the location is provided in the intervals specified by Frequency even when the location provider delivers the location updates more often or less often.
Minimum Accuracy (in meters)
Only newer locations with at least the specified accuracy are passed to the flow.
This can be useful to filter out locations calculated using the cell tower when also more exact locations using WiFi are available.
Limit time range
Whether the trigger should be active all the time or only within a defined time range.
Weekdays
The day on which the trigger should be active.
From - To
The start of the time range and the end of the time range. A To-time smaller than the From-time will move the To-time to the next day to simplify checks for time ranges crossing midnight.
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
location
the reported location
location_accuracy
the accuracy of the location
location_altitude
the altitude of the location when available
location_bearing
the direction of travel in degrees East of true North when available
location_speed
the speed of travel in meters per second when available
Top

Periodic Timer

The trigger Periodic Timer is executed in the specified interval.

 

Examples:
  • Remind about a recording task in Gleeo Time Tracker every 5 minutes.
Settings
Interval
Defines the time interval between flow executions.
Wake device when in sleep mode
Defines whether the device should be woken up from sleep mode.
Disabling this option saves a bit of battery but delays the trigger invocation for an unknown amount of time when the devices is asleep.
Limit time range
Whether the trigger should be active all the time or only within a defined time range.
Weekdays
The day on which the trigger should be active.
From - To
The start of the time range and the end of the time range. A To-time smaller than the From-time will move the To-time to the next day to simplify checks for time ranges crossing midnight.
At fixed times
Defines if the timer should execute the flow periodically in the set interval relative to midnight (or at the From-time when a limited time range is in effect).
If this option is not set, the interval starts at the moment when the trigger is enabled.

Examples when a flow is activated at 07:13:
  • Option not set, Interval 1h: Flow executes at 08:13, 09:13, 10:13, ...
  • Option set, Interval 1h: Flow executes at 08:00, 09:00, 10:00, ...
  • Option set, Interval 1h, Time range 07:00 - 09:00: Flow executes at 08:00, 09:00 (next day: 07:00, 08:00, 09:00)
  • Option set, Interval 1h, Time range 07:30 - 09:30: Flow executes at 07:30, 08:30, 09:30

Note that disabling Wake device when in sleep mode can delay the execution when the device is in deep sleep.
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Periodic Timer Inexact

The trigger Periodic Timer Inexact is executed approximately in the specified interval. The device can adjust the time of the trigger a bit and call the trigger when the device is currently also executing other tasks. This trigger uses less battery than the regular trigger Periodic Timer

 

Examples:
  • Check approximately once an hour if a server is online.
Settings
Interval (Inexact)
Defines the time interval between flow executions. Android only supports the times available in this list.
Wake device when in sleep mode
Defines whether the device should be woken up from sleep mode.
Disabling this option saves a bit of battery but delays the trigger invocation for an unknown amount of time when the devices is asleep.
Limit time range
Whether the trigger should be active all the time or only within a defined time range.
Weekdays
The day on which the trigger should be active.
From - To
The start of the time range and the end of the time range. A To-time smaller than the From-time will move the To-time to the next day to simplify checks for time ranges crossing midnight.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Phone Cell CDMA

The trigger Phone Cell CDMA is executed when the device connects or disconnects from the defined cells. Changes within the defined list of cells don't invoke the trigger.

Warning: Some devices don't report the cell to Automagic when the screen is turned off.

 

Examples:
  • Turn WiFi on, when the device connects to one of the cells at home
Settings
Method
Whether the classic, a modern or both methods should be used to find cells. It's highly device dependent which method works best.
Trigger when
Whether the trigger should execute the flow when connected/disconnected from an area defined by a list of cells or on every cell change (can be frequent).
Cell List
A comma separated list of cell IDs. Glob patterns (*, ?) are supported. Variables are supported.
Cell List to Ignore
A comma separated list of cell IDs to ignore. Glob patterns (*, ?) are supported. Variables are supported.
Connected / Disconnected
Whether the trigger should be executed when the device connects or disconnects from the listed cells. Changes within the defined list of cells don't invoke the trigger.
Wake device
Whether the trigger should wake the CPU of the device every X minutes or not. This is necessary for some devices when the cell is not updated regularly. Consumes more battery when a shorter time interval is chosen.
Turn screen on
Whether the display should be turned on briefly or not. This is necessary for some devices when the cell is not updated otherwise. This option increases battery consumption and should only be enabled when the cell is not updated otherwise.
Force update
Whether the cell update should be forced. This option increases battery consumption and should only be enabled when the cell is not updated otherwise.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
cell_id
the cell id, null if unknown
base_station_id
the ID of the base station , -1 if unknown
network_id
the ID of the network, -1 if unknown
system_id
the ID of the system, -1 if unknown
base_station_latitude
the latitude of the base station in quarter degree seconds, 2147483647 if unknown. Divide value by 14400 to get decimal degrees. Not all networks provide meaningful values.
base_station_longitude
the longitude of the base station in quarter degree seconds, 2147483647 if unknown. Divide value by 14400 to get decimal degrees. Not all networks provide meaningful values.
last_cell_id
the last cell id, null if unknown or the trigger was just activated
last_base_station_id
the last ID of the base station , -1 if unknown or the trigger was just activated
last_network_id
the last ID of the network, -1 if unknown or the trigger was just activated
last_system_id
the last ID of the system, -1 if unknown or the trigger was just activated
last_base_station_latitude
the latitude of the last base station in quarter degree seconds, 2147483647 if unknown. Divide value by 14400 to get decimal degrees. Not all networks provide meaningful values.
last_base_station_longitude
the longitude of the last base station in quarter degree seconds, 2147483647 if unknown. Divide value by 14400 to get decimal degrees. Not all networks provide meaningful values.
connected
true when connected to the defined cells, false otherwise
disconnected
true when disconnected from the defined cells, false otherwise
Top

Phone Cell GSM

The trigger Phone Cell GSM is executed when the device connects or disconnects from the defined cells. Changes within the defined list of cells don't invoke the trigger.

Warning: Some devices don't report the cell to Automagic when the screen is turned off.

 

Examples:
  • Turn WiFi on, when the device connects to one of the cells at home
Settings
Method
Whether the classic, a modern or both methods should be used to find cells. It's highly device dependent which method works best.
Trigger when
Whether the trigger should execute the flow when connected/disconnected from an area defined by a list of cells or on every cell change (can be frequent).
Location Area Code (LAC) List
A comma separated list of location area codes. A location area is set of base stations and usually covers a large area. Glob patterns (*, ?) are supported. Variables are supported.
Cell ID (CID) List
A comma separated list of cell IDs. Glob patterns (*, ?) are supported. Variables are supported.
Cell ID (CID) List to Ignore
A comma separated list of cell IDs to ignore. Glob patterns (*, ?) are supported. Variables are supported.
Connected / Disconnected
Whether the trigger should be executed when the device connects or disconnects from the listed cells. Changes within the defined list of cells don't invoke the trigger.
Wake device
Whether the trigger should wake the CPU of the device every X minutes or not. This is necessary for some devices when the cell is not updated regularly. Consumes more battery when a shorter time interval is chosen.
Turn screen on
Whether the display should be turned on briefly or not. This is necessary for some devices when the cell is not updated otherwise. This option increases battery consumption and should only be enabled when the cell is not updated otherwise.
Force update
Whether the cell update should be forced. This option increases battery consumption and should only be enabled when the cell is not updated otherwise.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
lac
the currently connected cells location area code (LAC), -1 if unknown
cid
the currently connected cells ID (CID), -1 if unknown
psc
the currently connected cells primary synchronization code (PSC), -1 if unknown
last_lac
the last connected cells location area code (LAC), -1 if unknown or the trigger was just activated
last_cid
the last connected cells ID (CID), -1 if unknown or the trigger was just activated
last_psc
the last connected cells primary synchronization code (PSC), -1 if unknown or the trigger was just activated
connected
true when connected to the defined cells, false otherwise
disconnected
true when disconnected from the defined cells, false otherwise
Top

Phone Service State

The trigger Phone Service State is executed when the device detects the specified state.

Warning: Some devices don't send the current service state to applications when the screen is turned off. You can periodically use the action Turn Screen On to mitigate this problem.

 

Examples:
  • Play a warning sound when no service is available.
Settings
SIM
The SIM card.
Phone Service State
In Service
Execute the flow when the telephony is back to regular operation.

Out of Service
Execute the flow when telephony becomes unavailable.

Emergency Only
Execute the flow when only emergency numbers can be called.

Power Off
Execute the flow when the radio is explicitly powered off.

Wake device
Whether the trigger should wake the CPU of the device every X minutes or not. Consumes more battery when a shorter time interval is chosen.
Turn screen on
Whether the display should be turned on briefly or not. This option increases battery consumption and should only be enabled when the values are not updated otherwise.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
previous_service_state
the previous service state (0=in service, 1=out of service, 2=emergency only, 3=power off)
service_state
the current state of the service (0=in service, 1=out of service, 2=emergency only, 3=power off)
roaming
boolean indicating the roaming status
Top

Phone Signal Strength

The trigger Phone Signal Strength is executed when the signal strength falls under or raises over the specified value.

Warning: Some devices don't send the current signal strength to applications when the screen is turned off.

 

Examples:
  • Play an alert when the signal strength becomes bad.
Settings
SIM
The SIM card.
Signal Strength Condition
Defines the condition that must be met to execute the flow:

becomes lower than
Executes the flow when the last reported value was above the defined level and the current value is below the defined level

becomes higher than
Executes the flow when the last reported value was below the defined level and the current value is above the defined level

becomes equal to
Executes the flow when the last reported value was different than the defined level and the current value equals the defined level

lower than
Executes the flow whenever the reported value by the system is below the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last value has been the same.

higher than
Executes the flow whenever the reported value by the system is above the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last value has been the same.

exactly
Executes the flow whenever the reported value by the system is exactly on the defined level. Depending on device this might cause the flow to be executed every few seconds. The flow is executed even when the last value has been the same.
Signal Strength
Defines the signal strength to use.
Wake device
Whether the trigger should wake the CPU of the device every X minutes or not. Consumes more battery when a shorter time interval is chosen.
Turn screen on
Whether the display should be turned on briefly or not. This option increases battery consumption and should only be enabled when the values are not updated otherwise.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
is_gsm
true when GSM
signal_strength_level
the signal strength in a value from 0 to 4 like the bars on a standard Android device
signal_strength_asu
the signal strength in ASU (0-31)
gsm_signal_strength
the GSM signal strength (0-31, 99 for unknown, -1 for unavailable)
gsm_bit_error_rate
the GSM bit error rate (0-7, 99 for unknown, -1 for unavailable)
cdma_dbm
the CDMA RSSI value in dBm (-1 for unavailable)
cdma_ecio
the CDMA Ec/Io value in dB*10 (-1 for unavailable)
evdo_dbm
the EVDO RSSI value in dBm (-1 for unavailable)
evdo_ecio
the EVDO Ec/Io value in dB*10 (-1 for unavailable)
evdo_snr
the EVDO signal to noise ratio (0-8, -1 for unavailable)
lte_dbm
the LTE RSRP value in dBm (-1 for unavailable)
Top

Plugin (Experimental)

The trigger Plugin (Experimental) executes a flow when the condition of a plugin changes to true and/or false.
Warning: This function is experimental and might not work with all existing plugins available in Google Play. We can not provide support for plugins.

Note: Plugins can be defined using the interface description available from the app Locale: Locale developer documentation and Tasker: Tasker plugin extensions.

Settings
Plugin
List of all available plugins found on the device.
Condition
  • becomes true: when the condition measured in the plugin changes from false or undefined to true
  • becomes false: when the condition measured in the plugin changes from true or undefined to false
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
condition
whether the condition became true or false
Top

Plugin Event (Experimental)

The trigger Plugin Event (Experimental) executes a flow when an event-plugin indicates an event.
Warning: This function is experimental and might not work with all existing plugins available in Google Play. We can not provide support for plugins.

Note: Plugins can be defined using the interface description available from the app Locale: Locale developer documentation and Tasker: Tasker plugin extensions.

Settings
Plugin
List of all available plugins found on the device.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Power Source

The trigger Power Source is executed when a power source is connected to the device (charger or USB cable).

 

Examples:
  • Turn on WiFi when a power source is connected.
  • Increase the screen brightness when a power source is connected.
  • Set screen brightness to automatic when a power source is disconnected.
Settings
Power connected/disconnected
Connected
When selected executes the flow when a power source is connected.
  • AC Adapter: when charging with the AC adapter
  • USB: when charging over an USB connection
  • Wireless: when charging wirelessly

Disconnected
When selected executes the flow when a power source is disconnected.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
battery_level
the charging level of the battery
battery_percentage
the charging percentage
battery_plugged
whether the battery is plugged (1=AC adapter, 2=USB, 4=Wireless) or not (0=not plugged)
battery_present
whether the battery is present or not
battery_scale
the maximum battery level
battery_status
the status of the battery (1=unknown, 2=charging, 3=discharging, 4=not charging, 5=full)
battery_technology
the technology of the battery
battery_temperature
the temperature of the battery (in tenths of degree Celsius)
battery_voltage
the current battery voltage
battery_health
the health of the battery
battery_charge_counter (Android 5+)
Battery capacity in microampere-hours. null when not available
battery_current_now (Android 5+)
Instantaneous battery current in microamperes (positive values=charging, negative values=discharging). null when not available
battery_current_average (Android 5+)
Average battery current in microamperes (positive values=charging, negative values=discharging). null when not available
battery_energy_counter (Android 5+)
Battery remaining energy in nanowatt-hours. null when not available
Top

Power Source (Android Wear)

The trigger Power Source (Android Wear) is executed when a power source is connected to the device (charger or USB cable).

 

Examples:
  • Turn on WiFi when a power source is connected.
  • Increase the screen brightness when a power source is connected.
  • Set screen brightness to automatic when a power source is disconnected.
Settings
Android Wear device
The target device.
Power connected/disconnected
Connected
When selected executes the flow when a power source is connected.
  • AC Adapter: when charging with the AC adapter
  • USB: when charging over an USB connection
  • Wireless: when charging wirelessly

Disconnected
When selected executes the flow when a power source is disconnected.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
battery_level
the charging level of the battery
battery_percentage
the charging percentage
battery_plugged
whether the battery is plugged (1=AC adapter, 2=USB, 4=Wireless) or not (0=not plugged)
battery_present
whether the battery is present or not
battery_scale
the maximum battery level
battery_status
the status of the battery (1=unknown, 2=charging, 3=discharging, 4=not charging, 5=full)
battery_technology
the technology of the battery
battery_temperature
the temperature of the battery (in tenths of degree Celsius)
battery_voltage
the current battery voltage
battery_health
the health of the battery
node_id
the ID of the Wear node
Top

Pressure Sensor

The trigger Pressure Sensor is executed when the measured pressure of the pressure sensor rises above or declines below a certain level or when the pressure changes at least the specified amount in the given time.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

Tip: If you need to check the pressure only every few minutes, it is recommended to use a condition Pressure Sensor since the condition will not use the sensor constantly and thus consumes less battery.

 

Examples:
  • Execute a flow when the pressure changes when walking down a stair
Settings
Type
  • Declines below: executes the trigger when the measured pressure falls under a certain value
  • Rises above: executes the trigger when the measured pressure rises above a certain value
  • Declines within duration: executes the trigger when the measured pressure declines a certain amount within a given time
  • Rises within duration: executes the trigger when the measured pressure rises a certain amount within a given time
Pressure (in mbar)
The pressure in millibar to compare.
Threshold
The minimal change in pressure before the trigger is executed again.

Example:
Type: Declines below, Pressure 1000mbar, Threshold: 5mbar
The trigger is executed when the pressure declines below 1000mbar. The pressure has to rise to at least 1005mbar again before the trigger is executed again.
Change (in mbar)
The change in pressure in mbar.
Duration
The duration the pressure change has to happen for the trigger to execute.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
pressure
the measured pressure in mbar
Top

Proximity Sensor

The trigger Proximity Sensor is executed when the measured distance of the proximity sensor passes the defined distance.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

Settings
Distance (in cm)
Whether to execute the trigger when the distance passes above or below the defined distance and the distance in cm.
Keep device awake
Ensure that the device does not go into deep sleep while the action is executed. This option increases battery consumption and should only be enabled when the proximity sensor stops working when the display is turned off.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
proximity
the measured value of the proximity sensor
Top

Quick Settings Tile Selected

The trigger Quick Settings Tile Selected configures the selected quick settings tile and is executed when the tile is selected/clicked.

Tip: Action Update Quick Settings Tile can be used to change the icon, label or state of the tile.

 

Examples:
  • Create a QS tile to send an SMS with the current location.
Settings
Tile
The tile to use.
Icon
Label
Collapse panel
Whether or not the quick settings area should be closed when the tile is selected/clicked.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Ringer Mode

The trigger Ringer Mode is executed when the device switches to the specified ringer mode.

Settings
Ringer Mode
The desired ringer mode.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Screen Orientation

The trigger Screen Orientation is executed when the orientation of the device changes to portrait or landscape.

 

Examples:
  • Change the active keyboard type depending on screen orientation
Settings
Portrait or Landscape
Whether the trigger should be executed when the display changes to portrait or landscape.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Send/Share Intent Received

The trigger Send/Share Intent Received is executed when the send/share menu is used in an app and the data is shared with Automagic.

 

Examples:
  • Share an URL in Google+ and directly send this link by SMS to one of your contacts.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
data_string
the URI of the data this intent is targeting or null
mimetype
the MIME type of the data being sent
text
the data as text when available
stream_uri
the URI of the data when available
html_text
optional data as HTML when available
email
the list of mail receivers when available
cc
the list of mail addresses to CC
bcc
the list of mail addresses to BCC
subject
the subject when available
Top

Send/Share Multiple Intent Received

The trigger Send/Share Multiple Intent Received is executed when the send/share menu is used in an app and multiple items are shared with Automagic.

 

Examples:
  • Select multiple files in a file manager and share the files with Automagic.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
data_string
the URI of the data this intent is targeting or null
mimetype
the MIME type of the data being sent
texts
the list of text items when available
stream_uris
the list of URIs when available
html_texts
optional texts as HTML when available
email
the list of mail receivers when available
cc
the list of mail addresses to CC
bcc
the list of mail addresses to BCC
subject
the subject when available
Top

Shake

The trigger Shake is executed when the device is shaken.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices turn off the sensors when the screen is off.

 

Examples:
  • Raise the screen brightness for 1 minute when the device is shaken.
  • Turn silent mode on when the device is shaken.
Settings
Sensitivity
Defines how strong a shake must be to invoke the trigger.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Shortcut

The trigger Shortcut is executed when a shortcut on the launcher is pressed.
You can create the shortcut and select an icon by pressing the Install Shortcut button.

 

Examples:
  • Turn WiFi on by pressing the shortcut.
  • Launch a settings application screen by pressing the shortcut.
  • Start recording in Gleeo Time Tracker by pressing the shortcut.
Settings
Title
The title/name of the shortcut to create. The title is used to identify the Shortcut-trigger in Automagic, which means that a shortcut can execute multiple triggers when two Shortcut-triggers use the same title. The title is passed to the launcher at the time when the button Install Shortcut is pressed.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Shortcut (Android Wear)

The trigger Shortcut (Android Wear) is executed when a shortcut in the list of Shortcut is selected (see Start -> Shortcut).

 

Examples:
  • Turn WiFi on by pressing the shortcut.
  • Launch a settings application screen by pressing the shortcut.
  • Start recording in Gleeo Time Tracker by pressing the shortcut.
Settings
Title
The title/name of the shortcut to create. The title is used to identify the Shortcut-trigger in Automagic, which means that a shortcut can execute multiple triggers when two Shortcut-triggers use the same title.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
node_id
the ID of the Wear node
Top

Shutdown

The trigger Shutdown is executed before the device shutdown.
A flow is executed on a best effort basis, Automagic might not have enough time to execute the flow completely or some services or interfaces might already be unavailable when the shutdown is detected.

 

Examples:
  • Vibrate before the device shuts down
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Significant Motion Detected

The trigger Significant Motion Detected is executed when the special hardware sensor of the device detects a significant motion. Automagic can not configure how strong or how long the duration of the motion needs to be to activate the sensor.

Warning: This trigger hardware sensors of the device. This special hardware sensor used by this trigger should have a very low battery consumption.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

SIM State

The trigger SIM State is executed when the SIM state changes to one of the selected states.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Play a warning sound when the SIM is removed.
Settings
SIM state changed to
Defines the SIM states to execute the trigger.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
previous_sim_state
the previous state (0=unknown, 1=absent, 2=PIN required, 3=PUK required, 4=network locked, 5=ready)
sim_state
the new state (0=unknown, 1=absent, 2=PIN required, 3=PUK required, 4=network locked, 5=ready)
Top

SMS Received

The trigger SMS Received is executed when an SMS is received depending on the criteria defined in the options.

 

Examples:
  • Play a special alert when an SMS containing the keyword Alert!
  • Send an SMS containing your location back to the SMS sender when the SMS contains Where are you?
  • Read the received SMS aloud.
  • Delete a password file on the SD card when the SMS contains house search!
  • Play a repeating sound and vibrate when an SMS contains device lost!
Tip: Use a keyword or password that will not be part of a regular SMS to avoid unpleasant surprises.
Settings
SMS Sender List
The list of callnumbers when the flow should be executed. Multiple numbers can be separated by comma.
Glob patterns (*, ?) can be used to filter on similar numbers like corporate number ranges:

Examples:
  • +17001111111
  • +17001111111,+17002222222
  • *70033311*
  • *70033311*,*70033?22*
Special characters like +, - and . are removed before comparing the number.

Warning: The formatting of the incoming number depends on the operator in use.
You have to check the log file to see the exact formatting used or you can add an action Notification on Screen with text {sms_sender} to see the actual number.
Contains Text
Only executes the flow when the text of the SMS contains the given text (no wildcards supported). The text is not case sensitive.
Prevent other apps from receiving the SMS
Prevents the regular SMS application from receiving the SMS.

Warning: Only check this option when you are sure that Contains Text does not match regular SMS by accident.
Warning: This feature is not supported on Android 4.4+.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
sms_text
the text of the SMS
sms_sender
the sender of the SMS
contact_name
the name of the contact if available
contact_company
the company of the contact if available
contact_title
the title of the contact if available
contact_note
the note of the contact if available
contact_nickname
the nickname of the contact if available
contact_email
an email address of the contact if available
contact_groups
the list of groups of the contact if available
Top

SMS Sent

The trigger SMS Sent is executed when an SMS is sent and stored as a sent SMS in the default SMS outbox of the standard Android SMS database.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Send every sent SMS as a mail to your mail account
Settings
SMS Receiver List
The list of callnumbers when the flow should be executed. Multiple numbers can be separated by comma.
Glob patterns (*, ?) can be used to filter on similar numbers like corporate number ranges:

Examples:
  • +17001111111
  • +17001111111,+17002222222
  • *70033311*
  • *70033311*,*70033?22*
Special characters like +, - and . are removed before comparing the number.

Contains Text
Only executes the flow when the text of the SMS contains the given text (no wildcards supported). The text is not case sensitive.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
sms_text
the text of the SMS
sms_receiver
the receiver of the SMS
contact_name
the name of the contact if available
contact_company
the company of the contact if available
contact_title
the title of the contact if available
contact_note
the note of the contact if available
contact_nickname
the nickname of the contact if available
contact_email
an email address of the contact if available
contact_groups
the list of groups of the contact if available
Top

Sound Level (Experimental)

The trigger Sound Level (Experimental) is executed when the recorded sound level in the environment exceed a certain level.

Warning: This condition records the environment sound using the microphone of the device which does not work, when another app already uses the microphone.

Settings
Average
If the current sound level should be considered or the duration to record and calculate the sound level.
Sensitivity
The sensitivity of the slider to define the sound level.
Sound Level
The sound level to check.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
sound_level
the detected sound level
Top

Speech Web Search Requested

The trigger Speech Web Search Requested is executed when the speech recognition based search is initiated, for example by long-pressing the headset hook button.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
language_model
free_form, web_search or null when not set
prompt
prompt to show or null when not set
language
the language code or null when not set
web_search_only
if only a web search should be executed or whether also other actions should be executed
origin
source of the trigger event or null when not set
Top

Speed

The trigger Speed is executed when the measured speed of the GPS receiver rises above or declines below a certain level.

Warning: This trigger uses the GPS receiver and might increase battery usage (depending on device model).

 

Examples:
  • Record the location in a file whenever you are driving faster than 120km/h
Settings
Type
  • Declines below: executes the trigger when the reported speed falls under a certain value
  • Rises above: executes the trigger when the reported speed rises above a certain value
Speed
The speed to compare.
Unit
The unit of the speed.
Threshold
The minimal change in speed before the trigger is executed again.

Example:
Type: Declines below, Speed 40km/h, Threshold: 10km/h
The trigger is executed when the speed declines under 40km/h. The speed has to rise to at least 50km/h again before the trigger is executed again.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
location
the reported location
location_accuracy
the accuracy of the location
location_altitude
the altitude of the location when available
location_bearing
the direction of travel in degrees East of true North when available
location_speed
the speed of travel in meters per second
Top

Step counter

The trigger Step counter uses the Step counter/Pedometer of the device and executes a flow when the specified number of steps have been counted. The device can optimise the battery usage and inform Automagic less often when the display is turned off.

Warning: This trigger uses the device hardware sensors and might increase battery usage (depending on device model). Some devices do not count the steps when the screen is off.

 

Examples:
  • Create a calendar event 'Training highly recommended' for the next day when less than 1000 steps have been counted for the day.
Settings
On every nth step (or less frequent)
Defines after how many steps a flow should be executed. The step counter can inform Automagic less often to save battery.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
step_count
the number of steps since the trigger was enabled
step_count_total
the number of steps counted by the sensor since the last reboot
last_step_time
the point in time of the last detected step. Automagic attempts to provide a regular system time but might fail on some devices due to differences on ROMs.
Top

Storage Media Event

The trigger Storage Media Event is executed when the system mounts or unmounts the SD card or makes other changes involving the storage media.

 

Examples:
  • Disable a flow writing the location to the SD card when the sdcard is removed.
Settings
Event
Defines the event when the flow should be executed.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
path
the affected path
Top

System Setting Changed

The trigger System Setting Changed is executed whenever a setting in the systems setting database was changed.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Play an alert when the system turns on the blocking mode.
Settings
Category
  • System: for regular settings
  • Secure: for settings which can usually not be modified
  • Global: for global Settings valid for all users of the device (Android 4.2+)
Name
The name of the setting to watch.
Variable
The name of the variable with the new value of the setting to pass to the flow.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
old_setting
the value of the setting before it was changed
setting
the new value of the setting
Top

System Setting Changed (Android Wear)

The trigger System Setting Changed (Android Wear) is executed whenever a setting in the systems setting database was changed.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Play an alert when the system turns on the blocking mode.
Settings
Android Wear device
The target device.
Category
  • System: for regular settings
  • Secure: for settings which can usually not be modified
  • Global: for global Settings valid for all users of the device (Android 4.2+)
Name
The name of the setting to watch.
Variable
The name of the variable with the new value of the setting to pass to the flow.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
old_setting
the value of the setting before it was changed
setting
the new value of the setting
node_id
the ID of the Wear node
Top

Take Note (Android Wear)

The trigger Take Note (Android Wear) is executed when a note is taken from the Wear device.

 

Examples:
  • Take a note and directly send the note by email to your inbox.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
note
the text of the note
node_id
the ID of the Wear node
Top

Theater Mode (Android Wear)

The trigger Theater Mode (Android Wear) is executed when the theater mode is turned on or off.

Warning: This function is not officially supported by Android and might not work on all devices.

 

Examples:
  • Disable some flows when the theater mode is turned on.
Settings
Android Wear device
The target device.
Theater Mode
Whether the trigger should be executed when the theater mode is turned on or off.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
node_id
the ID of the Wear node
Top

Time

The trigger Time is executed regularly on the defined weekday and time.

 

Examples:
  • Download a PDF newspaper every morning at 6am.
  • Turn on airplane mode every evening at 11pm.
  • Turn off airplane mode every morning at 6am.
Settings
Weekdays
The day on which the trigger should execute the flow.
Time
The time of the day when the trigger should execute the flow.
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Time Adjusted

The trigger Time Adjusted is executed when the time of the system is changed.

 

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Timezone Adjusted

The trigger Timezone Adjusted is executed when the timezone of the system has been changed.

 

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
timezone
the new timezone
Top

UI Event

The trigger UI Event executes a flow when the system detects a change in the user interface, for example when a window is opened, a button is pressed, a list is scrolled, text has been entered etc.

Note: The system informs Automagic not about all events. Some events that occur very frequently can be skipped by the system.

 

Examples:
  • Execute a flow, when the Install button in Google Play is pressed.
Settings
Event Type
  • Window opened: A new window, dialog or popup has been opened. The variable text often contains the title of the window.
  • Component clicked: A button or label has been clicked. The variable text of image buttons is often empty.
  • Component long clicked: A button or label has been long clicked. The variable text of image buttons is often empty.
  • Component selected: An element has been selected, e.g. a row in a list or an element in a dropdown.
  • Component focused: The input focus has been moved to another element.
  • Component scrolled: A list has been scrolled.
  • Text changed: The text in a text input fields has been changed.
  • Text selection changed: The text selection or cursor position has been changed.
  • Announcement: An app made an announcement like changing the page in a book.
Package Name
The list of apps to consider by this trigger. Glob patterns (*, ?) are supported.
Text
The text that should be contained in the event.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
event_type
the event represented by a number:
  • Window opened: 32
  • View clicked: 1
  • View long clicked: 2
  • View selected: 4
  • View focused: 8
  • Text changed: 16
  • Text selection changed: 8192
  • View scrolled: 4096
  • Announcement: 16384
content_description
the content description of the source
package_name
the package name of originating app
source_class_name
the class name of the source
source_bounds
the position and size of the element (null when not determinable)
text
the text of the source or the title of the opened window
label
the label of the source
enabled
whether the source is enabled
checked
whether the source is checked
fullscreen
whether the source is executed in fullscreen mode
password
whether the source is a password field
scrollable
whether the source can be scrolled
scroll_x
the scroll offset of the source left edge in pixels
scroll_y
the scroll offset of the source top edge in pixels
from_index
from index of the element
to_index
to index of the element
item_count
number of elements in a list
current_item_index
item position when the element is contained in a list
added_count
number of added characters when a text is edited
removed_count
number of removed characters when a text is edited
before_text
text before it was changed
app_name
the name of the originating app
Top

User Activity (Experimental)

The trigger User Activity (Experimental) asks the device to periodically check most probably physical activity of the user like driving a car, riding a bike or walking.

Note: The detection of the current activity is a feature of the device provided by Google. Automagic can not change or improve the quality of the detected activity.

 

Examples:
  • Check the activity every 5 minutes to measure how much time the user walks per day and how much time the user sits in the office.
  • Increase the ringer volume when the user is driving in a car.
Settings
Trigger when
  • Activity detected: execute the flow when the defined activity begins or ends.
  • Periodically: execute the flow periodically even when the activity stays the same.
Activity
Defines which activity should trigger the flow. Begin executes the flow when the detected activity switches to the defined activity and was different before. Ends executed the flow when the defined activity was in progress before and is not detected anymore.
Enforce Exact Frequency
Ensures that the flow is executed exactly at the defined frequency even when the detected activity changes more or less frequent.
Check Frequency
The desired time between activity checks. The actual time between activity updates depends on the device when Enforce Exact Frequency is not checked.
The device can detect the activity more frequently when another app is interested in activity updates and uses a shorter update interval. Some devices turn off activity detection when activity still is detected and a low power sensor to detect device movement is available.
Minimum Confidence
The minimum confidence level to accept (0=unconfident, 100=confident).
Limit time range
Whether the trigger should be active all the time or only within a defined time range.
Weekdays
The day on which the trigger should be active.
From - To
The start of the time range and the end of the time range. A To-time smaller than the From-time will move the To-time to the next day to simplify checks for time ranges crossing midnight.
Allow in device idle/doze (Android 6+)
Defines whether this trigger is allowed to wake the device from idle/doze mode. (see Device Idle/Doze Mode)
Like alarm clock (Android 5+)
Defines whether this trigger should be handled like an alarm clock which is usually displayed in the status bar.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
activity_name
the name of the activity ("in_vehicle", "on_bicycle", "on_foot", "still", "unknown", "tilting", "walking", "running")
activity_type
the type of the activity as a number (0=in_vehicle, 1=on_bicycle, 2=on_foot, 3=still, 4=unknown, 5=tilting, 7=walking, 8=running)
activity_confidence
the confidence in a number from between 0=unconfident and 100=confident
activity_time
the time when the activity was originally detected
detected_activities
list of detected activities sorted by confidence (descending). Each item is a map containing activity_name, activity_type, activity_confidence.
Top

User Present

The trigger User Present executes the flow when the user activates the device and passed the unlock screen.

Example:
  • Start the browser when the device is unlocked at home.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

Voice Command Requested

The trigger Voice Command Requested is executed when the voice recognition by a bluetooth headset (or some other means) is requested.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
Top

WiFi Connected

The trigger WiFi Connected is executed when a connection with the defined network has been established.

 

Examples:
  • Download a file as soon as WiFi is available.
Settings
SSID List
The list of SSIDs to execute the flow when connected. The list can contain glob pattern characters like * and ?. Variables are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
bssid
the BSSID of the connected WiFi network
ssid
the SSID of the connected WiFi network
Top

WiFi Disconnected

The trigger WiFi Disconnected is executed when a connection with the defined network has been separated.

 

Examples:
  • Play an alert when WiFi is not available anymore.
  • Turn off flows causing big data transfers.
Settings
SSID List
The list of SSIDs to execute the flow when disconnected. The list can contain glob pattern characters like * and ?. Variables are supported.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
bssid
the BSSID of the disconnected WiFi network
ssid
the SSID of the disconnected WiFi network
Top

WiFi Scan Results Available

The trigger WiFi Scan Results Available is executed when the results of a WiFi access point scan are available.

 

Examples:
  • Connect to a free WiFi network when it becomes available.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
access_points
the list of available access points
Top

WiFi State

The trigger WiFi State is executed when the devices wireless network adapter changes to one of the defined states.

 

Examples:
  • Enable some download flows when WiFi is turned on
Settings
WiFi States
The accepted states.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
previous_wifi_state
the wifi state (0=disabling, 1=disabled, 2=enabling, 3=enabled, 4=unknown)
wifi_state
the wifi state (0=disabling, 1=disabled, 2=enabling, 3=enabled, 4=unknown)
Top

WiFi Tethering State

The trigger WiFi Tethering State is executed when the devices wireless network tethering setting changes to one of the defined states.

 

Examples:
  • Play a notification sound when tethering is enabled
Settings
WiFi Tethering States
The accepted states.
A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
previous_tethering_wifi_state
the wifi tethering state (10=disabling, 11=disabled, 12=enabling, 13=enabled, 14=failed) on older devices (0=disabling, 1=disabled, 2=enabling, 3=enabled, 4=failed)
wifi_tethering_state
the wifi tethering state (10=disabling, 11=disabled, 12=enabling, 13=enabled, 14=failed) on older devices (0=disabling, 1=disabled, 2=enabling, 3=enabled, 4=failed)
Top

Wired Headset Plugged

The trigger Wired Headset Plugged is executed when a wired headset or earphones have been connected or disconnected.

 

Examples:
  • Turn down the volume when the headset is connected.
Settings
Wired headset plugged/unplugged
Plugged
Execute the flow when the headset has been plugged.

Unplugged
Execute the flow when the headset has been unplugged.

A variable is a container for a value that can be used in many actions and conditions to dynamically define a part of a text.
See action Script for a description.

Supplied Variables
triggertime
the time the trigger executed
headset_type
the type of the headset
microphone
whether a microphone is available or not
Top