cameractrls

<img align='left' height='140' src='https://yellow-cdn.veclightyear.com/835a84d5/a818a31a-d604-4cea-b291-f5b5a44a632c.svg'>

Linux 摄像头控制

这是一个独立的 Python 命令行界面和图形用户界面（GTK3、GTK4）以及摄像头查看器（SDL），用于在 Linux 中设置摄像头控制。它可以设置 V4L2 控制，并且可以扩展非标准控制。目前它具有 Logitech 扩展（LED 模式、LED 频率、BRIO 视野、相对平移/倾斜、PTZ 预设）、Kiyo Pro 扩展（HDR、HDR 模式、视野、自动对焦模式、保存）、预设扩展（保存和恢复控制）、控制恢复守护进程（在设备连接时恢复预设）。

安装

从 Flathub 安装

<a href='https://flathub.org/apps/details/hu.irl.cameractrls'><img width='240' alt='从 Flathub 下载' src='https://yellow-cdn.veclightyear.com/835a84d5/cf649a60-ac69-4b27-8d4a-81acc72092c4.png'/></a>

flatpak install flathub hu.irl.cameractrls

从 Arch 软件包仓库安装

pacman -S cameractrls

从 Manjaro 软件包仓库安装

pamac install cameractrls

Git 安装方法

通过 apt 安装依赖：

sudo apt install git libsdl2-2.0-0 libturbojpeg

或通过 dnf 安装：

sudo dnf install git SDL2 turbojpeg

克隆仓库

git clone https://github.com/soyersoyer/cameractrls.git
cd cameractrls

cameractrlsgtk

摄像头控制的 GTK3 图形用户界面

<img alt="cameractrls 启动器" src="https://yellow-cdn.veclightyear.com/835a84d5/eabf52fd-68e4-487e-8695-db57964d2eed.png" width="200"> <div> <img alt="cameractrls 裁剪界面" src="https://yellow-cdn.veclightyear.com/835a84d5/fa79b9ca-a4c7-415e-8654-0eca297e9b72.png" width="380"> <img alt="cameractrls 图像界面" src="https://yellow-cdn.veclightyear.com/835a84d5/a0c966af-8a21-4097-9da4-9239cd6363ab.png" width="380"> <img alt="cameractrls 曝光界面" src="https://yellow-cdn.veclightyear.com/835a84d5/0b58ec6d-c639-4951-a3ed-7f707c8fca4f.png" width="380"> <img alt="cameractrls 高级界面" src="https://yellow-cdn.veclightyear.com/835a84d5/3ccb60d8-30c4-43cc-bbff-b4697280d005.png" width="380"> <img alt="cameractrls 捕获界面" src="https://yellow-cdn.veclightyear.com/835a84d5/d115a2d2-6c99-4a3d-bcea-549d5bed3fb5.png" width="380"> <img alt="cameractrls PTZ 控制" src="https://yellow-cdn.veclightyear.com/835a84d5/a01f3a81-cf65-4a0e-ba0f-b4a5fbde7caf.png" width="380"> </div>

GTK3 图形用户界面安装

添加桌面文件到启动器

desktop-file-install --dir="$HOME/.local/share/applications" \
--set-key=Exec --set-value="$PWD/cameractrlsgtk.py" \
--set-key=Path --set-value="$PWD" \
--set-key=Icon --set-value="$PWD/pkg/hu.irl.cameractrls.svg" \
pkg/hu.irl.cameractrls.desktop

从启动器或 shell 运行

./cameractrlsgtk.py

GTK4 图形用户界面安装（实验性）

添加桌面文件到启动器

desktop-file-install --dir="$HOME/.local/share/applications" \
--set-key=Exec --set-value="$PWD/cameractrlsgtk4.py" \
--set-key=Path --set-value="$PWD" \
--set-key=Icon --set-value="$PWD/pkg/hu.irl.cameractrls.svg" \
pkg/hu.irl.cameractrls.desktop

从启动器或 shell 运行

./cameractrlsgtk4.py

cameractrls.py

命令行界面。

运行 cameractrls

./cameractrls.py

用法：./cameractrls.py [--help] [-d 设备] [--list] [-c 控制]

可选参数：
  -h, --help         显示此帮助信息并退出
  -d 设备            使用指定设备，默认为 /dev/video0
  -l, --list         列出控制和值
  -L, --list-devices 列出捕获设备
  -c 控制            设置控制（例如：hdr=on,fov=wide）

