timebuzzer-led

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

timeBuzzer LED

timeBuzzer LED

Control the timeBuzzer hardware LED over MIDI. The device has 3 RGB segments controllable independently or together.
通过MIDI控制timeBuzzer硬件LED。该设备拥有3个可独立或协同控制的RGB分段。

Requirements

要求

  • timeBuzzer device connected via USB-C
  • python-rtmidi
    installed (
    pip install python-rtmidi
    )
  • timeBuzzer app may be running (MIDI port is shared)
  • 通过USB-C连接timeBuzzer设备
  • 已安装
    python-rtmidi
    (执行
    pip install python-rtmidi
    安装)
  • timeBuzzer应用可能正在运行(MIDI端口为共享状态)

Script

脚本

Single CLI:
scripts/buzzer_led.py
单文件CLI:
scripts/buzzer_led.py

Color commands

颜色命令

bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py color red
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py color --hex "#FF8800"
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py rgb 255 100 0
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py off
Named colors: red, orange, yellow, green, cyan, blue, purple, magenta, pink, white, warm, off.
bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py color red
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py color --hex "#FF8800"
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py rgb 255 100 0
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py off
预设颜色:red、orange、yellow、green、cyan、blue、purple、magenta、pink、white、warm、off。

Effects

特效命令

bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py pulse blue --bpm 30 --seconds 5
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py strobe red --count 5 --interval 0.15
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py rainbow --seconds 5
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py fade warm --seconds 2
bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py pulse blue --bpm 30 --seconds 5
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py strobe red --count 5 --interval 0.15
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py rainbow --seconds 5
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py fade warm --seconds 2

Status signals (parallel to
hue
skill)

状态信号(与
hue
技能同步)

bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal success
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal thinking --seconds 5
signalcoloreffect
success/donegreensolid
errorredstrobe
warningorangepulse
thinkingbluepulse
workingcyanpulse
idlewarmsolid
attentionmagentastrobe
focuspurplesolid
bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal success
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal thinking --seconds 5
信号颜色特效
成功/完成绿色常亮
错误红色频闪
警告橙色脉冲
思考中蓝色脉冲
工作中青色脉冲
空闲暖白常亮
需注意品红频闪
专注紫色常亮

Per-segment control

分段控制

bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 0 255 0 0   # seg 0 red
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 1 0 255 0   # seg 1 green
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 2 0 0 255   # seg 2 blue
bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 0 255 0 0   # 分段0设为红色
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 1 0 255 0   # 分段1设为绿色
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py segment 2 0 0 255   # 分段2设为蓝色

Protocol details

协议细节

  • USB MIDI device (vendor 0x16D0, product 0x1170)
  • Sends/receives MIDI CC on channel 12 (status byte 187/0xBB)
  • LED output: CC 70-78 for 3 segments x 3 channels (R, G, B)
  • Values: 0-127 (half of standard 0-255 RGB)
  • The timeBuzzer app controls LED based on active project color; this script overrides it directly
  • USB MIDI设备(厂商ID 0x16D0,产品ID 0x1170)
  • 在通道12(状态字节187/0xBB)上发送/接收MIDI CC信号
  • LED输出:CC 70-78对应3个分段×3个通道(红、绿、蓝)
  • 值范围:0-127(为标准0-255 RGB的一半)
  • timeBuzzer应用会根据活跃项目颜色控制LED;本脚本可直接覆盖该设置

Syncing with Hue

与Hue同步

Use the same signal vocabulary as the
hue
skill. Example combined command:
bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal success &
python3 ~/.claude/skills/hue/scripts/hue.py signal success --group 1
使用与
hue
技能相同的信号词汇。示例组合命令:
bash
python3 ~/.claude/skills/timebuzzer-led/scripts/buzzer_led.py signal success &
python3 ~/.claude/skills/hue/scripts/hue.py signal success --group 1