Conditions

 





Conditions

Active CyanogenMod Profile

The condition Active CyanogenMod Profile checks whether one of the listed profiles is active.

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

 

Examples:
  • Play a sound only when the active profile is not Cinema
Settings
Profile Name List
The profile names to check. Glob patterns (*, ?) are supported. 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
profile_name
the name of the active profile
Top

Active Network Type

The condition Active Network Type checks if a network (usually WiFi or Mobile) is active and usable for data traffic.

 

Examples:
  • Execute a download action only when the current active network is WiFi
Settings
Network Type
Defines for what network types the condition should be true
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
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

Airplane Mode On

The condition Airplane Mode On checks whether the airplane mode is on or not.

 

Examples:
  • Only download a file when airplane mode is turned off.
Top

Android Wear Device Connected

The condition Android Wear Device Connected checks whether a particular Android Wear device is currently connected to the main device.

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

 

Examples:
  • Play a notification shound only when not connected to the Android Wear device.
Settings
Android Wear device
The target device. 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
node_id
the ID of the Wear node
node_name
the name of the Wear device
Top

App Process Running

The condition App Process Running checks whether the process hosting an app is currently running.

Note: Android keeps processes in memory even when the process might not be required anymore and enough free memory is available.

Note: The official API used to access this information has been removed by Google on Android 5.1.1 which means that the condition is now marked as not officially supported.
Note: The unofficial workarounds to access this information don't work anymore on most devices running Android 7.

Settings
Package Name
The name of the process to check. 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
pid
the id of the process
importance (Android <5.1.1)
the importance of the process. The smaller the value the higher the importance.
lru (Android <5.1.1)
least recently used. Smaller value means more recently used.
process_state (not available on all versions of Android, Android <5.1.1)
State of the process (2=Process hosting the current top activities)
uid
the user id of the process
Top

App Task Running

The condition App Task Running checks whether a task for one of the specified packages is currently running.

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

Settings
Package Name
The name of the app to check. Glob patterns (*, ?) are supported. Variables are supported.
check most recent app task only
if only the most recent app task should be checked (this is the active app on many Android versions)

Warning: This option must be activated on Android 5+.
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
package_name
the package name of the foreground app
index (not available on Android 5+)
the index of this task. An index of zero denotes the most recent running task.
base_activity (not available on Android 5+)
the component launched as the first activity in the task
top_activity (not available on Android 5+)
the activity component at the top of the history stack of the task
id (not available on Android 5+)
a unique identifier for this task
num_running (not available on Android 5+)
the number of activities that are currently running (not stopped and persisted) in this task
description (not available on Android 5+)
a description of the task's current state
Top

Audio Manager Mode

The condition Audio Manager Mode checks whether the device is currently configured to use the desired audio manager mode.

Settings
Audio Manager Mode
The desired audio manager mode to check.
Top

Audio Stream Active

The condition Audio Stream Active checks if the defined audio stream is currently in active use.

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

 

Examples:
  • check if a ringtone is currently played
Settings
Audio Stream Type
The type of audio stream to check.
Top

Audio Volume

The condition Audio Volume checks whether the volume of the selected stream type is above or below a certain level.

 

Examples:
  • Execute a vibrate action only when the music volume is very low
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.
Top

Auto Sync Enabled

The condition Auto Sync Enabled checks whether the automatic synchronisation is turned on or off either globally (the master switch) or for a specific account/authority.

 

Examples:
  • Check the current state of auto sync to toggle the setting to the opposite value
Settings
Global or Specific
Whether the global master switch should be checked or a specific account/authority.
Account
The account to check in format Type:Name. Variables are supported.
Authority
The part/database of the account to check. Variables are supported.
Top

Auto-rotate Screen Enabled

The condition Auto-rotate Screen Enabled checks whether the system setting to automatically rotate the screen is enabled or not.

Top

Battery Level

The condition Battery Level checks whether the battery level is above or below a certain level.

 

Examples:
  • Download a file only when the battery level is above 50%.
Settings
Battery Level
Defines the condition that must be met to continue the flow on the true branch:

lower than
true when the reported percentage by the system is below the defined level

higher than
true when the reported percentage by the system is above the defined level

exactly
true when the reported percentage by the system is exactly on the defined level

