Logo
Project Icon

display-switch

USB切换器升级为全功能KVM方案的开源工具

KVM切换显示器输入切换USB设备监控跨平台支持DDC/CI协议Github开源项目

display-switch是一款开源的跨平台工具，通过监控USB设备事件并利用DDC/CI协议切换显示器输入，将普通USB切换器功能扩展为KVM解决方案。它支持Windows、MacOS和Linux系统，能够实现一键切换所有显示器输入源。该工具还提供多显示器配置和外部命令执行功能，适用于提高多设备办公效率的场景。

访问官网访问官网GithubGithub
介绍相关项目

构建 GitHub 许可证

将30美元的USB切换器转换为功能齐全的KVM

这个实用程序监控USB设备的连接/断开事件，并通过DDC/CI切换显示器输入。这将简单的USB切换器转变为功能齐全的KVM解决方案：只需按下USB切换器上的一个按钮，所有显示器就会连接到不同的输入源。

它应该安装在所有可能连接到这些显示器的计算机上，因为该应用程序只能"单向"切换显示器，并依赖于在其他计算机上运行自身来根据需要"反向"切换。

支持的平台

该应用程序应该可以在MacOS（仅限Intel Mac）、Windows和Linux上运行。

注意：显示切换器目前不适用于M1 Mac：计划在ddc-macos-rs中支持M1系列SoC，但尚未实现。

配置

所有平台上的配置都非常相似：

在MacOS上：配置文件预期位于 ~/Library/Preferences/display-switch.ini 在Windows上：配置文件预期位于 %APPDATA%\display-switch\display-switch.ini 在Linux上：配置文件预期位于 $XDG_CONFIG_HOME/display-switch/display-switch.ini 或 ~/.config/display-switch/display-switch.ini

配置文件设置：

  usb_device = "1050:0407"
  on_usb_connect = "Hdmi1"
  on_usb_disconnect = "Hdmi2"

usb_device 是要监控的USB设备（十六进制的供应商ID/设备ID），on_usb_connect 是当该设备连接时要切换到的显示器输入。支持的值有 Hdmi1、Hdmi2、DisplayPort1、DisplayPort2、Dvi1、Dvi2、Vga1。 如果您的显示器有USB-C端口，它通常被报告为 DisplayPort2。输入也可以指定为"原始"十进制或十六进制值：on_usb_connect = 0x10

可选的 on_usb_disconnect 设置允许在USB设备断开连接时向另一个方向切换。 请注意，首选方法是在两台计算机上都安装此应用程序。"切换离开"是有问题的：如果另一台计算机使显示器进入睡眠状态，它们会立即切换回原始输入。

不同显示器使用不同输入

display-switch 支持每个显示器的配置：添加一个或多个显示器特定的配置部分来设置显示器特定的输入。例如：

on_usb_connect = "DisplayPort2"
on_usb_disconnect = "Hdmi1"

[monitor1]
monitor_id = "len"
on_usb_connect = "DisplayPort1"

[monitor2]
monitor_id = "dell"
on_usb_connect = "hdmi2"

monitor_id 指定一个不区分大小写的子字符串，用于匹配显示器ID。例如，'len'将匹配 LEN P27u-10 S/N 1144206897 显示器ID。如果多个部分有匹配项，将使用第一个。 如果定义了 on_usb_connect 和 on_usb_disconnect，它们将优先于全局默认值。

Windows提示：可以在注册表的 \HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\DISPLAY\{MODEL_ID}\{CONNECTION_ID} 中重命名显示器。编辑 DeviceDesc 值并更改最后一个分号后的名称。如果它们都只是"通用即插即用显示器"，这特别有用。

运行外部命令

display-switch 支持在USB设备连接或断开时运行外部命令。此配置可以是全局的（每次配置的USB设备连接或断开时运行）或特定于每个显示器（仅当给定显示器被切换时运行）：

usb_device = "1050:0407"
on_usb_connect = "Hdmi1"
on_usb_disconnect = "DisplayPort2"
on_usb_connect_execute = "echo connected"
on_usb_disconnect_execute = "echo disconnected"

[monitor1]
monitor_id="foobar"
on_usb_connect_execute = "echo usb connected, monitor 'foobar' being switched"
on_usb_disconnect_execute = "'c:\\program files\\my app.exe' --parameter"

注意：

  1. 外部应用程序以启动 display-switch 的相同用户身份执行。
  2. 该程序支持将提供的配置拆分为应用程序名称和参数，但不支持其他shell功能。
  3. 如果应用程序路径包含空格，请用单引号将完整文件路径括起来。
  4. 在Windows上，请转义反斜杠（将 \ 替换为 \，见上面的示例）。

