SmallWM 开源项目教程

1. 项目介绍

SmallWM 是一个基于 Xlib 的轻量级窗口管理器，它是 TinyWM 的扩展版本，旨在满足实际桌面使用的需求。SmallWM 提供了许多改进功能，包括窗口图标化、窗口层叠、点击聚焦和焦点循环、移动/调整占位符、多虚拟桌面、窗口吸附和窗口打包等。

2. 项目快速启动

环境准备

• 安装 Xlib 和 XRandR 头文件（通常可以通过包管理器轻松安装）。
• 安装 C++ 编译器，如 GNU G++ 或 clang++。
• 安装 C 编译器，如 GNU C 或 clang，用于构建包含在 SmallWM 中的 inih 库。

构建项目

git clone https://github.com/adamnew123456/SmallWM.git
cd SmallWM
make

构建完成后，你会在当前目录下得到 smallwm 二进制文件。

运行项目

将 smallwm 二进制文件移动到 /usr/local/bin 目录下：

sudo mv smallwm /usr/local/bin/

创建一个启动脚本 smallwm.sh 并放置在 /usr/share/xsessions/ 目录下：

#!/bin/bash
if [ -x $HOME/.smallwmrc ]; then
    $HOME/.smallwmrc &
fi
exec /usr/local/bin/smallwm

在 smallwm.sh 文件上设置执行权限：

sudo chmod +x /usr/share/xsessions/smallwm.sh

现在你可以从登录管理器中选择 SmallWM 作为窗口管理器。

3. 应用案例和最佳实践

配置文件

创建一个配置文件 $HOME/.config/smallwm/config，用于自定义窗口管理器的行为。以下是一个示例配置：

[smallwm]
shell=xterm
desktops=5
icon-width=75
icon-height=20
border-width=4
icon-icons=1
log-level=WARNING
hotkey-mode=focus
dump-file=/dev/null

应用案例

• 窗口吸附：使用 Super+Up 键将当前窗口吸附到屏幕顶部。
• 窗口最大化：使用 Super+m 键最大化当前窗口。
• 切换虚拟桌面：使用 Super+, 和 Super+. 键在虚拟桌面之间切换。

4. 典型生态项目

• Stalonetray：一个流行的系统托盘程序，可以与 SmallWM 配合使用。
• Xclock：一个简单的时钟应用程序，可以放在桌面任意位置。

以上就是关于 SmallWM 的开源项目教程，希望对您的使用和学习有所帮助。