🎬 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é)

# 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

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

4.9 KiB Raw Permalink Blame History