Skip to content

Automation

ars edited this page Mar 3, 2026 · 6 revisions

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.
  • 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)
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)
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

# 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"

Clone this wiki locally