Kiosk na 1 monitor. Chromium wyświetla stronę oczekiwania na sieć, a LibreOffice Impress uruchamia prezentację z zamontowanego udziału SMB w trybie pokazu (--show). Skrypt automatycznie wykrywa rozdzielczość ekranu. Używa X11 (xinit + openbox) i zachowuje animacje oraz przejścia.

Architektura

+-----------------------------------------------------------------------+
|                       Kiosk 1-ekranowy / X11 na tty7                   |
|                                                                       |
|  +----------------------+   +--------------------------------------+  |
|  | kiosk.service        |   | presentation-manager.sh              |  |
|  | xinit + openbox      |   | - montuje SMB                        |  |
|  |                      |   | - synchronizuje czcionki             |  |
|  |                      |   | - uruchamia LibreOffice Impress      |  |
|  +----------+-----------+   +------------------+-------------------+  |
|             |                                 |                       |
|             |                                 v                       |
|             |                    +-------------------------------+    |
|             |                    | LibreOffice Impress           |    |
|             |                    | terminal_live.pptx            |    |
|             |                    +----------------+--------------+    |
|             |                                      |                   |
|             |                                      v                   |
|  +----------------------+       +--------------------------------+   |
|  | Chromium             |       | /mnt/presentation              |   |
|  | waiting.html         |       | (CIFS/SMB)                     |   |
|  | fullscreen           |       +----------------+---------------+   |
|  +----------------------+                        |                   |
|                                                  v                   |
|                                       //192.168.40.201/DatyFirmowe  |
+-----------------------------------------------------------------------+

Pliki projektu

README.md — instrukcja instalacji i uruchomienia
kiosk-manager.sh — główny skrypt X11 + Chromium
presentation-manager.sh — montowanie SMB, synchronizacja czcionek i uruchomienie LibreOffice
kiosk.service — systemd service uruchamiający kiosk jako użytkownik kiosk
mnt-presentation.mount — alternatywna jednostka systemd do montowania SMB
smb-credentials.template — wzór pliku poświadczeń SMB
waiting.html — lokalna strona oczekiwania dla Chromium
logo.png — logo wyświetlane w waiting.html
wol-enable.service — usługa utrzymująca Wake on LAN włączone po restarcie
kiosk-schedule — cron wymuszający wyłączenie kiosku w nocnych i weekendowych oknach nieaktywności
sway-config — wzór konfiguracji Wayland/sway (zachowany w repo)

Przepływ — kiosk-manager.sh:

Konfiguruje X11: jeden monitor, wyłącza DPMS, uruchamia openbox
Zapisuje registrymodifications.xcu — wyłącza presenter console LO
Uruchamia watchdog sesji (co 0.4 s ukrywa okna LO poza widoczny obszar)
Uruchamia presentation-manager.sh w tle
Otwiera waiting.html fullscreen + always-on-top
Czeka na: sieć (ping diluals31) oraz sygnał od presentation-manager.sh (plik /tmp/kiosk-smb-ready)
Po otrzymaniu obu sygnałów: sleep 10 — daje LO czas na uruchomienie i pozycjonowanie okna
Przełącza Chromium na docelowy URL

sleep 10 jest kluczowe: zapewnia, że LibreOffice zdąży uruchomić i ustawić okno pokazu zanim Chromium wejdzie w tryb fullscreen+above. Bez tego opóźnienia konsola prezentacji była widoczna po reboot.

Przepływ — presentation-manager.sh:

Montuje udział SMB (mount /mnt/presentation) z retry co 5 s
Synchronizuje czcionki z $SMB_MOUNT/fonts/ do ~/.local/share/fonts/smb/
Tworzy plik /tmp/kiosk-smb-ready — sygnał dla kiosk-manager.sh
Czeka na plik terminal_live.pptx
Uruchamia persistentny watchdog konsoli (co 0.3 s)
Uruchamia soffice --show terminal_live.pptx
Przenosi okna konsoli poza widoczny obszar i fullscreenuje pokaz
Co 5 s: sprawdza mtime pliku i restartuje po zmianie

