StreamingCommunity 3.3.1__tar.gz → 3.3.2__tar.gz

{streamingcommunity-3.3.1/StreamingCommunity.egg-info → streamingcommunity-3.3.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: StreamingCommunity
-Version: 3.3.1
-Home-page: https://github.com/Lovi-0/StreamingCommunity
-Author: Lovi-0
-Project-URL: Bug Reports, https://github.com/Lovi-0/StreamingCommunity/issues
-Project-URL: Source, https://github.com/Lovi-0/StreamingCommunity
+Version: 3.3.2
+Home-page: https://github.com/Arrowar/StreamingCommunity
+Author: Arrowar
+Project-URL: Bug Reports, https://github.com/Arrowar/StreamingCommunity/issues
+Project-URL: Source, https://github.com/Arrowar/StreamingCommunity
 Keywords: streaming community
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
@@ -45,181 +45,184 @@ Dynamic: requires-python
 [![License](https://img.shields.io/github/license/Arrowar/StreamingCommunity?logo=gnu&logoColor=white&labelColor=2d3748&color=e53e3e&style=for-the-badge)](https://github.com/Arrowar/StreamingCommunity/blob/main/LICENSE)
 
 ## 💝 Support the Project
-
 [![Donate PayPal](https://img.shields.io/badge/💳_Donate-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white&labelColor=2d3748)](https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C)
-## 🚀 Download & Install
 
+## 🚀 Download & Install
 [![Windows](https://img.shields.io/badge/🪟_Windows-0078D4?style=for-the-badge&logo=windows&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_win.exe)
 [![macOS](https://img.shields.io/badge/🍎_macOS-000000?style=for-the-badge&logo=apple&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_mac)
 [![Linux latest](https://img.shields.io/badge/🐧_Linux_latest-FCC624?style=for-the-badge&logo=linux&logoColor=black&labelColor=2d3748)](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_linux_latest)
 [![Linux 22.04](https://img.shields.io/badge/🐧_Linux_22.04-FCC624?style=for-the-badge&logo=linux&logoColor=black&labelColor=2d3748)](https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity_linux_previous)
+
 ---
 
-*⚡ **Quick Start:** `pip install streamingcommunity` or download the executable for your platform above*
+*⚡ **Quick Start:** `pip install StreamingCommunity && StreamingCommunity`*
 
 </div>
 
-# 📋 Table of Contents
+---
+
+## 📖 Table of Contents
+- [Installation](#manual-installation)
+- [Quick Start](#quick-start)
+- [Downloaders](#downloaders)
+- [Configuration](#configuration)
+- [Login](.github/.site/login.md)
+- [Usage Examples](#usage-examples)
+- [Global Search](#global-search)
+- [Advanced Features](#advanced-options)
+- [Deployment](#docker)
+- [Tutorials](#tutorials)
+- [Related Projects](#useful-project)
+
+---
+
+## Manual Installation
 
 <details>
-<summary>📦 Installation</summary>
-
-- 🔄 [Update Domains](#update-domains)
-- 🌐 [Available Sites](https://arrowar.github.io/StreamingCommunity/)
-- 🛠️ [Installation](#installation)
-    - 📦 [PyPI Installation](#1-pypi-installation)
-    - 🔄 [Automatic Installation](#2-automatic-installation)
-    - 🔧 [Binary Location](#binary-location)
-    - 📝 [Manual Installation](#3-manual-installation)
-        - 💻 [Win 7](https://github.com/Ghost6446/StreamingCommunity_api/wiki/Installation#win-7)
-        - 📱 [Termux](https://github.com/Ghost6446/StreamingCommunity_api/wiki/Termux)
-</details>
+<summary>📝 Manual Installation & Update</summary>
 
 <details>
-<summary>⚙️ Configuration & Usage</summary>
-
-- ⚙️ [Configuration](#configuration)
-    - 🔧 [Default](#default-settings)
-    - 📩 [Request](#requests-settings)
-    - 📥 [Download](#m3u8_download-settings)
-    - 🔍 [Parser](#m3u8_parser-settings)
-- 📝 [Command](#command)
-- 🔍 [Global search](#global-search)
-- 💻 [Examples of terminal](#examples-of-terminal-usage)
+<summary>📋 Requirements</summary>
+
+Prerequisites:
+* [Python](https://www.python.org/downloads/) > 3.8
 </details>
 
 <details>
-<summary>🔧 Advanced Features</summary>
+<summary>⚙️ Python Dependencies</summary>
 
-- 🔧 [Manual domain configuration](#update-domains)
-- 🐳 [Docker](#docker)
-- 📝 [Telegram Usage](#telegram-usage)
-- 🧩 [Hook/Plugin System](#hookplugin-system)
+```bash
+pip install -r requirements.txt
+```
 </details>
 
 <details>
-<summary>ℹ️ Help & Support</summary>
+<summary>🚀 Usage</summary>
+
+#### On Windows:
 
-- 🎓 [Tutorial](#tutorials)
-- 📝 [To do](#to-do)
-- ⚠️ [Disclaimer](#disclaimer)
+```powershell
+python test_run.py
+```
+
+#### On Linux/MacOS:
+
+```bash
+python3 test_run.py
+```
 </details>
 
-# Installation
+## Update
 
-## 1. PyPI Installation
+Keep your script up to date with the latest features by running:
 
-Install directly from PyPI:
+### On Windows:
 
-```bash
-pip install StreamingCommunity
+```powershell
+python update.py
 ```
 
-Update to the latest version:
+### On Linux/MacOS:
 
 ```bash
-pip install --upgrade StreamingCommunity
+python3 update.py
 ```
 
-## Quick Start
+</details>
 
-Create a simple script (`run_streaming.py`) to launch the main application:
+---
 
-```python
-from StreamingCommunity.run import main
+## Quick Start
 
-if __name__ == "__main__":
-    main()
+After installing via pip, just run:
+```bash
+StreamingCommunity
 ```
+to start the application.
 
 Run the script:
-
 ```bash
 python run_streaming.py
 ```
 
-## Modules
+**Manual execution:**
+
+**Windows:**
+```powershell
+python test_run.py
+```
+
+**Linux/MacOS:**
+```bash
+python3 test_run.py
+```
+
+---
+
+## Downloaders
 
 <details>
-<summary>📥 HLS Downloader</summary>
+<summary>📥 HLS</summary>
 
 Download HTTP Live Streaming (HLS) content from m3u8 URLs.
 
 ```python
 from StreamingCommunity import HLS_Downloader
 
-# Initialize with m3u8 URL and optional output path
 downloader = HLS_Downloader(
     m3u8_url="https://example.com/stream.m3u8",
-    output_path="/downloads/video.mp4"  # Optional
+    output_path="/downloads/video.mp4"
 )
 
-# Start the download
 downloader.download()
 ```
 
-See [HLS example](./Test/Download/HLS.py) for complete usage.
+See [HLS example](./Test/EasyDownload//HLS.py) for complete usage.
 </details>
 
 <details>
-<summary>📽️ MP4 Downloader</summary>
+<summary>📽️ MP4</summary>
 
 Direct MP4 file downloader with support for custom headers and referrer.
 
 ```python
 from StreamingCommunity import MP4_downloader
 
-# Basic usage
 downloader = MP4_downloader(
     url="https://example.com/video.mp4",
     path="/downloads/saved_video.mp4"
 )
 
-# Advanced usage with custom headers and referrer
-headers = {
-    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
-}
-downloader = MP4_downloader(
-    url="https://example.com/video.mp4",
-    path="/downloads/saved_video.mp4",
-    referer="https://example.com",
-    headers_=headers
-)
-
-# Start download
 downloader.download()
 ```
 
-See [MP4 example](./Test/Download/MP4.py) for complete usage.
+See [MP4 example](./Test/EasyDownload/MP4.py) for complete usage.
 </details>
 
 <details>
-<summary>🧲 Torrent Client</summary>
+<summary>🧲 TOR</summary>
 
 Download content via torrent magnet links.
 
 ```python
 from StreamingCommunity import TOR_downloader
 
-# Initialize torrent client
 client = TOR_downloader()
 
-# Add magnet link
 client.add_magnet_link("magnet:?xt=urn:btih:example_hash&dn=example_name", save_path=".")
 
-# Start download
 client.start_download()
 ```
 
-See [Torrent example](./Test/Download/TOR.py) for complete usage.
+See [Torrent example](./Test/EasyDownload/TOR.py) for complete usage.
 </details>
 
 <details>
-<summary>🎞️ DASH Downloader</summary>
+<summary>🎞️ DASH</summary>
 
 ```python
-license_url = "https://example.com/stream.mpd"
-mpd_url = "https://example.com/get_license"
+mpd_url = "https://example.com/stream.mpd"
+license_url = "https://example.com/get_license"
 
 dash_process = DASH_Downloader(
     cdm_device=get_wvd_path(),
@@ -235,249 +238,12 @@ if dash_process.download_and_decrypt():
 dash_process.get_status()
 ```
 
+See [DASH example](./Test/EasyDownload/DASH.py) for complete usage.
 </details>
 
-## Binary Location
-
-<details>
-<summary>📂 Default Locations</summary>
-
-- **Windows**: `C:\binary`
-- **MacOS**: `~/Applications/binary`
-- **Linux**: `~/.local/bin/binary`
-</details>
-
-<details>
-<summary>🪟 Windows Configuration</summary>
-
-1. Move the binary folder from `C:\binary` to your desired location
-2. Add the new path to Windows environment variables:
-   - Open Start menu and search for "Environment Variables"
-   - Click "Edit the system environment variables"
-   - Click "Environment Variables" button
-   - Under "System Variables", find and select "Path"
-   - Click "Edit"
-   - Add the new binary folder path
-   - Click "OK" to save changes
-
-For detailed Windows PATH instructions, see the [Windows PATH guide](https://www.eukhost.com/kb/how-to-add-to-the-path-on-windows-10-and-windows-11/).
-</details>
-
-<details>
-<summary>🍎 MacOS Configuration</summary>
-
-1. Move the binary folder from `~/Applications/binary` to your desired location
-2. Add the new path to your shell's configuration file:
-   ```bash
-   # For bash (edit ~/.bash_profile)
-   export PATH="/your/custom/path:$PATH"
-
-   # For zsh (edit ~/.zshrc)
-   export PATH="/your/custom/path:$PATH"
-   ```
-3. Reload your shell configuration:
-   ```bash
-   # For bash
-   source ~/.bash_profile
-
-   # For zsh
-   source ~/.zshrc
-   ```
-</details>
-
-<details>
-<summary>🐧 Linux Configuration</summary>
-
-1. Move the binary folder from `~/.local/bin/binary` to your desired location
-2. Add the new path to your shell's configuration file:
-   ```bash
-   # For bash (edit ~/.bashrc)
-   export PATH="/your/custom/path:$PATH"
-
-   # For zsh (edit ~/.zshrc)
-   export PATH="/your/custom/path:$PATH"
-   ```
-3. Apply the changes:
-   ```bash
-   source ~/.bashrc   # for bash
-   # or
-   source ~/.zshrc    # for zsh
-   ```
-</details>
-
-> [!IMPORTANT]
-> After moving the binary folder, ensure that all executables (ffmpeg, ffprobe, ffplay) are present in the new location and have the correct permissions:
-> - Windows: `.exe` extensions required
-> - MacOS/Linux: Ensure files have execute permissions (`chmod +x filename`)
-
-## 3. Manual Installation
-
-<details>
-<summary>📋 Requirements</summary>
-
-Prerequisites:
-* [Python](https://www.python.org/downloads/) > 3.8
-* [FFmpeg](https://www.gyan.dev/ffmpeg/builds/)
-</details>
-
-<details>
-<summary>⚙️ Python Dependencies</summary>
-
-```bash
-pip install -r requirements.txt
-```
-</details>
-
-<details>
-<summary>🚀 Usage</summary>
-
-#### On Windows:
-
-```powershell
-python test_run.py
-```
-
-#### On Linux/MacOS:
-
-```bash
-python3 test_run.py
-```
-</details>
-
-## Update
-
-Keep your script up to date with the latest features by running:
-
-### On Windows:
-
-```powershell
-python update.py
-```
-
-### On Linux/MacOS:
-
-```bash
-python3 update.py
-```
-
-<br>
-
-## Update Domains
-
-<details>
-<summary>🌐 Domain Configuration Methods</summary>
-
-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!
-
-</details>
-
-## Hook/Plugin System
-
-<details>
-<summary>🧩 Run custom scripts before/after the main execution</summary>
-
-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.
-
-</details>
+---
 
-# Configuration
+## Configuration
 
 <details>
 <summary>⚙️ Overview</summary>
@@ -486,31 +252,7 @@ You can change some behaviors by tweaking the configuration file. The configurat
 </details>
 
 <details>
-<summary>🔧 DEFAULT Settings</summary>
-
-```json
-{
-    "DEFAULT": {
-        "debug": false,
-        "show_message": true,
-        "show_trending": true,
-        "fetch_domain_online": true,
-        "telegram_bot": false,
-        "validate_github_config": false
-    }
-}
-```
-
-- `debug`: Enables debug logging
-- `show_message`: Displays informational messages
-- `show_trending`: Shows trending content
-- `fetch_domain_online`: If true, downloads domains from GitHub repository and saves to local file; if false, uses existing local domains.json file
-- `telegram_bot`: Enables Telegram bot integration
-- `validate_github_config`: If set to false, disables validation and updating of configuration from GitHub
-</details>
-
-<details>
-<summary>📁 OUT_FOLDER Settings</summary>
+<summary>📁 OUT_FOLDER</summary>
 
 ```json
 {
@@ -564,51 +306,12 @@ You can change some behaviors by tweaking the configuration file. The configurat
 To enable qBittorrent integration, follow the setup guide [here](https://github.com/lgallard/qBittorrent-Controller/wiki/How-to-enable-the-qBittorrent-Web-UI).
 </details>
 
-<details>
-<summary>📡 REQUESTS Settings</summary>
-
-```json
-{
-    "REQUESTS": {
-        "verify": false,
-        "timeout": 20,
-        "max_retry": 8,
-        "proxy": {
-            "http": "http://username:password@host:port",
-            "https": "https://username:password@host:port"
-        }
-    }
-}
-```
-
-- `verify`: Verifies SSL certificates
-- `timeout`: Maximum timeout (in seconds) for each request
-- `max_retry`: Number of retry attempts per segment during M3U8 index download
-- `proxy`: Proxy configuration for HTTP/HTTPS requests
-  * Set to empty string `""` to disable proxies (default)
-  * Example with authentication:
-    ```json
-    "proxy": {
-        "http": "http://username:password@host:port",
-        "https": "https://username:password@host:port"
-    }
-    ```
-  * Example without authentication:
-    ```json
-    "proxy": {
-        "http": "http://host:port",
-        "https": "https://host:port"
-    }
-    ```
-</details>
-
 <details>
 <summary>📥 M3U8_DOWNLOAD Settings</summary>
 
 ```json
 {
     "M3U8_DOWNLOAD": {
-        "tqdm_delay": 0.01,
         "default_video_workser": 12,
         "default_audio_workser": 12,
         "segment_timeout": 8,
@@ -621,26 +324,23 @@ To enable qBittorrent integration, follow the setup guide [here](https://github.
             "ita",    // Specify language codes or use ["*"] to download all available subtitles
             "eng"
         ],
-        "cleanup_tmp_folder": true
+        "cleanup_tmp_folder": true,
+        "get_only_link": false
     }
 }
 ```
 
 #### Performance Settings
-- `tqdm_delay`: Delay between progress bar updates
 - `default_video_workser`: Number of threads for video download
   * Can be changed with `--default_video_worker <number>`
 - `default_audio_workser`: Number of threads for audio download
   * Can be changed with `--default_audio_worker <number>`
-- `segment_timeout`: Timeout for downloading individual segments
 
 #### Audio Settings
-- `download_audio`: Whether to download audio tracks
 - `specific_list_audio`: List of audio languages to download
   * Can be changed with `--specific_list_audio ita,eng`
 
 #### Subtitle Settings
-- `download_subtitle`: Whether to download subtitles
 - `merge_subs`: Whether to merge subtitles with video
 - `specific_list_subtitles`: List of subtitle languages to download
   * Use `["*"]` to download all available subtitles
@@ -651,66 +351,6 @@ To enable qBittorrent integration, follow the setup guide [here](https://github.
 - `cleanup_tmp_folder`: Remove temporary .ts files after download
 </details>
 
-<details>
-<summary>🌍 Available Language Codes</summary>
-
-| European        | Asian           | Middle Eastern  | Others          |
-|-----------------|-----------------|-----------------|-----------------|
-| ita - Italian   | chi - Chinese   | ara - Arabic    | eng - English   |
-| spa - Spanish   | jpn - Japanese  | heb - Hebrew    | por - Portuguese|
-| fre - French    | kor - Korean    | tur - Turkish   | fil - Filipino  |
-| ger - German    | hin - Hindi     |                 | ind - Indonesian|
-| rus - Russian   | mal - Malayalam |                 | may - Malay     |
-| swe - Swedish   | tam - Tamil     |                 | vie - Vietnamese|
-| pol - Polish    | tel - Telugu    |                 |                 |
-| ukr - Ukrainian | tha - Thai      |                 |                 |
-</details>
-
-<details>
-<summary>🎥 M3U8_CONVERSION Settings</summary>
-
-```json
-{
-    "M3U8_CONVERSION": {
-        "use_codec": false,
-        "use_vcodec": true,
-        "use_acodec": true,
-        "use_bitrate": true,
-        "use_gpu": false,
-        "default_preset": "ultrafast"
-    }
-}
-```
-
-#### Basic Settings
-- `use_codec`: Use specific codec settings
-- `use_vcodec`: Use specific video codec
-- `use_acodec`: Use specific audio codec
-- `use_bitrate`: Apply bitrate settings
-- `use_gpu`: Enable GPU acceleration (if available)
-- `default_preset`: FFmpeg encoding preset
-
-#### Encoding Presets
-The `default_preset` configuration can be set to:
-- `ultrafast`: Extremely fast conversion but larger file size
-- `superfast`: Very fast with good quality/size ratio
-- `veryfast`: Fast with good compression
-- `faster`: Optimal balance for most users
-- `fast`: Good compression, moderate time
-- `medium`: FFmpeg default setting
-- `slow`: High quality, slower process
-- `slower`: Very high quality, slow process
-- `veryslow`: Maximum quality, very slow process
-
-#### GPU Acceleration
-When `use_gpu` is enabled, supports:
-- NVIDIA: NVENC 
-- AMD: AMF
-- Intel: QSV
-
-Note: Requires updated drivers and FFmpeg with hardware acceleration support.
-</details>
-
 <details>
 <summary>🔍 M3U8_PARSER Settings</summary>
 
@@ -732,13 +372,130 @@ Note: Requires updated drivers and FFmpeg with hardware acceleration support.
     - 720p (1280x720)
     - 480p (640x480)
     - 360p (640x360)
-    - 320p (480x320)
-    - 240p (426x240)
-    - 240p (320x240)
-    - 144p (256x144)
+
+#### Link options
+- `get_only_link`: Return M3U8 playlist/index URL instead of downloading
 
 </details>
 
+## Update Domains
+
+<details>
+<summary>🌐 Domain Configuration Methods</summary>
+
+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!
+
+</details>
+
+---
+
+## 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
 
 <details>
@@ -781,42 +538,66 @@ The Global Search can be configured from the command line:
 - `-s`, `--search` - Specify the search terms.
 </details>
 
-# Examples of terminal usage
+---
 
-```bash
-# Run a specific site by name with a search term
-python test_run.py --site streamingcommunity --search "interstellar"
+## 🧩 Advanced Features
 
-# Run a specific site by numeric index (as shown in -h help)
-python test_run.py --site 0 --search "interstellar"
+## Hook/Plugin System
 
-# Auto-download the first result from search (requires --site and --search)
-python test_run.py --site streamingcommunity --search "interstellar" --auto-first
+<details>
+<summary>🧩 Run custom scripts before/after the main execution</summary>
 
-# Show help (includes available sites by name and by index)
-python test_run.py -h
+Define pre/post hooks in `config.json` under the `HOOKS` section. Supported types:
 
-# Change video and audio workers
-python test_run.py --default_video_worker 8 --default_audio_worker 8
+- **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`
 
-# Set specific languages
-python test_run.py --specific_list_audio ita,eng --specific_list_subtitles eng,spa
+Sample configuration:
 
-# Keep console open after download
-python test_run.py --not_close true
+```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'"
+      }
+    ]
+  }
+}
+```
 
-# Use global search
-python test_run.py --global -s "cars"
+Notes:
 
-# 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
+- **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.
 
-# If installed via pip, you can also use the entrypoint directly
-streamingcommunity --site streamingcommunity --search "interstellar" --auto-first
-```
+Hooks are executed automatically by `run.py` before (`pre_run`) and after (`post_run`) the main execution.
+
+</details>
+
+---
 
 # Docker
 
@@ -830,7 +611,13 @@ docker build -t streaming-community-api .
 
 Run the container with Cloudflare DNS for better connectivity:
 ```
-docker run -it --dns 1.1.1.1 -p 8000:8000 streaming-community-api
+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
 ```
 </details>
 
@@ -859,6 +646,7 @@ 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.
 </details>
 
+
 # Telegram Usage
 
 <details>
@@ -905,7 +693,35 @@ Start the bot (from /StreamingCommunity/TelegramHelp):
 ```bash
 python3 telegram_bot.py
 ```
-</details>
+</details>d
+- 🔹 `/list` – Displays the status of active downloads, with options to:
+  - Stop an incorrect download using `/stop <ID>`
+  - View the real-time output of a download using `/screen <ID>`
+
+⚠️ **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
 
@@ -914,19 +730,27 @@ python3 telegram_bot.py
 - [Pypy](https://www.youtube.com/watch?v=C6m9ZKOK0p4)
 - [Compiled](https://www.youtube.com/watch?v=pm4lqsxkTVo)
 
-## Useful Project
 
-### 🎯 [Unit3Dup](https://github.com/31December99/Unit3Dup)
+# 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)
+## 🇮🇹 [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)
+## 🧩 [streamingcommunity-unofficialapi](https://github.com/Blu-Tiger/streamingcommunity-unofficialapi)
 API non ufficiale per accedere ai contenuti del sito italiano StreamingCommunity.
 
-# Disclaimer
 
-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.
+# 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.
+
+---
+<div align="center">
+**Made with ❤️ for streaming lovers**
+
+*If you find this project useful, consider starring it! ⭐*
+</div>