Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bczsalba/asztal
Minimal Kréta client written in Python.
https://github.com/bczsalba/asztal
asztal boapps ekreta kreta python python3 terminal
Last synced: 3 months ago
JSON representation
Minimal Kréta client written in Python.
- Host: GitHub
- URL: https://github.com/bczsalba/asztal
- Owner: bczsalba
- License: gpl-3.0
- Created: 2020-06-18T21:58:18.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-10-07T11:25:42.000Z (over 1 year ago)
- Last Synced: 2024-08-01T16:41:33.299Z (5 months ago)
- Topics: asztal, boapps, ekreta, kreta, python, python3, terminal
- Language: Python
- Homepage:
- Size: 561 KB
- Stars: 11
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: changelog
- License: LICENSE
Awesome Lists containing this project
- my-awesome-github-stars - bczsalba/asztal - Minimal Kréta client written in Python. (Python)
README
# Asztal: A Terminal GUI client for the e-Kreta system
## Installation:
**Android**:
- I recommend using Termux and following the [Desktop](#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:
```bash
# 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:
```bash
echo "alias asztal='cd $HOME/asztal && python3 asztal.py'" >> $HOME/.bashrc && bash
```
- or create a desktop shortcut (MacOS):
```bash
# 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
```json
~/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](https://github.com/boapps/e-kreta-api-docs) |
| Extra Help | [Filc](https://filcnaplo.hu) |
| Updated API | [Me](https://github.com/bczsalba/ekreta-docs-v2) |