Wymagania

Debian 13 netinst — instalacja minimalna bez środowiska graficznego
Monitor HDMI-1
Dostęp do udziału SMB/CIFS z plikiem prezentacji

Instalacja krok po kroku

1. Utwórz użytkownika kiosk

useradd -m -s /usr/sbin/nologin kiosk
usermod -aG tty,input,video,render,dialout kiosk

2. Zainstaluj pakiety

apt update && apt install -y \
    xorg xinit openbox \
    chromium \
    libreoffice-impress \
    cifs-utils \
    xdotool wmctrl \
    x11-xserver-utils \
    iputils-ping \
    ethtool \
    wakeonlan

Nie są już potrzebne:

2a. Zainstaluj czcionki

LibreOffice podstawia czcionkę zastępczą gdy oryginalna nie jest zainstalowana w systemie — może to zmienić układ tekstu na slajdach.

Automatyczna instalacja przez udział SMB (zalecane)

presentation-manager.sh automatycznie synchronizuje czcionki z folderu fonts/ na udziale SMB do /home/kiosk/.local/share/fonts/smb/. Wystarczy wrzucić pliki .ttf/.otf na udział — zostaną zainstalowane przy najbliższym restarcie kiosku.

Na maszynie Windows — skopiuj pliki czcionek do \\serwer\\DatyFirmowe\\ALS\\fonts\\:

# Calibri (C:\Windows\Fonts\ lub %LOCALAPPDATA%\Microsoft\Windows\Fonts\)
Copy-Item C:\Windows\Fonts\calibri*.ttf \\\\serwer\\DatyFirmowe\\ALS\\fonts\\

# Aptos — zazwyczaj w cache czcionek chmurowych Microsoft 365:
$src = "$env:LOCALAPPDATA\Microsoft\FontCache\4\CloudFonts\Aptos"
Copy-Item "$src\*" \\\\serwer\\DatyFirmowe\\ALS\\fonts\\

Nazwy plików Aptos w cache mogą być numeryczne — to normalne, fontconfig czyta metadane wewnętrzne, nie nazwę pliku.

Restart kiosku — czcionki zostaną zainstalowane automatycznie:

systemctl restart kiosk.service
# Sprawdź w logach:
journalctl -u kiosk.service -b | grep "czcionka\|Cache czcionek"

Carlito — open-source'owy zamiennik Calibri (opcjonalnie)

Jeśli nie masz dostępu do oryginalnych plików Calibri, Carlito ma identyczne metryki (ten sam układ tekstu i łamania linii):

apt install fonts-crosextra-carlito fonts-crosextra-caladea

fonts-crosextra-caladea to odpowiednik Cambrii. Nie wymaga wrzucania plików na SMB — instalowany systemowo.

Inne czcionki Microsoft (Arial, Times New Roman, Verdana)

apt install ttf-mscorefonts-installer

Nie są już potrzebne: sway, swayidle, wlopm, wlr-randr, seatd, mpv, poppler-utils.

3. Skonfiguruj montowanie udziału SMB

3a. Utwórz plik poświadczeń

mkdir -p /etc/samba
cat > /etc/samba/kiosk-credentials << 'EOF'
username=NAZWA_UZYTKOWNIKA
password=HASLO
domain=WORKGROUP
EOF
chmod 600 /etc/samba/kiosk-credentials
chown root:kiosk /etc/samba/kiosk-credentials

3b. Utwórz punkt montowania

mkdir -p /mnt/presentation

3c. Dodaj wpis w /etc/fstab (montowanie przez użytkownika kiosk)

echo '//192.168.40.201/DatyFirmowe /mnt/presentation cifs credentials=/etc/samba/kiosk-credentials,uid=kiosk,gid=kiosk,vers=3.0,user,noauto,_netdev 0 0' >> /etc/fstab

Opcja user pozwala użytkownikowi kiosk wykonać mount /mnt/presentation bez uprawnień roota. Opcja noauto wyłącza automatyczne montowanie przy starcie — skrypt sam zarządza montem z retry.

