Skip to main content

​
Overview

Moorcheh voice can play TTS through a Bluetooth speaker on Linux (e.g. Arduino UNO Q) by setting "playback": "bluetooth" in ~/.moorcheh-edge/voice/audio.json. Pairing is done manually with bluetoothctl on the board. There is no fully automated CLI wizard today - headless boards often need the pairing agent registered in the same interactive session.
Keep the USB mic on ALSA (plughw:…) for capture. Only playback switches to Bluetooth.

​
Prerequisites

Log out of SSH and back in (or reboot) after adding yourself to the bluetooth group. Verify the adapter:
Expect Powered: yes.

​
Pair the speaker (interactive)

Put the speaker in pairing mode, then:
Inside the bluetoothctl prompt:
Leave scan on running. With the speaker in pairing mode, wait 10-15 seconds so it appears in the scan results.

​
Pick your speaker and note its MAC

Still inside bluetoothctl, list discovered devices:
Example output (yours will differ):
  1. Find the line for your Bluetooth speaker - read the name at the end of the line (e.g. JBL Flip 5).
  2. Copy the MAC address from the start of that same line - six pairs of hex digits like AA:BB:CC:DD:EE:FF.
If your speaker does not appear, keep it in pairing mode, wait a few more seconds, and run devices again. Optional: stop scanning once you have the MAC:

​
Pair, trust, and connect

Replace AA:BB:CC:DD:EE:FF with the MAC you copied from devices:
Expect Pairing successful and Connection successful before you run quit.
Run agent NoInputNoOutput and default-agent in the same bluetoothctl session before pair. If you see “No agent is registered”, exit and start over in one session.

​
Point Moorcheh at Bluetooth playback

Edit ~/.moorcheh-edge/voice/audio.json:
  • capture - USB mic (from voice setup or voice check)
  • playback - must be "bluetooth" for PipeWire/BlueZ output
  • bt_device - optional MAC hint when multiple bluez_output sinks exist
Test:
Restart the voice server after changing audio config:

​
Switch back to wired USB speaker

Or edit audio.json manually:
Remove bt_device when using wired playback.

​
PipeWire session on UNO Q

On some UNO Q images the Bluetooth sink appears under the lightdm session while you SSH as arduino. Moorcheh tries the current user first, then lightdm, when "playback": "bluetooth". If playback fails but pactl list sinks short shows a sink under another user:
Optional env vars: