SnapAzule Docs
License & Flash →

Bluetooth Pairing

SnapAzule advertises itself as a BLE keyboard + media-key peripheral named SnapAzule. Any device that accepts a Bluetooth keyboard can pair with it: iOS, Android, macOS, Windows, Linux, most smart TVs.

Pair a new device

  1. On the receiving device, open Bluetooth settings and start scanning.
  2. Look for SnapAzule and tap to pair. No PIN required.
  3. The Bluetooth Status panel in SnapAzule's web UI turns green and shows the peer's MAC address.
  4. The LCD's second tile also shows the connected peer.

That's it — SnapAzule saves the pairing to flash and will auto-reconnect on every boot.

Reconnect on boot

When a bond already exists, SnapAzule advertises as connectable but non-discoverable. This means the previously-paired device will reconnect automatically, but new devices won't see it in the Bluetooth picker.

To add a second device, first factory-reset and re-pair both.

Key types

SnapAzule can send two classes of keystrokes:

Keyboard keys

Standard HID keycodes — letters, numbers, function keys, arrow keys, Enter, Space, etc. Use these for:

  • iOS / iPadOS Volume Up as a camera shutter
  • OBS / Streamdeck / macro hotkeys
  • Generic "press any key" handlers

Media keys

HID consumer-control codes — Play/Pause, Volume Up/Down, Mute, Brightness, Next/Previous Track. Use these for:

  • Media players that don't respond to regular key presses
  • Smart TV remotes

Each save sends one press-release of the configured key.

Verifying a trigger

Before committing to a test print, sanity-check by watching the Monitor Activity panel at the bottom of the main page:

  • Match Count increments every time SnapAzule detects the configured pattern.
  • Last Match shows the timestamp of the most recent hit.

If Match Count increases but your camera doesn't respond, the Bluetooth link is fine — the problem is that your app isn't listening for the key you chose.

Bond persistence

Pairings are stored in NVS (non-volatile storage) and survive power-cycles, firmware re-flashes that keep NVS, and unplugging. Only a Factory Reset erases them.