https://github.com/Arrowar/StreamingCommunity
Downloader for movies, TV shows and anime — TOR / MP4 / HLS / DASH
https://github.com/Arrowar/StreamingCommunity
anime cdm dash-downloader drm drm-free film hls-downloader m3u8 m3u8-downloader mp4 mp4-downloader mpd series tor tor-download tv video-download
Last synced: 3 months ago
JSON representation
Downloader for movies, TV shows and anime — TOR / MP4 / HLS / DASH
- Host: GitHub
- URL: https://github.com/Arrowar/StreamingCommunity
- Owner: Arrowar
- License: gpl-3.0
- Created: 2023-12-16T17:28:02.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-06T15:20:40.000Z (3 months ago)
- Last Synced: 2025-10-06T15:25:19.732Z (3 months ago)
- Topics: anime, cdm, dash-downloader, drm, drm-free, film, hls-downloader, m3u8, m3u8-downloader, mp4, mp4-downloader, mpd, series, tor, tor-download, tv, video-download
- Language: Python
- Homepage: https://discord.com/invite/8vV68UGRc7
- Size: 6.97 MB
- Stars: 506
- Watchers: 11
- Forks: 71
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 📊 Project Status & Info
[](https://pypi.org/project/streamingcommunity)
[](https://github.com/Arrowar/StreamingCommunity/commits)
[](https://github.com/Arrowar/StreamingCommunity/issues)
[](https://github.com/Arrowar/StreamingCommunity/blob/main/LICENSE)
## 💝 Support the Project
## 🚀 Download & Install
[](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_win.exe)
[](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_mac)
[](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_linux_latest)
[](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_linux_previous)
---
*⚡ **Quick Start:** `pip install StreamingCommunity && StreamingCommunity`*
---
## 📖 Table of Contents
- ⚙️ [Installation](#installation)
- 🚀 [Quick Start](#quick-start)
- 📥 [Downloaders](#downloaders)
- 🛠️ [Configuration](#configuration)
- 🔐 [Login](.github/.site/login.md)
- 🌐 [Domain](https://arrowar.github.io/StreamingCommunity)
- 💡 [Usage Examples](#usage-examples)
- 🔍 [Global Search](#global-search)
- 🧩 [Advanced Features](#advanced-options)
- 🐳 [Deployment](#docker)
- 🎓 [Tutorials](#tutorials)
- 🔗 [Related Projects](#useful-project)
---
## Installation
### Prerequisites
Make sure you have Python installed on your system:
- **Windows**: Download from [python.org](https://python.org) or install via Microsoft Store
- **Linux**: `sudo apt install python3 python3-pip` (Ubuntu/Debian) or equivalent for your distro
- **MacOS**: `brew install python3` or download from [python.org](https://python.org)
### Dependencies
```bash
# Windows
pip install -r requirements.txt
# Linux/MacOS
pip3 install -r requirements.txt
```
### Update
```bash
# Windows
python update.py
# Linux/MacOS
python3 update.py
```
---
## Quick Start
**Via pip installation:**
```bash
StreamingCommunity
```
**Manual execution:**
```bash
# Windows
python test_run.py
# Linux/MacOS
python3 test_run.py
```
---
## Downloaders
📥 HLS
Download HTTP Live Streaming (HLS) content from m3u8 URLs.
```python
from StreamingCommunity import HLS_Downloader
downloader = HLS_Downloader(
m3u8_url="https://example.com/stream.m3u8",
output_path="/downloads/video.mp4"
)
downloader.download()
```
See [HLS example](./Test/Downloads//HLS.py) for complete usage.
📽️ MP4
Direct MP4 file downloader with support for custom headers and referrer.
```python
from StreamingCommunity import MP4_downloader
downloader = MP4_downloader(
url="https://example.com/video.mp4",
path="/downloads/saved_video.mp4"
)
downloader.download()
```
See [MP4 example](./Test/Downloads/MP4.py) for complete usage.
🧲 TOR
Download content via torrent magnet links.
```python
from StreamingCommunity import TOR_downloader
client = TOR_downloader()
client.add_magnet_link("magnet:?xt=urn:btih:example_hash&dn=example_name", save_path=".")
client.start_download()
```
See [Torrent example](./Test/Downloads/TOR.py) for complete usage.
🎞️ DASH
```python
mpd_url = "https://example.com/stream.mpd"
license_url = "https://example.com/get_license"
dash_process = DASH_Downloader(
cdm_device=get_wvd_path(),
license_url=license_url,
mpd_url=mpd_url,
output_path="output.mp4",
)
dash_process.parse_manifest()
if dash_process.download_and_decrypt():
dash_process.finalize_output()
dash_process.get_status()
```
See [DASH example](./Test/Downloads/DASH.py) for complete usage.
---
## Configuration
⚙️ Overview
You can change some behaviors by tweaking the configuration file. The configuration file is divided into several main sections.
📁 OUT_FOLDER
```json
{
"OUT_FOLDER": {
"root_path": "Video",
"movie_folder_name": "Movie",
"serie_folder_name": "Serie",
"anime_folder_name": "Anime",
"map_episode_name": "E%(episode)_%(episode_name)",
"add_siteName": false
}
}
```
#### Directory Configuration
- `root_path`: Directory where all videos will be saved
* Windows: `C:\\MyLibrary\\Folder` or `\\\\MyServer\\MyLibrary` (network folder)
* Linux/MacOS: `Desktop/MyLibrary/Folder`
#### Folder Names
- `movie_folder_name`: Subdirectory for movies (can be changed with `--movie_folder_name`)
- `serie_folder_name`: Subdirectory for TV series (can be changed with `--serie_folder_name`)
- `anime_folder_name`: Subdirectory for anime (can be changed with `--anime_folder_name`)
#### Episode Naming
- `map_episode_name`: Template for episode filenames
* `%(tv_name)`: Name of TV Show
* `%(season)`: Season number
* `%(episode)`: Episode number
* `%(episode_name)`: Episode name
* Can be changed with `--map_episode_name`
#### Additional Options
- `add_siteName`: Appends site_name to root path (can be changed with `--add_siteName true/false`)
🔄 QBIT_CONFIG Settings
```json
{
"QBIT_CONFIG": {
"host": "192.168.1.51",
"port": "6666",
"user": "admin",
"pass": "adminadmin"
}
}
```
To enable qBittorrent integration, follow the setup guide [here](https://github.com/lgallard/qBittorrent-Controller/wiki/How-to-enable-the-qBittorrent-Web-UI).
📥 M3U8_DOWNLOAD Settings
```json
{
"M3U8_DOWNLOAD": {
"default_video_workser": 12,
"default_audio_workser": 12,
"segment_timeout": 8,
"specific_list_audio": [
"ita"
],
"download_subtitle": true,
"merge_subs": true,
"specific_list_subtitles": [
"ita", // Specify language codes or use ["*"] to download all available subtitles
"eng"
],
"cleanup_tmp_folder": true,
"get_only_link": false
}
}
```
#### Performance Settings
- `default_video_workser`: Number of threads for video download
* Can be changed with `--default_video_worker `
- `default_audio_workser`: Number of threads for audio download
* Can be changed with `--default_audio_worker `
#### Audio Settings
- `specific_list_audio`: List of audio languages to download
* Can be changed with `--specific_list_audio ita,eng`
#### Subtitle Settings
- `merge_subs`: Whether to merge subtitles with video
- `specific_list_subtitles`: List of subtitle languages to download
* Use `["*"]` to download all available subtitles
* Or specify individual languages like `["ita", "eng"]`
* Can be changed with `--specific_list_subtitles ita,eng`
#### Cleanup
- `cleanup_tmp_folder`: Remove temporary .ts files after download
🔍 M3U8_PARSER Settings
```json
{
"M3U8_PARSER": {
"force_resolution": "Best"
}
}
```
#### Resolution Options
- `force_resolution`: Choose video resolution:
* `"Best"`: Highest available resolution
* `"Worst"`: Lowest available resolution
* `"720p"`: Force 720p resolution
* Specific resolutions:
- 1080p (1920x1080)
- 720p (1280x720)
- 480p (640x480)
- 360p (640x360)
#### Link options
- `get_only_link`: Return M3U8 playlist/index URL instead of downloading
## Update Domains
🌐 Domain Configuration Methods
There are two ways to manage the domains for the supported websites:
### 1. Online Domain Fetching (Recommended)
Set `fetch_domain_online` to `true` in your `config.json`:
```json
{
"DEFAULT": {
"fetch_domain_online": true
}
}
```
This will:
- Download the latest domains from the GitHub repository
- Automatically save them to a local `domains.json` file
- Ensure you always have the most up-to-date streaming site domains
### 2. Local Domain Configuration
Set `fetch_domain_online` to `false` to use a local configuration:
```json
{
"DEFAULT": {
"fetch_domain_online": false
}
}
```
Then create a `domains.json` file in the root directory with your domain configuration:
```json
{
"altadefinizione": {
"domain": "si",
"full_url": "https://altadefinizione.si/"
},
"streamingcommunity": {
"domain": "best",
"full_url": "https://streamingcommunity.best/"
}
}
```
### 3. Automatic Fallback
If online fetching fails, the script will automatically attempt to use the local `domains.json` file as a fallback, ensuring maximum reliability.
#### 💡 Adding a New Site
If you want to request a new site to be added to the repository, message us on the Discord server!
---
## Usage Examples
### Basic Commands
```bash
# Show help (includes available sites by name and by index)
python test_run.py -h
# Run a specific site by name with a search term
python test_run.py --site streamingcommunity --search "interstellar"
# Run a specific site by numeric index
python test_run.py --site 0 --search "interstellar"
# Auto-download the first result from search
python test_run.py --site streamingcommunity --search "interstellar" --auto-first
```
### Advanced Options
```bash
# Change video and audio workers
python test_run.py --default_video_worker 8 --default_audio_worker 8
# Set specific languages
python test_run.py --specific_list_audio ita,eng --specific_list_subtitles eng,spa
# Keep console open after download
python test_run.py --not_close true
```
### Global Search Commands
```bash
# Use global search
python test_run.py --global -s "cars"
# Select specific category
python test_run.py --category 1 # Search in anime category
python test_run.py --category 2 # Search in movies & series
python test_run.py --category 3 # Search in series
python test_run.py --category 4 # Search in torrent category
```
### PyPI Installation Usage
```bash
# If installed via pip, you can simply run:
StreamingCommunity
# Or use the entrypoint with arguments, for example:
StreamingCommunity --site streamingcommunity --search "interstellar" --auto-first
```
---
# Global Search
🔍 Feature Overview
You can now search across multiple streaming sites at once using the Global Search feature. This allows you to find content more efficiently without having to search each site individually.
🎯 Search Options
When using Global Search, you have three ways to select which sites to search:
1. **Search all sites** - Searches across all available streaming sites
2. **Search by category** - Group sites by their categories (movies, series, anime, etc.)
3. **Select specific sites** - Choose individual sites to include in your search
📝 Navigation and Selection
After performing a search:
1. Results are displayed in a consolidated table showing:
- Title
- Media type (movie, TV series, etc.)
- Source site
2. Select an item by number to view details or download
3. The system will automatically use the appropriate site's API to handle the download
⌨️ Command Line Arguments
The Global Search can be configured from the command line:
- `--global` - Perform a global search across multiple sites.
- `-s`, `--search` - Specify the search terms.
---
## 🧩 Advanced Features
## Hook/Plugin System
🧩 Run custom scripts before/after the main execution
Define pre/post hooks in `config.json` under the `HOOKS` section. Supported types:
- **python**: runs `script.py` with the current Python interpreter
- **bash/sh**: runs via `bash`/`sh` on macOS/Linux
- **bat/cmd**: runs via `cmd /c` on Windows
- Inline **command**: use `command` instead of `path`
Sample configuration:
```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'"
}
]
}
}
```
Notes:
- **os**: optional OS filter (`windows`, `darwin` (`darwin` is used for MacOS), `linux`).
- **args**: list of arguments passed to the script.
- **env**: additional environment variables.
- **cwd**: working directory for the script; supports `~` and environment variables.
- **continue_on_error**: if `false`, the app stops when the hook fails.
- **timeout**: in seconds; when exceeded the hook fails.
Hooks are executed automatically by `run.py` before (`pre_run`) and after (`post_run`) the main execution.
---
# Docker
🐳 Basic Setup
Build the image:
```
docker build -t streaming-community-api .
```
Run the container with Cloudflare DNS for better connectivity:
```
docker run -d --name streaming-community --dns 1.1.1.1 -p 8000:8000 streaming-community-api
```
Tip CLI:
- To run the CLI inside the container, attach to the container and execute:
```
docker exec -it streaming-community python test_run.py
```
💾 Custom Storage Location
By default the videos will be saved in `/app/Video` inside the container. To save them on your machine:
```
docker run -it --dns 9.9.9.9 -p 8000:8000 -v /path/to/download:/app/Video streaming-community-api
```
🛠️ Quick Setup with Make
Inside the Makefile (install `make`) are already configured two commands to build and run the container:
```
make build-container
# set your download directory as ENV variable
make LOCAL_DIR=/path/to/download run-container
```
The `run-container` command mounts also the `config.json` file, so any change to the configuration file is reflected immediately without having to rebuild the image.
# Telegram Usage
⚙️ Basic Configuration
The bot was created to replace terminal commands and allow interaction via Telegram. Each download runs within a screen session, enabling multiple downloads to run simultaneously.
To run the bot in the background, simply start it inside a screen session and then press Ctrl + A, followed by D, to detach from the session without stopping the bot.
Command Functions:
🔹 /start – Starts a new search for a download. This command performs the same operations as manually running the script in the terminal with test_run.py.
🔹 /list – Displays the status of active downloads, with options to:
Stop an incorrect download using /stop .
View the real-time output of a download using /screen .
⚠ Warning: If a download is interrupted, incomplete files may remain in the folder specified in config.json. These files must be deleted manually to avoid storage or management issues.
🛠 Configuration: Currently, the bot's settings are stored in the config.json file, which is located in the same directory as the telegram_bot.py script.
## .env Example:
You need to create an .env file and enter your Telegram token and user ID to authorize only one user to use it
```
TOKEN_TELEGRAM=IlTuo2131TOKEN$12D3Telegram
AUTHORIZED_USER_ID=12345678
DEBUG=False
```
📥 Dependencies & Launch
Install dependencies:
```bash
pip install -r requirements.txt
```
Start the bot (from /StreamingCommunity/TelegramHelp):
```bash
python3 telegram_bot.py
```d
- 🔹 `/list` – Displays the status of active downloads, with options to:
- Stop an incorrect download using `/stop `
- View the real-time output of a download using `/screen `
⚠️ **Warning:** If a download is interrupted, incomplete files may remain in the folder specified in config.json. These files must be deleted manually.
#### Setup
1. Create an `.env` file with your Telegram token and user ID:
```env
TOKEN_TELEGRAM=IlTuo2131TOKEN$12D3Telegram
AUTHORIZED_USER_ID=12345678
DEBUG=False
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Start the bot (from `/StreamingCommunity/TelegramHelp`):
```bash
python3 telegram_bot.py
```
**Running in background:**
Start the bot inside a screen session and press Ctrl + A, followed by D, to detach from the session without stopping the bot.
---
# Tutorials
- [Windows](https://www.youtube.com/watch?v=mZGqK4wdN-k)
- [Linux](https://www.youtube.com/watch?v=0qUNXPE_mTg)
- [Pypy](https://www.youtube.com/watch?v=C6m9ZKOK0p4)
- [Compiled](https://www.youtube.com/watch?v=pm4lqsxkTVo)
# Useful Project
## 🎯 [Unit3Dup](https://github.com/31December99/Unit3Dup)
Bot in Python per la generazione e l'upload automatico di torrent su tracker basati su Unit3D.
## 🇮🇹 [MammaMia](https://github.com/UrloMythus/MammaMia)
Addon per Stremio che consente lo streaming HTTPS di film, serie, anime e TV in diretta in lingua italiana.
## 🧩 [streamingcommunity-unofficialapi](https://github.com/Blu-Tiger/streamingcommunity-unofficialapi)
API non ufficiale per accedere ai contenuti del sito italiano StreamingCommunity.
# Disclaimer
> **Note:** 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.
> **Note:** DASH downloads require a valid L3 CDM (Content Decryption Module) to proceed. This project does not provide, include, or facilitate obtaining any CDM. Users are responsible for ensuring compliance with all applicable laws and requirements regarding DRM and decryption modules.
---
**Made with ❤️ for streaming lovers**
*If you find this project useful, consider starring it! ⭐*