pagan-welcome GNU AGPL v3.0
git clone https://git.paganlinux.eu/pagan-welcome.git | Nazwa↕ | Rozmiar↕ | Ostatnia zmiana↕ | |
|---|---|---|---|
| .gitignore | 49 B | 2 mies. temu | |
| build-in-rootfs.sh | 0.0 KB | 2 mies. temu | |
| LICENSE | 0.0 KB | 2 mies. temu | |
| Makefile | 0.0 KB | 1 mies. temu | |
| pagan-welcome-autostart.desktop | 548 B | 2 mies. temu | |
| pagan-welcome-backend.py | 0.0 KB | 1 mies. temu | |
| pagan-welcome-updates.desktop | 362 B | 2 mies. temu | |
| pagan-welcome.c | 0.1 KB | 1 mies. temu | |
| pagan-welcome.desktop | 432 B | 2 mies. temu | |
| pagan-welcome.png | 0.0 KB | 2 mies. temu | |
| pw-i18n.c | 0.0 KB | 1 mies. temu | |
| pw-i18n.h | 671 B | 1 mies. temu | |
| pw-util.c | 0.0 KB | 1 mies. temu | |
| pw-util.h | 0.0 KB | 1 mies. temu | |
| README.md | 0.0 KB | 1 mies. temu |
Pagan-Welcome
Centrum startowe PaganLinux – jedno okno, z którego nowy użytkownik może poznać system, zainstalować go, zaktualizować i dobrać podstawowe ustawienia.
Interfejs zbudowany jest na GTK3 (natywnie dla tej dystrybucji, bez dodatkowych zależności w obrazie). Ciężkie zadania sieciowe i parsowanie (HTML dokumentacji, JSON repozytorium) wykonuje backend w Pythonie (pagan-welcome-backend), dzięki czemu warstwa GTK zajmuje się wyłącznie prezentacją.
Funkcje
| Sekcja | Co robi |
|---|---|
| Nowości | Pobiera informacje o wydaniach z https://docs.paganlinux.eu/docs/paganlinux i pokazuje je jako listę zmian. Treść zmienia się razem z językiem interfejsu (backend wysyła nagłówek Accept-Language). Działa też offline (ostatnia pobrana wersja z pamięci podręcznej). |
| Instalator | Uruchamia instalator Calamares – aktywny wyłącznie w sesji live (z pendrive'a/ISO). |
| Aktualizacja | pag update + pag upgrade (system rolling) uruchamiane we wbudowanym terminalu (pseudotty). Widać pełny przebieg, można wpisać odpowiedź dla pag i przerwać przyciskiem Przerwij. |
| Sklep | Przeglądanie i wyszukiwanie pakietów z repozytorium PAG. Dla niezainstalowanych – Zainstaluj; dla zainstalowanych – Usuń, a gdy pakiet ma aplikację graficzną – dodatkowo Otwórz. |
Wi-Fi (pagan-wifi) uruchamiane z przycisku w nagłówku okna (oraz z apletu tray).
Interfejs jest dwujęzyczny (PL/EN). Język wybiera się w nagłówku i jest zapamiętywany w ~/.config/pagan-welcome/config.ini. Gdy język jest nieustawiony, domyślnie używany jest angielski.
Tryby uruchomienia
pagan-welcome # okno główne
pagan-welcome --page update # od razu strona aktualizacji
pagan-welcome --page store # od razu sklep
pagan-welcome --tray # aplet tray + powiadomienia (autostart)
pagan-welcome --check # wypisz liczbę dostępnych aktualizacji (CLI)
pagan-welcome --version
Aplet panelu (tray)
pagan-welcome --tray działa w tle jako aplet: pokazuje ikonę w tacce systemowej panelu (XFCE: wtyczka systray), cyklicznie (co 6 h) sprawdza aktualizacje przez pag update, a gdy są dostępne – wysyła powiadomienie (libnotify) i zmienia podpowiedź ikony. Menu apletu pozwala sprawdzić aktualizacje, uruchomić aktualizację, otworzyć Pagan-Welcome lub ustawienia.
Aplet startuje automatycznie przy logowaniu (/etc/xdg/autostart/pagan-welcome.desktop).
„Nie pokazuj tego okna przy logowaniu”
Pole wyboru w nagłówku zapisuje show_on_login=false w konfiguracji. Aplet nadal działa w tle – ukrywane jest tylko okno główne. Aby je przywrócić, odznacz pole (albo ustaw show_on_login=true).
Aktualizacja we wbudowanym terminalu
Aktualizacja nie musi już otwierać zewnętrznego emulatora terminala. pag uruchamiany jest pod pseudottty (PTY) wbudowanym w aplikację, dzięki czemu:
pagwidzi prawdziwy terminal – nie „zawiesza się” na braku wejścia i nie blokuje menedżera pakietów;- przebieg widać na żywo (kolory ANSI są czyszczone, a strumień obsługuje końce linii tty);
- pole Odpowiedź pozwala wpisać tekst, gdyby
pago coś spytał; - przycisk Przerwij kończy proces (SIGTERM na całą grupę).
pag uruchamiany jest z PAG_YES=1 (potwierdzenie automatyczne). Gdy trzeba hasła roota, aplikacja pyta o nie i podaje je na wejście procesu bez echa (echo na PTY jest wyłączane na czas podania hasła).
Uprawnienia
Operacje wymagające roota (aktualizacja, instalacja pakietów, zmiana locale) wykonuje warstwa uprawnień:
- jako root – bezpośrednio,
pkexec– gdy w sesji działa agent polkit (graficzne okno autoryzacji),sudo -S– w przeciwnym razie (aplikacja prosi wtedy o hasło w okienku).
Budowa i instalacja
make # zbuduj pagan-welcome
sudo make install # zainstaluj do systemu
Wymagania budowy: gtk+-3.0, libnotify (pkg-config), kompilator C11.
Instalowane pliki:
| Plik | Przeznaczenie |
|---|---|
/usr/bin/pagan-welcome | aplikacja (okno + tray) |
/usr/bin/pagan-welcome-backend | backend: nowości, repo, ustawienia (TSV) |
/usr/share/applications/pagan-welcome.desktop | wpis „Pagan-Welcome” |
/usr/share/applications/pagan-welcome-updates.desktop | wpis „Aktualizacje PaganLinux” |
/etc/xdg/autostart/pagan-welcome.desktop | aplet startujący przy logowaniu |
/usr/share/pixmaps/pagan-welcome.png | ikona (z branding/) |
Backend CLI
Backend wypisuje dane w formacie TSV (jedna linia = jedno zdarzenie):
pagan-welcome-backend news pl # UPDATED/CACHED/TITLE/REL/NOTE
pagan-welcome-backend repo # PKG: nazwa, wersja, rozmiar, opis, zależności, licencja
pagan-welcome-backend installed # INST: nazwa, wersja
pagan-welcome-backend updates # UPDATES: liczba
pagan-welcome-backend pkgfiles <pakiet> # GUI 1/0 + DESKTOP: nazwa, Exec
pagan-welcome-backend sysinfo # LOCALE/KEYMAP/TIMEZONE/HOSTNAME/LIVE/CALAMARES/PAG
pagan-welcome-backend timezones # TZ: lista stref
Dzięki temu backend da się testować i wywoływać niezależnie od GUI.
Dodawanie języka
- Dopisz kod i nazwę w
pw-i18n.c(tablicaTABLE) oraz – jeśli trzeba – locale wLOCALE_BY_LANG. - Uzupełnij tłumaczenia nowych kluczy.
Brakujący klucz jest po cichu uzupełniany z polskiego, więc aplikacja nigdy nie pokaże surowego identyfikatora.
Tłumaczenia treści nowości
Treść nowości pochodzi ze strony dokumentacji. Język wybiera backend, wysyłając nagłówek Accept-Language (pl/en) – serwer (blueprints/docs.py, get_lang()) rozpoznaje go i zwraca wersję językową dokumentu. Gdy danej wersji brak, serwer zwraca dostępną (fallback) – to zachowanie serwera. Dzięki temu zmiana języka w nagłówku przeładowuje także treść pobieraną z sieci.
Licencja
GPL-3.0-or-later – pełny tekst w pliku LICENSE.
Copyright (C) 2026 PaganLinux
- 27037ae sklep: respektuj Terminal=true z .desktop (uruchom w emulatorze terminala)
- 90d4bc2 Makefile: forkpty jest w libc (glibc>=2.34), usun -lutil
- 36e6c1e pagan-welcome 1.1: terminal PTY, sklep Otwórz/Usuń, news wg jezyka, bez Ustawien, domyslny EN
- 83622df UI: zakladka 'Instalacja' tylko w trybie live
- c5692b6 LICENSE: GPL-3.0-or-later
- be4ed3f pagan-welcome 1.0: centrum startowe PaganLinux (GTK3 + backend Python)