如何快速在 driftwm 上搭建完整桌面：waybar、fuzzel 与 QuickShell 整合实战指南-开发者社区

【免费下载链接】driftwm

A trackpad-first infinite canvas Wayland compositor.

项目地址：https://gitcode.com/gh_mirrors/dr/driftwm

driftwm 是一款触控板优先的无限画布 Wayland 合成器，本文带你用仓库自带的 extras 套件，一条命令搭出完整日常桌面——QuickShell 首页仪表盘、fuzzel 统一搜索与 waybar 触摸栏一步到位。

一条命令完成安装：extras 安装脚本

📦 driftwm 的 extras/ 目录是一个"拿来即用"的桌面套件：配置、脚本、主题、着色器壁纸和仪表盘一次装齐。

先装依赖：通过你的发行版包管理器安装 Quickshell（qs）、swaync、swayosd、fuzzel、jq、swaylock、swayidle、brightnessctl、playerctl、wl-clipboard 等工具；
运行安装脚本：

./extras/install.sh

脚本是幂等且非破坏性的：已有配置会先带时间戳备份，再复制 extras/config.toml 到~/.config/driftwm/，fuzzel 与 swaync 主题分别落到~/.config/fuzzel/和~/.config/swaync/。缺少的工具只会让对应功能静默跳过，不会报错崩溃，随时可重跑补全（详见 extras/README.md）。

QuickShell 首页仪表盘：画布原点的"家"

⌂ 安装后，extras/quickshell/Dashboard.qml 定义的仪表盘会以drift-dashboard窗体的身份被钉在画布原点——你的"home"。按Mod+A（或四指外张捏合）即可随时跳回家。

仪表盘采用纯文本 i3bar 风格，点击磁贴展开控制面板：

time：点击弹出日历；kbd：切换键盘布局
net：Wi-Fi 开关与附近网络列表，点击连接（新网络自动弹出密码输入框）
blu：蓝牙开关、扫描与配对管理
vol / bri / bat：音量、亮度滑块、电量与剩余时间
CPU / RAM：实时资源占用；tray：系统托盘（左键激活、右键菜单）
媒体控制：跟随当前播放设备；power：锁屏、注销、休眠、关机

启动行就在配置的 autostart 里（extras/config.toml）：

autostart = [ "swaync", "swayosd-server --top-margin 0.95", "qs -p ~/.config/driftwm/quickshell", # ... ]

仪表盘想手动调试？直接qs -p ~/.config/driftwm/quickshell单独运行即可。window_rules 中的position = [0, 0]+widget = true让它固定不动，[navigation] anchors = [[0, 0]]则保证即使原点没有窗口，四指滑动也能"导航回家"。

fuzzel Spotlight：一框搜索窗口与应用

🔍 裸机版Mod+D只是普通启动器；extras 把它升级为Spotlight：一次输入，同时搜索打开的窗口、挂起的窗口、已安装的应用。选中窗口直接聚焦，选中挂起窗口立即重新唤起，选中应用则启动。

核心逻辑在 extras/scripts/spotlight.sh：通过driftwm msg state --json一次 IPC 拉取画布状态（挂起窗口不是 foreign toplevel，只有 IPC 能看到），再喂给fuzzel --dmenu；应用列表按 .desktop 文件缓存，并复用 fuzzel 的使用频率缓存做排序——你常用什么，它就排最前面。

主题方面，extras/fuzzel/fuzzel.ini 配了一个无图标的极简灰主题，半透明背景配合合成器模糊，与通知中心视觉统一。IPC 命令细节可查 docs/cli.md。

waybar touchbar：可选的触控屏底栏

📱 如果你有触摸屏，extras 还附赠一条极简 waybar 底栏：左侧大按钮一键呼出 wvkbd 虚拟键盘，右侧是 Wi-Fi / 音量 / 电池 / 时钟，点击展开百分比，低电量自动变红。

它默认不安装（避免桌面环境冲突），需要时手动复制 extras/waybar/ 到~/.config/waybar/，再按 touchbar.jsonc 顶部的提示启动：

waybar -c ~/.config/waybar/touchbar.jsonc -s ~/.config/waybar/touchbar.css

虚拟键盘的开关由 wvkbd-toggle.sh 完成：首次点击启动 wvkbd，之后每次点击通过 SIGRTMIN 信号切换显隐，只操作自己启动的那个进程，干净利落。

磨砂玻璃视觉统一：swaync 与 swayosd

✨ 套件的点睛之笔是整体"磨砂"质感：extras/swaync/style.css 只改了一处——把通知中心外角拉直，其余沿用默认；fuzzel、swayosd 的主题都是半透明的，配合 config.toml 的 blur 设置（blur_radius = 5）和 window_rules 的 blur 规则，swaync 面板、fuzzel 启动器、swayosd 音量 OSD 背后全部实时模糊。

媒体键也被接管：XF86Audio*/XF86MonBrightness*全部路由到 swayosd-client（keybindings 段落），每次调节音量/亮度都有带磨砂背景的 OSD 反馈。

常用快捷键速查

快捷键	作用
`Mod+A`/ 四指外张捏合	回到画布原点（仪表盘）
`Mod+D`	Spotlight：搜索窗口 + 应用
`Mod+N`	打开通知中心
`Mod+Shift+Q`	挂起当前窗口（Spotlight 可重新唤起）
`Mod+M`/`Mod+Shift+M`	窗口 / 吸附集群自适应（放大类比）
`Ctrl+Print`	窗口截图直接进剪贴板
媒体键	音量/亮度 OSD（swayosd）

常见问题与进阶

部分工具没装会怎样？全部优雅降级——比如没装 playerctl 就没有媒体控制，其余照常。
想改哪些选项？配置是部分合并的，只写你要改的项即可；全部选项都有文档：config.reference.toml 与 docs/config.md。
换壁纸？extras/wallpapers/ 里的 GLSL 着色器壁纸装好后，把[background]指向~/.config/driftwm/wallpapers/下的某个.glsl即可，教程见 docs/gigapixel-wallpapers.md 与 docs/shaders.md。
会话恢复？配置已开启restore_windows+restore_camera，注销再登录，窗口和镜头位置都在。

搭好之后，Mod+A回家看看仪表盘、Mod+D随手搜个应用——你的无限画布桌面就已经完整运转起来了。