A powerful CLI tool for downloading video content from Italian streaming services.
Interactive • Multi-service • Fast • Configurable
Streamload is an interactive command-line video downloader that aggregates search results across 15 streaming platforms. It provides a clean, keyboard-driven interface for browsing, selecting, and downloading video content with full control over audio tracks, subtitles, and output quality.
- Interactive CLI -- Rich terminal interface with colors, tables, spinners, and progress bars
- Multi-service search -- Search across all 15 supported services simultaneously with parallel requests
- Track selection -- Choose specific audio languages and subtitle tracks before downloading
- Quality control -- Automatic 1080p targeting with graceful fallback
- Multi-threaded downloads -- Concurrent segment downloading for maximum speed
- Customizable output -- Configurable folder structure, naming patterns, and file formats
- Internationalization -- Full English and Italian interface support
- Auto-update -- Built-in update checker to stay on the latest version
- DRM support -- Widevine and PlayReady decryption via remote CDM
- Batch downloads -- Queue multiple episodes or films for sequential download
| Service | Category | Language |
|---|---|---|
| AnimeUnity | Anime | IT |
| AnimeWorld | Anime | IT |
| Crunchyroll | Anime | Multi |
| Discovery+ | Film / Serie | IT |
| DMAX | Serie | IT |
| Food Network | Serie | IT |
| GuardaSerie | Serie | IT |
| HomeGardenTV | Serie | IT |
| Mediaset Infinity | Film / Serie | IT |
| MostraGuarda | Film | IT |
| Nove | Serie | IT |
| RaiPlay | Film / Serie | IT |
| Real Time | Serie | IT |
| StreamingCommunity | Film / Serie | IT |
| TubiTV | Serie | EN |
Italian streaming sites rotate domains frequently. Streamload tracks them automatically so you rarely need to intervene.
-
The active domain list is stored in
domains.jsonin this repository, signed with Ed25519. When GitHub raw is unreachable, a jsDelivr CDN mirror serves the same signed bytes as a fallback. -
Every candidate domain is actively probed before use: parking pages, ISP hijack pages, and connection errors are all rejected silently.
-
The resolved domain is cached for 6 hours. On the next startup after the TTL expires, Streamload re-resolves in the background.
-
For an emergency override, set
services.<short_name>.base_urlinconfig.json-- the config source is always consulted first, bypassing the network entirely. -
Manage resolution state from the command line:
python streamload-domains.py status # show current cache state python streamload-domains.py refresh # force re-resolution for all services python streamload-domains.py pin <service> <url> # pin a URL for one service
For full operator instructions, including how to update domains.json and rotate the signing key, see docs/domain-resolver.md.
- Python 3.10 or higher
- FFmpeg -- automatically installed via the
imageio-ffmpegdependency
1. Clone the repository
git clone https://github.com/alfanowski/Streamload.git
cd Streamload
2. Install dependencies
pip install -r requirements.txt
3. Run Streamload
python -m streamload
Launch Streamload and follow the interactive prompts:
- Search -- Enter the title of a film, series, or anime. Streamload searches all supported services in parallel and displays aggregated results.
- Select -- Browse the results table and select your desired title. For series, navigate through available seasons and episodes.
- Configure tracks -- Choose your preferred audio language and subtitle tracks from the available options.
- Download -- Confirm your selection and Streamload handles the rest: fetching, decrypting, merging, and organizing the final file.
Downloaded files are saved to the configured output directory with automatic folder organization by content type.
Streamload uses a config.json file for customization. Copy the example to get started:
cp config.json.example config.json
Configurable options include:
- Output paths -- Root directory, folder structure per content type, file naming patterns
- Download settings -- Thread count, retry attempts, concurrent downloads, speed limits
- Processing -- GPU acceleration, subtitle format, automatic audio/subtitle merging
- Network -- Timeout, retries, SSL verification, proxy support
- DRM -- Widevine and PlayReady remote CDM configuration
- Interface -- Language preference (English / Italian), preferred audio and subtitle languages
See config.json.example for the full reference.
| Key | Action |
|---|---|
Arrow Keys |
Navigate through lists and menus |
Enter |
Confirm selection |
Esc |
Go back / cancel |
Space |
Toggle selection (multi-select mode) |
Tab |
Switch between panels or options |
q |
Quit the application |
Author: alfanowski
Built with the help of these open-source projects:
- N_m3u8DL-RE -- HLS/DASH stream downloader
- FFmpeg -- Audio/video processing and muxing
- Rich -- Terminal UI framework
- httpx -- Modern HTTP client
This software is provided strictly for educational and personal use.
By using Streamload, you acknowledge and agree to the following terms:
-
Compliance. You are solely responsible for ensuring that your use of this tool complies with all applicable local, national, and international laws and regulations. The developer assumes no responsibility for verifying the legality of your actions.
-
Copyrighted content. Downloading, reproducing, or distributing copyrighted material without explicit authorization from the rights holder may constitute a violation of copyright law. This tool does not encourage, endorse, or facilitate copyright infringement in any form.
-
No hosted content. Streamload does not host, store, index, or distribute any media content. It functions solely as a client-side utility that interacts with publicly accessible streaming APIs.
-
No liability. The developer of this software shall not be held liable for any direct, indirect, incidental, or consequential damages arising from the use or misuse of this tool. This includes, but is not limited to, legal consequences resulting from unauthorized downloading of protected content.
-
No warranty. This software is provided "as is", without warranty of any kind, express or implied. The developer makes no guarantees regarding the functionality, reliability, or availability of any supported service.
-
Acceptance. By downloading, installing, or using Streamload, you indicate your full acceptance of these terms. If you do not agree with any part of this disclaimer, you must immediately cease all use of the software and delete all copies in your possession.
Use responsibly and respect content creators.
Streamload v2 is a full web application deployed as a Docker stack on a home server (Acer + Ubuntu). It includes:
- Backend API — FastAPI + PostgreSQL, serves
/api/*and/stream/* - Frontend SPA — SvelteKit static app (PWA-installable, AirPlay + Cast, Vidstack player)
- TMDB catalog — ~150+ titles across 8 collection rows, auto-refreshed
- Multi-user auth — Password + Passkey (WebAuthn), email verification via Resend
- Auto-deploy — GitHub Actions builds multi-arch Docker images to GHCR; Watchtower pulls on every push to
mainwithin 5 min - Tailscale — Stack is bound to the Tailscale interface; accessible on your tailnet only
The frontend lives in the separate Streamload-Web repository (image: ghcr.io/alfanowski/streamload-web).
For first-time production setup on the Acer, follow docs/deploy.md.
Streamload v2 exposes a FastAPI HTTP API alongside the existing curses CLI.
# Configure
cp .env.example .env # edit DATABASE_URL, RESEND_API_KEY, etc.
# Setup database (one-time)
createdb streamload
DATABASE_URL=postgresql+asyncpg://streamload:streamload@127.0.0.1:5432/streamload \
venv/bin/alembic upgrade head
# Launch the API server
venv/bin/python streamload.py --api
# Listens on http://127.0.0.1:8000GET /api/health— liveness probeGET /api/version— version + git shaPOST /api/auth/register— create account (first user becomes admin)POST /api/auth/login— password loginPOST /api/auth/logout— terminate sessionGET /api/me— current user profilePOST /api/auth/verify-email— confirm email via tokenPOST /api/auth/request-password-reset— initiate resetPOST /api/auth/confirm-password-reset— apply new passwordPOST /api/auth/passkey/registration-options— start passkey registrationPOST /api/auth/passkey/registration-verify— finish passkey registrationPOST /api/auth/passkey/authentication-options— start passkey loginPOST /api/auth/passkey/authentication-verify— finish passkey login
Interactive docs at http://127.0.0.1:8000/api/docs (Swagger UI).
This project is licensed under the GNU Affero General Public License v3.0.