kiosk-montaz-screen/README.md

# Kiosk Jednoekranowy — Chromium + Prezentacja PowerPoint — Debian 13

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:**
1. Konfiguruje X11: jeden monitor, wyłącza DPMS, uruchamia openbox
2. Zapisuje `registrymodifications.xcu` — wyłącza presenter console LO
3. Uruchamia watchdog sesji (co 0.4 s ukrywa okna LO poza widoczny obszar)
4. Uruchamia `presentation-manager.sh` w tle
5. Otwiera `waiting.html` fullscreen + always-on-top
6. Czeka na: sieć (`ping diluals31`) **oraz** sygnał od `presentation-manager.sh` (plik `/tmp/kiosk-smb-ready`)
7. Po otrzymaniu obu sygnałów: `sleep 10` — daje LO czas na uruchomienie i pozycjonowanie okna
8. 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:**
1. Montuje udział SMB (`mount /mnt/presentation`) z retry co 5 s
2. Synchronizuje czcionki z `$SMB_MOUNT/fonts/` do `~/.local/share/fonts/smb/`
3. Tworzy plik `/tmp/kiosk-smb-ready` — sygnał dla `kiosk-manager.sh`
4. Czeka na plik `terminal_live.pptx`
5. Uruchamia persistentny watchdog konsoli (co 0.3 s)
6. Uruchamia `soffice --show terminal_live.pptx`
7. Przenosi okna konsoli poza widoczny obszar i fullscreenuje pokaz
8. 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

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

### 2. Zainstaluj pakiety

```bash
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\\`:

```powershell
# 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:

```bash
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):

```bash
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)

```bash
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ń

```bash
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

```bash
mkdir -p /mnt/presentation
```

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

```bash
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.

```bash
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`.

```bash
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`:
```bash
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`:

```bash
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:

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

Skopiuj plik cron:

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

Przeładuj systemd i uruchom serwisy:

```bash
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`:

```bash
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:

```bash
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:

```bash
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`:

```bash
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:

```bash
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:

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

Przeładuj systemd i zrestartuj serwis:

```bash
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

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

```bash
/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

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

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

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

Sprawdź, czy WoL jest aktywne:

```bash
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

```bash
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:

```bash
apt install wakeonlan
```

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

```bash
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:**
1. `xrandr` — pojedynczy ekran: `HDMI-1` primary (0,0)
2. `xsetroot` + `xset` — czarne tło, wyłączony wygaszacz i DPMS
3. `openbox --sm-disable` — lekki WM wymagany przez `wmctrl fullscreen`
4. Zapisuje `registrymodifications.xcu` — wyłącza presenter console LO (`StartWithPresenterScreen=false`)
5. Uruchamia watchdog sesji w tle — co 0.4 s chowa okna soffice poza obszarem widocznym ekranu
6. Uruchamia `presentation-manager.sh` w tle
7. Chromium otwiera `waiting.html` z `fullscreen` + `above`
8. Czeka na sieć (`ping diluals31`) **i** na plik `/tmp/kiosk-smb-ready`
9. `sleep 10` — LO ma czas na pełny start i pozycjonowanie okna przed Chromium
10. 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:**
```bash
# 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:**
```bash
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:**
```bash
SMB_MOUNT="/mnt/presentation"
SMB_SOURCE="//192.168.40.201/DatyFirmowe"
PRESENTATION_FILE="$SMB_MOUNT/terminal_live.pptx"
```

**Jak wyświetlana jest prezentacja:**
1. `presentation-manager.sh` montuje udział SMB na `/mnt/presentation`.
2. Skrypt synchronizuje czcionki z katalogu `fonts/` na udziale SMB do `/home/kiosk/.local/share/fonts/smb/`.
3. Czeka na plik `terminal_live.pptx`.
4. Uruchamia `soffice --show terminal_live.pptx`.
5. `xdotool` i `wmctrl` ustawiają okno pokazu na pełny ekran i przesuwają ewentualną konsolę poza widoczny obszar.
6. `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

```bash
# 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

```bash
systemctl restart kiosk.service
systemctl stop kiosk.service
```

### Ręczne montowanie / odmontowanie SMB (jako root)

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

### Wykrycie nazw wyjść wideo (bez uruchomionego kiosku)

```bash
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)

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

### Czyszczenie cache Chromium

```bash
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` |