StreamingCommunity-download-stream 1.3.0

⚠️ If a streaming service doesn't work, the site URL may have changed. The app normally fixes this automatically on startup (see Automatic Link Updates). You can also open Conf/domains.json and update the full_url for that service manually, then restart.

📖 Table of Contents

• Installation
  • PyPI
  • Pre-built Binaries
  • Manual Clone
  • System Dependencies
  • Update
• Quick Start
• Interactive TUI
  • Keyboard Shortcuts
  • Settings
• Supported Sites
• DNS Configuration
• Downloaders
• Music
• Manga
• Configuration
• Configuration Files
• Usage Examples
• Global Search
• Torrent Downloads
• Kodi/Jellyfin/Emby Metadata
• Automatic Link Updates
• Advanced Features
• Streaming
• Environment Variables
• Logs
• Related Projects

Installation

PyPI (Recommended)

pip install StreamingCommunity-download-stream
streamingcommunity

https://github.com/user-attachments/assets/f3741f9f-79c2-4315-8578-73fad33c151a

Pre-built Binaries

Download the latest binary for your platform from GitHub Releases:

On Linux/macOS, make the binary executable:

chmod +x StreamingCommunity_linux_x64
./StreamingCommunity_linux_x64

https://github.com/user-attachments/assets/a90a312a-72a4-4cce-a856-031805b4e019

Manual Clone

git clone https://github.com/Liutprando08/StreamingCommunity-downloader-streamer.git
cd StreamingCommunity-downloader-streamer
pip install -e .
python -m StreamingCommunity

Prefer uv? uv sync installs the locked dependencies from uv.lock, then uv run python -m StreamingCommunity.

System Dependencies

Most features work out of the box, but a few shell out to external tools. Install them for full functionality:

Update

# If using binary, use the built-in updater
streamingcommunity -UP

Quick Start

# Classic interactive CLI (numbered site menu)
python -m StreamingCommunity

# Interactive TUI (recommended)
python -m StreamingCommunity --tui

With no arguments the app opens the classic numbered CLI menu. Add --tui for the full-screen terminal interface.

Interactive TUI

The Textual-based full-screen interface (codename OSTE) is the recommended way to browse, search and download. Start it with:

python -m StreamingCommunity --tui
# or, from a clone:
python tui.py

Home screen

• Sidebar — every supported site (plus Esci to quit). Select a site to open its dedicated search flow.
• Global search bar — searches across all sites in the selected sector at once; results stream in live as each site replies.
• Sector tabs — Tutti, Film, Music, Altro scope the global search (a site can declare an explicit sector, otherwise it is derived from its category).
• Status bar — live progress while a search is running.

Keyboard shortcuts

Screens

The Queue screen runs jobs sequentially, shows a progress bar/speed/status per item and streams the underlying downloader output in an embedded log panel.

Settings

Press F2 (available from any screen) to edit every file under Conf/ without leaving the TUI:

• Tabs for config.json, login.json, domains.json and remote_cdm.json.
• A JSON tree on the left; pick a value to edit it on the right.
• Booleans use a switch, lists are edited as JSON (["a", "b"]), numbers are validated, strings are free text.
• Applica updates the value in memory, Salva file writes it to disk, Ricarica re-reads from disk.

See Configuration Files for what each file contains.

Supported Sites

Run python -m StreamingCommunity --help to see the live list, or pick a site by name (--site animeunity) or index (--site 1).

Sites marked — are available from the CLI but not yet surfaced in the TUI.

DNS Configuration

Required for optimal functionality and reliability.

Use one of these DNS providers:

• Cloudflare DNS: 1.1.1.1 - Setup guide
• Quad9 DNS: 9.9.9.9 - Setup guide

Downloaders

*DASH with DRM bypass: Requires a valid L3 CDM (Content Decryption Module). This project does not provide or facilitate obtaining CDMs. Users must ensure compliance with applicable laws.

Music

Search and download music from three services, via the TUI (recommended) or the CLI:

Search modes

Each service supports three modes — Song, Album, Artist. Pick a mode in the TUI, run the query, then drill down:

