5.1 KiB
OqeeRewind
Oqee TV Live Downloader
OqeeRewind - Oqee TV Live Downloader
Legal Warning
This application is not endorsed by or affiliated with Oqee. This application enables you to download videos for offline viewing which may be forbidden by law in your country. The usage of this application may also cause a violation of the Terms of Service between you and the stream provider. This tool is not responsible for your actions; please make an informed decision before using this application.
Installation
Prerequisites
- Python 3.9+
- uv
- Go (Installation Guide)
- ffmpeg
- mp4ff-decrypt
go install github.com/Eyevinn/mp4ff/cmd/mp4ff-decrypt@latest
Steps
Clone the repository and install dependencies:
git clone https://github.com/NohamR/OqeeRewind && cd OqeeRewind
uv sync
Configuration
Create a .env file in the root directory and add your Oqee credentials (otherwise the script will try to use IP login first):
OQEE_USERNAME=your_username
OQEE_PASSWORD=your_password
Optionally, you can set the following environment variables in the .env file:
OUTPUT_DIR=./downloads
API_KEY=your_api_key_here
API_URL=https://example.com/get-cached-keys
Usage
Interactive Mode
If you run the script without arguments, it will guide you through channel selection and date picking.
Using uv:
uv run main.py
CLI Mode
You can automate the download by providing 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]
options:
-h, --help show this help message and exit
--start-date START_DATE
Start date and time in YYYY-MM-DD HH:MM:SS format
--end-date END_DATE End date and time in YYYY-MM-DD HH:MM:SS format
--duration DURATION Duration in HH:MM:SS format (alternative to --end-date)
--channel-id CHANNEL_ID
Channel ID to download from
--video VIDEO Video quality selection (e.g., 'best', '1080p', '720p', '1080p+best', '720p+worst')
--audio AUDIO Audio track selection (e.g., 'best', 'fra_main')
--title TITLE Title for the download (default: channel_id_start_date)
--username USERNAME Oqee username for authentication
--password PASSWORD Oqee password for authentication
--key KEY DRM key for decryption (can be specified multiple times)
--output-dir OUTPUT_DIR
Output directory for downloaded files (default: ./download)
--widevine-device WIDEVINE_DEVICE
Path to Widevine device file (default: ./widevine/device.wvd)
Examples
Download a specific program with duration:
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 "MyMovie"
Download with manual DRM keys:
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"
DRM Decryption
Instructions (Widevine)
In order to decrypt DRM content, you will need to have a dumped CDM, after that you will need to place the CDM files into the ./widevine/ directory. For legal reasons we do not include the CDM with the software, and you will have to source one yourself.
Todo
- Bruteforce implementation
- EPG info support
- License
- Better README
- Lib used
- How to use
- Lib to install (pip + mp4ff + ffmpeg)
- Demo GIF
- Lint code
- Oqee widevine license implementation (.wvd) + mention README
- Full implementation
- Verify mp4ff installation
- CLI arguments implementation + documentation
- French/English full translation
- Better output system
- Add more comments in the code
- Logging system
- Live direct restream support
Libraries Used
- aiohttp - Async HTTP client/server framework
- InquirerPy - Interactive command line prompts
- python-dotenv - Environment variable management
- pywidevine - Widevine CDM implementation
- Requests - HTTP library