A Folio CLI egy parancssoros alkalmazás a Kréta e-napló rendszerhez. Az iOS alkalmazás OAuth2 hitelesítési folyamatait szimulálva közvetlen terminálos elérést biztosít a diákok adatlapjához és jegyeihez. A projekt a Folio ökoszisztéma hivatalos parancssoros eszköze.
- Élő Dashboard (TUI parancs): Parancssoros főoldal automatikus frissítéssel, folyamatban lévő óra hátralévő idejének számlálójával és karbantartási riasztásokkal.
- Folio Wrapped: Spotify-stílusú interaktív éves statisztikai összefoglaló (legszorgalmasabb nap, tanári rangsor, késések összesítése, üzenetek statisztikája).
- Bizonyítvány Tervező & Szellem Jegyek: Célátlag kalkulátor és hipotetikus jegy szimulátor a tantárgyankénti átlagok javításához.
- Tantárgyi és Osztályátlagok Részletesen: Saját átlagod összevetése az osztályátlaggal, eltérések, trendek (↗ / ↘) és jegy-határhelyzet figyelmeztetések.
- Jegy-trendek & Eloszlás Dashboard: Dinamikus y-tengelyű éves kumulatív átlagvonal-grafikon és színes érdemjegy eloszlási hisztogram.
- Globális Haladó Kereső: Ékezet-érzéketlen keresés a jegyekben, házi feladatokban, órarendben, vizsgákban, üzenetekben és hiányzásokban.
- Téma Választó & ASCII Banner: Támogatja a Classic Blue, Neon Matrix (Zöld), Midnight Pink, és Classic Amber témákat testreszabható ASCII főmenü bannerrel.
- ICS Naptár, CSV és Git Export: Órarend és jegytörténet mentése standard formátumokba vagy helyi Git repóba.
- Automatikus OAuth2 Token Frissítés: Megbízható háttér-hitelesítés párhuzamos API hívások és token lejárás esetén is (fájlkorrupció-elleni védelemmel).
- Windows UTF-8 & FFI Konzol Mód: Kényszerített UTF-8 kódolás (
chcp 65001) az ékezetes karakterek hibátlan megjelenítéséhez és FFI alapú billentyűzet-echo helyreállítás.
- Egyszerűen: szerezz egy előre megépített futtatható programot innétről. Ubuntu/Debian/Mint felhasználók számára külön
.debtelepítőfájl is elérhető!
Ha esetleg nem elérhető a platformodra (tudasd ezt velünk), nem tetszik az ötlet, vagy nem elég friss:
Linux bináris kézi futtatása
wget https://github.com/CsPS0/folio-cli/releases/download/v1.0.1/folio-cli-linux chmod +x folio-cli-linux ./folio-cli-linux
Debian / Ubuntu / Linux Mint (APT)
curl -fsSL https://CsPS0.github.io/folio-cli/public.key | sudo gpg --dearmor -o /usr/share/keyrings/folio-cli-archive-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/folio-cli-archive-keyring.gpg] https://CsPS0.github.io/folio-cli/repo stable main" | sudo tee /etc/apt/sources.list.d/folio-cli.list > /dev/null sudo apt update sudo apt install folio-cli
Arch Linux (AUR)
yay -S folio-cli-binHa nincs AUR helper (pl.
yay) a gépeden:git clone https://aur.archlinux.org/folio-cli-bin.git cd folio-cli-bin makepkg -si
macOS (Homebrew)
brew tap CsPS0/folio-cli https://github.com/CsPS0/folio-cli brew install folio-cli
Windows (Scoop)
scoop bucket add folio https://github.com/CsPS0/folio-cli scoop install folio-cli
Forráskódból történő fordítás
Dart SDK szükséges.
git clone https://github.com/CsPS0/folio-cli.git cd folio-cli dart pub get dart compile exe bin/folio_cli.dart dart run
Ha valamelyik fenti csomagkezelővel telepítetted, az alkalmazást bárhonnan indíthatod a terminálból az alábbi paranccsal:
folio-cliGyors parancsok és argumentumok:
folio-cli dash: Azonnali belépés az Élő Dashboard (TUI) nézetbe.folio-cli --daemon: Háttérfolyamat indítása az értesítésekhez.folio-cli -i <intezmenykod> -u <felhasznalonev> -p <jelszo>: Gyors belépés paraméterekkel.
- USER.md: Felhasználói útmutató.
- DEV.md: Fejlesztői és architektúrális dokumentáció.
- CONTRIBUTIONS.md: Irányelvek hozzájárulóknak.
- DATA_SECURITY.md: Adatkezelés és biztonsági tájékoztató.
Minden használatba vett Dart csomagnak köszönet, itt találhatóak. Kréta dokumentáció: https://nzx.hu/kreta-api/ Rengeteg dolgot tartalmazó dokumentáció: https://docs.zan1456.dev/
- Firka & firka-legacy
- Folio
- rsfilc (Rust alapú Filc Terminál)