blink-bridge Companion¶
blink-bridge is an optional Android companion app. When installed and
paired, it lets your Domina send small actions to your phone outside
the chat: set a wallpaper, push a notification, or run other future
permitted actions.
What you need¶
- An Android phone (Android 10 or later).
- The
blink-bridgeAPK installed. - A BLINK account on any tier.
- Each phone is paired individually; one BLINK account can have multiple paired devices.
Pairing¶
- Install
blink-bridgeon your Android phone. - Open the app and sign in with the same email and password you use on the web app. The Android app authenticates against the same Firebase Auth account, so there is no separate pairing code.
- Approve permissions on Android (notifications first, then any other permission you want the Domina to be able to use).
- The phone registers itself automatically and appears in Account > Devices on the web side.
Registration stores a stable per-device identifier (Android's ANDROID_ID) alongside your FCM push token. Re-installing the APK on the same phone updates the existing record rather than creating a duplicate.
What the Domina can do, only if you allow it¶
Each capability is gated by an explicit per-permission toggle on the device's permissions screen. Until you toggle it on, the Domina cannot use that capability.
| Permission | What it lets her do |
|---|---|
| Notifications | Push a reminder or directive notification to your phone (e.g. "kneel for one minute, now"). |
| Wallpaper | Set a generated image as your phone's wallpaper. |
| (more capabilities are added over time; see the device screen for the current list) |
You can turn off any single permission at any time. The Domina sees the updated set the next time she would dispatch a command.
Audit log¶
Every command sent to a device is logged in Account > Devices > Audit. The log shows:
- When the command was issued.
- Which capability it used.
- Whether the device acknowledged it.
- Any error returned by the device.
The log is read-only. You can use it to verify what your Domina has been doing on your phone.
Removing a device¶
From Account > Devices:
- Tap the device.
- Tap Unregister.
- The device is removed from your account and no further commands can be sent to it.
Uninstalling the APK without unregistering also stops commands - they will fail to deliver - but the entry stays on your account list until you remove it.
Privacy considerations¶
- The bridge does not give the Domina ongoing read access to your phone. Each capability is a one-shot command, not a stream.
- The bridge does not exfiltrate contacts, messages, photos, or other app data.
- The Audit log is the source of truth for what was sent. If anything on the Audit log surprises you, file a report.