Convert VOE.sx video URLs to direct download commands (curl / yt-dlp).
Bypasses JS-based obfuscation, ad overlays, and bot detection by using
a real (non-headless) Chromium browser via undetected-chromedriver + Xvfb.
- Launches a stealthy Chrome instance on a virtual display (Xvfb)
- Opens the VOE.sx URL (follows redirect to
matthewhotelscience.com) - Closes any ad overlays blocking the player
- Clicks Play via JavaScript
- Extracts the true video source URL from JW Player
- Outputs a ready-to-use download command
- Python 3.10+
- Xvfb (
apt install xvfbon Ubuntu/Debian) - Chrome/Chromium (auto-detected from selenium-manager cache, playwright, or system)
git clone https://github.com/YOUR_USERNAME/voe2curl.git
cd voe2curl
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtpython3 voe2curl.py https://voe.sx/e/VIDEO_IDpython3 voe2curl.py --download https://voe.sx/e/VIDEO_IDpython3 voe2curl.py urls.txtpython3 voe2curl.py --download --output-dir ./season-1 urls.txt- HLS streams (
.m3u8) → outputsyt-dlpcommand - Direct MP4 → outputs
curlcommand - With
--download: downloads the file automatically
MIT