Bakaláři CLI

Terminal timetable viewer for the Bakaláři school system.
A TUI (Terminal User Interface) application built with Textual.

Installation

The recommended way to install bakalari-cli is using uv or pipx:

# Using uv (fastest)
uv tool install bakalari-cli

# Using pipx
pipx install bakalari-cli

# Using standard pip (fallback)
pip install bakalari-cli

Usage

1. Run the application:

   bakalari

2. Enter your Bakaláři timetable URL, e.g.:

   https://bakalar.skola.cz/Timetable/Public/Permanent/Class/FF
   

3. Navigate the timetable:

   • Arrow keys: Move between cells
   • Shift+Left/Right: Switch between week types
   • R: Refresh
   • Q: Quit

URL Format

https://<school_bakalari_url>/Timetable/Public/<Type>/<EntityType>/<ID>

Type	Description
Permanent	Fixed schedule (stálý rozvrh)
Actual	Current week with changes
Next	Next week

EntityType	Description
Class	Class timetable
Teacher	Teacher timetable
Room	Room timetable

Development

This project uses uv for development.

# Clone the repository
git clone https://github.com/axo4xo/bakalari-cli.git
cd bakalari-cli

# Install dependencies and setup environment
uv sync

# Run the app
uv run bakalari

# Run tests
uv run pytest

Textual Development

To run with the Textual developer console:

uv run textual run --dev bakalari_cli.app:BakalariApp