Uwaga: Plik mnt-presentation.mount jest zachowany jako opcja systemd do montowania SMB. W obecnym trybie to presentation-manager.sh wykonuje mount /mnt/presentation, ale jednostka pozostaje w repo jako alternatywna opcja montowania.

systemctl disable mnt-presentation.mount
systemctl stop mnt-presentation.mount

4. Sprawdź nazwę wyjścia wideo dla pojedynczego ekranu

W przypadku jednego monitora nadal musisz znać jego X11-ową nazwę wyjścia, aby ustawić go jako OUTPUT_LEFT w kiosk-manager.sh.

for p in /sys/class/drm/card*-*; do
    echo "$(basename $p | sed 's/card[0-9]*-//'): $(cat $p/status)"
done

Przykładowe wyjście:

DP-1: connected
HDMI-1: connected

Ustaw właściwą nazwę wyjścia w kiosk-manager.sh:

OUTPUT_LEFT="HDMI-1"    # główny monitor HDMI

To nie jest wykrywanie wielu ekranów — to potwierdzenie, że pojedynczy monitor jest widoczny jako HDMI-1 (lub inna nazwa) w X11, zanim zostanie skonfigurowany i użyta jego rozdzielczość.

5. Skopiuj pliki konfiguracyjne i uruchom serwisy

Skopiuj skrypty i zasoby do katalogu użytkownika kiosk:

cp kiosk-manager.sh presentation-manager.sh waiting.html logo.png /home/kiosk/
chmod +x /home/kiosk/kiosk-manager.sh /home/kiosk/presentation-manager.sh
chown -R kiosk:kiosk /home/kiosk/

Skopiuj jednostki systemd:

cp kiosk.service wol-enable.service /etc/systemd/system/
cp mnt-presentation.mount /etc/systemd/system/mnt-presentation.mount

Skopiuj plik cron:

cp kiosk-schedule /etc/cron.d/kiosk-schedule
chmod 644 /etc/cron.d/kiosk-schedule

Przeładuj systemd i uruchom serwisy:

systemctl daemon-reload
systemctl enable --now kiosk.service
systemctl enable --now wol-enable.service

Jeżeli chcesz, aby montowanie SMB było wykonywane tylko przez presentation-manager.sh, wyłącz jednostkę mnt-presentation.mount:

systemctl disable --now mnt-presentation.mount

5a. Przez terminal / lokalnie — jak skopiować pliki do kiosku

Jeśli jesteś już zalogowany na kiosku przez terminal (np. Terminus), użyj cp lub mv do przeniesienia plików lokalnie.

Jeżeli pliki znajdują się w katalogu /tmp/ na kiosku, możesz użyć tego przykładu:

sudo cp /tmp/kiosk-manager.sh /home/kiosk/
sudo cp /tmp/presentation-manager.sh /home/kiosk/
sudo cp /tmp/waiting.html /home/kiosk/
sudo cp /tmp/logo.png /home/kiosk/
sudo chmod +x /home/kiosk/kiosk-manager.sh /home/kiosk/presentation-manager.sh
sudo chown -R kiosk:kiosk /home/kiosk/

sudo cp /tmp/kiosk.service /etc/systemd/system/kiosk.service
sudo cp /tmp/wol-enable.service /etc/systemd/system/wol-enable.service
sudo cp /tmp/kiosk-schedule /etc/cron.d/kiosk-schedule
sudo chmod 644 /etc/cron.d/kiosk-schedule

Jeżeli masz pliki w innym katalogu na kiosku, użyj zamiast /tmp/ odpowiedniej ścieżki do miejsca, w którym je zapisałeś.

Przykład z bieżącego katalogu:

sudo cp kiosk-manager.sh presentation-manager.sh waiting.html logo.png /home/kiosk/

Jeśli chcesz, możesz też użyć mv zamiast cp dla plików tymczasowych.

Jeżeli pliki są na innej maszynie, pozostaje opcja scp:

scp kiosk-manager.sh presentation-manager.sh waiting.html logo.png kiosk.service wol-enable.service kiosk-schedule <user>@<kiosk-ip>:/tmp/
ssh <user>@<kiosk-ip>

