Support and FAQ

PDF is not generated

Symptom: the ODP is created correctly but the PDF does not appear, or you see an error like LibreOffice failed (code 1).

Most common cause: LibreOffice is not installed or not in the PATH.

# Check LibreOffice is available
libreoffice --version

# Install on Ubuntu/Debian
sudo apt-get install -y libreoffice

If you use the full AppImage, LibreOffice is included. If you use the slim variant, you need LibreOffice installed on the system.

To skip PDF generation:

./temario build --no-pdf courses/my-course

“LibreOffice not found” when using the full AppImage

If the full AppImage fails to export to PDF with a soffice.bin error, make sure the downloaded version is v0.1.5 or later — earlier versions had an issue with internal LibreOffice paths.

Template not detected correctly

Symptom: generated slides do not have the expected design, or Temario uses the default template instead of yours.

Check:

The template.yaml file exists in courses/<course>/template/
The slide indices in template.yaml are correct (0-based)
The ODP file referenced in template.yaml is in the same directory

# Regenerate template.yaml from the ODP
./temario import courses/my-course/template/my-template.odp

ODP styles do not match the expected design

Symptom: text appears with the default style instead of the template’s.

Style names in template.yaml must exactly match those defined in the ODP. Open it in LibreOffice → Styles → Manage Styles to see the exact names and update template.yaml manually.

Watch does not detect changes

Symptom: ./temario build --watch shows “Watching N file(s)…” but does not regenerate on save.

Most common cause: the watchdog package is not installed.

uv sync --group watch
./temario build --watch courses/my-course

Second cause: the editor has auto-save enabled. With auto-save, the editor writes the file on every keystroke and watch regenerates constantly. Disable it (set to 0 seconds) while using watch.

Build fails with “must be inside courses//content/”

Symptom: ValueError: ... must be inside <courses_dir>/<course>/content/ when trying to generate a presentation from the GUI.

Cause: the courses directory was changed from GUI Settings without restarting the application. In versions prior to 0.1.7-beta2, the internal path became stale.

Fix: update to 0.1.7-beta2 or later. As a workaround, restart the GUI after changing courses_dir in settings.

Error: “uv: command not found”

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.local/bin/env   # or open a new terminal

GUI does not start: Qt library errors

On Ubuntu 24.04, install the system dependencies:

sudo apt-get install -y libxcb-cursor0 libxkbcommon-x11-0

Slides are split into too many fragments [N/M]

Temario automatically splits long code (>20 lines) and large lists (>14 items). To adjust the thresholds:

./temario config set generation.code_split_lines 30
./temario config set generation.list_split_items 20

Where do I report a bug?

Open an issue in the project repository:

gitlab.com/pepesan/temario-app → Issues

Include the version (./temario version), operating system and the full error message.