Sistema de arquivos

O Beam mantém o conteúdo durável do usuário separado dos caches substituíveis do aplicativo. Use esta referência para fazer backup, mover, inspecionar ou solucionar problemas de uma instalação do Beam.

Onde o Beam armazena os arquivos do usuário

O Beam localiza a pasta Vídeos do sistema operacional e cria Beam/user dentro dela. Uma pasta Vídeos redirecionada ou localizada altera o local resolvido; por isso, os caminhos abaixo são padrões usuais, não locais codificados.

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

Abrir a pasta no Windows

Pressione

Win+R

, cole %USERPROFILE%\Videos\Beam\user e pressione

↵

. O Windows expande %USERPROFILE% e abre a pasta no Explorador de Arquivos.

Abrir a pasta no macOS

Abra o Finder, pressione

⌘+Shift+G

, cole ~/Movies/Beam/user e pressione

↵

. O Finder expande ~ para sua pasta pessoal.

Abrir a pasta no Linux

Abra o gerenciador de arquivos, pressione

Ctrl+L

, digite ~/Videos/Beam/user e pressione

↵

. Para um diretório Vídeos redirecionado, execute xdg-open "$(xdg-user-dir VIDEOS)/Beam/user" em um terminal.

A pasta é criada quando necessário

Alguns diretórios só aparecem depois que o recurso é usado pela primeira vez. Grave uma vez antes de procurar projects/ ou importe um fundo antes de procurar a biblioteca de papéis de parede.

Estrutura dos dados do usuário

O diretório Beam/user pode conter os seguintes dados duráveis:

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

• preferences.json armazena aparência, comportamento do gravador, dispositivos selecionados, atalhos, estado de integração, presets e posição salva da janela. Ele é criado ou substituído por padrões normalizados quando necessário.
• projects/ armazena todos os projetos do Beam e suas sessões de gravação. É o diretório mais importante para fazer backup.
• media/wallpapers/image/ e media/wallpapers/video/ armazenam cópias dos fundos importados para a biblioteca compartilhada. São opcionais.
• models/whisper/ armazena modelos locais de transcrição baixados, seus manifestos e downloads temporários .partial. Os modelos são opcionais e podem ser baixados novamente.

Gravações e projetos

Cada projeto usa um nome de diretório legível, como project-vivid-cosmic. O UUID estável do projeto fica dentro de project.json, portanto o nome do diretório não é a identidade do projeto. Renomear um projeto também pode renomear seu diretório.

Diretório do projeto

Um projeto desenvolvido pode ter esta aparência:

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

Metadados obrigatórios do projeto

• project.json é o manifesto do projeto e a fonte de verdade. Ele contém a versão do esquema, o ID estável, o nome de exibição, marcas de tempo, referências de sessão, composição, configurações de apresentação, legendas, estado dos zooms e referências a recursos importados.
• Cada sessão concluída normalmente tem manifest.json, que descreve plataforma, fontes selecionadas, permissões, avisos, formatos de faixa, segmentos, métricas e estado de conclusão.
• manifest.partial.json preserva metadados recuperáveis enquanto a captura está ativa ou quando uma sessão não foi finalizada. Uma sessão recuperada pode usá-lo legitimamente no lugar de manifest.json.

Não edite manifestos manualmente

Os manifestos são dados versionados do aplicativo com referências entre arquivos. Edições manuais, mover arquivos de sessão individuais ou renomear arquivos dentro de um projeto pode deixar a mídia indisponível no editor.

Diretórios de faixas e mídia

• screen/ contém segmentos numerados de vídeo MP4 quando a captura de tela foi bem-sucedida.
• system-audio/, microphone/ e camera/ contêm segmentos numerados WebM gravados para as respectivas fontes ativadas.
• Os cinco diretórios de faixas podem existir mesmo quando uma fonte não foi selecionada. Use as entradas e os status de tracks do manifesto da sessão, não a presença de um diretório vazio, para determinar o que foi gravado.
• Arquivos de mídia temporários .partial podem existir durante uma gravação de mídia do navegador ativa ou interrompida. Segmentos finalizados são renomeados atomicamente.
• media/ contém cópias de vídeos, imagens ou áudios importados no editor. Remover pelo Beam um recurso importado que não é mais usado pode remover sua cópia.
• backgrounds/ contém cópias dos fundos importados especificamente para o projeto.

Cursor, interações e diagnósticos

• cursor/cursor.json contém eventos de cursor gravados quando a captura do cursor está disponível.
• cursor/telemetry.json contém amostras normalizadas do movimento do cursor usadas por recursos do editor, como acompanhamento do cursor.
• cursor/shapes.json descreve formas nativas de cursor; cursor/shapes/*.png pode conter formas bitmap capturadas quando exigido pela plataforma ou pelo caminho de compatibilidade.
• cursor/input.json contém metadados permitidos de atalhos e cliques. O texto digitado não é armazenado.
• health.jsonl registra a saúde da captura e interrupções; timing.jsonl registra âncoras de tempo usadas para alinhar as faixas. Mantenha ambos com a sessão ao mover ou diagnosticar um projeto.

Arquivos de apresentação opcionais

• thumbnail.webp é uma prévia gerada do cartão do projeto e pode ser recriada.
• session/teleprompter.json só existe depois que um documento do teleprompter é salvo para a sessão.
• Legendas geradas e configurações do editor ficam em project.json; não são arquivos de legenda separados dentro do projeto.

Faça backup do diretório completo do projeto

Copie project-<name>/ como uma unidade enquanto o Beam não estiver gravando. Um único MP4 da tela não inclui a composição do editor, faixas opcionais, dados do cursor, legendas ou diagnósticos.

Atualizações

As atualizações baixadas são armazenadas no cache do sistema operacional, separadas dos projetos. O diretório pending/ pode conter o instalador ou arquivo da atualização e update-info.json. O Beam limpa o cache do atualizador depois que a nova versão inicia com sucesso, preservando uma atualização que ainda aguarda instalação.

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

Estado da atualização

O Beam também armazena update-cache-state.json no diretório de dados do aplicativo Electron para diferenciar uma atualização instalada de outra ainda pendente. Os diretórios pai usuais são %APPDATA%\Beam no Windows, ~/Library/Application Support/Beam no macOS e ${XDG_CONFIG_HOME:-~/.config}/Beam no Linux.

Arquivos do atualizador são descartáveis

Não faça backup nem mova o cache do atualizador. Se nenhuma atualização estiver sendo baixada ou aguardando reinicialização, ele pode ser removido e o Beam baixará uma atualização futura novamente. Nunca o exclua enquanto uma atualização estiver sendo baixada ou pronta para instalar.