Asztal: A Terminal GUI client for the e-Kreta system

Installation:

Android:

• I recommend using Termux and following the Desktop instructions

iOS:

• Technically it should work with any python interpreter, however they are usually paid.

Desktop:

• git clone
• ...or for a more hands-off approach:

# Linux & MacOS
# this code will install asztal in your home directory
cd $HOME
git clone https://github.com/bczsalba/asztal
cd asztal
sudo python3 -m pip install requests
# After this, you can launch asztal by running `python3 asztal.py` in a terminal.

Additional quality of life fixes

• to start asztal by entering asztal into a bash terminal:

echo "alias asztal='cd $HOME/asztal && python3 asztal.py'" >> $HOME/.bashrc && bash

• or create a desktop shortcut (MacOS):

# create 'shortcut' icon
echo -e '#!/bin/bash\npython3 $HOME/asztal/asztal.py' >> $HOME/Desktop/asztal.command
# make executable // will need administrator password
sudo chmod +x $HOME/Desktop/asztal.command

Functionality

• Overview of grades, and info on each
• Grade simulation system
• Timetable display
• Multi-profile support
• Lots of configurability
• Self-contained update method

Extra features

There are some extra features not immediately apparent:

• the option -o will force the program to source info from storage
• forcett.py with the right syntax will be used as timetable, not Kreta info

~/asztal/forcett.py |
---------------------

timetable = [
    [
        {
            "start": "16:20",
            "end": "19:30",
            "subject": "Mathematics",
            "classroom": "Second corridor on the left",
            "teacher": "Albert Einstein"
        },
	...
    ]
]

Images

Sources

Sources & Contributions
Original API	BoA
Extra Help	Filc
Updated API	Me