Файловая система

Beam хранит постоянные пользовательские данные отдельно от заменяемых кэшей приложения. Используйте этот справочник для резервного копирования, переноса, проверки или устранения неполадок установки Beam.

Где Beam хранит пользовательские файлы

Beam определяет папку Videos операционной системы и создаёт внутри неё Beam/user. Перенаправленная или локализованная папка Videos изменяет определяемое местоположение, поэтому указанные ниже пути являются обычными значениями по умолчанию, а не жёстко заданными расположениями.

• 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, затем нажмите

↵

. Для перенаправленной директории Videos выполните 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 — манифест проекта и источник истины. Он содержит версию схемы, стабильный идентификатор проекта, отображаемое имя, временные метки, ссылки на сессии, композицию, параметры представления, субтитры, состояние масштабирования и ссылки на импортированные ресурсы.
• Каждая завершённая сессия обычно содержит manifest.json, который описывает платформу, выбранные источники, разрешения, предупреждения, форматы дорожек, сегменты, метрики и состояние завершения.
• manifest.partial.json сохраняет восстанавливаемые метаданные, пока захват активен или сессия не была завершена. Восстановленная сессия может использовать его вместо manifest.json.

Не редактируйте манифесты вручную

Манифесты являются версионируемыми данными приложения с перекрёстными ссылками между файлами. Ручное редактирование, перемещение отдельных файлов сессии или переименование файлов внутри проекта может сделать медиафайлы недоступными в редакторе.

Каталоги дорожек и медиафайлов

• Каталог screen/ содержит нумерованные сегменты экрана в MP4, если захват экрана прошёл успешно.
• Каталоги system-audio/, microphone/ и camera/ содержат нумерованные сегменты WebM для соответствующих включённых источников.
• Пять каталогов дорожек могут существовать, даже если источник не был выбран. Используйте записи и состояния 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; отдельными файлами субтитров внутри проекта они не являются.

Создавайте резервную копию полного каталога проекта

Скопируйте project-<name>/ целиком, пока Beam не выполняет запись. Один MP4-файл экрана не содержит композицию редактора, необязательные дорожки, данные курсора, субтитры или диагностику.

Обновления

Загруженные обновления хранятся в кэше операционной системы отдельно от проектов. Каталог 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 также хранит update-cache-state.json в каталоге данных приложения Electron, чтобы отличать установленное обновление от ожидающего. Обычные родительские каталоги: %APPDATA%\Beam в Windows, ~/Library/Application Support/Beam в macOS и ${XDG_CONFIG_HOME:-~/.config}/Beam в Linux.

Файлы обновления можно удалить

Не создавайте резервные копии и не перемещайте кэш обновлений. Если обновление не загружается и не ожидает перезапуска, кэш можно удалить, и Beam снова загрузит будущее обновление. Никогда не удаляйте его во время загрузки обновления или когда оно готово к установке.