GlazeWM 技术使用手册
安装指南
GlazeWM 的最新版本可通过访问 GitHub 发布页面来下载。如果您偏好手动编译,参考 贡献指南,但请注意目前Scoop和Winget不支持一键安装。
在安装过程中,您有选项可选择是否一并安装Zebar作为状态栏。直接运行安装程序,并根据提示操作即可完成安装。
使用说明
GlazeWM 是一款灵感源自i3wm的Windows平台窗口管理器,强调键盘驱动的高效窗口组织与布局调整。
启动与配置文件
首次启动时,GlazeWM提供自动生成默认配置文件的选项。配置文件默认位于 %userprofile%\.glzr\glazewm\config.yaml
。若要指定其他配置文件位置,可以在命令行中使用如下命令:
./glazewm.exe --config="C:\路径\至\您的\配置文件\config.yaml"
默认快捷键
GlazeWM提供一系列默认的键盘快捷键以执行各种操作,具体快捷键详情可见随软件附带的图表或在资源目录下的 cheatsheet.png
文件。
配置文档详述
常规设置
- 启动命令 (
startup_commands
):定义WM启动时自动执行的脚本或应用程序。 - 鼠标焦点跟随 (
focus_follows_cursor
):决定光标移动到哪个窗口时是否自动聚焦该窗口。 - 工作区切换 (
toggle_workspace_on_refocus
):重新聚焦当前工作区时是否切换回之前的工作区。 - 光标跳跃设置 (
cursor_jump
):控制光标在特定触发(如切换显示器或窗口)时是否自动移动。
键绑定定制
键绑定允许高度个性化,通过修改 keybindings
部分,您可以创建新的或者修改现有的快捷方式。每项键绑定包含一个或多个命令以及相应的按键组合。
例如,将窗口移动到第一个工作区并聚焦该工作区的配置如下:
- commands: ["move --workspace 1", "focus --workspace 1"]
bindings: ["alt+shift+1"]
API使用文档
尽管GlazeWM的核心是配置文件和键盘交互,没有明确的传统意义上的API接口供外部调用,其配置机制本身可以看作是一种内部API。上述配置节选展示了如何通过YAML配置文件来“编程”WM的行为。
工作空间与规则
工作空间需要在配置文件的workspaces
部分预先设定,您也可以为特定应用定义规则,使它们按您的需求打开或行为与众不同。
项目安装方式回顾
再次强调,安装GlazeWM主要通过访问官方GitHub发布页手动下载最新的发行版。源代码编译则要求遵循贡献指南中的指引进行。
通过这篇技术文档,希望用户能够顺利安装并深入理解GlazeWM的各项功能,充分利用它提升Windows桌面的管理和工作效率。