ファイルシステム

Beamは永続的なユーザーコンテンツと置き換え可能なアプリケーションキャッシュを分けて保存します。Beamのインストールをバックアップ、移動、確認、トラブルシューティングするときにこのリファレンスを使用してください。

Beamがユーザーファイルを保存する場所

BeamはOSの「ビデオ」フォルダーを解決し、その中に Beam/user を作成します。リダイレクトされた、またはローカライズされたビデオフォルダーでは解決先が変わるため、以下はハードコードされた場所ではなく通常の既定値です。

• Windows: %USERPROFILE%\Videos\Beam\user
• macOS: ~/Movies/Beam/user
• Linux: ${XDG_VIDEOS_DIR:-~/Videos}/Beam/user

Windowsでフォルダーを開く

Win+R

を押し、%USERPROFILE%\Videos\Beam\userを貼り付け、

↵

を押します。Windowsは%USERPROFILE%を展開し、エクスプローラーでフォルダーを開きます。

macOSでフォルダーを開く

Finderを開き、

⌘+Shift+G

を押し、~/Movies/Beam/userを貼り付けて、

↵

を押します。Finderは~をホームフォルダーに展開します。

Linuxでフォルダーを開く

ファイルマネージャーを開き、

Ctrl+L

を押して~/Videos/Beam/userを入力し、

↵

を押します。リダイレクトされたビデオディレクトリには、ターミナルでxdg-open "$(xdg-user-dir VIDEOS)/Beam/user"を実行します。

フォルダーは必要に応じて作成されます

一部のディレクトリは、その機能を初めて使った後にのみ表示されます。projects/を探す前に一度録画し、壁紙ライブラリを探す前に背景をインポートしてください。

ユーザーデータの構成

Beam/userディレクトリには、次の永続データが含まれることがあります：

Beam/user/
├── preferences.json
├── projects/
│   └── project-<readable-name>/
├── media/
│   └── wallpapers/
│       ├── image/
│       └── video/
└── models/
    └── whisper/

• preferences.jsonには、外観、レコーダーの動作、選択したデバイス、ショートカット、初回設定の状態、プリセット、保存されたウィンドウ位置が保存されます。必要に応じて正規化された既定値で作成または置き換えられます。
• projects/には、すべてのBeamプロジェクトと録画セッションが保存されます。バックアップするうえで最も重要なディレクトリです。
• media/wallpapers/image/とmedia/wallpapers/video/には、共有壁紙ライブラリにインポートした背景のコピーが保存されます。これらは任意です。
• models/whisper/には、ダウンロードしたローカル文字起こしモデル、そのマニフェスト、一時的な.partialダウンロードが保存されます。モデルは任意で、再度ダウンロードできます。

録画とプロジェクト

各プロジェクトにはproject-vivid-cosmicのような読みやすいディレクトリ名が使われます。安定したプロジェクトUUIDはproject.json内にあるため、ディレクトリ名がプロジェクトの識別子ではありません。プロジェクト名を変更するとディレクトリ名も変わることがあります。

プロジェクトディレクトリ

作成済みのプロジェクトは次のようになります：

project-<name>/
├── project.json                         required
├── thumbnail.webp                       optional
├── media/                               optional imported editor media
├── backgrounds/                         optional project backgrounds
└── session-<uuid>/                      one or more recording sessions
    ├── manifest.json                    completed session
    ├── manifest.partial.json            interrupted/in-progress recovery state
    ├── health.jsonl                     capture diagnostics
    ├── timing.jsonl                     clock synchronization anchors
    ├── screen/                          screen video segments
    ├── system-audio/                    optional system-audio segments
    ├── microphone/                      optional microphone segments
    ├── camera/                          optional camera segments
    ├── cursor/                          optional cursor and interaction data
    └── session/teleprompter.json        optional teleprompter document

必須のプロジェクトメタデータ

• project.jsonはプロジェクトマニフェストであり、正しい情報源です。スキーマバージョン、安定したプロジェクトID、表示名、タイムスタンプ、セッション参照、コンポジション、プレゼンテーション設定、キャプション、ズーム状態、インポートしたアセットへの参照が含まれます。
• 完了した各セッションには通常manifest.jsonがあり、プラットフォーム、選択したソース、権限、警告、トラック形式、セグメント、メトリクス、完了状態を記述します。
• manifest.partial.jsonは、キャプチャが進行中またはセッションが確定しなかった場合に復元可能なメタデータを保持します。復元されたセッションではmanifest.jsonの代わりにこれが使われることがあります。

