OqeeRewind/README.fr.md at main

noham/OqeeRewind

Fork 0

mirror of https://github.com/NohamR/OqeeRewind.git synced 2026-01-09 07:38:12 +00:00

Files

√(noham)² c23263364a Add segment batch size option and rename batch size args

2026-01-05 21:32:35 +01:00

6.5 KiB

Raw Permalink Blame History

OqeeRewind
^{Téléchargeur Oqee TV Live}

Français | English

Avertissement Légal

Cette application n'est pas affiliée à Oqee. Cette application vous permet de télécharger des vidéos pour une visualisation hors ligne, ce qui peut être interdit par la loi dans votre pays. L'utilisation de cette application peut également entraîner une violation des Conditions d'utilisation entre vous et le fournisseur de flux. Cet outil n'est pas responsable de vos actions ; veuillez prendre une décision éclairée avant d'utiliser cette application.

Installation

Prérequis

Python 3.9+
uv
Go (Guide d'installation)
ffmpeg
mp4ff-decrypt

go install github.com/Eyevinn/mp4ff/cmd/mp4ff-decrypt@latest

Étapes

Clonez le dépôt et installez les dépendances :

git clone https://github.com/NohamR/OqeeRewind && cd OqeeRewind
uv sync

Configuration

Créez un fichier .env dans le répertoire racine et ajoutez vos identifiants Oqee (sinon le script essaiera d'abord d'utiliser la connexion par IP) :

OQEE_USERNAME=votre_nom_utilisateur
OQEE_PASSWORD=votre_mot_de_passe

Optionnellement, vous pouvez définir les variables d'environnement suivantes dans le fichier .env :

OUTPUT_DIR=./downloads
API_KEY=votre_cle_api_ici
API_URL=https://example.com/get-cached-keys

Utilisation

Mode Interactif

Si vous exécutez le script sans arguments, il vous guidera à travers la sélection des chaînes et le choix des dates.

uv run main.py

https://github.com/user-attachments/assets/54a50828-c0e9-4a29-81c7-e188c238a998

Mode CLI

Vous pouvez automatiser le téléchargement en fournissant des arguments.

usage: main.py [-h] [--start-date START_DATE] [--end-date END_DATE] [--duration DURATION]
               [--channel-id CHANNEL_ID] [--video VIDEO] [--audio AUDIO] [--title TITLE]
               [--username USERNAME] [--password PASSWORD] [--key KEY]
               [--output-dir OUTPUT_DIR] [--widevine-device WIDEVINE_DEVICE]
               [--bruteforce-batch-size BRUTEFORCE_BATCH_SIZE]
               [--segment-batch-size SEGMENT_BATCH_SIZE]
               [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}]

options:
  -h, --help            afficher ce message d'aide et quitter
  --start-date START_DATE
                        Date et heure de début au format AAAA-MM-JJ HH:MM:SS
  --end-date END_DATE   Date et heure de fin au format AAAA-MM-JJ HH:MM:SS
  --duration DURATION   Durée au format HH:MM:SS (alternative à --end-date)
  --channel-id CHANNEL_ID
                        ID de la chaîne à télécharger
  --video VIDEO         Sélection de la qualité vidéo (ex: 'best', '1080p', '720p', '1080p+best', '720p+worst')
  --audio AUDIO         Sélection de la piste audio (ex: 'best', 'fra_main')
  --title TITLE         Titre du téléchargement (par défaut: channel_id_start_date)
  --username USERNAME   Nom d'utilisateur Oqee pour l'authentification
  --password PASSWORD   Mot de passe Oqee pour l'authentification
  --key KEY             Clé DRM pour le déchiffrement (peut être spécifiée plusieurs fois)
  --output-dir OUTPUT_DIR
                        Répertoire de sortie pour les fichiers téléchargés (par défaut: ./downloads)
  --widevine-device WIDEVINE_DEVICE
                        Chemin vers le CDM Widevine (par défaut: ./widevine/device.wvd)
  --bruteforce-batch-size BRUTEFORCE_BATCH_SIZE
                        Taille de lot pour le bruteforce (par défaut: 20000)
  --segment-batch-size SEGMENT_BATCH_SIZE
                        Taille de lot pour les téléchargements de segments (par défaut: 64)
  --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        Définir le niveau de logging (par défaut: INFO)

https://github.com/user-attachments/assets/cc76990a-3d13-4be1-bb3c-ba8d87e6eaba

Exemples

Télécharger un programme spécifique avec une durée :

uv run main.py --channel-id 536 --start-date "2025-12-19 12:00:00" --duration "01:30:00" --video "1080p+best" --audio "best" --title "Enregistrement"

Télécharger avec des clés DRM manuelles :

uv run main.py --channel-id 536 --start-date "2025-12-19 12:00:00" --duration "00:05:00" --key "KID:KEY" --key "KID2:KEY2"

Déchiffrement DRM

Instructions (Widevine)

Afin de déchiffrer le contenu DRM, vous devrez disposer d'un CDM dumpé, après quoi vous devrez placer les fichiers CDM dans le répertoire ./widevine/. Pour des raisons légales, nous n'incluons pas le CDM avec le logiciel, et vous devrez vous en procurer un vous-même.

À faire

Terminé

Implémentation du bruteforce
Support des informations EPG
Licence
Linting du code
Implémentation de la licence Oqee Widevine (.wvd)
Implémentation complète
Vérification de l'installation de mp4ff
Implémentation des arguments CLI + documentation
Traduction complète Français/Anglais
Ajout de plus de commentaires dans le code
Système de journalisation
Améliorations du README :
- Bibliothèques utilisées
- Instructions d'utilisation
- Exigences d'installation (pip + mp4ff + ffmpeg)
- GIF de démonstration

En cours

Meilleur système de sortie
Support du restream direct en direct

Bibliothèques Utilisées

aiohttp - Framework client/serveur HTTP asynchrone
InquirerPy - Invites interactives en ligne de commande
python-dotenv - Gestion des variables d'environnement
pywidevine - Implémentation CDM Widevine
Requests - Bibliothèque HTTP

6.5 KiB Raw Permalink Blame History