full
true when the reported battery status by the system is 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
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 condition Battery Level (Android Wear) checks whether the battery level is above or below a certain level.

 

Examples:
  • Download a file only when the battery level is above 50%.
Settings
Android Wear device
The target device. Variables are supported.
Battery Level
Defines the condition that must be met to continue the flow on the true branch:

lower than
true when the reported percentage by the system is below the defined level

higher than
true when the reported percentage by the system is above the defined level

exactly
true when the reported percentage by the system is exactly on the defined level

full
true when the reported battery status by the system is 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
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 Level BLE (Experimental)

The condition Battery Level BLE (Experimental) checks the battery level of a Bluetooth LE device that supports the standardized Battery service.

Warning: Bluetooth LE is not working reliable on many Android ROMs. Restarting the device or turning Bluetooth off and on again can help when the condition does not work.

 

Examples:
  • Check once a week if the battery of the Polar heart rate sensor is still OK.
Settings
Bluetooth Device Address
The address of the bluetooth device. Variables are supported.
Bluetooth Device Name
The name of the bluetooth device.
Battery Level
Defines the condition that must be met to continue the flow on the true branch:

lower than
true when the reported percentage by the device is below the defined level

higher than
true when the reported percentage by the device is above the defined level

exactly
true when the reported percentage by the device is exactly on the defined level

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
battery_level
the charging level of the battery
battery_percentage
the charging percentage
Top

Battery Saver Mode Enabled