USB设备ID

Windows

要在Windows上找到USB设备ID：

  1. 打开设备管理器
  2. 找到USB设备，查看其属性
  3. 切换到"详细信息"选项卡，在属性下拉列表中选择"硬件ID"
  4. 你应该会看到类似HID\VID_046D&PID_C52B&MI_00的值（具体值会有所不同）- USB设备ID是供应商ID（Vendor ID）和产品ID（Product ID）的组合 - 例如，在这种情况下，它应该是046D:C52B

MacOS

要在MacOS上找到USB设备ID，请打开终端并运行以下命令：

brew install lsusb

$ lsusb > a
<在此切换USB坞站>
$ lsusb > b
$ opendiff a b

在命令输出中，高亮显示的行表示最相关的USB ID。

Linux

需要额外的软件包，通过以下命令安装：sudo apt install libxi-dev xorg-dev

要在Linux上找到USB设备ID，首先安装lsusb，你的Linux发行版应该有相应的软件包。（在Debian、Ubuntu和RedHat上，软件包名为usbutils。） 然后，在终端中运行以下命令：

$ lsusb > a
<在此切换USB坞站>
$ lsusb > b
$ diff -u a b

diff输出将显示最相关的USB ID。

日志

  • 在MacOS上：日志文件写入/Users/用户名/Library/Logs/display-switch/display-switch.log
  • 在Windows上：日志文件写入%LOCALAPPDATA%\display-switch\display-switch.log
  • 在Linux上：日志文件写入$XDG_DATA_HOME/display-switch/display-switch.log 或~/.local/share/display-switch/display-switch.log

从源代码构建

Windows

安装Rust，然后执行cargo build --release

MacOS

安装Xcode，安装Rust，然后执行 cargo build --release

Linux

安装Rust，然后执行cargo build --release

开机自启

Windows

将target\release目录中的display_switch.exe（在上一步中构建的）复制到 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup。

MacOS

  # 请确保你的INI文件配置正确！（见上文）
  cp target/release/display_switch /usr/local/bin/
  cp dev.haim.display-switch.daemon.plist ~/Library/LaunchAgents/
  launchctl load ~/Library/LaunchAgents/dev.haim.display-switch.daemon.plist

Linux

复制构建好的可执行文件：

  cp target/release/display_switch /usr/local/bin/

为i2c组中的用户启用i2c设备的读写权限。以root身份运行：

groupadd i2c
echo 'KERNEL=="i2c-[0-9]*", GROUP="i2c"' >> /etc/udev/rules.d/10-local_i2c_group.rules
udevadm control --reload-rules && udevadm trigger

然后将你的用户添加到i2c组：

sudo usermod -aG i2c $(whoami)

在你的用户目录下创建一个systemd单元文件（/home/$USER/.config/systemd/user/display-switch.service），内容如下：

[Unit]
Description=通过USB切换显示器

[Service]
ExecStart=/usr/local/bin/display_switch
Type=simple
StandardOutput=journal
Restart=always

[Install]
WantedBy=default.target

在/home/$USER/.config/display-switch/display-switch.ini创建配置文件。 然后使用以下命令启用服务：

systemctl --user daemon-reload
systemctl --user enable display-switch.service
systemctl --user start display-switch.service
相关项目
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手，通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能，支持100+编程语言，与主流编辑器无缝集成，显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台，能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐，Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案，通过智能技术简化视频制作流程。无论是企业宣传还是个人分享，有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持，能够阅读和理解用户上传的文件内容，解析网页信息，并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题，Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术，为商家提供一键生成商品图和营销文案的服务，显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台，让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型，免费访问各种图像生成与AI训练工具，从Stable Diffusion等基础模型开始，轻松实现创新图像生成。体验前沿的AI技术，推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器，它将改变您观看视频的方式！SubCat结合了先进的人工智能技术，为您提供即时视频字幕翻译，无论是本地视频还是网络流媒体，让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台，利用前沿AI技术，为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图，再到文案生成，美间让创意设计更简单、更高效。

Project Cover

稿定AI

稿定设计 是一个多功能的在线设计和创意平台，提供广泛的设计工具和资源，以满足不同用户的需求。从专业的图形设计师到普通用户，无论是进行图片处理、智能抠图、H5页面制作还是视频剪辑，稿定设计都能提供简单、高效的解决方案。该平台以其用户友好的界面和强大的功能集合，帮助用户轻松实现创意设计。

使用协议隐私政策广告服务
投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号