Rust Elgato StreamDeck 驱动和工具

一个基于 hidapi 的驱动程序，用于直接与 Elgato StreamDeck 设备交互，旨在允许应用程序直接在任意平台上使用这些设备（无需使用 Elgato SDK），基于 python streamdeck 库 的基础上。

状态

工作进行中。欢迎提交拉取请求！

特性

• 连接到设备
  • 通过 VID/PID/序列号连接
  • 匹配设备 类型（Mini 等）
• 读取按钮
  • 轮询模式（带有阻塞/非阻塞选择和超时）
  • 多线程/异步/回调驱动模式
• 写入亮度
• 设置按钮
  • 写入颜色
  • 写入图像
• 设备
  • Stream Deck Mini
  • Stream Deck 原版（未测试）
  • Stream Deck 原版 V2
  • Stream Deck XL

入门

• cargo add streamdeck 将此库添加到您的项目中（使用 cargo-edit）
• cargo install streamdeck 仅安装实用程序
• git clone [email protected]:ryankurte/rust-streamdeck.git 来克隆仓库

构建需要 libusb 和 hidapi 软件包。

在 Linux 上设置权限

• cp 40-streamdeck.rules /etc/udev/rules.d/ 允许用户访问 streamdeck 设备
  • 注意这可能需要根据其他设备的 vid/pid 组合进行编辑
• sudo udevadm control --reload-rules 用于重新加载 udev 规则

使用命令行界面

streamdeck-cli --help 显示可用的子命令和选项，将 --help 传递给子命令（例如，streamdeck set-image --help 显示该子命令的选项）

streamdeck-cli 0.4.1
A CLI for the Elgato StreamDeck

USAGE:
    streamdeck-cli [OPTIONS] <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
        --log-level <level>    Enable verbose logging [default: info]
        --pid <pid>            USB Device Product ID (PID) in hex [env: USB_PID=]  [default: 0063]
        --serial <serial>      USB Device Serial [env: USB_SERIAL=]
        --vid <vid>            USB Device Vendor ID (VID) in hex [env: USB_VID=]  [default: 0fd9]

SUBCOMMANDS:
    get-buttons       Fetch button states
    help              Prints this message or the help of the given subcommand(s)
    reset             Reset the attached device
    set-brightness    Set device display brightness
    set-colour        Set button colours
    set-image         Set button images
    version           Fetch the device firmware version

相关作品

这个库站在巨人的肩膀上（他们已经完成了所有的逆向工作）...

你可能还想看看

• streamdeck-rs 用于编写与官方 Elgato SDK 交互的插件
• stream_deck_rs 另一个具有类似目标的项目
• @cliffrowley 的 streamdeck 协议注释
• python streamdeck 库
• node-elgato-stream-deck

图标 来自 material.io 和 brandeps.com