Project Structure
When you create a project named MyProject, Beutl creates this directory structure:
MyProject/
├── MyProject.bep
└── MyProject/
└── MyProject.scene
Project, scene, and element data are JSON. Media and Git metadata have their own formats.
MyProject.bep
The project file records the scenes in the project and shared settings such as frame rate, sample rate, and speaker layout.
MyProject.palettes.json
The project's color palettes, the ones saved with Save in this project, are kept in this file beside the project file rather than in it, since the project file holds only what the project renders. Beutl creates the file when the first such palette is saved and removes it with the last one.
MyProject.scene
The scene file stores the scene size, timing, and the elements on its timeline.
*.belm
Each element file stores its timeline position, duration, layer, name, and settings for drawing, sound, and effects.
.beutl
Beutl stores local UI state here, including the dock arrangement and editor view state, and the thumbnail the start screen shows for the project, in .beutl/thumbnails.
When a project closes, Beutl records the scene that was selected in .beutl/view-state/<project file name>.config, and the project opens on that scene the next time. Without a record, or when the project no longer holds that scene, the project opens on its last scene. The record is written only when the project closes, so after a crash the project opens on the scene of its last clean close.
Git files
When version control is enabled, the project uses a standard Git repository. A repository created for the project has a .git directory; a project inside an existing repository can use that enclosing repository.
The local UI state in .beutl is excluded from project history. See Version Control for recording and restoring versions.
Version compatibility
Projects saved by 2.0.0-preview.11 or later do not open in preview.10 or earlier. Preview.12, preview.13, and preview.14 keep the project file format floor at 2.0.0-preview.11, so projects they save still open in preview.11. Back up the whole project folder before upgrading if you need to keep an older version usable.
Project, scene, and element files record the minimum Beutl version needed to open them. Preview.11 raises the floor because a row that shows two or three values together, such as a Translate's X and Y, saves its expression as a new kind of expression. An older version would find no expression there and lose it the next time it saved, so it refuses such a project instead. The floor applies to every project that preview.11 saves, whether or not it uses such an expression. See Values shown in one row.
Preview.10 raised the floor because the Stroke effect's draw order moved from its Style property to the pen's Stroke order. A saved Style is converted when loaded, but an older version would ignore the new setting and draw the stroke over the content. Only the saved value carries over: Stroke order cannot be animated, so a Style driven by keyframes or an expression loads as its base value.
Preview.9 stores timeline and media times as integer flick counts. Older time strings are converted when loaded; the editor still shows readable time values. Project frame rate and sample rate are stored as project settings, with fractional frame rates preserved as rational values.