实用知识 / FIELD GUIDE

Omarchy 壁纸：个人背景、裁切、多屏、视频与恢复

不改调色板添加背景，理解选择目录和多屏裁切，判断视频资源消耗，并排查图片缺失与缓存。

资料核对2026-10-13官方背景手册；选择、状态与静态图片裁切固定至 defbf90e（4.0.0.alpha）13 分钟阅读

根据公开资料整理，未在实机验证。操作前请核对你的版本与硬件环境。

壁纸是窗口背后的媒体，主题则提供应用颜色与其他样式。可以保留 Catppuccin、Gruvbox 等配色，只替换图片。文字已经清楚、图片却干扰工作时，这通常比换整套主题更容易判断效果。

背景来自哪里

官方背景指南提供菜单流程。固定布局会合并当前主题的 backgrounds/ 与该主题的个人目录，然后更新当前背景链接并通知运行中的面板进程。

主题 backgrounds + ~/.config/omarchy/backgrounds/<theme>/
  → 有顺序的候选文件
  → current/background 符号链接
  → 通知桌面背景更新
  → 在显示界面中渲染

位置	用途
`~/.config/omarchy/backgrounds/<theme>/`	与系统源文件分开保存个人图片
主题源的 `backgrounds/`	该主题提供的素材
`~/.local/state/omarchy/current/background`	查看当前选择，不是素材存储目录
`~/.local/state/omarchy/current/theme/`	生成的主题状态，不是永久个人素材

固定的轮换工具查找目录顶层文件，不会递归任意相册子目录。之后移动正在引用的图片，可能破坏当前链接。

本文选择器识别 JPG/JPEG、PNG、GIF、BMP、WebP 与列出的影音扩展名。识别扩展名不保证损坏文件能解码；把其他格式重命名成 .png 不是修复。

想明确指定一个文件，可在对应命令集中使用：

omarchy-theme-bg-set "$HOME/Pictures/my wallpaper.png"

换成真实存在的路径，引号保留空格。设置工具解析文件并让当前状态指向它，不会复制到个人素材库。需要参与正常轮换，应放到个人背景目录。

固定的静态渲染组件保留长宽比例并裁切：先缩放到填满界面、不留空边，再裁掉多出来的部分。

原图尺寸 Iw × Ih，显示界面尺寸 Sw × Sh 时：

缩放比例 = max(Sw / Iw, Sh / Ih)
缩放后的尺寸 = Iw × 比例, Ih × 比例
超出的宽/高 = 缩放后的尺寸 − 显示界面尺寸

3840 × 2160 图片放在 1920 × 1080 界面，比例相同，不需要因比例裁切；放在 1080 × 1920 竖屏，按高度缩放后宽度约 3413 像素，只能看到原图宽度约 31.6%。更高分辨率不能解决构图问题。

竖屏或不同长宽比组合，应选主体靠近中央、周围留空间的图片，或制作符合目标比例的裁切版本。选择后检查两块屏幕。本页不编造逐显示器独立壁纸命令；承诺每屏不同图片之前，要核对实际安装的桌面能力。一个当前背景链接，也不表示图片会横跨所有屏幕拉成一整张画布。

官方列出 MP4、M4V、MOV、WebM、MKV、AVI，由 OWE 提供视频背景；说明包含跨屏共享解码、隐藏时暂停，以及锁屏的静音/缓存静帧处理。GIF 在桌面和锁屏也不同。这些行为依赖安装的集成，启动磁盘解锁又是另一界面。

先用一段短的本地视频，检查编码兼容、CPU/GPU 活动、声音、锁屏与惯常电池表现。共享解码不代表渲染零成本，本站没有可承诺的省电百分比。动画或声音影响工作时，返回静态图片即可，不必禁用整个面板进程。

固定状态布局可这样只读查看：

omarchy-theme-current
readlink -f ~/.local/state/omarchy/current/background
file -- "$HOME/Pictures/my wallpaper.png"

最后一条应填实际候选路径，不一定是当前图片。file 查看真实内容格式；解析后的链接应指向仍存在的文件。

恢复时选择已知可用的主题背景，或重新应用原主题。移除个人图片前备份，不要为重置壁纸删除整个当前状态目录。持久颜色修改可看应用主题差异，屏幕位置与缩放可看显示器指南。