파일 시스템

Beam은 영구 사용자 콘텐츠를 교체 가능한 애플리케이션 캐시와 분리합니다. Beam 설치를 백업하거나 이동하거나 검사하거나 문제를 해결할 때 이 참조를 사용하세요.

Beam이 사용자 파일을 저장하는 위치

Beam은 운영체제의 비디오 폴더를 확인하고 그 안에 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 안에 있으므로 디렉터리 이름이 프로젝트의 ID는 아닙니다. 프로젝트 이름을 바꾸면 디렉터리 이름도 바뀔 수 있습니다.

프로젝트 디렉터리

개발된 프로젝트는 다음과 같이 보일 수 있습니다.

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 하나만으로는 편집기 구성, 선택적 트랙, 커서 데이터, 자막 또는 진단 정보가 포함되지 않습니다.

업데이트

다운로드한 업데이트는 프로젝트와 별도로 운영체제의 캐시에 저장됩니다. 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은 이후 업데이트를 다시 다운로드합니다. 업데이트를 다운로드 중이거나 설치 준비가 된 상태에서는 절대 삭제하지 마세요.