Automation Bridge

Automation Bridge allows Yasan Launcher and third-party apps such as Tasker to communicate through Android broadcasts.

This is a step-by-step setup guide for Automation Bridge. You can also use the llms.txt file for AI-assisted setup.

Available Functionalities

Outgoing Broadcasts: sending events to other apps
- Broadcast Space Changes: Notifying other apps when the active Space changes
- Broadcast Gestures: Notifying other apps when you perform a gesture
Incoming Commands: receiving commands from other apps
- Update Space: Other apps changing the active Space
- Update Settings: Other apps changing global or Space-specific settings

Outgoing Broadcasts

Broadcast Space Changes

To enable Space change broadcasts, follow the steps below:

Open Settings > Advanced > Automation Bridge
Enable Broadcast Space Changes
Make sure your automation app is whitelisted
Now the whitelisted apps receive a broadcast whenever the active Space changes

To listen to these broadcasts, follow the steps below:

General Guide

Listen for yasan.space.mnml.ai.launcher.action.ACTIVE_SPACE_CHANGED broadcast actions
Read the broadcast’s extras to get the details of the change, listed below

Tasker Guide

Open Tasker
Open Profiles tab
Tap the plus (+) button
Create a new Event
Select System Event category
Select Intent Received event
Set Action to yasan.space.mnml.ai.launcher.action.ACTIVE_SPACE_CHANGED
The extras below are available as local variables named after them, e.g. %space_id

The ACTIVE_SPACE_CHANGED broadcast contains these extras:

Extra	Meaning	Possible values
`space_id`	New active Space ID	`home`, `commute`, `away`, `active`, `school`, `work`, `focus`, `morning`, `night`
`set_by`	How the Space was activated	`user`, `time`, `location_enter`, `location_exit`, `external`
`changed_at`	Change time	Unix time in milliseconds
`previous_space_id`	Previously active Space ID	`home`, `commute`, `away`, `active`, `school`, `work`, `focus`, `morning`, `night`
`previous_set_by`	How the previous Space was activated	`user`, `time`, `location_enter`, `location_exit`, `external`
`previous_changed_at`	When the previous Space became active (if available)	Unix time in milliseconds

Broadcast Gestures

To enable gesture broadcasts, follow the steps below:

Open Settings > Advanced > Automation Bridge
Enable Allow Broadcasting Gestures
Make sure your automation app is whitelisted
Open Settings > Gestures
Tap the gesture you want to broadcast and select Broadcast action
Now the whitelisted apps receive a broadcast when this gesture is triggered

To listen to these broadcasts, follow the steps below:

General Guide

Listen for yasan.space.mnml.ai.launcher.action.GESTURE_TRIGGERED broadcast actions
Read the gesture_id extra to identify the gesture, listed below

Tasker Guide

Open Tasker
Open Profiles tab
Tap the plus (+) button
Create a new Event
Select System Event category
Select Intent Received event
Set Action to yasan.space.mnml.ai.launcher.action.GESTURE_TRIGGERED
The %gesture_id local variable lets you identify the gesture, listed below

The gesture_id value identifies the gesture:

Gesture	`ID`
1-finger swipe down	`swipe_down`
2-finger swipe down	`two_finger_swipe_down`
3-finger swipe down	`three_finger_swipe_down`
1-finger swipe up	`swipe_up`
2-finger swipe up	`two_finger_swipe_up`
3-finger swipe up	`three_finger_swipe_up`
1-finger swipe left	`swipe_left`
2-finger swipe left	`two_finger_swipe_left`
3-finger swipe left	`three_finger_swipe_left`
1-finger swipe right	`swipe_right`
2-finger swipe right	`two_finger_swipe_right`
3-finger swipe right	`three_finger_swipe_right`
Double tap	`double_tap`

Whitelist

Broadcast Whitelist allows you to select which apps should receive the broadcasts from Yasan Launcher. It appears when either Broadcast Space Changes or Allow Broadcasting Gestures is enabled, and the same list applies to both.

Open Settings > Advanced > Automation Bridge
Open Broadcast Whitelist
Select apps you want to whitelist for broadcasts
Now only these whitelisted apps receive the broadcasts

Notes

The whitelisted apps are matched using the package name and their signature. This means if you whitelist a trusted app, and later it is replaced with an app that has the same package name but a different signature, the whitelist is no longer valid and that app will not receive the broadcasts.
Yasan Launcher verifies the signature of the official Tasker and Automate apps based on the signature of their Play Store release. If the signature does not match, a warning is shown about the app possibly being modified and unsafe to use.

Incoming Commands

Update Space

To enable updating spaces in other apps, follow the steps below:

Open Settings > Advanced > Automation Bridge
Enable Accept External Commands

To send space update commands to Yasan Launcher, follow the steps below:

General Guide

Send a broadcast to the yasan.space.mnml.ai.launcher package with action yasan.space.mnml.ai.launcher.action.SET_ACTIVE_SPACE
Include the extra password, set to your password
Include the extra space_id, set to one of the Space IDs listed below

Tasker Guide

