Automation

Automation Guide

Maximize your convenience by automating the start and connection process.

1. Using Wireless Helper (Easiest)

The simplest way to automate the connection is using our companion app: Wireless Helper

1. Select your Car's Bluetooth device in the app.
2. Set Auto-Start to "On Bluetooth Connection".
3. The app will automatically wake up and trigger Android Auto as soon as your phone connects to your car.

2. Headless Operation (Helper Mode)

If you use Wireless Mode: Helper Mode (Settings -> General), HeadUnit Revived runs a background service on the tablet.

• The service listens for connection requests from your phone.
• Once a request is received, the app pops up automatically.
• Tip: Whitelist HeadUnit Revived in your tablet's "Battery Optimization" or "Auto-Start" settings.

3. Power Users: Tasker / MacroDroid / App Shortcuts

You can trigger actions using Android Intents or the new App Shortcuts (v1.15.0+).

App Shortcuts (Easiest for Samsung Modes & Routines)

Headunit Revived supports static shortcuts that are automatically detected by system automation tools:

• Connect: Automatically connects to the last known device.
• Disconnect: Safely ends the current session.
• Exit App: Safely ends the session, stops all background services, and completely closes the app.
• Mode: Day / Night / Auto: Directly controls the display theme.

Android Intents

If you have complex automation needs, you can use the following intent data:

• Action: android.intent.action.VIEW
• Package: com.andrerinas.headunitrevived
• Target: Activity (via AutomationActivity)

Useful Intents

Purpose	Action / Data
Connect to IP	headunit://connect?ip=192.168.x.x (URI)
Connect (Last Device)	headunit://connect (URI)
Disconnect Session	headunit://disconnect (URI)
Exit App	headunit://exit (URI)
Set Night Mode	headunit://nightmode?state=day|night|auto (URI)
Connect Action	com.andrerinas.headunitrevived.ACTION_CONNECT (Intent)
Disconnect Action	com.andrerinas.headunitrevived.ACTION_DISCONNECT (Intent)
Exit App Action	com.andrerinas.headunitrevived.ACTION_STOP_SERVICE (Intent)
Set Night Mode Action	com.andrerinas.headunitrevived.ACTION_SET_NIGHT_MODE (Intent)

Note for Intents: These are Activity-based intents. Use the state extra (String: day, night, or auto) when sending ACTION_SET_NIGHT_MODE.

ADB Examples

# Exit the application
adb shell am start -a android.intent.action.VIEW -d "headunit://exit"

# Set night mode
adb shell am start -a android.intent.action.VIEW -d "headunit://nightmode?state=night"

# Disconnect session
adb shell am start -a android.intent.action.VIEW -d "headunit://disconnect"