这是什么？

iNiR 就是你的整个桌面。顶部的栏、dock、通知、设置、壁纸，全部都是。它不是主题，也不是拿来粘贴的 dotfiles，而是一个运行在 Linux 上的完整 shell。

运行它需要什么？

一个合成器。它负责管理窗口，把像素画到屏幕上。iNiR 为 Niri（一个 Wayland 平铺合成器）而做。代码里还留着一些 Hyprland 的旧代码，来自它还是 end-4 dots 分支的时候，但我真正在用、在测试的是 Niri。

这个 shell 运行在 Quickshell 上，它是一个用 QML（Qt 的界面语言）构建 shell 的框架。使用时这些都不用懂：一切都能在图形界面或 JSON 文件里配置。

各部分如何连接

your apps
   ↓
iNiR (shell: bar, sidebars, dock, notifications, settings...)
   ↓
Quickshell (runs QML shells)
   ↓
Niri (compositor: windows, rendering)
   ↓
Wayland → GPU

稳定吗？

这是一个做着做着就停不下来的个人项目。我每天都在用，Discord 里也有很多人在用。但偶尔还是会坏，代码有些地方很乱，我也在边做边学。

如果有东西不工作，inir doctor 能修好大部分问题。还不行的话，Discord 很活跃。只是别指望它是打磨完美的软件：这是一个人的 rice，碰巧别人也喜欢。

为什么会有它？

我想让自己的桌面长成某个样子、按某种方式工作，而没有任何东西正好做到这一点。它从 end-4 的 Hyprland dots 起步，后来变成了为 Niri 完全重写、功能多得多的版本。

你会看到的词

• Shell：界面层（栏、面板、覆盖层）
• 合成器：管理窗口、绘制屏幕（Niri、Hyprland、Sway...）
• Wayland：Linux 的显示协议（新的那个，取代 X11）
• QML：Qt 的声明式界面语言，iNiR 就是用它写的
• Material You：Google 从图片生成配色的颜色系统（自动主题就是靠它）
• ii / waffle / iRiS：三个面板家族。ii 是 Material Design 风格，waffle 是 Windows 11 风格，iRiS 是一个会变成你所打开内容的 Island。Super+Shift+W 在它们之间切换

iRiS

• Island：屏幕边缘的一个形状，告诉你“正在发生什么”，并变成你打开的页面、卡片或面板，然后再收起来。可放在上、下、左、右（inir iris edge <side>，或直接拖过去）。放在侧边时它会竖起来，时钟竖排，气泡在上下两侧
• 菜单栏：一条细长的栏，放着工作区、当前窗口和组件，Island 像刘海一样挂在它下面（inir iris layout menubar）
• 全宽栏模式，有开始、中间和结尾三个区域，可以放 Island、工作区、焦点窗口、时间或任何组件（inir iris zone start|center|end kinds+joined+with+plus）
• 组件（pieces）：天气、声音、麦克风、托盘、通知、工具、媒体、VPN、可视化器、动漫（Airing 和 Continue）以及你自己的应用，以气泡的形式放在 Island 上、屏幕轮廓上或桌面任意位置
• 组件会并入它碰到的东西：把一个放到 Dock 或 Island 的边上，它就成为那个主体的一部分，而不是浮在上面
• Dock 可放在任意边缘（inir iris dockEdge <side|auto>）；auto 时位于 Island 对面，把一个移到另一个所在的边缘，它们会互换位置
• 玻璃：在每个表面下对壁纸做磨砂处理，即使在明亮或花哨的壁纸上也能保持文字清晰。合成器模糊也有，但仍在开发中，先别急着评价
• Themes：20 套精选重新设计（Liquid Glass、Frost、Obsidian、Terminal、Neo Tokyo、Twilight、Lume、Sakura、Unit-01 等），以及你自己的、可分享的 JSON 文件（inir iris theme）
• 浅色、墨色和深色，各有自己的色调和磨砂程度，还有你的应用也会跟着使用的配色主题（Catppuccin、Nord、Rosé Pine、Tokyo Night…）（inir iris palette）
• 形状：Island 和 Dock 可选胶囊、圆形、超椭圆或方形
• 在 shell 上直接 Customize：点一下 Island、Dock 或气泡，它的选项就从原地展开，Island 下方有 Themes、Look、Pieces 和撤销（inir iris edit）。如果你更喜欢，Studio 会把所有内容放在屏幕旁的一个面板里
• 由你排布的控制中心：每个共享快捷开关、播放器和每个滑块都是格子，可以拖动、从角落调整大小，并从旁边的库里添加，提供六种起始布局；右键可展开控件（inir iris control edit）
• 可以排练的锁屏：真正的锁屏以可编辑状态打开，不需要解锁；移动时钟、播放器和登录框，并选择背景播放的内容，包括视频（inir iris lock edit）

