litra-rs

💡 通过命令行控制 Logitech Litra 灯

特性

使用此工具，您可以

• 打开和关闭灯光
• 检查灯光是否打开或关闭
• 设置、获取、增加和减少灯光亮度
• 设置、获取、增加和减少灯光温度
• 当您的摄像头打开或关闭时，自动打开或关闭灯光（仅限 Linux）

支持的设备

以下 Logitech Litra 设备，通过 USB 连接，得到支持

• Logitech Litra Glow
• Logitech Litra Beam
• Logitech Litra Beam LX

安装

macOS 配合 Homebrew

1. 运行以下命令安装最新版本：brew tap timrogers/tap && brew install litra.
2. 运行 litra --help 检查一切是否正常，并查看可用的命令。

所有其他平台（使用 Cargo）

1. 如果您尚未安装 Rust，请在其上安装 Rust。
2. 运行以下命令安装 litra crate：cargo install litra.
3. 运行 litra --help 检查一切是否正常，并查看可用的命令。

所有其他平台（通过二进制文件）

1. 下载您平台的最新版本 发布。支持 macOS、Linux 和 Windows 设备。
2. 将二进制文件添加到 $PATH 中，以便您可以从 shell 中执行它。为了获得最佳体验，在 macOS 和 Linux 上将其命名为 litra，在 Windows 上命名为 litra.exe。
3. 运行 litra --help 检查一切是否正常，并查看可用的命令。

在 Linux 上配置 udev 权限

在大多数 Linux 操作系统中，您需要使用 udev 手动配置权限，以便非 root 用户可以访问和管理 Litra 设备。

要允许 video 组的所有用户访问 Litra 设备，将 99-litra.rules 文件复制到 /etc/udev/rules.d。接下来，重启您的计算机或以 root 身份运行以下命令：

# udevadm control --reload-rules
# udevadm trigger

用法

从命令行

以下命令可用于控制您的设备：

• litra on：打开 Logitech Litra 设备
• litra off：关闭 Logitech Litra 设备
• litra toggle：切换 Logitech Litra 设备的开启或关闭状态
• litra brightness：设置 Logitech Litra 设备的亮度，使用 --value（以流明为单位）或 --percentage（作为设备最大亮度的百分比）。亮度可以设置为 devices 命令返回的设备的最小和最大值之间的任何值。
• litra brightness-up：增加 Logitech Litra 设备的亮度，使用 --value（以流明为单位）或 --percentage（增加到设备亮度的百分比点数）
• litra brightness-down：降低 Logitech Litra 设备的亮度，使用 --value（以流明为单位）或 --percentage（从设备亮度中减去的百分比点数）
• litra temperature：设置 Logitech Litra 设备的温度，使用 --value（以开尔文为单位）。温度可以设置为 devices 命令返回的设备的最小和最大值之间的任何 100 的倍数。
• litra temperature-up：增加 Logitech Litra 设备的温度，使用 --value（以开尔文为单位）。该值必须是 100 的倍数。
• litra temperature-down：降低 Logitech Litra 设备的温度，使用 --value（以开尔文为单位）。该值必须是 100 的倍数。
• litra auto-toggle （仅限 Linux）：当您的网络摄像头开始捕获视频时自动打开 Logitech Litra 设备，当它停止捕获视频时关闭。此命令应在后台运行。

所有这些命令都支持 --serial-number/-s 参数，以指定您要针对的设备的序列号。如果您只有一个 Litra 设备，您可以省略此参数。如果您有多个设备，我们建议指定它。如果没有指定，将选择“第一个”设备，但这并不保证在命令运行之间稳定。

以下命令还包括：

• litra devices：列出连接到您计算机的Logitech Litra设备。默认情况下，将以可读格式返回，或您可以使用--json标志获取JSON输出。

每个CLI命令也可以使用--help进行调用，以获取更详细的文档。

从Rust应用程序中

litra库包含从您的Rust应用程序中与Litra设备交互的功能。

要查看完整的API，请查看Docs.rs上的文档或阅读src/lib.rs。