Skip to main content

SMHUB Peripheral (IR, Buzzer, Ambilight) Control Guide

🎛️ SMHUB Peripheral Control Guide

IR • Buzzer • WS2812 (Ambilight)

This page documents how to control SMHUB peripherals via CLI (recommended) and IPC (advanced).

🌈 WS2812 LED Control (Ambilight)

Daemon: smhub-ambilight-daemon
CLI: smhub-ambilightctl
Socket: /run/smhub-ambilight.sock

CLI Commands

Turn LEDs Off

smhub-ambilightctl off

Set Solid Color

# RGB
smhub-ambilightctl color 255 0 0

# RGB + brightness
smhub-ambilightctl color 255 0 0 128

Parameters: R/G/B (0–255), optional brightness (1–255).

Start an Effect

# Effect only (defaults)
smhub-ambilightctl effect breathe

# Effect + RGB
smhub-ambilightctl effect breathe 0 255 0

# Effect + RGB + brightness + speed
smhub-ambilightctl effect breathe 0 255 0 128 -S 100

Effects: blink, breathe, wipe, chase, theater, rainbow

Trigger Notification Preset

# Default TTL
smhub-ambilightctl notify success

# Custom TTL (ms)
smhub-ambilightctl notify error 500

Presets: booting, boot_success, success, error, warn, busy, pair, update, button_feedback

Set Global Brightness

smhub-ambilightctl brightness 128

Night Mode

# Enable (default dim cap)
smhub-ambilightctl night on

# Enable with custom dim cap
smhub-ambilightctl night on 30

# Disable
smhub-ambilightctl night off

Status & List

smhub-ambilightctl status
smhub-ambilightctl list

📡 IR Control (Infrared)

Daemon: smhub-ir-daemon
CLI: smhub-irctl
Socket: /run/smhub-ir.sock

CLI Commands

Status

smhub-irctl status

Learn a Command

# Learn with default timeout
smhub-irctl learn tv_power

# Learn with custom timeout (seconds)
smhub-irctl -t 20 learn ac_mode

Send a Saved Command

smhub-irctl send tv_power

One-shot Capture (No Save)

smhub-irctl receive

List / Delete Commands

smhub-irctl list
smhub-irctl delete tv_power

Send Raw Data

smhub-irctl send_raw /tmp/ir_data.json

Use Custom Socket Path

smhub-irctl -s /run/smhub-ir.sock status

🔔 Buzzer Control

Daemon: smhub-buzzer-daemon
CLI: smhub-buzzerctl
Socket: /run/smhub-buzzer.sock

Built-in Sounds

  • click
  • success
  • startup
  • shutdown
  • warning
  • error

CLI Commands

Play Built-in Sound

smhub-buzzerctl play builtin success
smhub-buzzerctl play builtin warning -p 8

Play RTTTL Melody

smhub-buzzerctl play rtttl "Melody:d=4,o=5,b=120:c,d,e,f,g"

Stop Playback

smhub-buzzerctl stop
smhub-buzzerctl stop -q   # stop + clear queue

Mute / Unmute

smhub-buzzerctl mute 5
smhub-buzzerctl mute 5 -m 300   # mute for 5 minutes
smhub-buzzerctl unmute

Status & List

smhub-buzzerctl status
smhub-buzzerctl list

🧩 Advanced: IPC JSON via Unix Sockets

All peripherals support newline-delimited JSON over a Unix socket. Use this for automation scripts or integrations.

Ambilight (example)

echo '{"cmd":"color","r":255,"g":0,"b":0}' | socat - UNIX-CONNECT:/run/smhub-ambilight.sock

IR (example)

echo '{"cmd":"status"}' | socat - UNIX-CONNECT:/run/smhub-ir.sock

Buzzer (example)

echo '{"cmd":"list"}' | socat - UNIX-CONNECT:/run/smhub-buzzer.sock
Back to top