Artist → Albums → Tracks → Queue
Album  → Tracks → Queue
Song   → (downloaded directly)

In the home global search the Music sector queries every music service at once using the Song mode.

Output

Tracks are written under OUTPUT.music_folder_name (default Music), inside your normal download root:

{
    "OUTPUT": {
        "music_folder_name": "Music"
    }
}

Monochrome is fully DRM-free: its public endpoint serves plain audio/mp4 (AAC ~320 kbps), so no CDM or decryption is involved. FLAC is not offered by the public endpoint.

Manga

MangaWorld is supported for manga downloads. Search a title, pick the volumes ("seasons") and chapters ("episodes"); each chapter is packaged into a .cbz archive.

python -m StreamingCommunity --site mangaworld --search "one piece"

Manga has no streaming path, so the streaming button is hidden. Reach it from the TUI sidebar or the Altro sector of the global search.

Configuration

Key configuration parameters in config.json:

Output Directories

{
    "OUTPUT": {
        "root_path": "Video",
        "movie_folder_name": "Movie",
        "serie_folder_name": "Serie",
        "anime_folder_name": "Anime",
        "music_folder_name": "Music",
        "map_episode_name": "%(episode_name) S%(season)E%(episode)",
        "add_siteName": false
    }
}

• root_path: Base directory where videos are saved

  • Windows: C:\\MyLibrary\\Folder or \\\\MyServer\\Share
  • Linux/MacOS: Desktop/MyLibrary/Folder

• movie_folder_name: Subfolder name for movies (default: "Movie")

• serie_folder_name: Subfolder name for TV series (default: "Serie")

• anime_folder_name: Subfolder name for anime (default: "Anime")

• music_folder_name: Subfolder name for music (default: "Music")

• map_episode_name: Episode filename template

  • %(tv_name): TV Show name
  • %(season): Season number (zero-padded)
  • %(episode): Episode number (zero-padded)
  • %(episode_name): Episode title
  • Example: "%(episode_name) S%(season)E%(episode)" → "Pilot S01E01"

• add_siteName: Append site name to root path (default: false)

Download Settings

{
    "DOWNLOAD": {
        "skip_download": false,
        "thread_count": 8,
        "retry_count": 30,
        "concurrent_download": true,
        "max_speed": "",
        "real_time_decryption": false,
        "check_segments_count": true,
        "select_video": "best",
        "select_audio": "lang='ita|Ita|it':for=best",
        "select_subtitle": "lang='ita|eng|Ita|Eng|it|en':for=all",
        "cleanup_tmp_folder": true
    }
}

Performance Settings

• skip_download: Skip the download step and process existing files (default: false)
• thread_count: Number of parallel download threads (default: 8)
• retry_count: Maximum retry attempts for failed segments (default: 30)
• concurrent_download: Download video and audio simultaneously (default: true)
• max_speed: Speed limit per stream (e.g., "30MB", "10MB"), empty string for no limit
• real_time_decryption: Decrypt segments in real-time during download instead of post-processing (default: false)
• check_segments_count: Verify segment count matches manifest (default: true)
• cleanup_tmp_folder: Remove temporary files after download (default: true)

Stream Selection

- select_video

OPTIONS: id=REGEX:lang=REGEX:name=REGEX:codecs=REGEX:res=REGEX:frame=REGEX:
         segsMin=number:segsMax=number:ch=REGEX:range=REGEX:url=REGEX:
         plistDurMin=hms:plistDurMax=hms:bwMin=int:bwMax=int:role=string:for=FOR

    for=FOR: Selection type - best (default), best[number], worst[number], all

"select_video": "for=best"                                // Select best video
"select_video": "res=3840*:codecs=hvc1:for=best"          // Select 4K HEVC video
"select_video": "res=1080:for=best"                       // Select 1080p video
"select_video": "plistDurMin=1h20m30s:for=best"           // Duration > 1h 20m 30s
"select_video": "role=main:for=best"                      // Main video role
"select_video": "bwMin=800:bwMax=1000:for=best"           // Bandwidth 800-1000 Kbps

