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 會顯示現有專案的實際位置。