StreamingCommunity-download-stream 1.2.1

⚠️ 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
• Quick Start
• DNS Configuration
• Downloaders
• Configuration
• Usage Examples
• Global Search
• Torrent Downloads
• Kodi/Jellyfin/Emby Metadata
• Automatic Link Updates
• Advanced Features
• Streaming
• TO DO
• 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
pip install -r requirements.txt
python -m StreamingCommunity

Update

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

Quick Start

python -m StreamingCommunity

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.

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",
        "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")

• 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,
        "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"],
        "extension": "mkv"
    }
}

• generate_nfo: Generate .nfo metadata file alongside the video (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"] 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
    }
}

• 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 latest domains from GitHub (default: true)

Usage Examples

Basic Commands

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

# 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:

# 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
    }
}

• 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)

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

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.