Android Intents

Beeper Android supports Android Intents that allow other apps, automation tools like Tasker, or command-line tools to interact with and control certain Beeper features. This enables powerful automation and integration possibilities.

Supported intents

Toggle incognito mode

Control Beeper’s incognito mode programmatically from external sources.

• Requires Beeper Android version 4.31.1 or later
• Requires a Beeper Plus or PlusPlus subscription to enable Incognito Mode

Intent details:

• Action: com.beeper.android.TOGGLE_INCOGNITO_MODE
• Component: com.beeper.android/com.beeper.ext.ExternalBroadcastReceiver
• Extra: enabled (boolean) - true to enable, false to disable incognito mode

Usage examples

Android App (Kotlin)

import android.content.Intent
import android.content.ComponentName

// Enable incognito mode
fun enableIncognitoMode() {
    val intent = Intent().apply {
        action = "com.beeper.android.TOGGLE_INCOGNITO_MODE"
        component = ComponentName(
            "com.beeper.android",
            "com.beeper.ext.ExternalBroadcastReceiver"
        )
        putExtra("enabled", true)
    }
    sendBroadcast(intent)
}

// Disable incognito mode
fun disableIncognitoMode() {
    val intent = Intent().apply {
        action = "com.beeper.android.TOGGLE_INCOGNITO_MODE"
        component = ComponentName(
            "com.beeper.android",
            "com.beeper.ext.ExternalBroadcastReceiver"
        )
        putExtra("enabled", false)
    }
    sendBroadcast(intent)
}

Tasker

Task setup:

1. Create a new Task in Tasker
2. Add Action → System → Send Intent
3. Configure the intent:
   • Action: com.beeper.android.TOGGLE_INCOGNITO_MODE
   • Package: com.beeper.android
   • Class: com.beeper.ext.ExternalBroadcastReceiver
   • Extra: enabled:true (or enabled:false)
   • Target: Broadcast Receiver

ADB command-line

# Enable incognito mode
adb shell am broadcast \
  -a com.beeper.android.TOGGLE_INCOGNITO_MODE \
  --ez enabled true \
  -n com.beeper.android/com.beeper.ext.ExternalBroadcastReceiver

# Disable incognito mode
adb shell am broadcast \
  -a com.beeper.android.TOGGLE_INCOGNITO_MODE \
  --ez enabled false \
  -n com.beeper.android/com.beeper.ext.ExternalBroadcastReceiver

Requires USB debugging to be enabled on the target device.

Troubleshooting

Common issues

Intent not received:

• Verify Beeper Android is installed and updated
• Check that the component name is exactly: com.beeper.android/com.beeper.ext.ExternalBroadcastReceiver
• Ensure the action string is correct: com.beeper.android.TOGGLE_INCOGNITO_MODE

ADB command fails:

• Confirm ADB is properly installed and device is connected
• Check that the device is authorized for ADB access

Verification

To verify the intent was received, check Beeper’s incognito mode status in the app UI after sending the intent.