Po skopiowaniu i ustawieniu uprawnień uruchom:

sudo systemctl daemon-reload
sudo systemctl enable --now kiosk.service
sudo systemctl enable --now wol-enable.service
sudo systemctl disable --now mnt-presentation.mount

Tryb 1-ekranowy

Istniejące skrypty już działają w konfiguracji jednoekranowej. Krok kopiowania plików wykonaj raz w sekcji 5; ta część opisuje tylko dodatkowe ustawienia środowiska.

W kiosk.service możesz dodać zmienną środowiskową ONE_SCREEN=1, aby wymusić obsługę jednego ekranu:

[Service]
Environment=ONE_SCREEN=1
ExecStart=xinit /home/kiosk/kiosk-manager.sh -- :0 vt7

Przeładuj systemd i zrestartuj serwis:

systemctl daemon-reload
systemctl restart kiosk.service

Skrypt wykrywa rozdzielczość ekranu automatycznie; SCREEN_WIDTH lub RES_W należy ustawiać tylko w razie potrzeby.

6. Rozwiązanie problemu z domenami .local


### 6. Rozwiązanie problemu z domenami .local

Jeśli `diluals31` jest rozwiązywany przez DNS firmowy (nie mDNS):

- Otwórz `/etc/nsswitch.conf`
- Zmień linię `hosts:` na: `hosts: files dns mdns4_minimal [NOTFOUND=return]`

### 7. Włącz i uruchom serwis

