digcli.py

A lightweight Python CLI client for digitalesregister.it.

Installation

1. Clone or download this repository.
2. Set up a virtual environment (recommended):

python -m venv venv
source venv/bin/activate  # Linux/macOS
.\venv\Scripts\activate   # Windows

3. Install dependencies:

pip install requests python-dotenv

Configuration

1. Edit the .env.example file and fill in your username, password, and school subdomain.
2. Rename the file to .env so the script can detect it:

# Linux / macOS
mv .env.example .env

# Windows
ren .env.example .env

Customizing Display Names

If lesson or teacher names are too long for your terminal, you can map them to shorter aliases inside the short_lesson_name or short_teacher_name dictionaries within the digcli.py script.

Usage

Run the script using Python: python digcli.py [options]

Common Commands

* python digcli.py -c : View the calendar for the current week.
* python digcli.py -f : Fetch general info (grades, absences).
* python digcli.py -d 5 : Show the dashboard for the next 5 days.