Install from source

System requirements

Ubuntu 24.04 / 26.04

sudo apt-get update
sudo apt-get install -y git curl libreoffice poppler-utils

# For the GUI as well:
sudo apt-get install -y libxcb-cursor0 libxkbcommon-x11-0

Fedora 43 / 44

sudo dnf install -y git curl libreoffice poppler-utils

# For the GUI as well:
sudo dnf install -y libxcb xcb-util-cursor libxkbcommon-x11

macOS

brew install libreoffice poppler

Install uv

Linux / macOS

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

Clone and install

git clone https://gitlab.com/pepesan/temario-app temario && cd temario

# CLI only
uv sync

# CLI + desktop GUI
uv sync --group gui

# CLI + reactive watch
uv sync --group watch

# Everything
uv sync --group gui --group watch

Verify the installation

./temario version
./temario build courses/ejemplo

If everything works you will see the generated files in courses/ejemplo/output/.

Initial setup

./temario setup

The wizard asks for the courses directory and other basic preferences. You can also configure manually:

./temario config set courses_dir ~/my-courses

Configuration file

Settings are saved in ~/.config/temario/temario.yaml. You can edit it directly or use ./temario config show to inspect it.

Desktop launcher (optional)

To access Temario from the GNOME/KDE application menu:

./scripts/install/icons.sh

Installs icons in ~/.local/share/icons/ and creates the .desktop shortcut in ~/.local/share/applications/. Only needs to be run once after cloning.