CLI — Command reference

1. New course

The first step is to create the course directory structure:

./temario new my-course

Creates courses/my-course/ with the full structure and copies the ODP template from the ejemplo course as a starting point.

courses/my-course/
├── content/
│   └── my-course_00.yaml   ← ready-to-edit initial YAML
├── template/
│   └── plantilla.odp       ← copy of the example template
├── output/
│   ├── odp/
│   └── pdf/
└── version.txt

2. Import ODP template

To use your own ODP template instead of the example:

./temario import courses/my-course/template/my-template.odp

Analyses the ODP and generates template.yaml with the detected slide indices and styles. From that point on, the generator uses your template.

3. Build

Generates ODP and PDF from the course YAML files:

# Build all courses
./temario build

# Build a complete course
./temario build courses/my-course

# Build a single presentation
./temario build courses/my-course/content/my-course_00.yaml

# ODP only, no PDF
./temario build courses/my-course --no-pdf

4. Watch

Automatically regenerates when YAML file changes are detected:

./temario build --watch courses/my-course

Note

Requires installing the watch group:

uv sync --group watch

Disable editor auto-save

If your editor has auto-save enabled, disable it (or set it to 0 seconds) while using --watch. With auto-save active the editor writes the file on every keystroke and watch regenerates the presentation constantly.

Validate YAML

Checks the YAML structure without generating anything:

./temario validate courses/my-course/content/my-course_00.yaml

Version

./temario version
./temario version courses/my-course

Clean output

# All generated output
./temario clean

# One course only
./temario clean courses/my-course

# ODP only or PDF only
./temario clean --tipo odp
./temario clean courses/my-course --tipo pdf

Configuration

./temario config show
./temario config set courses_dir ~/my-courses
./temario config set language en
./temario config set theme light
./temario config set generation.code_split_lines 30
./temario config set generation.list_split_items 14
./temario config set generation.compare_split_lines 20

Initial setup

./temario setup

First-run configuration wizard. Asks for the courses directory and other basic preferences. Equivalent to running config set for each key.

Tests

# Full suite (generates reports in reports/)
./temario test

# With test name filter
./temario test -k helpers

# GUI tests (requires uv sync --group gui)
uv run --group gui python -m pytest tests/gui/ -v