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.

i

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

VariableWhat it does
MANOVELLA_BRANDThe brand library folder; wins over brandLibrary in settings.json.
MANOVELLA_ROOTSComma-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=chromeOpen the Studio in a Chrome app window even when Manovella.app is built.
VOICE_PYTHONThe Python that runs the voice models, instead of the one voice.mjs --setup makes.
VOICE_SETUP_PYTHONThe Python 3.13 --setup builds the environment from, when it is not the usual python3.13.
HF_HOME, HF_HUB_CACHEWhere the Studio looks for downloaded voice models (default ~/.cache/huggingface).
OPTIM=0Skip ImageOptim on delivered covers, for an image whose pixels must not change.
WORKERS, QOS, TEMP_MAXThe render’s heat defaults: see Rendering.

Where Manovella keeps things

PathWhat
~/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.appThe Studio’s window app, once built.
~/.local/share/film-voiceThe voice models’ Python environment, made by voice.mjs --setup.
~/Downloads/<name>-work/A film’s work folder, until it is delivered.