🖥️ BYOS Next — TRMNL Build Your Own Server
Un serveur Next.js open-source pour piloter des écrans e-ink TRMNL — gestion de devices, playlists, rendu BMP à la demande, et recettes personnalisées.
📋 Sommaire
💡 C'est quoi BYOS ?
BYOS (Build Your Own Server) est une alternative open-source au cloud TRMNL. Il te permet d'héberger toi-même le serveur qui pilote tes écrans e-ink TRMNL, sans dépendre de l'infrastructure officielle.
Ce repo est une implémentation Next.js 16 / React 19 du protocole BYOS. Il gère :
- 📡 L'enregistrement et le suivi de tes devices TRMNL (par MAC address & clé API)
- 🖼️ Le rendu à la demande en BMP 1-bit pour l'affichage e-ink
- 📅 La rotation automatique des écrans via un système de playlists
- 🧪 Une galerie de recettes pour prototyper et tester des écrans
✨ Fonctionnalités
| Feature | Description |
|---|
| 🖨️ Rendu BMP | Génération de bitmaps 1-bit via Takumi/Satori, avec cache et revalidation |
| 📱 Gestion devices | Enregistrement MAC/API key, statut, logs, refresh scheduling |
| 📅 Playlists | Rotation d'écrans par heure, jour de semaine, durée, assignée par device |
| 🧪 Galerie recipes | Prototypage d'écrans avec comparaison rendu direct vs BMP |
| 🐳 Docker | Docker Compose pour app + Postgres ; prêt pour le déploiement Vercel |
| 🔐 Auth optionnelle | Mode mono-utilisateur ou multi-utilisateurs avec Better Auth |
| 📦 No-DB mode | Preview des écrans sans base de données |
🌿 reTerminal E1001 — Le setup e-ink parfait
Le Seeed Studio reTerminal E1001 est un écran ePaper monochrome 7.5 pouces open-source, propulsé par un ESP32-S3, avec jusqu'à 3 mois d'autonomie sur batterie.
Dans ce projet, il est utilisé comme device TRMNL autonome :
┌────────────────────────────────────────┐
│ reTerminal E1001 │
│ ┌─────────────────────────────────┐ │
│ │ Écran ePaper 7.5" monochrome │ │
│ │ Rafraîchissement toutes │ │
│ │ les X minutes selon playlist │ │
│ └─────────────────────────────────┘ │
│ ESP32-S3 + WiFi + batterie 3 mois │
└─────────────────┬──────────────────────┘
│ HTTP polling
▼
┌────────────────────────────────────────┐
│ BYOS Next (ce serveur) │
│ - Authentifie le device │
│ - Calcule l'écran courant │
│ - Renvoie le BMP 1-bit │
└────────────────────────────────────────┘
Pourquoi le reTerminal E1001 ?
- 🔋 Jusqu'à 3 mois d'autonomie sur batterie — parfait pour un affichage ambiant
- 📶 WiFi natif via ESP32-S3
- 🖥️ Écran 7.5" monochrome haute qualité, sans rétroéclairage
- 🔧 Compatible nativement TRMNL, Home Assistant, Arduino, ESP-IDF
- 🎨 Idéal pour météo, agenda, tableaux de bord, affichage bureau
🌦️ StarMeteo — La recette météo phare
💡 L'idée
StarMeteo est une recette e-ink inspirée des stations météo La Crosse Technology des années 2000, notamment leurs affichages e-ink segmentés avec police LCD et icônes 1-bit.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
