---
title: Riven
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, media-streaming, scraping, debrid, streaming, python]
confidence: medium
contested: false
sources:
  - https://selfh.st/apps/?tag=Media+Streaming
  - https://github.com/dyascr/riven
---

# 🎬 Riven

> Gestionnaire de scraping et de streaming haute qualité pour *arr, avec support natif des services de débridage (Real-Debrid, AllDebrid, etc.).

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Riven |
| **Slug** | app-riven |
| **Description** | Couche de scraping/streams pour Sonarr/Radarr/Bazarr, orientée débridage et qualité 4K |
| **Site officiel** | https://github.com/dyascr/riven |
| **Repository** | https://github.com/dyascr/riven |
| **Stars** | 805 ⭐ |
| **Licence** | MIT |
| **Langage principal** | Python |
| **Catégorie** | Media Streaming |
| **Tags** | [catalogue, media-streaming, scraping, debrid, streaming, python] |

## 📝 Description

Riven se positionne comme une alternative moderne au couple `Jackett + Prowlarr + indexers torrent` en s'appuyant nativement sur des services de débridage payants. Là où les outils *arr classiques téléchargent un fichier .torrent/.nzb puis l'injectent dans le client BT, Riven récupère des **liens de streaming débridés** et les re-stream via WebDAV ou un serveur HTTP local.

Le projet vise à éliminer la saturation de bande passante réseau tout en conservant la logique de scraping (qualité, langue, taille, release group) que l'on trouve dans Sonarr/Radarr. Il s'intègre avec [[app-jellyfin]], [[app-plex]] et [[app-emby]] en tant que bibliothèque réseau, et expose une API consommable par les *arr si l'on souhaite conserver un workflow existant.

Points forts : interface web claire, support multi-comptes Real-Debrid, filtrage qualité poussé. Limites : encore jeune (API instable entre versions), nécessite un abonnement à un service de débridage (~3 €/mois), et le streaming WebDAV peut butter sur des kernels exotiques ou des players Android TV.

## 🚀 Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
version: "3.8"

services:
  riven:
    image: ghcr.io/dyascr/riven:latest
    container_name: riven
    restart: unless-stopped
    ports:
      - "3000:3000"   # UI web
      - "8080:8080"   # API
    environment:
      - REAL_DEBRID_API_KEY=xxx
      - DEBRID_PROVIDER=realdebrid
      - DEFAULT_RESOLUTION=1080p
      - DATABASE_URL=postgresql://riven:***@riven-db:5432/riven
    volumes:
      - ./config:/app/config
      - ./cache:/app/cache
    depends_on:
      - riven-db

  riven-db:
    image: postgres:16-alpine
    container_name: riven-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: riven
      POSTGRES_PASSWORD: ***
      POSTGRES_DB: riven
    volumes:
      - ./db:/var/lib/postgresql/data
```

### Installation manuelle

```bash
git clone https://github.com/dyascr/riven.git
cd riven
poetry install
poetry run python -m riven
```

## ⚙️ Configuration

- **Provider de débridage** : Real-Debrid, AllDebrid, Premiumize, Debrid-Link — clé API obligatoire.
- **Résolution cible** : 720p, 1080p, 2160p — Riven tente de remonter la qualité en cas d'absence.
- **Filtres langue** : français prioritaire par défaut, configurable via regex.
- **Synchronisation bibliothèque** : Riven peut alimenter directement un dossier consommé par [[app-jellyfin]] ou [[app-plex]] via WebDAV.
- **Reverse proxy** : frontal HTTPS obligatoire ([[app-traefik]] ou [[app-caddy]]).

## 🔗 Alternatives

- **Prowlarr + Sonarr/Radarr + qBittorrent** — Stack torrent classique, plus éprouvée mais consomme de la bande passante.
- **Jackett + Overseerr** — Workflow scraping historique, sans débridage natif.
- **Debrid Media Manager** — GUI pour gérer Real-Debrid, plus simple mais moins intégré.
- **Stremio + addon Torrentio** — Sans auto-hébergement, dépendant de services tiers.

## 🔒 Sécurité

- La clé API Real-Debrid doit être traitée comme un mot de passe : la stocker en variable d'environnement, jamais dans le repo.
- Restreindre l'accès à l'UI au réseau local ou via VPN ([[app-wireguard]]).
- Surveiller le quota de streaming ; un usage intensif peut déclencher des limites côté provider.
- Mettre à jour régulièrement : le projet évolue vite, de nombreux correctifs de sécurité.

## 📚 Ressources

- Repository : https://github.com/dyascr/riven
- Documentation : https://riven.media/docs
- Forum communautaire : https://discord.gg/riven
- Real-Debrid : https://real-debrid.com/

## 🔗 Pages Liées

- [[cat-media-streaming]] (catégorie parente)
- [[app-jellyfin]] — Lecteur principal des médias Riven
- [[app-sonarr]] — Alternative *arr classique
- [[app-prowlarr]] — Indexeurs de torrents
- [[app-traefik]] — Reverse proxy HTTPS
- [[securisation-home-lab]] — Bonnes pratiques
- [[recettes-docker-compose]] — Templates