The condition Battery Saver Mode Enabled checks whether the battery saver mode is active or not (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 Init Variable System Setting on such devices.

 

Examples:
  • Execute a battery hungry flow only when the battery saver mode is not active.
Top

Bluetooth Device Connected

The condition Bluetooth Device Connected checks whether a connection to a Bluetooth device exists.

Warning: This function is not directly supported by Android. The list of currently connected Bluetooth devices is collected using connect/disconnect events reported to Automagic. Under certain circumstances, the list of connected devices might not correspond to the list of really connected devices, for example when Automagic is freshly installed and a bluetooth device was already connected. In such cases, the bluetooth adapter must be disabled temporarily and reenabled in the preferences of Android to force the Bluetooth devices to reconnect.

 

Examples:
  • Turn on WiFi in the evening only when one of the Bluetooth devices at home is connected.
Settings
Bluetooth Device
Defines whether the condition should check if at least one connection to a device exists or if the condition should check a specific device.
Bluetooth Device Address
The address of the bluetooth device. Variables are supported.
Bluetooth Device Name
The name of the bluetooth device.
Bluetooth Profile
Defines the type of connection to check. Not all device support all types.
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
connected_devices_addresses
list of addresses of the connected devices
connected_devices_names
list of names of the connected devices
Top

Bluetooth Enabled

The condition Bluetooth Enabled checks whether bluetooth is turned on or off.

 

Examples:
  • Open an app when bluetooth is turned on.
Top

Bluetooth LE Device Available

The condition Bluetooth LE Device Available executes a BT LE scan to test if a device is currently available.

 

Examples:
  • Scan every 10 minutes if a BT LE beacon is available to turn WiFi on at home.
Settings
Bluetooth Device Address
The address of the bluetooth device. Variables are supported.
Bluetooth Device Name
The name of the bluetooth device.
Timeout
The maximum duration of the scan. 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
rssi
measured signal strength, 0 when not available
Top

Bluetooth SCO On

The condition Bluetooth SCO On checks whether communications use Bluetooth SCO or not.

Top

Calendar Event

The condition Calendar Event checks, whether an event on the calendar is currently active.

 

Examples:
  • Send an SMS to the calling number telling when your meeting ends
  • Don't let the SMS be read aloud in a meeting
Settings
Starting
The start time offset the condition should consider an event as active.
Ending
The end time offset the condition should consider an event as active.
Calendars
A comma separated list of calendar names that should be checked for events. The values can contain glob pattern characters like * and ?. Variables are supported.
Titles
A comma separated list of event titles to match. The values can contain glob pattern characters like * and ?. Variables are supported.

Examples:
  • Plan* matches titles like Planning, Plan B etc.
Descriptions
A comma separated list of event descriptions to match. The values can contain glob pattern characters like * and ?. Variables are supported.
Locations
A comma separated list of event locations to match. The values can contain glob pattern characters like * and ?. Variables are supported.
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.
Multiple Events
The event that should be preferred to fill the variables when multiple events match the defined criteria of the condition.
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
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

Call State

The condition Call State checks whether a call is currently active or not.

Settings
Phone state
The accepted states.

Note: State Ringing is only valid for incoming calls, an outgoing call directly changes the state from Idle to Off-hook
Top

Confirmation Dialog

The condition Confirmation Dialog shows a dialog with a question and continues flow execution depending on the button pressed.

 

Examples:
  • Turn on bluetooth but ask for confirmation first.
Settings
Title
The optional title of the dialog. Variables are supported.
Question
The text of the question to ask. Variables are supported.
False Button / True Button
The text labels of the buttons that execute the true/false-branch of the condition. Variables are supported.
Behavior on Back button
Whether to ignore the back button or to confirm the dialog with true or false.
Activate Timeout
Whether an automatic timeout should be used when the user does not react within the specified time.
Duration
The amount of time to automatically close the dialog and to continue the flow.
Value on Timeout
Whether the flow should be continued on the true- or false-branch.
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
operation
the operation used to close the dialog.

Can be one of:
  • yes when the user pressed the Yes-button
  • no when the user pressed the No-button
  • timeout when the dialog was closed by a timeout
Top

Debug Dialog

The condition Debug Dialog shows a dialog containing all variables and the corresponding values in a dialog. Buttons can be used to control if the condition continues at true or false.

 

Examples:
  • Debug a complex flow.
Top

Device Idle/Doze Mode Active

The condition Device Idle/Doze Mode Active checks if the device is currently in idle/doze mode.

 

Examples:
  • Only male network access from a flow when the device is not in idle/doze mode to save battery.
Top

Device Orientation

The condition Device Orientation checks whether the device is in one of the specified orientation.

 

Examples:
  • Beep every 5 minutes when recording your time but only when the device display is not 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.
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
accel_x
the measured acceleration in m/s^2 on the X-axis
accel_y
the measured acceleration in m/s^2 on the Y-axis
accel_z
the measured acceleration in m/s^2 on the Z-axis
Top

Device Storage Space

The condition Device Storage Space checks the storage space on the filesystem containing the specified path.

Example:
  • Check every morning if 100MB are still free on the SD card.
Settings
Filesystem
The path of the filesystem to check. Variables are supported.
Compare Free or Used Space
Whether to check the free or used space on the filesystem.
Size
The size 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
available_blocks
the number of free blocks available to applications
free_blocks
the number of free blocks inclusive reserved blocks not usable by applications
block_count
the total number of blocks in the filesystem
block_size
the size of the blocks in bytes
available_space
the available space in bytes
used_space
the used space in bytes
Top

Device Storage Space Low

The condition Device Storage Space Low checks whether the free space of the internal memory of the device is low.

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 every 5 minutes when the device storage space is low.
Top

Dock State

The condition Dock State checks whether the device is in one of the docking states or not.

Settings
Dock States
The accepted docking states.
  • Docked Car: in a car dock
  • Docked Desk: in a desk dock
  • Docked Desk (High End, Digital): in a high end, digital dock
  • Docked Desk (Low End, Analog Dock): in a low end, analog dock
  • Docked Special: in a special dock like a hardware keyboard for an ASUS Transformer
  • Undocked: not in a dock
Top

Execution Count

The condition Execution Count checks whether the condition has been executed a certain amount of times. An internal counter is incremented whenever the condition is executed. The counter is reset to zero when to condition is met.

 

Examples:
  • Play an alarm when 2 SMS are received in 5 minutes.
  • Turn off the screen when the device is shook 2 times in 10 seconds.
Settings
Count
The count to compare. Variables are supported.
Timed
Only consider executions that happened within the given duration.
Duration
The maximum age of executions to consider.
Top

Expression

The condition Expression checks whether the expression is true or not.

Example Expressions:
  • a==1
  • b > =3
  • c < b AND a > 3
  • (a--)==0
  • startsWith(a, "test")
  • a > addDays(b, 4)
  • isEmpty(files)

 

Examples:
  • Check if the accuracy of a location is good enough: location_accuracy<300
  • Check if a counter reached zero: counter==0
See action Script for a description of the scripting language.
Settings
Expression
The expression to evaluate.

Note: Variables can be used directly in an expression and don't need to be escaped using curly braces.

Example: use location_accuracy instead of {location_accuracy}.
Top

Flashlight On

The condition Flashlight On checks if the flashlight has been turned on by Automagic.

Warning: This condition can only check if the flashlight was turned on by Automagic but not if the flashlight has been turned on by another app.

Top

Flow Enabled

The condition Flow Enabled checks whether a flow is enabled or disabled.

Settings
Flow Name
The exact name of the flow to check. Variables are supported.
Top

Flow Executing

The condition Flow Executing checks if a particular flow is currently executing.

 

Examples:
  • Don't execute a flow when the flow is already executed.
Settings
Flow Name
The name of the flow to check. 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
flow_execution_contexts
how many times the flow is currently executing
Top

Gleeo is Recording

The condition Gleeo is Recording checks whether Gleeo Time Tracker is currently recording a specific project or task.

Settings
Domain Filter List
A comma separated list of the domains to accept. Variables are supported.
Project Filter List
A comma separated list of the projects to accept. Variables are supported.
Task Filter List
A comma separated list of the tasks to accept. Variables are supported.
Top

Gmail Unread Conversation Count

The condition Gmail Unread Conversation Count checks the number of unread conversations available in the Gmail app on the device.

 

Examples:
  • Play an alert sound every 5 minutes when unread conversations are available
Settings
Condition
Defines the condition that must be met to continue the flow on the true branch:

lower than
true when the reported count is below the defined count

higher than
true when the reported count is above the defined count

exactly
true when the reported count is exactly matches the defined count
Unread Count
The number to compare in the condition.
Accounts
The accounts to check. The sum of unread conversations is checked when multiple accounts are specified. The values 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
count
the number of unread conversations
Top

Host Reachable

The condition Host Reachable tests whether a host can be reached by either opening a TCP-connection using a socket or by executing a ping command.

 

Examples:
  • Check once an hour if a server can be reached or not.
Settings
Type
Type of the check:
  • Automatic: Tries to connect to the host to port 7 to determine if the host is available. This method might use ping on some versions of Android.
  • Socket: Tries to establish a TCP-connection to the specified host and port. The host is only considered to be reachable when the connection can be successfully established.
  • Ping: Checks the reachability of the host using a ping-command (only one echo-request is sent). This option only works when the ping-command is available on the device.
Host
The host to check. Variables are supported.
Port
The port to connect to (only for type=Socket). Variables are supported.
Top

Interruptions Mode

The condition Interruptions Mode checks if the device is in the specified interruption mode.

 

Examples:
  • Only speak out an SMS when all interruptions are allowed.
Settings
Interruptions Mode
The mode to check.
Top

Keyguard Locked

The condition Keyguard Locked checks whether or not the keyguard is currently active/showing.

Top

Keyguard with Security

The condition Keyguard with Security checks whether a keyguard/lockscreen with a security element (PIN, password, ...) or not (None, Swipe) is set.

Top

Light Sensor

The condition Light Sensor checks whether the measured value of the light sensor is below or above the defined level.

Warning: Some devices turn off the sensors when the screen is off.
Warning: Some devices can not determine the current value of the sensor and only deliver a value when the measured value of the sensor changes. This condition does not work on such devices.

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.
Timeout
The amount of time to wait for a value of the sensor, the condition is terminated with an error when no value 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
light_level
the effective illuminance in lux
Top

Location

The condition Location checks whether a location is inside a specific area or not. The condition can also check if an area is entered or exited by comparing the location of the last execution and the current location.

The condition uses the location already made available to the flow from a location trigger or uses the last known location of the system.
The condition fails when no location is available in the flow and the device does not have a last known location ready. This usually happens when the flow is executed manually. Either use one of the location triggers to execute your flow or explicitly acquire the location using an action Init Variable Location before the condition is reached.

 

Examples:
  • Enable WiFi when you enter your office.
  • Stop recording in Gleeo Time Tracker when you leave your office.
Settings
Location
The location used by this condition.
Location Name
The name to use for this location. This name is used in the condition name and to select an existing location on the map.
Radius
The radius around the location in meters.
Entering
True when the location was outside the defined location and is inside now.
Exiting
True when the location was inside the defined location and is outside now.
Ignore when previous state was not known
Ignore entering/exiting when the location has not been known before. This is usually the case when the flow is executed for the first time after starting Automagic.
Inside
True when the location is inside. This is also true when the location has been inside before and therefore is possibly true for every location provided by a 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
location
the reported location
location_name
the name of the location
entering
whether the location has been entered or not
exiting
whether the location has been exited or not
inside
whether the location is inside the defined area or not
Top

Location Entering

The condition Location Entering checks whether an area has been entered or exited. This condition should only be used in conjunction with a Location trigger.

 

Examples:
  • Enable WiFi when entering a location, disable WiFi when exiting the location.
  • Start recording in Gleeo Time Tracker when coming to the office, stop recording when exiting the office.
Settings
Entering/Exiting
Whether the condition should be true when entering or when exiting the location.
Top

Location Provider Enabled

The condition Location Provider Enabled checks whether a particular location provider like GPS is enabled or not.

 

Examples:
  • Report your location per SMS only when GPS is active.
Settings
Location Provider
The location provider to check.

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.

Top

Magnetic Field Sensor

The condition Magnetic Field Sensor checks whether the measured value of the magnetic field sensor is below or above the defined level.

Warning: Some devices turn off the sensors when the screen is off.
Warning: Some devices can not determine the current value of the sensor and only deliver a value when the measured value of the sensor changes. This condition does not work on such devices.

 

Examples:
  • Execute some actions only when the device is placed near a magnet.
Settings
Sensitivity
The sensitivity of the slider to define the field strength.
Magnetic Field Strength
Whether the trigger should execute when the illuminance passes above or below a certain value and the level to use.
Timeout
The amount of time to wait for a value of the sensor, the condition is terminated with an error when no value 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
magnetic_field_strength
the measured strength in micro Tesla
Top

Microphone Mute

The condition Microphone Mute checks whether the microphone is currently muted.

 

Examples:
  • Play a warning sound when the microphone is mute.
Top

Mobile Datanetwork Enabled

The condition Mobile Datanetwork Enabled checks whether the mobile datanetwork is turned on or off.

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

 

Examples:
  • Open an app when the mobile datanetwork is turned on.
Top

Mobile Datanetwork Type

The condition Mobile Datanetwork Type checks if the current datanetwork type matches one selected in the list.

 

Examples:
  • Download a PDF only when the network type is UMTS or LTE
Settings
Network Type
The network types 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
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

Music Active

The condition Music Active checks whether the music audio stream is currently in use.

 

Examples:
  • Turn down the media volume when entering a location and the music is playing.
Top

Network Connected

The condition Network Connected checks if a network connection is currently available.

 

Examples:
  • Check that a network connection is available before sending a mail.
Top

NFC Enabled

The condition NFC Enabled checks whether NFC is turned on or off.

 

Examples:
  • Play an alert sound when NFC is turned off when you enter the office.
Top

Night Mode

The condition Night Mode checks whether the device is currently configured to use the desired night mode.

Settings
Night Mode
The accepted night modes.
Top

Notification on Statusbar Displayed

The condition Notification on Statusbar Displayed checks whether a notification of an app is displayed in the statusbar and supplies the information of the first matching notification as variables to the flow.

 

Examples:
  • Check every 5 minutes if an Hangout message is displayed in the statusbar and play a notification sound
Settings
Package Name
The comma separated list of apps that displayed the notification. Glob patterns can be used to match multiple packages. Variables are supported.
Notification ID
The ID of the notification. Variables are supported.
Filter
Defines the text that must be contained in one of the available fields. Variables are supported for contains text and matches glob.
Ignore regular events
Defines whether or not the condition should ignore 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 condition should ignore 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
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 (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 (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
the id of the notification
buttons (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
count
the number of notifications matching the condition
Top

Phone Cell CDMA

The condition Phone Cell CDMA checks whether the phone is connected to one of the specified cells of interest.

 

Examples:
  • Turn on WiFi when the phone cell at home is detected
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.
Cell List
A comma separated list of cell IDs. Glob patterns (*, ?) are supported. 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
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.
Top

Phone Cell GSM

The condition Phone Cell GSM checks whether the phone is connected to one of the specified cells of interest.

 

Examples:
  • Turn on WiFi when the phone cell at home is detected
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.
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.
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
lac
the currently connected location area code (LAC), -1 if unknown
cid
the currently connected cell ID (CID), -1 if unknown
psc
the primary synchronization code (PSC), -1 if unknown
neighboring_cells
the list of neighboring cells. Null or empty if not available
Top

Phone Service State

The condition Phone Service State checks whether the phone service is currently available, unavailable or only emergency calls can be placed.

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

Settings
Phone Service state
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
service_state
the 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 condition Phone Signal Strength checks whether the signal strength of the mobile network is above or below a certain level.
Warning: Some devices don't send the current signal strength to applications when the screen is turned off. You can use the options to periodically turn the screen on or wake the device.

 

Examples:
  • Beep every five minutes when the network strength is very weak
Settings
Signal Strength Condition
Defines the condition that must be met to execute the flow:

lower than
true when the reported signal strength by the system is below the defined level

higher than
true when the reported signal strength by the system is above the defined level

exactly
true when the reported signal strength by the system is exactly on the defined level
Signal Strength
Defines the signal strength 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
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)
Top

Plugin (Experimental)

The condition Plugin (Experimental) checks the condition of a plugin.

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.
replace variables/modify configuration
Script to dynamically replace variables and to modify the configuration passed to the plugin.
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
Tasker variables
takes over the local Tasker variables returned by the plugin (without leading %-character)
Top

Power Source Connected

The condition Power Source Connected checks whether the device is currently connected to a power source.

 

Examples:
  • Turn on WiFi only when the device is connected to an AC adapter.
Settings
Power connected/disconnected
Connected
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 no power source is connected.

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
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 Connected (Android Wear)

The condition Power Source Connected (Android Wear) checks whether the device is currently connected to a power source.

 

Examples:
  • Turn on WiFi only when the device is connected to an AC adapter.
Settings
Android Wear device
The target device. Variables are supported.
Power connected/disconnected
Connected
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 no power source is connected.

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
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 condition Pressure Sensor checks whether the measured pressure is below or above the defined value.

Warning: Some devices turn off the sensors when the screen is off.
Warning: Some devices can not determine the current value of the sensor and only deliver a value when the measured value of the sensor changes. This condition does not work on such devices.

Settings
Pressure (in mbar)
Whether the condition should check if the pressure is above or below the defined pressure.
Timeout
The amount of time to wait for a value of the sensor, the condition is terminated with an error when no value 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
pressure
the measured pressure in mbar
Top

Proximity Sensor

The condition Proximity Sensor checks whether the measured distance of the proximity sensor is below or above the defined distance.

Warning: Some devices turn off the sensors when the screen is off.
Warning: Some devices can not determine the current value of the sensor and only deliver a value when the measured value of the sensor changes. This condition does not work on such devices.

Settings
Distance (in cm)
Whether the condition should check if the distance is above or below the defined distance and the distance in cm.
Timeout
The amount of time to wait for a value of the sensor, the condition is terminated with an error when no value 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
proximity
the measured value of the proximity sensor
Top

Ringer Mode

The condition Ringer Mode checks whether the device is currently configured to use the desired ringer mode.

Settings
Ringer Mode
The desired ringer mode to check.
Top

Roaming

The condition Roaming checks whether you are currently in a roaming location.

 

Examples:
  • Only download a file when you are not using a more expensive roaming tariff.
Top

Screen Automatic Brightness Enabled

The condition Screen Automatic Brightness Enabled checks whether the setting to change the display brightness automatically depending on the environment is turned on or not.

Top

Screen On

The condition Screen On checks whether the screen is currently turned on.

 

Examples:
  • Show an alert only when the display is on.
Top

Screen Orientation

The condition Screen Orientation tests whether the device is currently in portrait or landscape mode.

Settings
Portrait or Landscape
Whether the condition should check for portrait or landscape.
Top

Service Running

The condition Service Running checks whether the specified service is currently running.

Settings
Service Class
The class name of the service to check. 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
package_name
the package name of the service
service_name
the display name of the service
pid
the process this service is running in
uid
the user id owning this service
active_since
the time this service has been started (in milliseconds since the device was booted)
last_activity_time
the time this service was last active (in milliseconds since boot not counting sleep phases)
restarting
the time when this service will be started, 0 when the service is currently running
foreground
true when the service is run as a foreground process
Top

Sound Level (Experimental)

The condition Sound Level (Experimental) checks whether or not the environment sound 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
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
sound_level
the detected sound level
Top

Speakerphone On

The condition Speakerphone On checks whether speakerphone is turned on or off.

Top

Telephony Radio Enabled

The condition Telephony Radio Enabled checks if the radio of the phone is enabled or not.

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

 

Top

Theater Mode On (Android Wear)

The condition Theater Mode On (Android Wear) checks whether the theater mode is turned on or not.

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

Settings
Android Wear device
The target device. Variables are supported.
Top

Time Range

The condition Time Range is true when the current time is in the defined time range.

 

Examples:
  • Play an alert only during the day.
Settings
Weekdays
The day on which the condition should check the time range.
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.
Top

UI Mode

The condition UI Mode checks whether the device is currently in car, desk, TV or normal UI mode.

Note: Many devices only support the normal UI mode.

Settings
UI Mode
The UI mode to check.
Top

USB Tethering Enabled

The condition USB Tethering Enabled checks whether USB tethering is enabled or not.

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

Top

Vibrate on Ring Enabled

The condition Vibrate on Ring Enabled checks whether the setting to vibrate on ring is enabled or not.

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

Top

WiFi Access Point Enabled

The condition WiFi Access Point Enabled checks whether a WiFi configuration is enabled and the system is allowed to connect to this access point.

 

Settings
SSID
The SSID to check. Variables are supported.
Top

WiFi Available

The condition WiFi Available checks whether one specific WiFi access point is currently available. The condition waits for the first available scan result when wifi has just been enabled and no scan result is available yet.

 

Examples:
  • Check if a specific free access point is available and enable this one.
Settings
SSID List
The comma separated list of SSIDs to accept. The condition is true when one of the access points in the list is available. Glob patterns can be used to match multiple SSIDs. Variables are supported.
The variables supplied by the condition relate to the available access point with the highest signal strength.
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
access_points
the list of available access point SSIDs
bssid (only set when the SSID is available)
the BSSID of the available access point
bssids (only set when the SSID is available)
the list of BSSIDs of the available access points
ssid (only set when the SSID is available)
the SSID of the WiFi network
capabilities (only set when the SSID is available)
the capabilities of the WiFi network
frequency (only set when the SSID is available)
the frequency of the WiFi network
level (only set when the SSID is available)
the signal strength level of the WiFi network
Top

WiFi Connected

The condition WiFi Connected checks whether the device is currently connected to one of the specified WiFi networks.

 

Examples:
  • Start recording in Gleeo Time Tracker when you are in the office and connected to the wireless network.
  • Enable a flow downloading big PDF files only when connected to your free wireless network at home.
Settings
SSID List
The comma separated list of SSIDs to accept. Glob patterns can be used to match multiple SSIDs. 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
bssid
the BSSID of the connected WiFi network
ssid
the SSID of the connected WiFi network
Top

Wifi Signal Level

The condition Wifi Signal Level checks the signal level of the connected wifi network.

Note: The current signal strength has to be measured using a wifi scan when the display is turned off. A wifi scan can take a few seconds and increases battery consumption.

Settings
Signal Level Condition
Defines the condition that must be met to continue the flow on the true branch:

lower than
true when the reported level by the system is below the defined level

higher than
true when the reported level by the system is above the defined level

exactly
true when the reported level by the system is exactly on the defined level
Signal Level
Defines the level to compare (usually in range 0-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
rssi
the signal strength in dBm
signal_strength_level
the signal strength mapped to levels (usually in range 0-4)
Top

WiFi State

The condition WiFi State checks whether the device wireless network adapter is in the specified state.

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
wifi_state
the wifi state (0=disabling, 1=disabled, 2=enabling, 3=enabled, 4=unknown)
Top

WiFi Tethering State

The condition WiFi Tethering State checks whether the device wireless network adapter is in the specified state.

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
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 condition Wired Headset Plugged checks whether a wired headset is currently plugged in or not.

 

Examples:
  • Turn the volume to maximum only when the headset is not plugged.
Top