# Installation Raspberry Pi — Écran TV Salsabil Madrassas

## Objectif
Lancer automatiquement Chromium en mode kiosk sur l’URL TV de l’école, par exemple :

```txt
https://alqiyam.salsabil.cm/tv?code=TV-XXXXXX&token=TOKEN
```

## Matériel conseillé

- Raspberry Pi 4 ou 5
- Carte microSD 32 Go minimum
- Alimentation officielle
- Câble HDMI
- Connexion Internet stable
- Clavier/souris uniquement pour la première configuration

## 1. Installer Raspberry Pi OS

Installer **Raspberry Pi OS with desktop** avec Raspberry Pi Imager.

Pendant la préparation, configurer :

```txt
- nom utilisateur ;
- mot de passe ;
- Wi-Fi ;
- pays : Cameroon si disponible ;
- SSH activé si besoin.
```

## 2. Mettre à jour le Raspberry Pi

```bash
sudo apt update
sudo apt full-upgrade -y
sudo reboot
```

## 3. Installer Chromium et outils utiles

```bash
sudo apt install -y chromium-browser unclutter xdotool
```

`unclutter` masque le curseur de la souris sur l’écran TV.

## 4. Désactiver la veille écran

Éditer le fichier autostart :

```bash
mkdir -p ~/.config/lxsession/LXDE-pi
nano ~/.config/lxsession/LXDE-pi/autostart
```

Mettre ce contenu en remplaçant l’URL par l’URL réelle du player TV :

```txt
@xset s off
@xset -dpms
@xset s noblank
@unclutter -idle 0.5 -root
@chromium-browser --kiosk --noerrdialogs --disable-infobars --disable-session-crashed-bubble --autoplay-policy=no-user-gesture-required --check-for-update-interval=31536000 https://alqiyam.salsabil.cm/tv?code=TV-XXXXXX\&token=TOKEN
```

Important : dans le fichier autostart, garder `\&` entre `code` et `token`.

## 5. Redémarrer

```bash
sudo reboot
```

Au redémarrage, le Raspberry Pi ouvre automatiquement l’écran TV en plein écran.

## 6. Conseils de production

### Éviter que l’écran reste noir

Dans le menu Raspberry Pi :

```txt
Preferences > Raspberry Pi Configuration > Display
```

Désactiver le blanking si l’option est disponible.

Ou en terminal :

```bash
sudo raspi-config
```

Puis chercher les options d’affichage/blanking selon la version du système.

### Tester l’URL avant kiosk

Avant d’activer définitivement le kiosk, ouvrir l’URL dans Chromium normal et vérifier :

```txt
- page TV visible ;
- statut connecté ;
- horloge correcte ;
- activité en cours ;
- résultats si activés ;
- annonces si activées.
```

### En cas de changement de token

Si le token est régénéré dans l’admin, modifier l’URL dans :

```bash
nano ~/.config/lxsession/LXDE-pi/autostart
```

puis redémarrer :

```bash
sudo reboot
```

## 7. Commandes utiles

Redémarrer le Raspberry Pi :

```bash
sudo reboot
```

Éteindre proprement :

```bash
sudo shutdown -h now
```

Afficher l’adresse IP :

```bash
hostname -I
```

Relancer Chromium sans redémarrer :

```bash
pkill chromium
chromium-browser --kiosk --noerrdialogs --disable-infobars --disable-session-crashed-bubble --autoplay-policy=no-user-gesture-required 'https://alqiyam.salsabil.cm/tv?code=TV-XXXXXX&token=TOKEN'
```