MiniVid est une application web auto-hébergée légère qui permet de parcourir, organiser et lire vos vidéos locales depuis n’importe quel appareil.
Pensée pour être simple, rapide et efficace, elle combine navigation par dossiers, tags automatiques, favoris, vidéos similaires, et un lecteur intégré compatible avec les formats vidéo modernes.
- 🎬 Vidéos similaires : Affiche sous chaque vidéo une grille de vidéos partageant des tags communs (configurable : 1, 2 ou 3 tags minimum).
- ✨ Interface Moderne : Design "Premium" avec police Inter, effets de Glassmorphism et animations fluides.
- 🎥 Lecture Native (DIRECT) : Priorité à la lecture sans transcodage pour les formats supportés par le navigateur (MKV/MP4).
- 🔄 Fallback Intelligent : Bascule automatique en HLS (transcodé) si le flux direct n'est pas supporté.
- ⚡ Optimisations HLS : Accélération matérielle NVIDIA NVENC (GPU) et mise en cache des segments sur disque.
- 📅 Grouper par date : Nouvelle vue chronologique (Aujourd'hui, Cette semaine, Ce mois...) pour vos vidéos.
- ⌨️ UX & Accessibilité : Skeleton loading, nouveaux raccourcis clavier (J/K/L, F, M, Espace) et support total des caractères Cyrilliques.
- Accédez à vos vidéos avec une arborescence claire
- Extraction depuis les noms de fichiers
- Tags globaux par dossier
- Tags individuels par fichier
- Multi-sélection et recherche par tags
- Blacklist configurable pour supprimer les mots inutiles (
and,the,source, etc.)
- Par nom de fichier
- Par tags multiples
- Par favoris
- Par statut Lue / Non lue
- Nom, Taille, Date de modification
- Statut Lues / Non lues
- Grouper par date (Vue chronologique)
- Marquez vos vidéos d’un clic (★)
- Accédez à la vue dédiée Favoris
- Support natif mp4, webm et mkv (Chrome/Edge)
- HLS dynamique pour Firefox et formats non supportés
- Accélération matérielle (NVENC) pour le transcodage
- Reprise de lecture automatique (Progress bar)
- Générées avec
ffmpeg - Capture par défaut à 5 secondes (pour éviter logos/intro)
- Ajustable via les variables
MINI_THUMB_OFFSET,MINI_THUMB_MAX
- Design moderne Inter, Glassmorphism
- Desktop, tablette et mobile
- Skeleton loading pour un affichage fluide
- Bascule instantanée
- Rescan complet de la bibliothèque
- Purge des miniatures et du cache HLS
- Journal d’événements en direct (logs des actions)
- Toutes les heures par défaut
- Intervalle configurable via
MINI_SCAN_INTERVAL
- Mode public
- Ou mono-utilisateur avec identifiant/mot de passe
- Tout se règle via variables d’environnement dans votre
docker-compose.yml
Pour découvrir MiniVid en images et lire la présentation complète, consultez l’article dédié sur mon blog :
👉 MiniVid — Indexage, lecture, tags et favoris pour vos vidéos locales
| Variable | Valeur par défaut | Description |
|---|---|---|
| MEDIA_DIRS | (vide) | Liste des dossiers vidéos (séparés par ` |
| MEDIA_NAMES | Dossier 1, Dossier 2… |
Noms affichés pour chaque dossier (même ordre que MEDIA_DIRS) |
| MINI_ALLOWED_EXT | .mp4,.webm,.mkv,.avi,.flv,.m2ts |
Extensions autorisées |
| MINI_BANNED_TAGS | (vide) | Liste de mots à ignorer lors de la génération de tags (and,the,source,…) |
| DATA_DIR | /data |
Dossier de stockage interne (état, favoris, prefs) |
| THUMB_DIR | /cache/thumbs |
Dossier cache des miniatures |
| MINI_USER | (vide) | Identifiant de connexion (optionnel) |
| MINI_PASS | (vide) | Mot de passe de connexion (optionnel) |
| SECRET_KEY | (aléatoire) | Clé de session Flask (authentification) |
| MINI_PLAYBACK | direct |
Mode lecture : direct, auto, remux |
| MINI_TRANSCODE | 0 |
Autoriser le transcodage H.264/AAC (1 = oui, 0 = non) |
| MINI_FIREFOX_MKV_FALLBACK | 1 |
Force le remux des .mkv dans Firefox |
| MINI_AUTOSCAN | 1 |
Activer le rescan automatique (1 = oui) |
| MINI_SCAN_INTERVAL | 3600 |
Intervalle entre scans auto (en secondes) |
| MINI_THUMB_OFFSET | 5 |
Seconde du screenshot miniature |
| MINI_THUMB_MAX | 30 |
Offset max (si vidéo longue) |
| MINI_FFPROBE_TIMEOUT | 10 |
Timeout en secondes pour ffprobe/ffmpeg |
L'indexation des fichiers se fait à la volée au 1er lancement, plus ou moins rapidement selon la quantité de vidéos et le CPU. Le transcodage est optimisé via GPU (NVENC) si disponible. Aucun appel externe, tout est 100% local. Fonctionne en http://IP:port comme en reverse proxy.
Un fichier .env.example est fourni comme base :
cp .env.example .envPuis éditez .env selon vos besoins :
# URL interne du service
APP_URL=http://minivid:8080
# Auth (laisser vide pour désactiver l'auth)
MINI_USER=michel
MINI_PASS=m1ch3l
# Fréquence en secondes (3600 = 1h)
INTERVAL=3600
openssl rand -hex 32services:
minivid:
image: ghcr.io/aerya/minivid:latest
container_name: minivid
restart: always
environment:
TZ: Europe/Paris
MEDIA_DIRS: /videos1|/videos2
MEDIA_NAMES: ruTorrent|MeTube
DATA_DIR: /data
THUMB_DIR: /cache/thumbs
MINI_ALLOWED_EXT: .mp4,.webm,.mkv,.avi,.flv,.m2ts,.ts
MINI_PLAYBACK: "auto"
MINI_TRANSCODE: 1
MINI_FIREFOX_MKV_FALLBACK: 1
MINI_THUMB_OFFSET: 5
MINI_THUMB_MAX: 30
MINI_AUTOSCAN: 1
# Auth (prises du .env ; si vide => pas d'auth)
MINI_USER: ${MINI_USER}
MINI_PASS: ${MINI_PASS}
# En console : openssl rand -hex 32
SECRET_KEY:
# Liste noire tags (les mots de moins de 3 lettres sont automatiquement bannis)
MINI_BANNED_TAGS: >
and,the,source,video,videos,vid,vids,film,movie,part,
les,une,des,ils,elles,sur,sous,dans,par,pour,sans,avec,chez,
cet,cette,ces,mon,mes,ton,tes,ses,notre,nos,votre,vos,leur,leurs,
qui,que,quoi,dont,quand,comme,
your,they,for,with,without,into,onto,about,this,that,these,those,
here,there,then,than,are,was,being,been,have,had,just,only,
over,under,very,more,most,less,were,com,net
volumes:
- /mnt/Fichiers/rutorrentdirect:/videos1:ro
- /mnt/Fichiers/metube:/videos2:ro
- /mnt/Docker/MiniVid/data:/data
- /mnt/Docker/MiniVid/cache:/cache
ports:
- "8080:8080"
# Scan toutes les INTERVAL secondes
minivid-scheduler:
image: curlimages/curl:8.10.1
container_name: minivid-scheduler
depends_on:
- minivid
restart: always
environment:
APP_URL: ${APP_URL}
MINI_USER: ${MINI_USER}
MINI_PASS: ${MINI_PASS}
INTERVAL: ${INTERVAL}
command: >
sh -c '
set -eu;
for i in $(seq 1 60); do curl -fsS "$APP_URL/maintenance" >/dev/null 2>&1 && break || sleep 2; done
while :; do
if [ -n "$MINI_USER" ] && [ -n "$MINI_PASS" ]; then
# login (remember=on)
curl -sS -c /tmp/c.jar -X POST "$APP_URL/login" \
-d "username=$MINI_USER" -d "password=$MINI_PASS" -d "remember=on" -o /dev/null || true
if curl -sS -b /tmp/c.jar "$APP_URL/api/maintenance/progress" | grep -qi "\"running\"\\s*:\\s*true"; then
sleep 120
else
curl -m 5 -sS -b /tmp/c.jar -X POST "$APP_URL/api/maintenance/rescan" -o /dev/null || true
fi
else
curl -m 5 -sS -X POST "$APP_URL/api/maintenance/rescan" -o /dev/null || true
fi
sleep "$INTERVAL"
done
'👉 Télécharger et lancer Windows-MiniVid.bat
- Il installera si nécessaire Docker Desktop sur la machine,
- Guidage complet pour la configuration de MiniVid (édition complète disponible),
- Ajout de dossiers locaux comme distants (SMB/CIFS avec ou sans user:pwd).
