You will learn#
- which settings belong to a project and how to change them;
- which settings belong to you, in the editor;
- where the settings of the server are.
The idea#
There are three levels of settings, and they are kept apart on purpose.
Project settings are part of the project and its history, so every change can be undone: the frame width and height (even numbers, 16 to 4096), the frame rate, the background colour (a hex colour or a template colour such as $paper), and the loudness_target in LUFS (-30 to -5). Changing the frame rate rescales every time in the project and repairs what rounding breaks, such as a duration that became zero; the result lists every item it adjusted. The name of the project is changed with project.rename. New projects start from a preset: 9:16, 1:1, 16:9 or 4:5.
Editor preferences are yours and live in the browser: the language (English or Brazilian Portuguese), chosen on the projects page, and the light or dark theme, which has a button on the projects page and in the top bar of the editor. The language switch changes only the editor; the CLI and MCP text stays English.
Server settings are environment variables read at start-up, such as the encoder, the limits and the mode. They are listed in Configuration variables. Changing one needs a restart.
There is no settings page in this release: project settings are changed with the command palette (Ctrl+K, Cmd+K on macOS), the CLI or an agent.
Quick start#
vukem-video edit --project prj_7k2m9x4q1b settings.set background=#101820 width:=1080 height:=1920
vukem-video edit --project prj_7k2m9x4q1b settings.set_fps fps=30000/1001
vukem-video edit --project prj_7k2m9x4q1b project.rename name="Launch teaser v2"edit with the operations:
{ "op": "settings.set", "args": { "background": "#101820", "loudness_target": -16 } }
{ "op": "settings.set_fps", "args": { "fps": "30" } }Common mistakes#
- An odd frame size:
E_VALIDATION. Widths and heights must be even. - Changing the frame rate late in the work. Every time is rescaled; check the
adjustedlist and runlint. - Looking in the editor for a server setting such as a limit. Those are environment variables.