# 📺 GridTV

> Guide TV IPTV en temps réel, pensé pour [Tunarr](https://github.com/chrisbenincasa/tunarr) et toute source XMLTV/M3U.

![PHP](https://img.shields.io/badge/PHP-8.0+-777BB4?style=flat-square&logo=php&logoColor=white)
![Nginx](https://img.shields.io/badge/Nginx-ready-009639?style=flat-square&logo=nginx&logoColor=white)
![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)

---

## ✨ Fonctionnalités

- 🎛️ **Grille timeline** — vue horizontale façon guide TV classique, avec ligne "maintenant" en temps réel
- 📱 **Responsive** — vue liste optimisée sur mobile
- ⏱️ **Barre de progression** en direct sur le programme en cours
- 🕶️ **Programmes passés** atténués automatiquement
- 📋 **Tooltip** au survol — titre, synopsis, saison/épisode, horaires, durée
- 🔗 **Boutons copie** EPG & M3U en un clic dans la topbar
- ⚙️ **Setup guidé** au premier lancement — zéro fichier à éditer à la main
- 🔄 **Rechargement automatique** de l'EPG toutes les 30 minutes
- 0️⃣ **Zéro dépendance** — PHP vanilla + nginx, c'est tout

---

## 📸 Aperçu

```
┌─────────────────────────────────────────────────────────────────┐
│ MonGroupe / GridTV   Lun 09 Mar   14:32:18   ◀1h  Maintenant  1h▶  EPG  M3U  ● LIVE │
├──────────┬────────────────────────┬──────────────────┬──────────┤
│ 1 Action │ ██████ Terminator ████ │  Die Hard        │  ...     │
│ 2 Legend │   Bio de Jimi Hendrix  │ ████████████████ │  ...     │
│ 3 Séries │  Sopranos S02E07  ████ │  ...             │          │
└──────────┴────────────────────────┴──────────────────┴──────────┘
```

---

## 🚀 Installation

### Prérequis

- Serveur web avec **PHP 8.0+** et **php-fpm**
- **Nginx** (ou Apache)
- Une source **EPG au format XMLTV** (ex: Tunarr, Jellyfin, xTeVe...)
- *(Optionnel)* Une playlist **M3U**

---

### 1. Cloner le repo

```bash
git clone https://github.com/Johnnybegood90/gridtv.git /var/www/gridtv
cd /var/www/gridtv
```

---

### 2. Permissions

```bash
# Le serveur web doit pouvoir écrire config.json lors du setup
chmod 775 /var/www/gridtv
chown -R www-data:www-data /var/www/gridtv
```

---

### 3. Configurer Nginx

```nginx
server {
    listen 80;
    server_name guide.ton-domaine.fr;

    root /var/www/gridtv;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}
```

> 💡 Adapte la version de PHP (`php8.2-fpm`) à celle installée sur ton serveur.

```bash
nginx -t && systemctl reload nginx
```

---

### 4. Premier lancement — Setup

Ouvre ton navigateur sur `http://guide.ton-domaine.fr`.

GridTV détecte l'absence de config et te redirige automatiquement vers la page de setup :

| Champ | Description |
|---|---|
| **Nom du groupe** | S'affiche en haut à gauche (ex: *JohnnyBeGood*, *MaTV*...) |
| **URL EPG (XMLTV)** | L'URL de ton guide électronique des programmes |
| **URL M3U** *(optionnel)* | Ta playlist IPTV, pour copie rapide depuis la topbar |

Une fois validé, le fichier `config.json` est créé sur le serveur. **La page setup devient inaccessible.**

---

### 5. Modifier la config plus tard

```bash
# Via SSH
nano /var/www/gridtv/config.json
```

```json
{
  "group_name": "MonGroupe TV",
  "epg_url": "http://192.168.0.3:8000/api/xmltv.xml",
  "m3u_url": "http://192.168.0.3:8000/api/channels.m3u"
}
```

---

## 📁 Structure du projet

```
gridtv/
├── index.php            # Le guide TV (redirige vers setup si pas de config)
├── setup.php            # Page de configuration initiale
├── config.example.json  # Template de config (à copier → config.json)
├── .gitignore           # config.json exclu du repo
└── README.md
```

> `config.json` est dans le `.gitignore` — tes URLs privées ne seront jamais poussées sur GitHub.

---

## ⚙️ Configuration avancée

Les constantes suivantes sont modifiables directement dans `index.php` :

```js
const PX_PER_MIN   = 5;   // Zoom horizontal (pixels par minute)
const HOURS_BEFORE = 1;   // Heures passées visibles dans la grille
const HOURS_AFTER  = 3;   // Heures futures visibles
const ROW_H        = 80;  // Hauteur d'une ligne chaîne (px)
```

---

## 🧩 Compatibilité EPG

GridTV parse le format **XMLTV standard**. Testé avec :

- ✅ [Tunarr](https://github.com/chrisbenincasa/tunarr)
- ✅ [xTeVe](https://github.com/xteve-project/xTeVe)
- ✅ [Jellyfin](https://jellyfin.org/) (via plugin LiveTV)
- ✅ Tout fichier XMLTV conforme à la spec

---

## 🤝 Contribuer

Les PRs sont les bienvenues ! Si t'as une idée, une correction, ou une feature — ouvre une issue ou envoie direct une PR.

---

## 📄 Licence

MIT — fais-en ce que tu veux.