- select_audio

"select_audio": "for=all"                                 // Select all audio tracks
"select_audio": "lang=en:for=best"                        // Select best English audio
"select_audio": "lang='ja|en':for=best2"                  // Best 2 tracks (Japanese or English)
"select_audio": "lang='ita|Ita':for=all"                  // All Italian audio tracks
"select_audio": "role=main:for=best"                      // Main audio role

- select_subtitle

"select_subtitle": "for=all"                              // Select all subtitles
"select_subtitle": "name=English:for=all"                 // All subtitles containing "English"
"select_subtitle": "lang='ita|eng|Ita|Eng':for=all"       // Italian and English subtitles
"select_subtitle": "lang=en:for=best"                     // Best English subtitle
"select_subtitle": "false"                                // Disable subtitle download

Processing Settings

{
{
    "PROCESS": {
        "generate_nfo": false,
        "kodi_nfo": false,
        "use_gpu": false,
        "param_video": ["-c:v", "libx265", "-crf", "28", "-preset", "medium"],
        "param_audio": ["-c:a", "libopus", "-b:a", "128k"],
        "param_final": ["-c", "copy"],
        "audio_order": [],
        "subtitle_order": [],
        "merge_audio": true,
        "merge_subtitle": true,
        "subtitle_disposition": false,
        "subtitle_disposition_language": ["forced-ita", "ita-forced"],
        "sync_tolerance_ms": 45,
        "sync_itsoffset_threshold_ms": 10,
        "audio_resync": false,
        "extension": "mkv"
    }
}

• generate_nfo: Generate a minimal .nfo metadata file alongside the video (default: false)
• kodi_nfo: Generate full Kodi/Jellyfin/Emby .nfo + artwork via TMDB (see Kodi/Jellyfin/Emby Metadata) (default: false)
• use_gpu: Enable hardware acceleration (default: false)
• param_video: FFmpeg video encoding parameters
  • Example: ["-c:v", "libx265", "-crf", "28", "-preset", "medium"] (H.265/HEVC encoding)
• param_audio: FFmpeg audio encoding parameters
  • Example: ["-c:a", "libopus", "-b:a", "128k"] (Opus audio at 128kbps)
• param_final: Final FFmpeg parameters (default: ["-c", "copy"] for stream copy)
• audio_order: List of strings to order audio tracks (e.g., ["ita", "eng"])
• subtitle_order: List of strings to order subtitle tracks (e.g., ["ita", "eng"])
• merge_audio: Merge all audio tracks into a single output file (default: true)
• merge_subtitle: Merge all subtitle tracks into a single output file (default: true)
• subtitle_disposition: Automatically set default subtitle track (default: false)
• subtitle_disposition_language: Languages to mark as default/forced
  • Example: ["forced-ita", "ita-forced"] (Italian and Italian forced subtitles)
• sync_tolerance_ms: Audio/subtitle sync tolerance in milliseconds; offsets within this window are ignored (default: 45)
• sync_itsoffset_threshold_ms: MPEG-TS itsoffset correction threshold in milliseconds (default: 10)
• audio_resync: Re-align audio tracks when the sync drift exceeds the tolerance (default: false) for Italian forced subtitles
• extension: Output file format ("mkv" or "mp4")

Request Settings

{
    "REQUESTS": {
        "verify": true,
        "timeout": 30,
        "max_retry": 8,
        "use_proxy": false,
        "proxy": {
            "http": "http://localhost:8888",
            "https": "http://localhost:8888"
        }
    }
}

• verify: Enable SSL certificate verification (default: true)
• timeout: Request timeout in seconds (default: 30)
• max_retry: Maximum retry attempts for failed requests (default: 8)
• use_proxy: Enable proxy support for HTTP requests (default: false)
• proxy: Proxy configuration for HTTP and HTTPS connections
  • http: HTTP proxy URL (e.g., "http://localhost:8888")
  • https: HTTPS proxy URL (e.g., "http://localhost:8888")

Default Settings

{
    "DEFAULT": {
        "close_console": true,
        "show_message": true,
        "show_device_info": true,
        "fetch_domain_online": true,
        "check_domain_on_start": true
    }
}

• close_console: Automatically close console after download completion (default: true)
• show_message: Display debug messages (default: true)
• show_device_info: Display device information (default: true)
• fetch_domain_online: Automatically fetch the latest domains.json from GitHub on startup (default: true)
• check_domain_on_start: Verify the StreamingCommunity domain on every launch and update domains.json if it changed (default: true)

YouTube Settings

{
    "YOUTUBE": {
        "format": "",
        "max_height": 1080
    }
}

• format: yt-dlp format selector; empty string lets the app pick automatically (default: "")
• max_height: Maximum video height in pixels (default: 1080)

Configuration Files

config.json (above) is the main file, but three more live in Conf/:

All four can be edited directly, or from the TUI with F2 (see Settings).

login.json

Credentials and tokens for services that need them. Leave empty if unused:

{
    "TMDB": { "api_key": "" },
    "crunchyroll": { "device_id": "", "etp_rt": "" },
    "tubi": { "email": "", "password": "" },
    "mediasetinfinity": { "beToken": "" },
    "discoveryeu": { "st": "" }
}

domains.json

Maps every service to its current URL. The app keeps it fresh automatically, but you can edit it manually when a site moves:

{
    "streamingcommunity": { "full_url": "https://streaming-community.coffee" },
    "limetorrent": {
        "full_url": "https://limetorrent.net",
        "mirrors": ["https://limetorrent.net", "https://www.limetorrents.fun"]
    }
}

• full_url: the service's base URL
• mirrors: optional list of fallback URLs (used by trackers)

remote_cdm.json

Configuration for the optional remote CDM used by DRM-protected streams (DASH/ISM). The app ships no keys or devices — you point it at your own CDM service:

{
    "config": { "delay_after_request": 5, "create_local_db": false },
    "external_supa_db": { "url": "https://…supabase.co" },
    "remote_cdm": {
        "widevine": { "device_type": "ANDROID", "security_level": 3, "host": "...", "secret": "..." },
        "playready": { "security_level": 3000, "host": "...", "secret": "..." }
    }
}

• config.delay_after_request: seconds to wait between CDM requests
• config.create_local_db: cache keys locally
• external_supa_db.url: optional external key cache (a lookup failure is non-fatal)
• remote_cdm.*: remote CDM endpoint, secret and device parameters

The external Supabase URL is only a key cache, not a CDM provider. You are responsible for supplying a licensed CDM — see the Disclaimer.

Usage Examples

Basic Commands

# Show help and available sites
python -m StreamingCommunity -h

# Launch the interactive TUI (recommended)
python -m StreamingCommunity --tui

# Search and download from a specific site
python -m StreamingCommunity --site streamingcommunity --search "interstellar"

# Auto-download first result
python -m StreamingCommunity --site streamingcommunity --search "interstellar" --auto-first

# Use site by index
python -m StreamingCommunity --site 0 --search "interstellar"

Advanced Options

# Keep console open
python -m StreamingCommunity --not_close true

# Override stream selection from CLI
python -m StreamingCommunity -sv "res=3840*:codecs=hvc1:for=best"  # 4K HEVC
python -m StreamingCommunity -sa "lang=en:for=best"                 # Best English audio
python -m StreamingCommunity -ss "lang=en:for=best"                 # Best English subtitle

# Override output extension
python -m StreamingCommunity --extension mp4

# Enable proxy
python -m StreamingCommunity --use_proxy

# Check for updates (binary only)
python -m StreamingCommunity -UP

# Show version
python -m StreamingCommunity --version

Global Search

Search across multiple streaming sites simultaneously, from either the TUI or the CLI.

TUI

Type a query in the home search box and press Enter (or click Cerca). Results stream in live from every site in the selected sector (Tutti, Film, Music, Altro); select a row to open it — video results go to the detail screen, music results open the music flow pre-seeded with the query.

CLI

# Global search
python -m StreamingCommunity --global -s "cars"

When using --global, you will be prompted to:

1. Search all sites
2. Search by category (anime, film & series, series)
3. Select specific sites to search

Results display title, media type, year, and source site in a consolidated table. You can select any result to download directly.

Torrent Downloads

Search and download content from public torrent trackers as an alternative to streaming sites. Results are aggregated from multiple trackers, ranked by seeders, downloaded with aria2c and optionally muxed with the original Italian audio track.

Usage

python -m StreamingCommunity --site torrent --search "interstellar"

In the interactive site menu, select the Torrent entry (shown in magenta). Torrent results are also included in Global Search.

Features

• Multi-tracker search: aggregates results from YTS, EZTV, Nyaa, LimeTorrents and TorrentGalaxy (plus Jackett if configured), sorted by seeders
• Magnet downloads: downloads .torrent/magnet links via aria2c with live progress output
• Audio dub muxing: after the download completes, you can mux the original Italian audio track (from a streaming site) onto the torrent video using FFmpeg — the PROCESS encoding settings apply
• Disk space check: verifies free space before starting and warns on insufficient storage

Configuration

{
    "TORRENT": {
        "enabled": true,
        "sync_interval_hours": 24,
        "jackett_url": "",
        "jackett_api_key": "",
        "max_seeders": 0,
        "preferred_quality": "best",
        "download_path": "Torrents",
        "auto_mux": true,
        "mux_timeout_minutes": 30,
        "flaresolverr_url": "",
        "scrape_impersonate": "chrome",
        "scrape_delay_seconds": 2,
        "scrape_retry_count": 3,
        "max_duration_diff_sec": 30
    }
}

• enabled: Enable/disable torrent search (default: true)
• sync_interval_hours: How often the local torrent index refreshes (default: 24)
• max_seeders: Minimum seeders filter; 0 disables it (default: 0)
• preferred_quality: Preferred quality for results (default: "best")
• download_path: Folder where torrents are downloaded (default: "Torrents")
• auto_mux: Offer to mux the Italian audio track after download (default: true)
• mux_timeout_minutes: FFmpeg mux timeout in minutes (default: 30)
• flaresolverr_url: Optional FlareSolverr URL for trackers behind Cloudflare challenges
• scrape_impersonate: Browser profile impersonated when scraping (default: "chrome")
• scrape_delay_seconds: Delay between scraper requests to avoid rate-limiting (default: 2)
• scrape_retry_count: Retry attempts per scraper on failure (default: 3)
• max_duration_diff_sec: Maximum accepted difference between the video and the audio source duration when muxing, in seconds (default: 30)

Requires: aria2c (auto-downloaded by the app) and ffmpeg (for audio muxing).

Kodi/Jellyfin/Emby Metadata

Generate Kodi-compatible XML metadata files (.nfo) plus poster/fanart images alongside your downloads, so media centers (Kodi, Jellyfin, Emby) recognize your library immediately.

How it works

After a download completes, the app looks up the title on TMDB (using the series/movie name from the output path) and writes:

Enable

Set kodi_nfo to true in the PROCESS section of config.json and add a TMDB API key to Conf/login.json:

{
    "PROCESS": {
        "kodi_nfo": true
    }
}

{
    "TMDB": {
        "api_key": "your_tmdb_api_key"
    }
}

Note: A free TMDB API key can be obtained at themoviedb.org/settings/api. The same key powers metadata lookups and title matching. The older plain-text generate_nfo flag can be enabled independently.

Automatic Link Updates

Streaming site URLs change frequently, so the app keeps them up to date automatically in two ways:

Domain auto-refresh (fetch_domain_online)

On startup, the app downloads the latest domains.json from the project's GitHub repository and saves it to Conf/domains.json, keeping all site links fresh without manual edits.

{
    "DEFAULT": {
        "fetch_domain_online": true
    }
}

StreamingCommunity link check (check_domain_on_start)

StreamingCommunity changes its domain very often. When enabled, the app verifies the current domain on every launch by scraping the link tracker page (giardiniblog.it). If the domain changed, Conf/domains.json is updated automatically — no restart required.

{
    "DEFAULT": {
        "check_domain_on_start": true
    }
}

Binary auto-update (-UP)

For pre-built binaries, run the built-in updater to download and install the latest release:

streamingcommunity -UP

For pip installs, update with pip install -U StreamingCommunity-download-stream.

Advanced Features

Hook System

Execute custom scripts before/after downloads. Configure in config.json:

{
  "HOOKS": {
    "pre_run": [
      {
        "name": "prepare-env",
        "type": "python",
        "path": "scripts/prepare.py",
        "args": ["--clean"],
        "env": {"MY_FLAG": "1"},
        "cwd": "~",
        "os": ["linux", "darwin"],
        "timeout": 60,
        "enabled": true,
        "continue_on_error": true
      }
    ],
    "post_run": [
      {
        "name": "notify",
        "type": "bash",
        "command": "echo 'Download completed'"
      }
    ]
  }
}

Hook Configuration Options

• name: Descriptive name for the hook
• type: Script type - python, bash, sh, bat, cmd
• path: Path to script file (alternative to command)
• command: Inline command to execute (alternative to path)
• args: List of arguments passed to the script
• env: Additional environment variables as key-value pairs
• cwd: Working directory for script execution (supports ~ and environment variables)
• os: Optional OS filter - ["windows"], ["darwin"] (macOS), ["linux"], or combinations
• timeout: Maximum execution time in seconds (hook fails if exceeded)
• enabled: Enable/disable the hook without removing configuration
• continue_on_error: If false, stops execution when hook fails

Hook Types

• Python hooks: Run with current Python interpreter
• Bash/sh hooks: Execute via bash/sh on macOS/Linux
• Bat/cmd hooks: Execute via cmd /c on Windows
• Inline commands: Use command instead of path for simple one-liners

Hooks are automatically executed before (pre_run) and after (post_run) the main execution flow.

Streaming

Stream content in real-time using a local proxy server instead of downloading.

Basic Usage

# Stream with auto-detected player
python -m StreamingCommunity --stream --site streamingcommunity --search "interstellar"

# Stream with a specific player
python -m StreamingCommunity --stream --player mpv --site streamingcommunity --search "interstellar"

# Stream on a specific port
python -m StreamingCommunity --stream --player vlc --stream-port 8080

Supported Players

• mpv (recommended) - High-quality playback with hardware decoding support
• vlc - Network caching for smoother streams
• ffplay - Lightweight fallback from FFmpeg

Players are auto-detected from your PATH and the common per-OS install locations, so a Homebrew/macOS-bundle install is found even when it is not on PATH (e.g. when the app is launched from Finder).

Installing a player

If you see "No media player found", install one of the players above or point the app at an existing binary via --player (CLI) / STREAMING_PLAYER (environment variable).

Environment Variables

The streaming flags are also exposed as environment variables, which is handy for scripts and launchers:

Hook scripts also receive any extra variables defined in their env block — see Hook System.

Logs

The TUI keeps a live log panel in the Queue screen. In addition, each download writes progress/FFmpeg logs next to the output:

Temporary files are removed after the download when DOWNLOAD.cleanup_tmp_folder is enabled.

Related Projects

• MammaMia - Stremio addon for Italian streaming
• Unit3Dup - Torrent automation for Unit3D tracker

Disclaimer

This software is provided strictly for educational and research purposes only. The author and contributors:

• DO NOT assume any responsibility for illegal or unauthorized use of this software
• DO NOT encourage, promote, or support the download of copyrighted content without proper authorization
• DO NOT provide, include, or facilitate obtaining any DRM circumvention tools, CDM modules, or decryption keys
• DO NOT endorse piracy or copyright infringement in any form

User Responsibilities

By using this software, you agree that:

1. You are solely responsible for ensuring your use complies with all applicable local, national, and international laws and regulations
2. You must have legal rights to access and download any content you process with this software
3. You will not use this software to circumvent DRM, access unauthorized content, or violate copyright laws
4. You understand that downloading copyrighted content without permission is illegal in most jurisdictions

No Warranty

This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

If you do not agree with these terms, do not use this software.