示例： ./cameractrls.py -c brightness=128,kiyo_pro_hdr=on,kiyo_pro_fov=wide

# cameractrlsd.py

控制恢复守护程序。

使用GUI/CLI将其添加到SystemD/桌面门户。

# cameraview.py

摄像头查看器。

```shell
./cameraview.py -h

用法: ./cameraview.py [--help] [-d 设备] [-s 尺寸] [-r 角度] [-m 翻转] [-c 色彩映射]

可选参数:
  -h, --help         显示此帮助信息并退出
  -d 设备            使用指定设备，默认 /dev/video0
  -s 尺寸            将窗口置于指定尺寸矩形内 (宽x高)，默认未设置
  -r 角度            将图像旋转指定角度，默认 0
  -m 翻转            镜像图像，默认无，(无, 水平, 垂直, 水平垂直)
  -c 色彩映射        设置色彩映射，默认无
                    (无, 灰度, 炽热, 翠绿, 铁黑, 彩虹)

示例:
  ./cameraview.py -d /dev/video2

快捷键:
  f: 切换全屏
  r: 角度 +90 (shift+r -90)
  m: 翻转下一个 (shift+m 上一个)
  c: 色彩映射下一个 (shift+c 上一个)

PTZ 控制

键盘

当PTZ控制之一处于焦点状态或在cameraview窗口中时，使用键盘的方向键/小键盘键/wasd/Home/End/PageUp/PageDown/+/-/Ctrl++/Ctrl+-来控制您的PTZ摄像头。

使用Alt+预设编号来选择logitech_pantilt_preset的预设。

3Dconnexion SpaceMouse

使用6自由度SpaceMouse控制您的摄像头。

Z => zoom_absolute
X => pan_absolute
Y => tilt_absolute
RY => pan_speed
RX => tilt_speed
BTN1 => PTZ 重置

需要安装spacenavd和libspnav。（可选，仅当您有SpaceMouse时）

sudo apt install spacenavd libspnav0
sudo cp /usr/share/doc/spacenavd/examples/example-spnavrc /etc/spnavrc

或通过dnf：

sudo dnf install spacenavd libspnav
sudo cp /usr/share/doc/spacenavd/example-spnavrc /etc/spnavrc

提示：在/etc/spnavrc中设置 led = auto

游戏控制器

使用游戏控制器（PS5 DualSense/Xbox 控制器/等）控制您的摄像头

左摇杆 => pan_speed/tilt_speed 或 pan_absolute/tilt_absolute
右摇杆 => pan_absolute/tilt_absolute
方向键 => pan_absolute/tilt_absolute
左/右扳机 => zoom_absolute
南/东/西/北/左肩/右肩/后退/开始 => PTZ 预设 1-8
指南键 => PTZ 重置

MIDI 控制器

使用MIDI控制器（如MPK Mini或任何带可配置旋钮/操纵杆的控制器）控制您的摄像头

按如下方式配置您的MIDI控制器：

使用操纵杆：
CC78 => pan_speed/pan_absolute
CC79 => tilt_speed/tilt_absolute

使用绝对旋钮（旋钮值：0-127）：
CC71 => pan_absolute
CC72 => tilt_absolute
CC73 => zoom_absolute

使用相对旋钮（旋钮值：增加:1 减少:127）：
CC70 => pan_speed
CC74 => tilt_speed
CC75 => pan_absolute
CC76 => tilt_absolute
CC77 => zoom_absolute

CC121 => PTZ 重置
PGM0-7 => PTZ 预设 1-8

更新 cameractrls

git pull

从 0.5.x 更新到 0.6.x

禁用、停止并删除旧的systemd路径和服务：

cd ~/.config/systemd/user
systemctl --user disable --now cameractrls-*
rm cameractrls-*

删除 cameractrls

禁用、停止并删除systemd服务：

cd ~/.config/systemd/user
systemctl --user disable --now cameractrlsd.service
rm cameractrlsd.service

删除启动器快捷方式

rm ~/.local/share/applications/hu.irl.cameractrls.desktop

删除cameractrls：

rm -rf cameractrls

供应商合作机会

Linux使用率每年都在增加，目前约为3-4%。

由于Linux的采用率较低，带有自定义控制的摄像头控制软件通常只适用于Windows/MacOS，因此Linux用户无法充分利用每个摄像头的真正潜力。

如果您希望Linux用户满意，并且您的摄像头有此应用程序缺少的自定义控制，只需给我发送一个摄像头，我就会添加它们。 联系

当然，您也可以创建PR。