niri 可滚动平铺 Wayland 合成器配置实操指南：5 分钟装好并定制你的第一套桌面

niri 可滚动平铺 Wayland 合成器配置实操指南5 分钟装好并定制你的第一套桌面【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niriniri 是一款可滚动平铺scrollable-tiling的 Wayland 合成器窗口按列排布在可无限横向滚动的条带上打开新窗口不会挤压已有窗口。本文面向刚接触 niri 的 Linux 用户装好、写出第一份 config.kdl、排掉常见坑。一分钟认识它niri 是什么、适合谁它是什么用 Rust 编写的 Wayland 合成器窗口以列为单位横向排列鼠标滚轮或触摸板就能左右滚动工作区在垂直方向动态生成。适合谁喜欢键盘驱动 手势操作、受够了开一个窗口所有窗口跟着缩放的人。核心卖点每块显示器有独立的窗口条带窗口绝不会溢出到相邻屏幕配置热重载保存即生效。特性一句话说明可滚动平铺窗口按列排布横向无限滚动动态工作区垂直排布底部永远有一个空工作区配置热重载保存文件即应用无需重启合成器多显示器每块屏幕独立窗口条带混合 DPI 可用内置截图PrtSc 直接框选截图AltPrtSc 截当前窗口最短路径跑起来各发行版的 niri 安装命令这一节的目标只有一件事让 niri 会话出现在你屏幕上。以下都是发行版现成软件包按你的系统选一行执行即可。系统命令Fedorasudo dnf copr enable avengemedia/dms然后sudo dnf install niri dmsArch Linuxsudo pacman -Syu niri xwayland-satellite xdg-desktop-portal-gnome xdg-desktop-portal-gtk alacritty dms-shell-niri matugen cava qt6-multimedia-ffmpegUbuntu 25.10 及以上sudo add-apt-repository ppa:avengemedia/danklinux再sudo add-apt-repository ppa:avengemedia/dms最后sudo apt install niri dms装完后Fedora 和 Arch执行一次systemctl --user add-wants niri.service dms登录时才会自动拉起会话。接着注销在显示管理器里选 Niri 重新登录不用显示管理器的话直接在 TTY 里运行niri-session。验证方法用 ModTMod 即 Super 键打开终端运行niri msg outputs能看到你的屏幕列表说明会话和 IPC 都正常。第一份配置文件写出并校验 config.kdl这一节的目标把自动生成的默认配置换成你自己的最小版本。文件在~/.config/niri/config.kdl不存在时 niri 首次启动会自动生成一份。格式是 KDL//开头是注释在节点前写/-可以整段注释掉。有一点要注意binds段不会自动填充默认值自己写配置时别把这一段删了否则所有快捷键全部失效。input { touchpad { tap natural-scroll } } layout { gaps 16 } binds { ModT { spawn alacritty; } ModQ { close-window; } ModShiftE { quit; } }参数说明tap开关型标志触摸板单指点按算左键点击写了就启用注释掉就关闭natural-scroll自然滚动滚动方向跟手指动作一致gaps 16窗口之间的间隙单位是逻辑像素ModTMod 在 TTY 下等于 Super在嵌套窗口模式下等于 Altspawn alacrittyspawn 不走 shell每个参数必须单独加引号quit退出前弹确认框防止误触保存后配置会热重载。想确认有没有写坏在终端运行niri validate有解析错误会直接打出来无输出即通过。再按 ModT 试试新绑定的终端快捷键。高频进阶场景多屏、布局、动画与快捷键配置多屏摆放一个 output 段配好目标固定两块屏幕的位置和模式让光标在屏间正常移动。output eDP-1 { scale 2 } output HDMI-A-1 { mode 1920x108060.000 position x1920 y0 }屏幕名用niri msg outputs查写错名字整段都不生效。mode 里的刷新率必须和小数点后三位完全一致。position 按逻辑像素计算要算上 scale。效果每块屏各自一条窗口条带光标只能穿过直接相邻的屏幕边界摆放顺序和物理位置对齐。布局间隙与焦点环layout 段调整目标加宽窗口间隙换一个醒目的焦点环。layout { gaps 24 center-focused-column on-overflow focus-ring { width 4 active-color #7fc8ff } }gaps控制窗口间距center-focused-column控制聚焦列是否在放不下时自动居中可选never、always、on-overflow。focus-ring 的 width 是环向外扩展的像素数颜色支持 CSS 写法还能用渐变。效果切到屏外的列时自动居中显示当前窗口被一圈蓝色描边标出。动画手感自定义窗口打开动画目标让窗口开合的节奏慢一点、顺一点。animations { window-open { duration-ms 200 curve ease-out-expo } window-close { duration-ms 150 curve ease-out-quad } }缓动型动画只有两个参数duration-ms是时长curve从ease-out-quad、ease-out-cubic、ease-out-expo等里选。想要带惯性的回弹感就改用spring配合 damping-ratio 等参数试调。效果窗口展开花 200 毫秒且末端减速不再啪地弹出来。快捷键绑定给 binds 加自己的键目标绑一个音量面板再让键盘物理静音键在锁屏时也能用。binds { ModP repeatfalse { spawn pavucontrol; } XF86AudioMute allow-when-lockedtrue { spawn-sh wpctl set-mute DEFAULT_AUDIO_SINK toggle; } }repeatfalse让按住不连续触发allow-when-lockedtrue使快捷键在锁屏时依然有效spawn-sh把整条命令作为单个参数交给sh -c支持变量展开和管道。找不到某个键的 XKB 名字时用wev工具按一下该键即可看到名字。效果ModP 一键打开音量面板键盘的静音键锁屏后照样工作。出问题先查这里niri 常见问题速查现象最可能原因一步修复启动后出现两条任务栏默认配置自带 waybar和 DMS 自带的栏重复pkill waybar并删掉配置里的spawn-at-startup waybar行改了配置却不生效KDL 语法错误整个文件未被重新加载终端运行niri validate定位解析错误output 段完全不生效屏幕名和真实名称对不上用niri msg outputs查真实名字高刷新率没打上mode 的刷新率没有和小数点后三位完全一致照抄niri msg outputs里列出的 modeNVIDIA 显卡 TTY 启动黑屏驱动过旧不支持 GBM或未开内核 modeset按 docs/wiki/Nvidia.md 修驱动或在内核参数加nvidia-drm.modeset1下一步niri 官方文档与资源入口想查全部配置项从 docs/wiki/Configuration:-Introduction.md 入手input、layout、window-rule、animations 等每个段都有独立页面里面含完整参数说明和示例。日常使用离不开的通知守护进程、portal 等软件清单见 docs/wiki/Important-Software.md要跑 X11 应用Steam、Discord 等看 docs/wiki/Xwayland.md。配置改乱了想回退对照内置的默认配置 resources/default-config.kdl 逐项核对更细的疑难杂症先翻 docs/wiki/FAQ.md。【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考