Guide
Settings
Nothing needs configuring. The one optional setting is a brand library for music and deliveries; this page also lists the environment variables and folders.
Nothing needs configuring. One optional thing does: a brand library.
The brand library
A brand library is a folder with one sub-folder per brand. It holds each brand’s music and receives its finished films.
<library>/<Brand>/audio/ the brand's tracks, with <brand>-music-notes.txt beside them
(a paragraph per track, starting with its file name)
<library>/<Brand>/video/<name>/ delivered films
Point Manovella at it with the environment variable MANOVELLA_BRAND, or in ~/Library/Application Support/manovella/settings.json (~/.config/manovella/settings.json on other systems); a leading ~ is expanded. Nothing is auto-detected.
{
"brandLibrary": "~/Documents/Brand",
"brandLibraryIgnore": ["Archive", "Templates"]
}
brandLibraryIgnore lists folder names that are not brands; they are skipped, like dot-folders. With a library, a film is delivered to <library>/<Brand>/video/<name>/. Without one, it goes where the project’s own instructions keep finished media, else ~/Downloads/<name>/, and there is no library music to offer. Files a library keeps are copied, never moved out of it.
A library in a file provider (Google Drive, iCloud Drive, Dropbox) may hold its files “dataless” until they are opened: open or copy a file before measuring it.
Environment variables
| Variable | What it does |
|---|---|
MANOVELLA_BRAND | The brand library folder; wins over brandLibrary in settings.json. |
MANOVELLA_ROOTS | Comma-separated folders whose git repositories the Studio offers as products (two levels deep). Without it, the parent of the repository the command runs in. |
MANOVELLA_WINDOW=chrome | Open the Studio in a Chrome app window even when Manovella.app is built. |
VOICE_PYTHON | The Python that runs the voice models, instead of the one voice.mjs --setup makes. |
VOICE_SETUP_PYTHON | The Python 3.13 --setup builds the environment from, when it is not the usual python3.13. |
HF_HOME, HF_HUB_CACHE | Where the Studio looks for downloaded voice models (default ~/.cache/huggingface). |
OPTIM=0 | Skip ImageOptim on delivered covers, for an image whose pixels must not change. |
WORKERS, QOS, TEMP_MAX | The render’s heat defaults: see Rendering. |
Where Manovella keeps things
| Path | What |
|---|---|
~/Library/Application Support/manovella/ | The Studio’s remembered briefs (one per product) and settings.json. |
~/Library/Caches/manovella/ | Pictures converted for the Studio, and the Chrome app window’s own profile. |
~/Applications/Manovella.app | The Studio’s window app, once built. |
~/.local/share/film-voice | The voice models’ Python environment, made by voice.mjs --setup. |
~/Downloads/<name>-work/ | A film’s work folder, until it is delivered. |