CLI reference

The CLI is primarily for engine checkouts, development, and project authors who prefer a terminal. The desktop application communicates with the sidecar directly instead of shelling out to these commands.

From the repository root, use either:

./matemium.sh <command>

or:

python -m matemium <command>

after activating the environment where Matemium is installed.

demo

Render a built-in demonstration:

./matemium.sh demo
./matemium.sh demo landscape
./matemium.sh demo tictactoe

Available aliases include portrait/reels, landscape/youtube, builder, and tictactoe/tutorial/flex.

Options:

-q, --quality     fast_preview | preview | draft | low | medium | high | final
-o, --output      custom output name
-r, --resolution  WIDTH,HEIGHT or native

Quality profiles preserve the scene aspect ratio:

Profile	Pixel scale	Frame rate
preview	50%	15 fps
draft	75%	30 fps
low	100%	30 fps
medium	100%	30 fps
high	100%	60 fps
final	100%	60 fps

The explicit resolution option overrides the pixel dimensions but does not recompose the scene’s logical layout.

list

List projects, discovered scene classes, and output paths:

./matemium.sh list

new

Create a project from the template:

./matemium.sh new binary_search

This creates projects/binary_search/. Edit its scenes.py.

render

Render the default scene in a project:

./matemium.sh render binary_search

Render a named scene:

./matemium.sh render binary_search BinarySearch

Render a quick preview:

./matemium.sh render binary_search -q preview

Use an explicit resolution:

./matemium.sh render binary_search -r 1080,1920

Version

./matemium.sh --version

Output

Project renders are isolated beneath:

outputs/<project>/media/

Generated output is normally excluded from version control.