diff --git a/README.fr.md b/README.fr.md new file mode 100644 index 0000000..d9d694a --- /dev/null +++ b/README.fr.md @@ -0,0 +1,146 @@ +

+ OqeeRewind +
+ Téléchargeur Oqee TV Live +

+ +

+ + Licence + + + Gestionnaire: uv + +
+ Français | English +

+ +## Avertissement Légal + +Cette application n'est ni endossée ni 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](https://docs.astral.sh/uv/) +- Go ([Guide d'installation](https://go.dev/doc/install)) +- ffmpeg +- [mp4ff-decrypt](https://github.com/Eyevinn/mp4ff) +```bash +go install github.com/Eyevinn/mp4ff/cmd/mp4ff-decrypt@latest +``` + +### Étapes +Clonez le dépôt et installez les dépendances : + +```bash +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) : +```bash +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` : +```bash +OUTPUT_DIR=./telechargements +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. + +```bash +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. + +```bash +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] + [--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: ./download) + --widevine-device WIDEVINE_DEVICE + Chemin vers le fichier de périphérique Widevine (par défaut: ./widevine/device.wvd) + --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL} + Définir le niveau de journalisation (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 :** +```bash +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 "MonFilm" +``` + +**Télécharger avec des clés DRM manuelles :** +```bash +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é +- [x] Implémentation du bruteforce +- [x] Support des informations EPG +- [x] Licence +- [x] Linting du code +- [x] Implémentation de la licence Oqee Widevine (.wvd) +- [x] Implémentation complète +- [x] Vérification de l'installation de mp4ff +- [x] Implémentation des arguments CLI + documentation +- [x] Traduction complète Français/Anglais +- [x] Ajout de plus de commentaires dans le code +- [x] Système de journalisation +- [x] Améliorations du README : + - [x] Bibliothèques utilisées + - [x] Instructions d'utilisation + - [x] Exigences d'installation (pip + mp4ff + ffmpeg) + - [x] GIF de démonstration + +### En cours +- [ ] Meilleur système de sortie +- [ ] Support du restream direct en direct + + +## Bibliothèques Utilisées +- [**aiohttp**](https://github.com/aio-libs/aiohttp) - Framework client/serveur HTTP asynchrone +- [**InquirerPy**](https://github.com/kazhala/InquirerPy) - Invites interactives en ligne de commande +- [**python-dotenv**](https://github.com/theskumar/python-dotenv) - Gestion des variables d'environnement +- [**pywidevine**](https://github.com/rlaphoenix/pywidevine) - Implémentation CDM Widevine +- [**Requests**](https://github.com/psf/requests) - Bibliothèque HTTP diff --git a/README.md b/README.md index ded02f9..b3dcc35 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,8 @@ Manager: uv +
+ Français | English

## Legal Warning