StreamingCommunity 2.5.2__py3-none-any.whl → 2.5.6__py3-none-any.whl

{StreamingCommunity-2.5.2.dist-info → StreamingCommunity-2.5.6.dist-info}/METADATA

@@ -1,543 +1,601 @@
-Metadata-Version: 2.1
-Name: StreamingCommunity
-Version: 2.5.2
-Summary: UNKNOWN
-Home-page: https://github.com/Lovi-0/StreamingCommunity
-Author: Lovi-0
-License: UNKNOWN
-Project-URL: Bug Reports, https://github.com/Lovi-0/StreamingCommunity/issues
-Project-URL: Source, https://github.com/Lovi-0/StreamingCommunity
-Keywords: streaming community
-Platform: UNKNOWN
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: httpx
-Requires-Dist: bs4
-Requires-Dist: rich
-Requires-Dist: tqdm
-Requires-Dist: m3u8
-Requires-Dist: psutil
-Requires-Dist: unidecode
-Requires-Dist: jsbeautifier
-Requires-Dist: pathvalidate
-Requires-Dist: pycryptodomex
-Requires-Dist: googlesearch-python
-Requires-Dist: fake-useragent
-Requires-Dist: qbittorrent-api
-Requires-Dist: python-qbittorrent
-
-<p align="center">
-  <img src="https://i.ibb.co/PFnjvBc/immagine-2024-12-26-180318047.png" alt="Project Logo" width="700"/>
-</p>
-
-<p align="center">
-  <a href="https://pypi.org/project/streamingcommunity">
-    <img src="https://img.shields.io/pypi/v/streamingcommunity?logo=pypi&labelColor=555555&style=for-the-badge" alt="PyPI"/>
-  </a>
-  <a href="https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C">
-    <img src="https://img.shields.io/badge/_-Donate-red.svg?logo=githubsponsors&labelColor=555555&style=for-the-badge" alt="Donate"/>
-  </a>
-  <a href="https://github.com/Lovi-0/StreamingCommunity/commits">
-    <img src="https://img.shields.io/github/commit-activity/m/Lovi-0/StreamingCommunity?label=commits&style=for-the-badge" alt="Commits"/>
-  </a>
-  <a href="https://github.com/Lovi-0/StreamingCommunity/commits">
-    <img src="https://img.shields.io/github/last-commit/Lovi-0/StreamingCommunity/main?label=&style=for-the-badge&display_timestamp=committer" alt="Last Commit"/>
-  </a>
-</p>
-
-<p align="center">
-  <a href="https://github.com/Lovi-0/StreamingCommunity/blob/main/LICENSE">
-    <img src="https://img.shields.io/badge/License-GPL_3.0-blue.svg?style=for-the-badge" alt="License"/>
-  </a>
-  <a href="https://pypi.org/project/streamingcommunity">
-    <img src="https://img.shields.io/pypi/dm/streamingcommunity?style=for-the-badge" alt="PyPI Downloads"/>
-  </a>
-  <a href="https://github.com/Lovi-0/StreamingCommunity">
-    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Lovi-0/StreamingCommunity/main/Test/Util/loc-badge.json&style=for-the-badge" alt="Lines of Code"/>
-  </a>
-</p>
-
-# 📋 Table of Contents
-
-- 🌐 [Website available](#website-status)
-- 🛠️ [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)
-- ⚙️ [Configuration](#configuration)
-    - 🔧 [Default](#default-settings)
-    - 📩 [Request](#requests-settings)
-    - 📥 [Download](#m3u8_download-settings)
-    - 🔍 [Parser](#m3u8_parser-settings)
-- 🐳 [Docker](#docker)
-- 🎓 [Tutorial](#tutorials)
-- 📝 [To do](#to-do)
-- 💬 [Support](#support)
-- 🤝 [Contribute](#contributing)
-- ⚠️ [Disclaimer](#disclaimer)
-- ⚡ [Contributors](#contributors)  
-
-# Installation
-
-<p align="center">
-  <a href="https://github.com/Lovi-0/StreamingCommunity/releases/latest/download/StreamingCommunity.exe">
-    <img src="https://img.shields.io/badge/-Windows_x64-blue.svg?style=for-the-badge&logo=windows" alt="Windows">
-  </a>
-  <a href="https://pypi.org/project/StreamingCommunity">
-    <img src="https://img.shields.io/badge/-PyPI-blue.svg?logo=pypi&labelColor=555555&style=for-the-badge" alt="PyPI">
-  </a>
-  <a href="https://github.com/Lovi-0/StreamingCommunity/releases/latest/download/StreamingCommunity.zip">
-    <img src="https://img.shields.io/badge/-Source_tar-green.svg?style=for-the-badge" alt="Source Tarball">
-  </a>
-  <a href="https://github.com/Lovi-0/StreamingCommunity/releases">
-    <img src="https://img.shields.io/badge/-All_Versions-lightgrey.svg?style=for-the-badge" alt="All Versions">
-  </a>
-</p>
-
-
-## 1. PyPI Installation
-
-Install directly from PyPI:
-
-```bash
-pip install StreamingCommunity
-```
-
-### Creating a Run Script
-
-Create `run_streaming.py`:
-
-```python
-from StreamingCommunity.run import main
-
-if __name__ == "__main__":
-    main()
-```
-
-Run the script:
-```bash
-python run_streaming.py
-```
-
-### Updating via PyPI
-
-```bash
-pip install --upgrade StreamingCommunity
-```
-
-## 2. Automatic Installation
-
-### Supported Operating Systems 💿
-
-| OS              | Automatic Installation Support |
-|:----------------|:------------------------------:|
-| Windows 10/11   |              ✔️              |
-| Windows 7       |              ❌              |
-| Debian Linux    |              ✔️              |
-| Arch Linux      |              ✔️              |
-| CentOS Stream 9 |              ✔️              |
-| FreeBSD         |              ⏳              |
-| MacOS           |              ✔️              |
-| Termux          |              ❌              |
-
-### Installation Steps
-
-#### On Windows:
-
-```powershell
-.\Installer\win_install.bat
-```
-
-#### On Linux/MacOS/BSD:
-
-```bash
-sudo chmod +x Installer/unix_install.sh && ./Installer/unix_install.sh
-```
-
-### Usage
-
-#### On Windows:
-
-```powershell
-python .\test_run.py
-```
-
-or
-
-```powershell
-source .venv/bin/activate && python test_run.py && deactivate
-```
-
-#### On Linux/MacOS/BSD:
-
-```bash
-./test_run.py
-```
-
-## Binary Location
-
-### Default Locations
-- **Windows**: `C:\binary`
-- **MacOS**: `~/Applications/binary`
-- **Linux**: `~/.local/bin/binary`
-
-You can customize these locations by following these steps for your operating system:
-
-#### Windows
-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/).
-
-#### MacOS
-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
-   ```
-
-#### Linux
-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
-   ```
-
-> [!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
-
-### Requirements 📋
-
-Prerequisites:
-* [Python](https://www.python.org/downloads/) > 3.8
-* [FFmpeg](https://www.gyan.dev/ffmpeg/builds/)
-
-### Install Python Dependencies
-
-```bash
-pip install -r requirements.txt
-```
-
-### Usage
-
-#### On Windows:
-
-```powershell
-python test_run.py
-```
-
-#### On Linux/MacOS:
-
-```bash
-python3 test_run.py
-```
-
-## 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>
-
-# Configuration
-
-You can change some behaviors by tweaking the configuration file.
-
-The configuration file is divided into several main sections:
-
-## DEFAULT Settings
-
-```json
-{
-    "root_path": "Video",
-    "movie_folder_name": "Movie",
-    "serie_folder_name": "TV",
-    "map_episode_name": "%(tv_name)_S%(season)E%(episode)_%(episode_name)",
-    "add_siteName": false,
-    "disable_searchDomain": false,
-    "not_close": false
-}
-```
-
-- `root_path`: Directory where all videos will be saved
-
-  ### Path examples:
-  * Windows: `C:\\MyLibrary\\Folder` or `\\\\MyServer\\MyLibrary` (if you want to use a network folder)
-  * Linux/MacOS: `Desktop/MyLibrary/Folder`
-    `<br/><br/>`
-
-- `movie_folder_name`: The name of the subdirectory where movies will be stored.
-- `serie_folder_name`: The name of the subdirectory where TV series will be stored.
-
-- `map_episode_name`: Template for TV series episode filenames
-
-  ### Episode name usage:
-
-  You can choose different vars:
-
-
-  * `%(tv_name)` : Is the name of TV Show
-  * `%(season)` : Is the number of the season
-  * `%(episode)` : Is the number of the episode
-  * `%(episode_name)` : Is the name of the episode
-    `<br/><br/>`
-
-- `add_siteName`: If set to true, appends the site_name to the root path before the movie and serie folders.
-- `disable_searchDomain`: If set to true, disables the search for a new domain for all sites.
-- `not_close`: If set to true, keeps the program running after the download is complete.
-
-
-    ### qBittorrent Configuration
-
-    ```json
-    {
-        "config_qbit_tor": {
-            "host": "192.168.1.59",
-            "port": "8080",
-            "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).
-
-
-## REQUESTS Settings
-
-```json
-{
-    "timeout": 20,
-    "max_retry": 3
-}
-```
-
-- `timeout`: Maximum timeout (in seconds) for each request
-- `max_retry`: Number of retry attempts per segment during M3U8 index download
-
-
-## M3U8_DOWNLOAD Settings
-
-```json
-{
-    "tqdm_delay": 0.01,
-    "tqdm_use_large_bar": true,
-    "default_video_workser": 12,
-    "default_audio_workser": 12,
-    "cleanup_tmp_folder": true
-}
-```
-
-- `tqdm_delay`: Delay between progress bar updates
-- `tqdm_use_large_bar`: Use detailed progress bar (recommended for desktop) set to false for mobile
-- `default_video_workser`: Number of threads for video download
-- `default_audio_workser`: Number of threads for audio download
-- `cleanup_tmp_folder`: Remove temporary .ts files after download
-
-> [!IMPORTANT]
-> Set `tqdm_use_large_bar` to `false` when using Termux or terminals with limited width to prevent network monitoring issues
-
-
-
-### Language Settings
-
-The following codes can be used for `specific_list_audio` and `specific_list_subtitles`:
-
-```
-ara - Arabic       eng - English      ita - Italian     por - Portuguese
-baq - Basque       fil - Filipino     jpn - Japanese    rum - Romanian
-cat - Catalan      fin - Finnish      kan - Kannada     rus - Russian
-chi - Chinese      fre - French       kor - Korean      spa - Spanish
-cze - Czech        ger - German       mal - Malayalam   swe - Swedish
-dan - Danish       glg - Galician     may - Malay       tam - Tamil
-dut - Dutch        gre - Greek        nob - Norw. Bokm  tel - Telugu
-                   heb - Hebrew       nor - Norwegian    tha - Thai
-forced-ita         hin - Hindi        pol - Polish      tur - Turkish
-                   hun - Hungarian                       ukr - Ukrainian
-                   ind - Indonesian                      vie - Vietnamese
-```
-
-> [!NOTE]
-> When using subtitles on Windows, please note that the default Windows Media Player may not display them correctly. We recommend using VLC Media Player for proper subtitle display and optimal playback experience.
-
-
-> [!IMPORTANT]
-> Language code availability may vary by site. Some platforms might:
->
-> - Use different language codes
-> - Support only a subset of these languages
-> - Offer additional languages not listed here
->
-> Check the specific site's available options if downloads fail.
-
-> [!TIP]
-> You can configure multiple languages by adding them to the lists:
->
-> ```json
-> "specific_list_audio": ["ita", "eng", "spa"],
-> "specific_list_subtitles": ["ita", "eng", "spa"]
-> ```
-
-For the best viewing experience, we recommend using VLC Media Player:
-- Supports all video formats and codecs
-- Properly displays embedded subtitles
-- Available for all major operating systems
-- Free and open-source
-
-You can download VLC Media Player from the [official website](https://www.videolan.org/vlc/).
-
-## M3U8_PARSER Settings
-
-```json
-{
-    "force_resolution": -1,
-    "get_only_link": false
-}
-```
-
-- `force_resolution`: Force specific resolution (-1 for best available, or specify 1080, 720, 360)
-- `get_only_link`: Return M3U8 playlist/index URL instead of downloading
-
-
-# COMMAND
-
-- Download a specific season by entering its number.
-  *  **Example:** `1` will download *Season 1* only.
-
--  Use the wildcard `*` to download every available season.
-   * **Example:** `*` will download all seasons in the series.
-
-- Specify a range of seasons using a hyphen `-`.
-   * **Example:** `1-2` will download *Seasons 1 and 2*.
-
-- Enter a season number followed by `-*` to download from that season to the end.
-  * **Example:** `3-*` will download from *Season 3* to the final season.
-
-
-# Docker
-
-You can run the script in a docker container, to build the image just run
-
-```
-docker build -t streaming-community-api .
-```
-
-and to run it use
-
-```
-docker run -it -p 8000:8000 streaming-community-api
-```
-
-By default the videos will be saved in `/app/Video` inside the container, if you want to to save them in your machine instead of the container just run
-
-```
-docker run -it -p 8000:8000 -v /path/to/download:/app/Video streaming-community-api
-```
-
-### Docker 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.
-
-# Website Status 
-
-| Website            | Status |
-|:-------------------|:------:|
-| [1337xx](https://1337xx.to/) |   ✅   |
-| [AltadefinizioneGratis](https://altadefinizionegratis.site/) |   ✅   |
-| [AnimeUnity](https://animeunity.so/) |   ✅   |
-| [Ilcorsaronero](https://ilcorsaronero.link/) |   ✅   |
-| [CB01New](https://cb01new.video/) |   ✅   |
-| [DDLStreamItaly](https://ddlstreamitaly.co/) |   ✅   |
-| [GuardaSerie](https://guardaserie.meme/) |   ✅   |
-| [MostraGuarda](https://mostraguarda.stream/) |   ✅   |
-| [StreamingCommunity](https://streamingcommunity.paris/) |   ✅   |
-
-
-# Tutorials 
-
-- [Windows Tutorial](https://www.youtube.com/watch?v=mZGqK4wdN-k)
-- [Linux Tutorial](https://www.youtube.com/watch?v=0qUNXPE_mTg)
-- [Pypy Tutorial](https://www.youtube.com/watch?v=C6m9ZKOK0p4)
-- [Compiled .exe Tutorial](https://www.youtube.com/watch?v=pm4lqsxkTVo)
-
-# To Do 
-
-- Finish [website API](https://github.com/Lovi-0/StreamingCommunity/tree/test_gui_1)
-
-# Contributing
-
-Contributions are welcome! Steps:
-1. Fork the repository
-2. Create feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to branch (`git push origin feature/AmazingFeature`)
-5. Open Pull Request
-
-
-# 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.
-
-## Contributors
-
-<a href="https://github.com/Lovi-0/StreamingCommunity/graphs/contributors" alt="View Contributors">
-  <img src="https://contrib.rocks/image?repo=Lovi-0/StreamingCommunity&max=1000&columns=10" alt="Contributors" />
-</a>
-
-
+Metadata-Version: 2.1
+Name: StreamingCommunity
+Version: 2.5.6
+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
+Keywords: streaming community
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Requires-Dist: bs4
+Requires-Dist: rich
+Requires-Dist: tqdm
+Requires-Dist: m3u8
+Requires-Dist: psutil
+Requires-Dist: unidecode
+Requires-Dist: jsbeautifier
+Requires-Dist: pathvalidate
+Requires-Dist: pycryptodomex
+Requires-Dist: googlesearch-python
+Requires-Dist: fake-useragent<2.0.0
+Requires-Dist: qbittorrent-api
+Requires-Dist: python-qbittorrent
+Requires-Dist: Pillow
+Requires-Dist: pyTelegramBotAPI
+
+<p align="center">
+  <img src="https://i.ibb.co/v6RnT0wY/s2.jpg" alt="Project Logo" width="700"/>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/streamingcommunity">
+    <img src="https://img.shields.io/pypi/v/streamingcommunity?logo=pypi&labelColor=555555&style=for-the-badge" alt="PyPI"/>
+  </a>
+  <a href="https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C">
+    <img src="https://img.shields.io/badge/_-Donate-red.svg?logo=githubsponsors&labelColor=555555&style=for-the-badge" alt="Donate"/>
+  </a>
+  <a href="https://github.com/Arrowar/StreamingCommunity/commits">
+    <img src="https://img.shields.io/github/commit-activity/m/Arrowar/StreamingCommunity?label=commits&style=for-the-badge" alt="Commits"/>
+  </a>
+  <a href="https://github.com/Arrowar/StreamingCommunity/commits">
+    <img src="https://img.shields.io/github/last-commit/Arrowar/StreamingCommunity/main?label=&style=for-the-badge&display_timestamp=committer" alt="Last Commit"/>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Arrowar/StreamingCommunity/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-GPL_3.0-blue.svg?style=for-the-badge" alt="License"/>
+  </a>
+  <a href="https://pypi.org/project/streamingcommunity">
+    <img src="https://img.shields.io/pypi/dm/streamingcommunity?style=for-the-badge" alt="PyPI Downloads"/>
+  </a>
+  <a href="https://github.com/Arrowar/StreamingCommunity">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Arrowar/StreamingCommunity/main/Test/Media/loc-badge.json&style=for-the-badge" alt="Lines of Code"/>
+  </a>
+</p>
+
+# 📋 Table of Contents
+
+- 🌐 [Website available](#website-status)
+- 🛠️ [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)
+- ⚙️ [Configuration](#configuration)
+    - 🔧 [Default](#default-settings)
+    - 📩 [Request](#requests-settings)
+    - 📥 [Download](#m3u8_download-settings)
+    - 🔍 [Parser](#m3u8_parser-settings)
+- 📝 [Command](#command)
+- 💻 [Examples of terminal](#examples-of-terminal-usage)
+- 🐳 [Docker](#docker)
+- 📝 [Telegram Usage](#telegram-usage)
+- 🎓 [Tutorial](#tutorials)
+- 📝 [To do](#to-do)
+- 💬 [Support](#support)
+- 🤝 [Contribute](#contributing)
+- ⚠️ [Disclaimer](#disclaimer)
+- ⚡ [Contributors](#contributors)  
+
+# Installation
+
+<p align="center">
+  <a href="https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity.exe">
+    <img src="https://img.shields.io/badge/-Windows_x64-blue.svg?style=for-the-badge&logo=windows" alt="Windows">
+  </a>
+  <a href="https://github.com/Arrowar/StreamingCommunity/releases/latest/download/StreamingCommunity.zip">
+    <img src="https://img.shields.io/badge/-Source_tar-green.svg?style=for-the-badge" alt="Source Tarball">
+  </a>
+  <a href="https://github.com/Arrowar/StreamingCommunity/releases">
+    <img src="https://img.shields.io/badge/-All_Versions-lightgrey.svg?style=for-the-badge" alt="All Versions">
+  </a>
+</p>
+
+
+## 1. PyPI Installation
+
+Install directly from PyPI:
+
+```bash
+pip install StreamingCommunity
+```
+
+### Creating a Run Script
+
+Create `run_streaming.py`:
+
+```python
+from StreamingCommunity.run import main
+
+if __name__ == "__main__":
+    main()
+```
+
+Run the script:
+```bash
+python run_streaming.py
+```
+
+### Updating via PyPI
+
+```bash
+pip install --upgrade StreamingCommunity
+```
+
+## 2. Automatic Installation
+
+### Supported Operating Systems 💿
+
+| OS              | Automatic Installation Support |
+|:----------------|:------------------------------:|
+| Windows 10/11   |              ✔️              |
+| Windows 7       |              ❌              |
+| Debian Linux    |              ✔️              |
+| Arch Linux      |              ✔️              |
+| CentOS Stream 9 |              ✔️              |
+| FreeBSD         |              ⏳              |
+| MacOS           |              ✔️              |
+| Termux          |              ❌              |
+
+### Installation Steps
+
+#### On Windows:
+
+```powershell
+.\Installer\win_install.bat
+```
+
+#### On Linux/MacOS/BSD:
+
+```bash
+sudo chmod +x Installer/unix_install.sh && ./Installer/unix_install.sh
+```
+
+### Usage
+
+#### On Windows:
+
+```powershell
+python .\test_run.py
+```
+
+or
+
+```powershell
+source .venv/bin/activate && python test_run.py && deactivate
+```
+
+#### On Linux/MacOS/BSD:
+
+```bash
+./test_run.py
+```
+
+## Binary Location
+
+### Default Locations
+- **Windows**: `C:\binary`
+- **MacOS**: `~/Applications/binary`
+- **Linux**: `~/.local/bin/binary`
+
+You can customize these locations by following these steps for your operating system:
+
+#### Windows
+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/).
+
+#### MacOS
+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
+   ```
+
+#### Linux
+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
+   ```
+
+> [!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
+
+### Requirements 📋
+
+Prerequisites:
+* [Python](https://www.python.org/downloads/) > 3.8
+* [FFmpeg](https://www.gyan.dev/ffmpeg/builds/)
+
+### Install Python Dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+### Usage
+
+#### On Windows:
+
+```powershell
+python test_run.py
+```
+
+#### On Linux/MacOS:
+
+```bash
+python3 test_run.py
+```
+
+## 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>
+
+# Configuration
+
+You can change some behaviors by tweaking the configuration file.
+
+The configuration file is divided into several main sections:
+
+## DEFAULT Settings
+
+```json
+{
+    "root_path": "Video",
+    "movie_folder_name": "Movie",
+    "serie_folder_name": "TV",
+    "map_episode_name": "%(tv_name)_S%(season)E%(episode)_%(episode_name)",
+    "add_siteName": false,
+    "disable_searchDomain": false,
+    "not_close": false
+}
+```
+
+- `root_path`: Directory where all videos will be saved
+  
+  ### Path examples:
+  * Windows: `C:\\MyLibrary\\Folder` or `\\\\MyServer\\MyLibrary` (if you want to use a network folder)
+  * Linux/MacOS: `Desktop/MyLibrary/Folder`
+    `<br/><br/>`
+
+- `movie_folder_name`: The name of the subdirectory where movies will be stored.
+  * Can be changed from terminal with `--movie_folder_name`
+    <br/><br/>
+
+- `serie_folder_name`: The name of the subdirectory where TV series will be stored.
+  * Can be changed from terminal with `--serie_folder_name`
+    <br/><br/>
+
+- `map_episode_name`: Template for TV series episode filenames
+
+  ### Episode name usage:
+
+  You can choose different vars:
+  * `%(tv_name)` : Is the name of TV Show
+  * `%(season)` : Is the number of the season
+  * `%(episode)` : Is the number of the episode
+  * `%(episode_name)` : Is the name of the episode
+    `<br/><br/>`
+  * Can be changed from terminal with `--map_episode_name`
+    <br/><br/>
+    
+- `add_siteName`: If set to true, appends the site_name to the root path before the movie and serie folders.
+  * Can be changed from terminal with `--add_siteName true/false`
+    <br/><br/>
+
+- `disable_searchDomain`: If set to true, disables the search for a new domain for all sites.
+  * Can be changed from terminal with `--disable_searchDomain true/false`
+    <br/><br/>
+
+- `not_close`: If set to true, keeps the program running after the download is complete.
+  * Can be changed from terminal with `--not_close true/false`
+    <br/><br/>
+
+    ### qBittorrent Configuration
+
+    ```json
+    {
+        "config_qbit_tor": {
+            "host": "192.168.1.59",
+            "port": "8080",
+            "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).
+
+
+## REQUESTS Settings
+
+```json
+{
+    "timeout": 20,
+    "max_retry": 3
+}
+```
+
+- `timeout`: Maximum timeout (in seconds) for each request
+- `max_retry`: Number of retry attempts per segment during M3U8 index download
+
+
+## M3U8_DOWNLOAD Settings
+
+```json
+{
+    "tqdm_delay": 0.01,
+    "default_video_workser": 12,
+    "default_audio_workser": 12,
+    "cleanup_tmp_folder": true
+}
+```
+
+- `tqdm_delay`: Delay between progress bar updates
+- `default_video_workser`: Number of threads for video download
+  * Can be changed from terminal with `--default_video_worker <number>`
+    <br/><br/>
+
+- `default_audio_workser`: Number of threads for audio download
+  * Can be changed from terminal with `--default_audio_worker <number>`
+    <br/><br/>
+
+- `cleanup_tmp_folder`: Remove temporary .ts files after download
+
+
+
+### Language Settings
+
+The following codes can be used for `specific_list_audio` and `specific_list_subtitles`:
+* Can be changed from terminal with `--specific_list_audio ita,eng` for audio
+* Can be changed from terminal with `--specific_list_subtitles eng,spa` for subtitles
+
+
+```
+ara - Arabic       eng - English      ita - Italian     por - Portuguese
+baq - Basque       fil - Filipino     jpn - Japanese    rum - Romanian
+cat - Catalan      fin - Finnish      kan - Kannada     rus - Russian
+chi - Chinese      fre - French       kor - Korean      spa - Spanish
+cze - Czech        ger - German       mal - Malayalam   swe - Swedish
+dan - Danish       glg - Galician     may - Malay       tam - Tamil
+dut - Dutch        gre - Greek        nob - Norw. Bokm  tel - Telugu
+                   heb - Hebrew       nor - Norwegian    tha - Thai
+forced-ita         hin - Hindi        pol - Polish      tur - Turkish
+                   hun - Hungarian                       ukr - Ukrainian
+                   ind - Indonesian                      vie - Vietnamese
+```
+
+> [!NOTE]
+> When using subtitles on Windows, please note that the default Windows Media Player may not display them correctly. We recommend using VLC Media Player for proper subtitle display and optimal playback experience.
+
+
+> [!IMPORTANT]
+> Language code availability may vary by site. Some platforms might:
+>
+> - Use different language codes
+> - Support only a subset of these languages
+> - Offer additional languages not listed here
+>
+> Check the specific site's available options if downloads fail.
+
+> [!TIP]
+> You can configure multiple languages by adding them to the lists:
+>
+> ```json
+> "specific_list_audio": ["ita", "eng", "spa"],
+> "specific_list_subtitles": ["ita", "eng", "spa"]
+> ```
+
+For the best viewing experience, we recommend using VLC Media Player:
+- Supports all video formats and codecs
+- Properly displays embedded subtitles
+- Available for all major operating systems
+- Free and open-source
+
+You can download VLC Media Player from the [official website](https://www.videolan.org/vlc/).
+
+## M3U8_PARSER Settings
+
+```json
+{
+    "force_resolution": -1,
+    "get_only_link": false
+}
+```
+
+- `force_resolution`: Force specific resolution (-1 for best available, or specify 1080, 720, 360)
+- `get_only_link`: Return M3U8 playlist/index URL instead of downloading
+
+
+# COMMAND
+
+- Download a specific season by entering its number.
+  *  **Example:** `1` will download *Season 1* only.
+
+-  Use the wildcard `*` to download every available season.
+   * **Example:** `*` will download all seasons in the series.
+
+- Specify a range of seasons using a hyphen `-`.
+   * **Example:** `1-2` will download *Seasons 1 and 2*.
+
+- Enter a season number followed by `-*` to download from that season to the end.
+  * **Example:** `3-*` will download from *Season 3* to the final season.
+
+# Examples of terminal usage
+
+```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
+
+# Disable domain search and add site name
+python test_run.py --disable_searchDomain true --add_siteName true
+```
+
+# Docker
+
+You can run the script in a docker container, to build the image just run
+
+```
+docker build -t streaming-community-api .
+```
+
+and to run it use
+
+```
+docker run -it -p 8000:8000 streaming-community-api
+```
+
+By default the videos will be saved in `/app/Video` inside the container, if you want to to save them in your machine instead of the container just run
+
+```
+docker run -it -p 8000:8000 -v /path/to/download:/app/Video streaming-community-api
+```
+
+### Docker 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
+
+## Configuration
+
+You need to create an .env file and enter your Telegram token 
+
+and user ID to authorize only one user to use it
+
+## .env Example:
+
+```
+TOKEN_TELEGRAM=IlTuo2131TOKEN$12D3Telegram
+AUTHORIZED_USER_ID=12345678 
+DEBUG=False
+```
+
+## Install Python Dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+## On Linux/MacOS:
+
+```bash
+python3 telegram_bot.py
+```
+
+# Website Status 
+
+| Website            | Status | Command |
+|:-------------------|:------:|:--------:|
+| [1337xx](https://1337xx.to/) |   ✅   | -133 |
+| [AltadefinizioneGratis](https://altadefinizionegratis.pro/) |   ✅   | -ALT |
+| [AnimeUnity](https://animeunity.so/) |   ✅   | -ANI |
+| [Ilcorsaronero](https://ilcorsaronero.link/) | ✅ | `-ILC` |
+| [CB01New](https://cb01new.media/) |   ✅   | -CB0 |
+| [DDLStreamItaly](https://ddlstreamitaly.co/) |   ✅   | -DDL |
+| [GuardaSerie](https://guardaserie.meme/) |   ✅   | -GUA |
+| [MostraGuarda](https://mostraguarda.stream/) |   ✅   | -MOS |
+| [StreamingCommunity](https://streamingcommunity.paris/) |   ✅   | -STR |
+
+
+# Tutorials 
+
+- [Windows Tutorial](https://www.youtube.com/watch?v=mZGqK4wdN-k)
+- [Linux Tutorial](https://www.youtube.com/watch?v=0qUNXPE_mTg)
+- [Pypy Tutorial](https://www.youtube.com/watch?v=C6m9ZKOK0p4)
+- [Compiled .exe Tutorial](https://www.youtube.com/watch?v=pm4lqsxkTVo)
+
+# To Do 
+
+- To Finish [website API](https://github.com/Arrowar/StreamingCommunity/tree/test_gui_1)
+- To finish [website API 2](https://github.com/hydrosh/StreamingCommunity/tree/test_gui_1)
+
+# Contributing
+
+Contributions are welcome! Steps:
+1. Fork the repository
+2. Create feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to branch (`git push origin feature/AmazingFeature`)
+5. Open Pull Request
+
+
+# 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.
+
+## Contributors
+
+<a href="https://github.com/Arrowar/StreamingCommunity/graphs/contributors" alt="View Contributors">
+  <img src="https://contrib.rocks/image?repo=Arrowar/StreamingCommunity&max=1000&columns=10" alt="Contributors" />
+</a>