Linux
在 Linux 上配置录制服务、授予可选的交互访问权限，并启用 Instant 文件复制。
选择 AppImage、DEB 或 RPM
根据发行版和 CPU 架构选择软件包。DEB/RPM 软件包会声明运行时依赖，并安装 Beam 的受保护输入辅助程序和 Polkit 规则。AppImage 便于携带，但仍需配置下文所述的录制服务。
将下载的 AppImage 设为可执行文件后运行。请将示例文件名替换为你的实际文件名。如果出现 FUSE 错误，请使用发行版提供的 AppImage 兼容软件包，或安装对应的 DEB/RPM。
chmod +x "./Beam.AppImage"
"./Beam.AppImage"检查屏幕录制要求
在 Linux 上（包括 X11 会话），Beam 通过 XDG Desktop Portal、PipeWire 和 FFmpeg 进行录制。当前使用的门户后端必须提供 ScreenCast 2 或更高版本，以及你要录制的来源类型。
请使用当前桌面环境对应的门户后端，例如 GNOME、KDE Plasma 或兼容的 wlroots 合成器。FFmpeg 必须提供受支持的编码器和 MP4 输出。开始录制前，Beam 会报告缺失的要求。
| 要求 | 检查内容 |
|---|---|
| XDG Desktop Portal | 当前桌面会话中提供 ScreenCast 的后端。 |
| PipeWire / WirePlumber | 正在运行且可提供所选媒体流的用户服务。 |
| FFmpeg | 可通过 PATH 使用，或通过 BEAM_FFMPEG_PATH 配置；需包含所需编码器并支持 MP4 输出。 |
systemctl --user --no-pager status xdg-desktop-portal pipewire wireplumber在门户中确认来源
门户选择器出现时，请授权要录制的屏幕或窗口。对于 Region，请选择与 Beam 中绘制矩形对应的显示器。选择窗口无法提供显示器裁剪区域。
如果 Beam 控件会出现在全屏录制画面中，请在确认前移动或最小化 Beam。开始前启用系统音频；Linux 不支持录制过程中切换此选项。
允许录制点击和快捷键
在 Settings → Accessibility 中启用 Record keyboard & mouse events on Linux。此可选设置默认关闭。其受保护的辅助程序会捕获点击以生成自动缩放，并记录用于字幕的安全快捷键令牌，同时过滤普通输入文本。
DEB/RPM 安装包含辅助程序及其授权规则。AppImage 可请求管理员授权以安装或更新它们。安装匹配的辅助程序后，它可在活动桌面会话中运行，无需每次都重新输入密码。
如果访问失败，请修复报告的辅助程序或身份验证问题，然后在 Accessibility 设置中重试。如果错误持续存在，请在报告中附上 Settings → About → Copy system information。
为 Instant 安装剪贴板工具
DEB/RPM 软件包会声明这两种工具。使用 AppImage 或开发构建时，请安装当前会话所需的工具并确保其位于 PATH 中。Instant 会复制文件 URI，供支持附件的应用使用。
剪贴板被替换前，你可以重复粘贴。Beam 获取选择内容时，Wayland 可能会短暂聚焦临时表面。如果复制失败，导出的视频仍会保留。
| 会话 | 所需工具 |
|---|---|
| Wayland | wl-copy，由 wl-clipboard 提供 |
| X11 | xclip |
叠加层位置与项目文件夹
Beam 的 Linux 窗口使用 X11（Wayland 桌面上包括 XWayland），因此可以恢复摄像头和提词器的位置。Wayland 桌面需要提供 XWayland。屏幕录制仍使用门户和 PipeWire；Instant 剪贴板复制遵循宿主会话。
默认内容文件夹位于系统 Videos 目录下，通常是 ~/Videos/Beam/user。XDG 用户目录设置可能会更改此路径。你也可以在 Settings → General 中设置 Project location 和 Export folder；项目菜单中的 Explore 会显示现有项目的实际位置。