マニフェストを手動で編集しないでください

マニフェストはファイル間の参照を持つバージョン管理されたアプリケーションデータです。手動で編集したり、個別のセッションファイルを移動したり、プロジェクト内のファイル名を変更したりすると、エディターでメディアを利用できなくなることがあります。

トラックとメディアのディレクトリ

• screen/には、画面キャプチャに成功した場合に番号付きのMP4画面セグメントが含まれます。
• system-audio/、microphone/、camera/には、それぞれ有効なソース向けに書き込まれた番号付きWebMセグメントが含まれます。
• ソースを選択していなくても、5つのトラックディレクトリが存在することがあります。何が録画されたかは空のディレクトリの有無ではなく、セッションマニフェストのtracksエントリと状態で判断してください。
• アクティブまたは中断されたブラウザメディア書き込み中は、一時的な.partialメディアファイルが存在することがあります。確定したセグメントはアトミックに名前が変更されます。
• media/にはエディターにインポートした動画、画像、音声のコピーが含まれます。Beamで未使用のインポートアセットを削除すると、そのコピーも削除されることがあります。
• backgrounds/には、そのプロジェクト専用にインポートした背景のコピーが含まれます。

カーソル、操作、診断

• cursor/cursor.jsonには、カーソルキャプチャが利用できる場合に記録されたカーソルイベントが含まれます。
• cursor/telemetry.jsonには、カーソル追従などエディターの動作に使われる正規化されたカーソル移動サンプルが含まれます。
• cursor/shapes.jsonはネイティブカーソルの形状を記述します。プラットフォームまたは互換性パスで必要な場合、cursor/shapes/*.pngにキャプチャしたビットマップ形状が含まれることがあります。
• cursor/input.jsonには、許可されたショートカットとクリック操作のメタデータが含まれます。入力したテキストは保存されません。
• health.jsonlはキャプチャの健全性と中断を記録し、timing.jsonlはトラックの同期に使うタイミングアンカーを記録します。プロジェクトを移動または診断するときは、両方をセッションと一緒に保管してください。

任意のプレゼンテーションファイル

• thumbnail.webpは生成されたプロジェクトカードのプレビューで、再生成できます。
• そのセッションのテレプロンプタードキュメントを保存した後にのみ、session/teleprompter.jsonが存在します。
• 生成されたキャプションとエディター設定はproject.jsonに保存され、プロジェクト内に個別の字幕ファイルはありません。

プロジェクトディレクトリ全体をバックアップ

Beamが録画していない状態で、project-<name>/をひとつの単位としてコピーしてください。画面MP4だけでは、エディターのコンポジション、任意のトラック、カーソルデータ、キャプション、診断情報は含まれません。

更新

ダウンロードした更新はOSのキャッシュに保存され、プロジェクトとは別に管理されます。pending/ディレクトリにはインストーラーまたは更新アーカイブとupdate-info.jsonが含まれることがあります。新しいバージョンが正常に起動するとBeamはアップデーターのキャッシュを削除しますが、インストール待ちの更新は保持します。

• Windows: %LOCALAPPDATA%\beam-updater\pending
• macOS: ~/Library/Caches/beam-updater/pending
• Linux: ${XDG_CACHE_HOME:-~/.cache}/beam-updater/pending

更新状態

BeamはElectronのアプリケーションデータディレクトリにもupdate-cache-state.jsonを保存し、インストール済みの更新と保留中の更新を区別します。通常の親ディレクトリは、Windowsでは%APPDATA%\Beam、macOSでは~/Library/Application Support/Beam、Linuxでは${XDG_CONFIG_HOME:-~/.config}/Beamです。

アップデーターのファイルは削除できます

アップデーターのキャッシュをバックアップしたり移動したりしないでください。更新をダウンロード中または再起動待ちでない場合は削除でき、Beamは次回の更新を再びダウンロードします。更新のダウンロード中またはインストール準備完了時には絶対に削除しないでください。