Hyprswitch 安装与使用指南

Hyprswitch 安装与使用指南

hyprswitch A CLI/GUI that allows switching between windows in Hyprland 项目地址: https://gitcode.com/gh_mirrors/hy/hyprswitch

Hyprswitch 是一个专为 Hyprland 窗口管理器设计的 CLI/GUI 工具，它允许用户通过键盘快捷键或图形界面切换窗口。本指南将详细介绍其目录结构、启动文件以及配置相关的知识。

1. 项目目录结构及介绍

以下是 Hyprswitch 的基本目录结构及其简要说明：

.
├── Cargo.lock      # Rust 依赖关系锁定文件
├── Cargo.toml      # Rust 项目配置文件
├── flake.lock      # Nix flakes 锁定文件（用于NixOS安装）
├── gitignore       # Git 忽略文件列表
├── LICENSE         # 许可证文件，采用MIT协议
├── PKGBUILD        # Arch Linux 包构建脚本
├── README.md       # 项目的主要文档，包含使用说明
├── flake.nix       # Nix flake 配置文件
└── src             # 源代码目录
    ├── main.rs     # 主程序入口
    └── ...         # 其他Rust源文件

• Cargo.lock 和 Cargo.toml 是 Rust 项目的核心，定义了项目的依赖项和元数据。
• PKGBUILD 是用于在Arch Linux上创建软件包的文件。
• flake.nix, flake.lock, 用于Nix系统上的配置与构建。
• src/main.rs 是项目的主入口点，控制程序的启动流程。
• README.md 包含详细的安装与使用指南，是用户首次接触项目时的重要信息来源。

2. 项目的启动文件介绍

主程序启动

项目主要由 src/main.rs 负责启动。当你通过 cargo run 或安装后的命令执行 hyprswitch 时，就是从这里开始执行的。该文件初始化应用程序，包括GUI的启动逻辑、命令行参数的处理等核心功能。

命令行启动示例

用户可以通过以下命令来运行Hyprswitch的不同模式：

• 直接切换窗口而不使用GUI：hyprswitch simple
• 启动带有GUI的模式：hyprswitch gui

对于Hyprland配置文件 (~/.config/hypr/hyprland.conf)，添加如下的行可以在Hyprland启动时自动运行Hyprswitch的守护进程：

exec-once = hyprswitch init &

3. 项目的配置文件介绍

Hyprswitch本身并不直接提供一个独立的配置文件来定制其行为，但它的功能很大程度上依赖于如何集成到你的Hyprland配置中。因此，配置主要发生在Hyprland的配置文件(~/.config/hypr/hyprland.conf)中。

你需要在Hyprland的配置中设置快捷键绑定来调用Hyprswitch，并且可以利用命令行参数进行一些自定义。例如：

• 设置快速启动GUI：bind = $MODKEY Tab exec hyprswitch gui
• 自动初始化Hyprswitch守护进程：在配置文件顶部加入 exec-once = hyprswitch init &

对于更复杂的交互需求，比如子映射(submaps)以实现更多键绑定，这些都需要在Hyprland的配置体系内完成，而不是在Hyprswitch侧直接配置。

综上所述，虽然Hyprswitch不维护单独的配置文件，但它通过灵活的命令行参数和与Hyprland紧密的集成，提供了丰富的定制选项，以满足不同用户的窗口切换需求。

hyprswitch A CLI/GUI that allows switching between windows in Hyprland 项目地址: https://gitcode.com/gh_mirrors/hy/hyprswitch