主题与外观

• 9 种全局风格：Material（实色）、Cards、Aurora（玻璃模糊）、iNiR（TUI 风格）、Angel（新粗野主义）、Regalia（黑色机身、温暖的象牙色墨水、克制的香槟色细节）、ZZZ（海报板块）、Cookie Shapes（形状变换动画）、Editorial（纸墨排版）
• 来自壁纸的动态颜色，通过 Material You 应用到整个系统
• 10 个终端和 TUI 工具自动主题化：foot、kitty、alacritty、ghostty、wezterm、starship、fuzzel、btop、lazygit、yazi
• 应用主题：GTK3/4、Qt（通过 plasma-integration 和 darkly）、Firefox、Discord/Vesktop（System24）、Zed、Spicetify、Steam、SDDM
• 主题预设：Gruvbox、Catppuccin、Rosé Pine 等，或者自己做一个
• 视频壁纸：mp4/webm/gif，可选模糊，也可以冻结第一帧以节省性能
• 桌面小组件：所有小组件共用一种设计（iRiS、Material、iNstrument 或 Readout），像 iOS 那样轮换的堆叠，以及随下方壁纸变化的墨色

栏

• 6 种栏样式：classic、islands、scenic、frame、Material 3 胶囊和 pill
• Pill 栏：一个会变形的中央岛，悬停时展开工作区、启动器、混音器、媒体、日历和录屏
• 模块化布局，设置里有拖放编辑器，任何模块都能放到任何位置
• 垂直栏，给想要把屏幕边缘拿回来的人

侧边栏与小组件（Material ii）

左侧栏（应用抽屉）：

• AI 聊天：Ollama、LM Studio、OpenRouter、Gemini、Groq、Mistral、Cerebras、Anthropic、OpenAI 和 OpenCode 的实时模型目录
• YT Music：无需 cookie 的 InnerTube 播放器，支持搜索、队列、电台和同步歌词
• Wallhaven 浏览器：直接搜索并应用壁纸
• 动漫追踪：集成 AniList，带播出时间表
• 翻译：通过 Gemini 或 translate-shell
• 可拖动小组件：加密货币、媒体播放器、快速笔记、状态环、周历

右侧栏：

• 日历，集成事件
• 通知中心
• 快捷开关：WiFi、蓝牙、夜间模式、勿扰、电源模式、WARP VPN、EasyEffects
• 音量混合器，可按应用调节
• 蓝牙和 WiFi 设备管理
• 番茄钟、待办、计算器、记事本
• 系统监视器：CPU、内存、温度

工具

• 工作区概览：适配 Niri 的滚动模型，带应用搜索和计算器
• 仪表板：可配置的三栏覆盖层，包含日程、通知、待办、笔记、媒体和天气
• 边缘工作区条：悬停时出现，带实时工作区预览，可拖动排序
• 窗口切换器：跨所有工作区的动画 Alt-Tab，Niri 自带了之后改为可选
• 剪贴板管理：带搜索和图片预览的历史
• 区域工具：截图、录屏、OCR、以图搜图
• 快捷键速查：从你的 Niri 配置中读取快捷键
• 媒体控制：完整的 MPRIS 播放器，多种布局
• 屏幕提示：音量、亮度和媒体
• 听歌识曲：通过 SongRec 实现类似 Shazam 的识别
• 语音输入：已安装时使用本地 whisper.cpp，或连接 Groq、Gemini、OpenAI

系统

• 图形化设置：不碰文件就能配置一切
• GameMode：全屏应用时自动关闭特效
• 自动更新：inir update，支持回滚、迁移并保留你的改动
• 锁屏和会话屏幕（注销/重启/关机/挂起）
• Polkit 代理、屏幕键盘、基于 niri 自身启动文件的自启动管理
• Kira：一个像素风猫娘，会在屏幕边缘走来走去，对你的操作做出反应，还有混乱模式。可选，单独的约 32 MiB 美术包在 ./setup › Extras 里
• 18 种语言，自动检测，包括印尼语（id_ID）和格陵兰语（kl_GL）
• 夜间模式：定时或手动
• 天气：Open-Meteo，支持 GPS、手动坐标或城市名
• 电池管理：可配置阈值，电量危急时自动挂起
• 自定义事件音效，有总音量，每个事件可用单独的音频文件
• 更新检查：有新版本时提醒你