VOE.sx Bulk Video Downloader — voedl

voedl is a high‑speed, command‑line utility that turns stream pages from VOE.sx, jonathansociallike.com, and diananatureforeign.com into direct MP4 downloads—parallelized and using multi‑connection transfers for maximum throughput.

---

✨ Features

• Resolver chain: VOE JSON API → /e/ embed → /download stub → orbitcache MP4 (with correct Referer header to bypass 403).
• Multi‑connection download via aria2c (default: 16 × 2 MiB per file).
• Parallel downloads with configurable worker pool (-w / --workers).
• Progress bars: Per‑file live bars via tqdm (--progress).
• Debug mode (-d): Logs detailed resolver and download steps to a timestamped logfile.
• Single‑entry mode (-l): Download one URL|Name directly without a list file.

---

🚀 Installation

1) From PyPI

pip install voedl

Visit the latest release on PyPI: https://pypi.org/project/voedl/

2) From source (no pip install required except dependencies)

# Clone the repository
git clone https://github.com/M2tecDev/voedl.git
cd voedl

# Install Python dependencies only
pip install -r requirements.txt

# Run directly from source
python voedl.py [options]

---

⚙️ Usage

Once installed via pip:

voedl [options]

If running from a local clone:

python voedl.py [options]

Options:
  -h, --help            Show this help message and exit
  -f, --file FILE       Path to links list file (default: links.txt)
  -w, --workers N       Number of parallel download slots (default: 2)
  -c, --chunks N        Number of aria2c connections per file (default: 16)
  -l, --url ENTRY       Download a single "URL | Name" entry
  -d, --debug           Enable debug log (writes voedl_YYYYMMDD-HHMMSS.log)
      --progress        Show tqdm progress bars ( slower )

---

🖥️ Examples

• Download whole list with 4 parallel workers and live bars:

  voedl -f links.txt -w 4 --progress

• Single video with 32 aria2c segments:

  voedl -l "https://voe.sx/v/XYZ123 | My Clip" -c 32 --progress

• Default list with debug log:

  voedl -d

---

📜 License

Released under the MIT License.
See the LICENSE file for details.

---

_{SEO keywords: voe downloader, voe.sx downloader, jonathansociallike, orbitcache mp4, bulk video CLI.}