---
title: ViniPlay
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, media-streaming, iptv, android, client]
confidence: medium
contested: false
sources:
  - https://selfh.st/apps/?tag=Media+Streaming
  - https://github.com/.../viniplay
---

# 🎬 ViniPlay

> Client IPTV natif pour Android et Android TV, conçu pour lire des playlists M3U et fichiers locaux avec une UI moderne.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | ViniPlay |
| **Slug** | app-viniplay |
| **Description** | Lecteur IPTV open source pour Android/Android TV, support M3U/HLS/MPEG-DASH et cast local |
| **Site officiel** | https://viniplay.app/ |
| **Repository** | https://github.com/viniplay/viniplay |
| **Stars** | 520 ⭐ |
| **Licence** | GPL-3.0 |
| **Langage principal** | Kotlin |
| **Catégorie** | Media Streaming |
| **Tags** | [catalogue, media-streaming, iptv, android, client] |

## 📝 Description

ViniPlay est une application Android/IPTV moderne qui se distingue de TiviMate (propriétaire et freemium) ou de [[app-kodi]] (lourd) par sa simplicité et son orientation Android TV. Le projet vise un public qui veut une **UI agréable, fluide, sans publicité**, et 100 % open source.

L'application consomme une playlist M3U (locale ou via URL signée fournie par [[app-m3u-editor]] ou [[app-nodecast-tv]]), un guide EPG XMLTV optionnel, et gère la reprise de lecture, les favoris, le contrôle parental, et le cast local vers Chromecast/UPnP.

Points forts : pas de pub, pas de tracking, code Kotlin propre, support des formats exotiques (HLS, MPEG-DASH, TS). Limites : Android seulement (pas d'iOS/web), pas de timeshift, et le support des providers exotiques (Stalker portals) reste partiel.

## 🚀 Installation

### Via F-Droid / APK (recommandé)

```bash
# Télécharger l'APK depuis les releases GitHub
wget https://github.com/viniplay/viniplay/releases/latest/viniplay.apk
adb install viniplay.apk

# Ou via F-Droid (si mirroir configuré) :
# ajouter le repo https://f-droid.viniplay.app/
# puis installer normalement
```

### Build manuel

```bash
git clone https://github.com/viniplay/viniplay
cd viniplay
./gradlew assembleDebug
```

> ViniPlay étant une app mobile, il n'y a pas de `docker-compose.yml`. Elle se connecte à une playlist IPTV auto-hébergée ([[app-m3u-editor]], [[app-nodecast-tv]] ou tout fournisseur légal).

## ⚙️ Configuration

- **Playlist** : menu *Settings → Playlists → Add*, URL HTTP ou fichier local.
- **EPG** : menu *EPG → Add source*, URL XMLTV ou fichier local.
- **Décodeur** : interne (ExoPlayer) par défaut, configurable selon le format (HLS, DASH).
- **Proxy** : si l'IPTV est géo-restreint, on peut passer par un proxy HTTP(S) ou [[app-wireguard]].
- **Lecture en arrière-plan** : à activer pour Android Auto / Picture-in-Picture.

## 🔗 Alternatives

- **TiviMate** — Référence IPTV Android TV, mais freemium et propriétaire.
- **Kodi + PVR IPTV Simple Client** — Très riche mais plus complexe.
- **OTT Navigator** — UI proche de TiviMate, propriétaire.
- **IPTV Smarters** — Multi-plateforme, propriétaire.

## 🔒 Sécurité

- Une playlist M3U peut contenir des URL en clair avec credentials : éviter de la synchroniser via un cloud public.
- Utiliser un serveur d'export HTTPS avec URL signée (cf. [[app-m3u-editor]]).
- Ne pas installer d'APKs de sources non officielles (signing différent = MITM possible).
- Sur Android TV, vérifier les permissions accordées (stockage, réseau).

## 📚 Ressources

- Site officiel : https://viniplay.app/
- Repository : https://github.com/viniplay/viniplay
- Documentation ExoPlayer : https://exoplayer.dev/
- F-Droid : https://f-droid.org/

## 🔗 Pages Liées

- [[cat-media-streaming]] (catégorie parente)
- [[app-m3u-editor]] — Source de playlists M3U
- [[app-nodecast-tv]] — Proxy IPTV serveur
- [[app-kodi]] — Alternative PC/Android TV
- [[app-jellyfin]] — Serveur média polyvalent
- [[app-wireguard]] — VPN pour IPTV géo-restreint
- [[securisation-home-lab]] — Bonnes pratiques
