Sistema de archivos

Beam mantiene los datos de usuario persistentes separados de las cachés que se pueden regenerar de la aplicación. Usa esta referencia para hacer copias de seguridad, mover, inspeccionar o solucionar problemas de una instalación de Beam.

Dónde almacena Beam los archivos de usuario

Beam resuelve la carpeta Videos del sistema operativo y crea Beam/user dentro de ella. Una carpeta Videos redirigida o localizada cambia la ubicación resuelta, por lo que las rutas siguientes son los valores predeterminados habituales, no rutas codificadas.

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

Abrir la carpeta en Windows

Pulsa

Win+R

, pega %USERPROFILE%\Videos\Beam\user y pulsa

↵

. Windows expande %USERPROFILE% y abre la carpeta en el Explorador de archivos.

Abrir la carpeta en macOS

Abre Finder, pulsa

⌘+Shift+G

, pega ~/Movies/Beam/user y pulsa

↵

. Finder expande ~ hasta tu carpeta personal.

Abrir la carpeta en Linux

Abre tu gestor de archivos, pulsa

Ctrl+L

, introduce ~/Videos/Beam/user y pulsa

↵

. Si la carpeta Videos está redirigida, ejecuta xdg-open "$(xdg-user-dir VIDEOS)/Beam/user" en un terminal.

La carpeta se crea cuando es necesaria

Algunos directorios solo aparecen después de usar su función por primera vez. Graba una vez antes de buscar projects/ o importa un fondo antes de buscar la biblioteca de fondos.

Estructura de los datos de usuario

El directorio Beam/user puede contener los siguientes datos persistentes:

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

• preferences.json almacena la apariencia, el comportamiento del grabador, los dispositivos seleccionados, los atajos, el estado de la introducción, los preajustes y la posición guardada de las ventanas. Se crea o se reemplaza con valores predeterminados normalizados cuando es necesario.
• projects/ almacena todos los proyectos de Beam y sus sesiones de grabación. Es el directorio más importante para las copias de seguridad.
• media/wallpapers/image/ y media/wallpapers/video/ almacenan copias de los fondos importados a la biblioteca de fondos compartida. Son opcionales.
• models/whisper/ almacena los modelos locales de transcripción descargados, sus manifiestos y las descargas temporales .partial. Los modelos son opcionales y se pueden volver a descargar.

Grabaciones y proyectos

Cada proyecto utiliza un nombre de directorio legible, como project-vivid-cosmic. El UUID estable del proyecto se encuentra dentro de project.json, por lo que el nombre del directorio no es la identidad del proyecto. Cambiar el nombre de un proyecto también puede cambiar el nombre de su directorio.

Directorio del proyecto

Un proyecto completo puede tener este aspecto:

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

Metadatos de proyecto obligatorios

• project.json es el manifiesto del proyecto y la fuente de verdad. Contiene la versión del esquema, el ID estable del proyecto, el nombre mostrado, las marcas de tiempo, las referencias a sesiones, la composición, los ajustes de presentación, los subtítulos, el estado de los zooms y las referencias a los recursos importados.
• Cada sesión completada normalmente tiene manifest.json, que describe la plataforma, las fuentes seleccionadas, los permisos, las advertencias, los formatos de las pistas, los segmentos, las métricas y el estado de finalización.
• manifest.partial.json conserva metadatos recuperables mientras la captura está activa o cuando una sesión no se ha finalizado. Una sesión recuperada puede utilizarlo legítimamente en lugar de manifest.json.

No edites los manifiestos manualmente

Los manifiestos son datos de la aplicación versionados con referencias entre archivos. Las ediciones manuales, mover archivos de sesión individuales o cambiar el nombre de archivos dentro de un proyecto pueden hacer que el contenido multimedia no esté disponible en el editor.

Directorios de pistas y contenido multimedia

• screen/ contiene segmentos de pantalla MP4 numerados cuando la captura de pantalla se realizó correctamente.
• system-audio/, microphone/ y camera/ contienen segmentos WebM numerados escritos para las fuentes activadas correspondientes.
• Los cinco directorios de pistas pueden existir aunque no se haya seleccionado una fuente. Usa las entradas y los estados de tracks del manifiesto de sesión —no la presencia de un directorio vacío— para determinar qué se grabó.
• Durante una escritura activa o interrumpida de contenido multimedia del navegador pueden existir archivos .partial temporales. Los segmentos finalizados cambian de nombre atómicamente.
• media/ contiene copias de vídeos, imágenes o audios importados al editor. Eliminar un recurso importado sin usar desde Beam puede eliminar su archivo copiado.
• backgrounds/ contiene copias de los fondos importados específicamente a ese proyecto.

Cursor, interacciones y diagnósticos

• cursor/cursor.json contiene los eventos del cursor grabados cuando la captura del cursor está disponible.
• cursor/telemetry.json contiene muestras normalizadas de movimiento del cursor utilizadas por el comportamiento del editor, como el seguimiento del cursor.
• cursor/shapes.json describe las formas nativas del cursor; cursor/shapes/*.png puede contener formas de mapa de bits capturadas cuando la plataforma o la ruta de compatibilidad lo requieren.
• cursor/input.json contiene los metadatos permitidos de atajos y clics. No se almacena texto escrito.
• health.jsonl registra el estado de la captura y las interrupciones; timing.jsonl registra las anclas temporales utilizadas para alinear las pistas. Conserva ambos archivos con la sesión al mover o diagnosticar un proyecto.

Archivos de presentación opcionales

• thumbnail.webp es una vista previa generada para la tarjeta del proyecto y se puede volver a crear.
• session/teleprompter.json solo existe después de guardar un documento de teleprompter para esa sesión.
• Los subtítulos generados y la configuración del editor se almacenan en project.json; no son archivos de subtítulos independientes dentro del proyecto.

Haz una copia de seguridad del directorio completo del proyecto

Copia project-<name>/ como una unidad mientras Beam no esté grabando. Un único MP4 de pantalla no incluye la composición del editor, las pistas opcionales, los datos del cursor, los subtítulos ni los diagnósticos.

Actualizaciones

Las actualizaciones descargadas se almacenan en la caché del sistema operativo, separadas de los proyectos. El directorio pending/ puede contener el instalador o el archivo de actualización y update-info.json. Beam limpia la caché del actualizador después de que la nueva versión se inicia correctamente, pero conserva una actualización que aún espera a instalarse.

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

Estado de la actualización

Beam también almacena update-cache-state.json en el directorio de datos de la aplicación de Electron para distinguir una actualización instalada de otra que aún está pendiente. Los directorios principales habituales son %APPDATA%\Beam en Windows, ~/Library/Application Support/Beam en macOS y ${XDG_CONFIG_HOME:-~/.config}/Beam en Linux.

Los archivos del actualizador son desechables

No hagas copias de seguridad ni muevas la caché del actualizador. Si no se está descargando ninguna actualización ni hay una esperando el reinicio, se puede eliminar y Beam volverá a descargar una futura actualización. No la elimines mientras una actualización se esté descargando o esté lista para instalarse.