Open Tasker
Open Tasks tab
Tap the plus (+) button
Name your task as you wish, e.g. “Update Yasan Launcher Space”
Confirm the task name which opens the Task Edit screen
Tap the plus (+) button
Select System category
Select Send Intent action
Set Target to Broadcast Receiver
Set Package to yasan.space.mnml.ai.launcher
Set Action to yasan.space.mnml.ai.launcher.action.SET_ACTIVE_SPACE
Add extra password:<YourPassword>, your password
Add extra space_id:<space>, one of the Space IDs listed below

Set space_id to one of these values:

Space	`ID`
Home	`home`
Commute	`commute`
Away	`away`
Active	`active`
School	`school`
Work	`work`
Focus	`focus`
Morning	`morning`
Night	`night`

Notes

The space must be enabled, otherwise the command is ignored.
The Morning & Night Spaces are special spaces that are automatically disabled outside their predefined schedule. This is planned to change soon .

Update Settings

To enable updating settings in other apps, follow the steps below:

Open Settings > Advanced > Automation Bridge
Enable Accept External Commands

To send setting update commands to Yasan Launcher, follow the steps below:

General Guide

Send a broadcast to the yasan.space.mnml.ai.launcher package with action yasan.space.mnml.ai.launcher.action.SET_SETTING
Include the extra password, set to your password
Include the extra setting_id, set to the setting to change, listed below
Include the extra value, set to the new value as text
Include the extra space_id only when changing a setting that supports a Space-specific override

Tasker Guide

Open Tasker
Open Tasks tab
Tap the plus (+) button
Name your task as you wish, e.g. “Update Yasan Launcher Setting”
Confirm the task name which opens the Task Edit screen
Tap the plus (+) button
Select System category
Select Send Intent action
Set Target to Broadcast Receiver
Set Package to yasan.space.mnml.ai.launcher
Set Action to yasan.space.mnml.ai.launcher.action.SET_SETTING
Add extra password:<YourPassword>, your password
Add extra setting_id:<setting>, one of the settings listed below
Add extra value:<value>, the new value as text
Add extra space_id:<space> only when changing a setting that supports a Space-specific override

Send all values as text. Send value as an empty string to reset the setting.

Supported settings

A checked box means the setting supports a Space-specific override.

Setting	`setting_id`	Supports Space	Accepted values
Streamer Mode	`streamer_mode`	check_box_outline_blank	`true`, `false`
Notification Dots	`notification_dots`	check_box	`true`, `false`
Notification Dot Color	`notification_dot_color`	check_box	`content`, `information`, `caution`, `danger`, `success`
Show Wallpaper	`show_wallpaper`	check_box	`true`, `false`
Auto Adaptive Icons	`auto_adaptive_icons`	check_box	`true`, `false`
Theme Grayscale	`theme_grayscale`	check_box	`true`, `false`
Icon Pack	`icon_pack`	check_box	`system` or the package name of an installed icon pack app
Orientation	`orientation`	check_box_outline_blank	`system`, `portrait`, `landscape`
Icon Shape	`icon_shape`	check_box	`system`, `circle`, `rounded_square`, `square`, `squircle`
Primary Theme	`theme_palette`	check_box	A Theme ID , or `system` when set globally (without `space_id`)
Light Theme	`theme_light_palette`	check_box_outline_blank	A Theme ID
Dark Theme	`theme_dark_palette`	check_box_outline_blank	A Theme ID

Notes

Setting theme_palette to system means the Follow System theme setting is enabled; the active theme switches between theme_light_palette and theme_dark_palette depending on the system dark mode.
Setting a theme setting to system is only accepted for the global primary theme setting. Space-specific settings do not support changing based on system dark mode.

Supported Themes

Theme	`ID`
Light	`light`
Dark	`dark`
Black	`black`
Solarized Dark	`solarized-dark`
Solarized Light	`solarized-light`
Catppuccin Frappé	`catppuccin-frappe`
Catppuccin Latte	`catppuccin-latte`
Catppuccin Macchiato	`catppuccin-macchiato`
Catppuccin Mocha	`catppuccin-mocha`
Gruvbox Dark	`gruvbox-dark`
Gruvbox Light	`gruvbox-light`

These themes are from Kepko , the open-source design system Yasan Launcher uses.

Password

All commands sent to Yasan Launcher need to include a valid password, otherwise they are rejected.

Open Settings > Advanced > Automation Bridge
Copy the auto-generated password by tapping the Copy Password button

Include this password in every incoming command:

General Guide

Include the extra password, set to the copied password

Tasker Guide

Add extra password:<YourPassword>

Notes

You can regenerate the password from the Automation Bridge settings using the Regenerate Password button. This will invalidate the previous password, and you will have to update all your automations to use the new password.
This password is only stored on-device and is encrypted.

Footnotes

At the moment, these APIs are experimental and may change without backwards compatibility.
Additional features such as logs to ease debugging, and additional commands are planned for the future .
Automation Bridge is publicly available on Yasan Launcher 26.32-4577 and later.
If you are having issues with Automation Bridge or have feedback, feel free to open an issue on the official issue tracker .