Your Local Media Workspace & Viral Content Engine
Download videos, extract audio, create short clips, and manage batch queues locally.
Velo is a fully localized media workspace designed for efficiency and robustness. It offers a premium, modern web dashboard that runs entirely in your browser, powered locally by Flask and yt-dlp.
Built specifically to handle real-world network conditions—including unstable and low-bandwidth connections—Velo provides the ultimate toolkit for media management and history tracking without relying on cloud services.
- 🌗 Local Web Dashboard: A sleek, Vercel-inspired interface with light/dark mode support.
- 📶 Resilient Network Modes: Choose from Stable, Balanced, Turbo, and Data Saver to adapt to your connection.
- 🛠️ Versatile Workflows: Support for single video downloads, audio extraction, batch queues, and precise clip making.
- ⏯️ Advanced Queue Controls: Pause, resume, stop, retry failed items, deduplicate links, and requeue directly from history.
- 📊 Insights & Statistics: Built-in dashboard tracking total downloads, storage usage, top channels, formats, and daily activity.
- 📁 Seamless Management: Search history, filter by channel, copy file paths, and open folders directly from the UI.
- 🌍 Multilingual: UI foundation with support for English and Arabic.
- 📄 Exportable Reports: Export your download history in JSON or CSV formats.
Before you begin, ensure you have the following installed:
- 🐍 Python 3.11 or newer.
- 🎬 FFmpeg (Must be installed and available on your system's PATH).
- 🌐 Internet Access (For downloading media and initial CDN assets).
winget install ffmpegGet Velo running locally in a few simple steps:
-
Create and activate a virtual environment:
python -m venv .venv .\.venv\Scripts\Activate.ps1 -
Install dependencies:
pip install -r requirements.txt -
Start the application:
python main.py
Alternatively, on Windows, simply double-click or run:
.\run_velo.bat -
Open the Dashboard:
The application will automatically be available at: http://127.0.0.1:5000
Optimize your experience based on your internet connection:
| Mode | Use Case |
|---|---|
| 📉 Low Bandwidth | Best for downloading the smallest practical file sizes. |
| 🛡️ Data Saver | Ideal when your connection disconnects frequently. |
| ⚓ Stable | Perfect for when downloads fail midway and require multiple retries. |
| ⚖️ Balanced | Recommended for connections that are slow but mostly steady. |
| ⚡ Turbo | Use only when your connection is strong enough to handle parallel fragments. |
Velo provides a comprehensive local API for developers:
GET /api/meta- App metadata and feature flags.GET /api/settings&POST /api/settings- Read and save user configurations.GET /api/history&DELETE /api/history- Retrieve or clear download history.GET /api/stats- Access computed statistics from local history.GET /api/report?format=json|csv- Export detailed reports.POST /api/estimate- Estimate file sizes for known formats.POST /api/fetch- Fetch video metadata and information.POST /api/download- Initiate a single file download.POST /api/batch- Queue a batch download job.GET /api/batch/state- Inspect the current state of batch jobs.POST /api/batch/control- Pause, resume, stop, or retry jobs.POST /api/clip- Generate a specified media clip.
Run the included pytest suite to verify settings, history management, and statistics helpers:
python -m pytestTo create a professional, standalone Windows executable using PyInstaller:
pip install pyinstaller
pyinstaller --onefile --name Velo main.pyTip: For a polished release, add a custom app icon, sign your installer, and include detailed release notes!
The Arabic UI text utilizes locally bundled Thmanyah Sans woff2 files. If you fork or distribute this application, please ensure you retain the original font license and verify that your use case complies with their terms.
Warning
Velo does not bypass DRM or access private, restricted content. Please ensure you only download media that you have the right to save, reuse, or archive.