← 返回系统组成地图
把这一层分成 媒体处理、设备策略、桌面访问、具体应用 四部分更容易理解。PipeWire 连接与处理媒体流，WirePlumber 管理设备和路由策略；Hyprland desktop portal 让应用请求桌面共享能力。播放器与录制工具则完成用户的实际任务。
播放视频： mpv 读取并解码文件，将画面交给桌面显示，声音通过所配置的音频输出路径送往设备。在 PipeWire 音频会话中，WirePlumber 的策略会影响流与设备的连接。使用蓝牙耳机还涉及 BlueZ。
共享屏幕： 支持门户的应用请求共享，门户后端与 Hyprland 协调捕获能力，并通过媒体流把画面交给应用。是否弹出选择器、是否收到画面和是否带有声音，是可以分别检查的环节。
录制视频： Omarchy 使用适合平台的捕获流程，GPU Screen Recorder 与 Apple Silicon 清单中的 wf-recorder 是不同后端，不需要串联运行。录制也不一定与浏览器共享屏幕采用完全相同的路径。
以下逐一介绍本分类已收录的全部组件，涵盖用途、原理、配置、排查、注意事项与学习资料。点击目录中的名称可跳转到相应正文。
本分类已收录的全部 6 个组件
PipeWire 的会话与策略管理器，负责设备选择及音频路由。
- 包名
wireplumber- 收录状态
- 核心清单
用途与日常使用
为 PipeWire 会话管理设备、配置模式和路由策略。声音输出到错误设备、耳机模式变化或默认设备不符合预期时，这一层尤其值得检查。
工作原理与协作关系
PipeWire 处理音频流，WirePlumber 决定设备与音频流如何组织。蓝牙音频还依赖 BlueZ，因此无声问题需要沿设备连接、会话策略和音量逐层分析。
配置与定制
日常切换输出先使用桌面音频面板。高级规则需要匹配 WirePlumber 版本；0.4 的旧示例与 0.5 配置机制存在差异，不应仅改文件名后直接套用。
常见问题与排查思路
查看 wpctl status、静音状态和当前设备。完全没有设备时，应先检查 PipeWire 与硬件识别；只有默认输出不对时，再集中检查路由策略。
能力边界与修改注意事项
重启会话策略可能打断正在播放或录制的音频。设备数字编号可能变化，不应把一次观察到的编号当作长期稳定的硬件标识写死在规则中。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi wireplumber
wpctl status
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
音视频处理基础设施。列于其他包清单，仅凭这份清单不能确定每个平台的安装情况。
- 包名
pipewire- 收录状态
- 其他安装候选
用途与日常使用
为音频与桌面视频共享提供媒体流基础设施。它服务于各类应用，本身不是音乐播放器，也不是用户点击的音量面板。
工作原理与协作关系
通过处理图连接媒体节点。WirePlumber 提供会话策略，兼容组件则让使用其他音频接口的应用接入。屏幕共享还涉及桌面门户与合成器。
配置与定制
日常设备切换通过音频面板完成。延迟、采样率和节点等高级设置应按照已安装版本的文档修改；先确认实际需要，再调整会影响所有应用的全局参数。
常见问题与排查思路
检查用户服务，并判断是一个应用还是全部应用异常。本地播放正常但屏幕共享失败，与完全没有音频设备属于不同路径，不能用同一套重置办法处理。
能力边界与修改注意事项
更低延迟可能增加处理压力，应结合设备能力权衡。该包位于其他清单，这个归属本身不代表所有平台都有完全相同的安装配置。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi pipewire
systemctl --user status pipewire --no-pager
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
通过桌面门户接口把应用与屏幕共享等桌面能力连接起来。
- 包名
xdg-desktop-portal-hyprland- 收录状态
- 核心清单
用途与日常使用
为 Hyprland 实现桌面门户功能，尤其是由桌面协调的捕获与共享。应用通过请求访问桌面能力工作，而不是直接接管合成器。
工作原理与协作关系
门户服务选择后端，Hyprland 提供桌面访问，PipeWire 传递媒体流。选择器出现、访问请求成功和真正收到媒体画面，是三个可分别失败的步骤。
配置与定制
后端选择与桌面环境会影响行为。除非正在定位明确冲突，否则应保留发行版的门户配置，不要为了某个应用安装多个后端后假设系统会自动选择正确的一个。
常见问题与排查思路
共享失败时，对比不同应用并查看用户门户日志。能打开选择器但画面全黑，与完全没有选择请求应分别分析，同时核对 PipeWire 与会话环境。
能力边界与修改注意事项
它不是录屏界面。应用支持情况和实际选中的后端同样重要；软件包已经安装，并不能证明当前会话正在使用这个后端。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi xdg-desktop-portal-hyprland
systemctl --user status xdg-desktop-portal-hyprland --no-pager
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
屏幕录制后端；Apple Silicon 平台清单另有 wf-recorder 作为回退方案。
- 包名
gpu-screen-recorder- 收录状态
- 核心清单
用途与日常使用
在硬件支持时借助 GPU 编码捕获桌面视频。Omarchy 提供自己的录制操作流程；这与保存一张静态截图的工作不同。
工作原理与协作关系
捕获画面、采集声音、视频编码和写入文件构成一条处理流程。某一步成功，不保证最终文件一定包含预期画面和声音，需要检查完整结果。
配置与定制
选择当前版本支持的录制目标、音源和输出格式。优先使用 Omarchy 的录制入口，不要直接复制针对另一种显卡的编码命令。
常见问题与排查思路
黑色视频应区分画面捕获与编码支持问题；无声视频则检查音源选择和应用静音。先做短录制并回放，比长时间录完后才发现问题更有效。
能力边界与修改注意事项
支持情况与显卡和平台有关。固定快照中的 Apple Silicon 清单提供 wf-recorder 作为回退，因此不同设备不一定使用同一个录制后端。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi gpu-screen-recorder
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
视频与音频播放器。
- 包名
mpv- 收录状态
- 核心清单
用途与日常使用
播放音视频，提供以键盘操作为主的控制和多种格式支持。把文件交给独立播放器，也有助于判断问题出在媒体文件本身还是创建它的应用。
工作原理与协作关系
解封装、解码、画面渲染和音频输出是不同阶段。硬件加速会改变播放路径，但不会改变原文件；同一个文件在不同输出与解码配置下可能表现不同。
配置与定制
上游常用个人配置为 ~/.config/mpv/mpv.conf，按键配置为 input.conf。应把通用播放偏好与某个文件专用的选项分开，避免为修复单个视频而影响全部媒体。
常见问题与排查思路
对比另一个文件和最小配置。只有画面异常时检查解码与渲染；所有应用都无声时应检查系统音频层，而不是只改播放器音量。
能力边界与修改注意事项
脚本可以扩展行为，也会执行代码，应确认来源。它是播放器，不是修复全系统编解码器的工具，也不负责提供完整的媒体资料库管理。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi mpv
mpv --version
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
Apple Silicon 平台清单中的屏幕录制回退工具。
- 包名
wf-recorder- 收录状态
- 平台限定
用途与日常使用
Wayland 屏幕录制工具，在固定 Omarchy 清单中作为 Apple Silicon 的回退方案出现，用于处理该平台特定的画面捕获路径。
工作原理与协作关系
通过合成器支持的协议捕获画面，再对帧进行编码。合成器能力与平台图形结构共同决定这条路径是否适用，不能仅凭软件包可安装就保证可用。
配置与定制
优先使用了解平台差异的 Omarchy 录制流程。直接调用工具时，应从已安装版本文档中选择兼容的捕获与输出选项，不把其他后端参数直接搬过来。
常见问题与排查思路
比较所选输出、合成器支持和实际生成文件。没有声音需要检查音源，与黑色视频的捕获问题分别处理，先用短样本确认整条流程。
能力边界与修改注意事项
平台清单不表示所有 Omarchy 设备都使用它。录制会持续占用存储空间，而能够捕获画面也不等于适合分享其中内容，输出前应确认范围。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi wf-recorder
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
搜索所有组件 · 官方软件包清单索引
本页随共享组件目录更新；收录范围基于目录标注的源码快照，不代表所有版本或全部间接依赖。