显示切换器（display-switch）安装与配置指南

显示切换器（display-switch）安装与配置指南

display-switchTurn a $30 USB switch into a full-featured multi-monitor KVM switch项目地址:https://gitcode.com/gh_mirrors/di/display-switch

1. 项目目录结构及介绍

display-switch 是一个开源项目，旨在将廉价的USB开关转换成支持多功能的多显示器KVM交换机。以下是基于提供的内容对项目关键目录结构的一个简要概述：

• 根目录:
  • src: 包含项目的主要Rust源代码。
  • Cargo.toml: 是Cargo清单文件，定义了项目依赖和元数据。
  • README.md: 提供了项目的简介、安装步骤、配置说明等重要信息。
  • daemon: 存放用于后台运行服务的配置或脚本，如在Linux中的systemd单元文件示例。
  • dev: 可能包含开发过程中的辅助文件或示例脚本，如MacOS的LaunchAgent配置。

2. 项目的启动文件介绍

此项目的核心在于其可执行文件 display_switch ，该文件通常位于项目编译后的 target/release/ 目录下。部署时，需要将其复制到系统路径中，例如 /usr/local/bin/，以便从命令行轻松访问。

对于不同操作系统，启动方法有所不同：

• Windows: 直接执行编译好的可执行文件或者创建批处理文件来调用。
• Linux: 设置为systemd服务，通过命令 systemctl --user start display-switch.service 启动。
• MacOS: 使用 LaunchAgent 脚本自动在用户登录时启动。

3. 项目的配置文件介绍

配置文件是让 display-switch 根据特定硬件事件（如USB设备连接和断开）自动调整显示器输入的关键。文件位置因操作系统而异：

• 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设备ID (usb_device) 和当设备连接或断开时显示器应切换到的输入 (on_usb_connect, on_usb_disconnect)。例如：

[General]
usb_device = "1050:0407"
on_usb_connect = "Hdmi1"
on_usb_disconnect = "Hdmi2"

此外，项目支持为不同的显示器指定单独的配置，确保了灵活性，通过指定 monitor_id 实现：

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

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

请注意，进行配置更改后，可能需要重启相关的服务或应用以应用新设置。这个项目特别强调了跨平台兼容性并提供了一套详尽的指导，使技术专家可以高效地部署和管理多显示器环境。

display-switchTurn a $30 USB switch into a full-featured multi-monitor KVM switch项目地址:https://gitcode.com/gh_mirrors/di/display-switch