```bash
systemctl daemon-reload
systemctl enable kiosk.service
systemctl start kiosk.service

8. Skonfiguruj GRUB — natychmiastowy start

# /etc/default/grub
GRUB_DEFAULT=0
GRUB_TIMEOUT=0

/usr/sbin/grub-mkconfig -o /boot/grub/grub.cfg

Harmonogram — Automatyczne wyłączanie i Wake on LAN

Plik kiosk-schedule wymusza wyłączenie kiosku w godzinach nocnych i podczas weekendów. Harmonogram ma trzy cele:

codziennie o 22:00 wywołuje shutdown -h now
w dni robocze dodatkowo co 5 minut wyłącza kiosk między 22:00 a 23:59 oraz między 00:00 a 05:59
w sobotę i niedzielę raz na 5 minut wywołuje shutdown -h now przez całą dobę

Dzięki temu kiosk jest aktywny przede wszystkim w godzinach dziennych w dni robocze, a w oknach nieaktywności system jest pewnie wyłączany.

Utrata prądu: WoL nie zadziała, gdy karta sieciowa nie ma zasilania. Aby kiosk sam wstał po powrocie prądu, ustaw w BIOS/UEFI opcję Restore on AC Power Loss (lub After Power Failure) na Power On. W połączeniu z cyklicznym WoL zapewnia to pełne pokrycie: brak prądu → BIOS bootuje automatycznie; awaria software → WoL obudzi po max. 5 min.

Jeśli prąd wróci w oknie wyłączenia, kiosk może włączyć się przez BIOS, ale kiosk-schedule wyłączy go ponownie w ciągu kilku minut.

Na kiosku

9a. Cron — automatyczne wyłączanie

cp kiosk-schedule /etc/cron.d/kiosk-schedule
chmod 644 /etc/cron.d/kiosk-schedule

9b. Wake on LAN — włączanie i utrwalanie

cp wol-enable.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now wol-enable.service

Sprawdź, czy WoL jest aktywne:

ip link show | grep -A1 "state UP" | grep ether  # MAC adres kiosku
ethtool enp2s0 | grep -i wake                    # zamień enp2s0 na właściwy interfejs

Wymagane ręcznie: BIOS kiosku — wejdź w ustawienia firmware i włącz opcję Wake on LAN lub Power on by PCI-E/PCI. Bez tego ustawienia Magic Packet jest ignorowany przez sprzęt.

9c. Pobierz MAC adres kiosku

ip link show | grep -A1 "state UP" | grep ether | awk '{print $2}'

Zanotuj ten adres — potrzebny do konfiguracji serwera (krok poniżej).

Na serwerze (192.168.40.126)

Zainstaluj narzędzie do wysyłania Magic Packet:

apt install wakeonlan

Utwórz plik crona wysyłającego WoL co 5 minut przez całe okno aktywności kiosku (wstaw MAC kiosku):

cat > /etc/cron.d/kiosk-wol << 'EOF'
SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# Budź kiosk WS-FM035 co 5 min w oknie aktywności: nd 21:00 – sb 7:00
# Jeśli kiosk jest już włączony, pakiet WoL jest ignorowany (bezpieczne).
*/5 21-23 * * 0 root wakeonlan XX:XX:XX:XX:XX:XX
*/5 *    * * 1-5 root wakeonlan XX:XX:XX:XX:XX:XX
*/5 0-6  * * 6   root wakeonlan XX:XX:XX:XX:XX:XX
EOF
chmod 644 /etc/cron.d/kiosk-wol

Zastąp XX:XX:XX:XX:XX:XX adresem MAC pobranym w kroku 9c.

WoL działa w obrębie jednej podsieci (broadcast). Kiosk i serwer są w sieci 192.168.40.x — brak potrzeby konfiguracji routera.

`kiosk.service` → `/etc/systemd/system/kiosk.service`

Jednostka systemd uruchamiająca sesję X11 jako użytkownik kiosk.

Opcja	Wartość	Opis
`ExecStart`	`xinit kiosk-manager.sh -- :0 vt7`	Uruchamia X11 na tty7
`ExecStartPre`	`chvt 7`	Przełącza konsolę na tty7
`PAMName`	`login`	Wymagane do bezrootowego X11 (xinit jako user)
`TTYPath`	`/dev/tty7`	Przypisuje serwis do tty7
`SLIDE_DURATION`	`10`	Czas slajdu (s) — aktualnie nieużywany, LO używa timingów z PPTX
`Restart=always`	—	Automatyczny restart po awarii

Serwis startuje bez network-online.target — celowo, aby waiting.html było widoczne od razu po uruchomieniu systemu. Montowanie SMB obsługuje skrypt z retry.

`kiosk-manager.sh` → `/home/kiosk/kiosk-manager.sh`

Uruchamiany przez xinit. Konfiguruje X11 dla pojedynczego ekranu.

Co robi:

xrandr — pojedynczy ekran: HDMI-1 primary (0,0)
xsetroot + xset — czarne tło, wyłączony wygaszacz i DPMS
openbox --sm-disable — lekki WM wymagany przez wmctrl fullscreen
Zapisuje registrymodifications.xcu — wyłącza presenter console LO (StartWithPresenterScreen=false)
Uruchamia watchdog sesji w tle — co 0.4 s chowa okna soffice poza obszarem widocznym ekranu
Uruchamia presentation-manager.sh w tle
Chromium otwiera waiting.html z fullscreen + above
Czeka na sieć (ping diluals31) i na plik /tmp/kiosk-smb-ready
sleep 10 — LO ma czas na pełny start i pozycjonowanie okna przed Chromium
Kill waiting Chromium → exec Chromium z docelowym URL

Flagi Chromium (CHROMIUM_OPTS):

Flaga	Opis
`--app=URL`	Tryb aplikacji — brak paska adresu, brak kart
`--window-position=0,0 --window-size=1920,1080`	Pozycja na głównym ekranie (X11: bez `--kiosk`, który rozciąga na cały wirtualny desktop)
`--no-first-run`	Pomija ekran powitalny
`--noerrdialogs`	Ukrywa okna dialogowe błędów
`--disable-gpu-suspend`	Zapobiega zawieszaniu GPU przy wygaszaniu
`--force-device-scale-factor=1`	Skalowanie 1:1
`--disable-features=Translate,MediaRouter`	Wyłącza tłumaczenie i Chromecast
`--disable-sync`	Wyłącza synchronizację Google
`--disable-extensions`	Wyłącza rozszerzenia
`--password-store=basic`	Nie używa systemowego portfela haseł
`--disable-pinch`	Wyłącza pinch-to-zoom

Uwaga: --kiosk na X11 rozciąga okno na cały wirtualny desktop. Używamy --app + --window-position/size + wmctrl fullscreen.

Zmiana hosta / URL kiosku:

# kiosk-manager.sh
KIOSK_HOST="diluals31"
KIOSK_URL="http://diluals31/terminal/ift/5/DE/index"

`presentation-manager.sh` → `/home/kiosk/presentation-manager.sh`

Obsługuje montowanie SMB i wyświetlanie prezentacji.

Montowanie SMB:

until mountpoint -q "$SMB_MOUNT"; do
    mount "$SMB_MOUNT"   # korzysta z wpisu fstab z opcją 'user'
    sleep 5              # retry co 5 s
done

Przy zakończeniu skryptu (trap EXIT/INT/TERM): umount /mnt/presentation.

Ustawianie okien LibreOffice (start_lo):

Iteruje wszystkie widoczne okna soffice wg pozycji X:

x ≥ SCREEN_WIDTH → okno pokazu slajdów → wmctrl fullscreen
x < SCREEN_WIDTH → konsola prezentacji → przeniesienie poza obszar widoczny ekranu + wmctrl below
Fallback po 5 s: jeśli nie znajdzie okna do fullscreen, przenosi pierwsze znalezione i ustawia je jako fullscreen

Po ustawieniu LO: Chromium podniesiony jako above (always-on-top).

Watchdog (co 5 s w głównej pętli):

Sprawdza wszystkie widoczne okna soffice — jeśli któreś wróciło na ekran (x < SCREEN_WIDTH), wysyła je z powrotem poza obszar X11
Sprawdza mtime pliku PPTX — po zmianie restartuje pokaz
Sprawdza czy soffice żyje — jeśli zakończył (koniec pokazu), restartuje

Konfiguracja:

SMB_MOUNT="/mnt/presentation"
SMB_SOURCE="//192.168.40.201/DatyFirmowe"
PRESENTATION_FILE="$SMB_MOUNT/terminal_live.pptx"

Jak wyświetlana jest prezentacja:

presentation-manager.sh montuje udział SMB na /mnt/presentation.
Skrypt synchronizuje czcionki z katalogu fonts/ na udziale SMB do /home/kiosk/.local/share/fonts/smb/.
Czeka na plik terminal_live.pptx.
Uruchamia soffice --show terminal_live.pptx.
xdotool i wmctrl ustawiają okno pokazu na pełny ekran i przesuwają ewentualną konsolę poza widoczny obszar.
kiosk-manager.sh uruchamia jednocześnie Chromium z waiting.html i przełącza się na docelowy URL dopiero po gotowości prezentacji i sieci.

`kiosk.service` (wyłączone) `mnt-presentation.mount`

Plik mnt-presentation.mount jest zachowany jako opcja systemd do montowania SMB. Obecna konfiguracja domyślnie używa presentation-manager.sh do montowania /mnt/presentation, ale jednostka w repo może być włączona jako alternatywa.

`sway-config`

Plik sway-config jest zachowany w repo jako opcja/wzór dla środowiska Wayland/sway. Obecne skrypty domyślnie działają na X11, jednak sway-config pozostaje do użytku lub dalszego portowania.

mnt-presentation.mount także pozostaje w repo jako opcja montowania SMB; nie usuwamy go, bo może być przydatny jako alternatywne rozwiązanie.

`kiosk-schedule` → `/etc/cron.d/kiosk-schedule`

Plik crona systemu wyłączający kiosk w sobotę o 7:00 (shutdown -h now jako root).

`wol-enable.service` → `/etc/systemd/system/wol-enable.service`

Jednostka systemd uruchamiana przy każdym starcie systemu. Wywołuje ethtool -s IFACE wol g na wszystkich interfejsach sieciowych — utrzymuje Wake on LAN włączone po rebootach (niektóre sterowniki resetują ustawienie WoL przy wyłączaniu).

`waiting.html` → `/home/kiosk/waiting.html`

Lokalna strona HTML wyświetlana przez Chromium podczas oczekiwania na sieć. Ciemne tło, animowany spinner. Widoczna od startu systemu do momentu, gdy diluals31 odpowie na ping.

Zarządzanie i diagnostyka

Logi

# Logi kiosku na żywo
journalctl -u kiosk.service -f

# Ostatnie 100 linii
journalctl -u kiosk.service -b -n 100

# Tylko logi prezentacji
journalctl -u kiosk.service -b | grep presentation-manager

# Logi montowania SMB
journalctl -u kiosk.service -b | grep "mount:"

Restart / zatrzymanie

systemctl restart kiosk.service
systemctl stop kiosk.service

Ręczne montowanie / odmontowanie SMB (jako root)

mount /mnt/presentation
umount /mnt/presentation
mountpoint /mnt/presentation && echo "zamontowany"

Wykrycie nazw wyjść wideo (bez uruchomionego kiosku)

for p in /sys/class/drm/card*-*; do
    echo "$(basename $p | sed 's/card[0-9]*-//'): $(cat $p/status)"
done

Wymuszenie restartu pokazu (zmiana pliku)

touch /mnt/presentation/terminal_live.pptx
# skrypt wykryje zmianę mtime w ciągu 5 s i zrestartuje LO

Czyszczenie cache Chromium

systemctl stop kiosk.service
rm -rf /home/kiosk/.cache/chromium
systemctl start kiosk.service

Rozwiązywanie problemów

Objaw	Przyczyna	Rozwiązanie
`waiting.html` nie pojawia się	Sieć dostępna natychmiast, ping loop kończy się w <2 s	Normalne zachowanie — `sleep 2` zapewnia min. 2 s widoczności
Prezentacja się nie wyświetla	SMB nie zamontowany	`journalctl -u kiosk.service -b \| grep mount` — sprawdź błędy
`mount: Permission denied`	Opcja `user` brak w fstab lub kiosk nie jest właścicielem	Sprawdź wpis fstab: `grep presentation /etc/fstab`
`mount: not found in /etc/fstab`	Brak wpisu fstab	Dodaj wpis zgodnie z sekcją 3c
Konsola LibreOffice widoczna na ekranie po reboot	LibreOffice startuje przed Chromium (kiosk URL) i konsola zdąży się pokazać	Zwiększ `sleep 10` w `kiosk-manager.sh` (linia po pętli `kiosk-smb-ready`)
Chromium rozciągnięty na cały wirtualny desktop	Użyto `--kiosk` zamiast `--app`	Sprawdź `kiosk-manager.sh` — nie używamy `--kiosk`
Wyświetlacz czarny lub niepoprawny układ	Chromium nie znalazł okna w 30 s	`journalctl \| grep "kiosk-manager"` — sprawdź błędy Chromium
`openbox: command not found`	Brak pakietu	`apt install openbox`
`wmctrl: command not found`	Brak pakietu	`apt install wmctrl`
`xdotool: command not found`	Brak pakietu	`apt install xdotool`
Animacje nie działają	LO konwertuje do PNG/PDF (stare podejście)	Aktualna wersja używa `soffice --show` bezpośrednio — animacje powinny działać
Tekst źle wyświetlany (zła czcionka, zły układ)	Brak czcionki	Skopiuj pliki `.ttf`/`.otf` do `\\serwer\DatyFirmowe\fonts\` i zrestartuj kiosk — skrypt zainstaluje je automatycznie
Udział SMB z protokołem SMB 1.0	`vers=3.0` nieobsługiwany	Zmień na `vers=2.1` lub `vers=1.0` w `/etc/fstab`
Czarny ekran po restarcie	Chromium trzyma zablokowany profil	`rm -rf /home/kiosk/.cache/chromium`
X11 nie startuje (`cannot open display`)	Brak pakietu xorg	`apt install xorg`

README.md Unescape Escape

Kiosk Jednoekranowy — Chromium + Prezentacja PowerPoint — Debian 13