---
title: Android Intents - Beeper Developer Docs
description: Control Beeper Android through Android Intents from other apps, Tasker, or command-line
lastUpdated: 2026-02-23T00:29:17.000Z
---

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)](#tab-panel-45)
- [Tasker](#tab-panel-46)
- [ADB command-line](#tab-panel-47)

```
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)
}
```

**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

Terminal window

```
# 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.