Android Intents

Beeper Android supports external 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.

Note

• 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

Note

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.