StreamingCommunity


NameStreamingCommunity JSON
Version 2.2.0 PyPI version JSON
download
home_pagehttps://github.com/Lovi-0/StreamingCommunity
SummaryNone
upload_time2025-01-01 14:28:56
maintainerNone
docs_urlNone
authorLovi-0
requires_python>=3.8
licenseNone
keywords streaming community
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <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.python.org">
    <img src="https://img.shields.io/badge/Python->=3.8-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"/>
  </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/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://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://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/network/members">
    <img src="https://img.shields.io/github/forks/Lovi-0/StreamingCommunity?style=for-the-badge" alt="Forks"/>
  </a>
  <a href="https://github.com/Lovi-0/StreamingCommunity">
    <img src="https://img.shields.io/github/languages/code-size/Lovi-0/StreamingCommunity?style=for-the-badge" alt="Code Size"/>
  </a>
  <a href="https://github.com/Lovi-0/StreamingCommunity">
    <img src="https://img.shields.io/github/repo-size/Lovi-0/StreamingCommunity?style=for-the-badge" alt="Repo Size"/>
  </a>
</p>

# 📋 Table of Contents

- 🌐 [Website available](#website-status)
- 🛠️ [Installation](#installation)
    - 📦 [PyPI Installation](#1-pypi-installation)
    - 🔄 [Automatic Installation](#2-automatic-installation)
    - 📝 [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

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

## 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)",
    "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/>`

- `not_close`: If true, continues running after downloading

    ### 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).

<br>

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

<br>

## 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 display issues


<br>

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

> [!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"]
> ```

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

<br>

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

<br>

# 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             |   ✅   |
| Altadefinizione    |   ✅   |
| AnimeUnity         |   ✅   |
| Ilcorsaronero      |   ✅   |
| CB01New            |   ✅   |
| DDLStreamItaly     |   ✅   |
| GuardaSerie        |   ✅   |
| MostraGuarda       |   ✅   |
| StreamingCommunity |   ✅   |

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



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Lovi-0/StreamingCommunity",
    "name": "StreamingCommunity",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "streaming community",
    "author": "Lovi-0",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/6b/a9/c6df25a84d01bf02f2229e4ca8bb01dac9e31f5c27e0fd92bd1565b1c774/StreamingCommunity-2.2.0.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\r\n  <img src=\"https://i.ibb.co/PFnjvBc/immagine-2024-12-26-180318047.png\" alt=\"Project Logo\" width=\"700\"/>\r\n</p>\r\n\r\n<p align=\"center\">\r\n  <a href=\"https://pypi.org/project/streamingcommunity\">\r\n    <img src=\"https://img.shields.io/pypi/v/streamingcommunity?logo=pypi&labelColor=555555&style=for-the-badge\" alt=\"PyPI\"/>\r\n  </a>\r\n  <a href=\"https://www.python.org\">\r\n    <img src=\"https://img.shields.io/badge/Python->=3.8-3776AB?style=for-the-badge&logo=python&logoColor=white\" alt=\"Python\"/>\r\n  </a>\r\n  <a href=\"https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C\">\r\n    <img src=\"https://img.shields.io/badge/_-Donate-red.svg?logo=githubsponsors&labelColor=555555&style=for-the-badge\" alt=\"Donate\"/>\r\n  </a>\r\n  <a href=\"https://github.com/Lovi-0/StreamingCommunity/blob/main/LICENSE\">\r\n    <img src=\"https://img.shields.io/badge/License-GPL_3.0-blue.svg?style=for-the-badge\" alt=\"License\"/>\r\n  </a>\r\n  <a href=\"https://github.com/Lovi-0/StreamingCommunity/commits\">\r\n    <img src=\"https://img.shields.io/github/commit-activity/m/Lovi-0/StreamingCommunity?label=commits&style=for-the-badge\" alt=\"Commits\"/>\r\n  </a>\r\n  <a href=\"https://github.com/Lovi-0/StreamingCommunity/commits\">\r\n    <img src=\"https://img.shields.io/github/last-commit/Lovi-0/StreamingCommunity/main?label=&style=for-the-badge&display_timestamp=committer\" alt=\"Last Commit\"/>\r\n  </a>\r\n</p>\r\n\r\n<p align=\"center\">\r\n  <a href=\"https://pypi.org/project/streamingcommunity\">\r\n    <img src=\"https://img.shields.io/pypi/dm/streamingcommunity?style=for-the-badge\" alt=\"PyPI Downloads\"/>\r\n  </a>\r\n  <a href=\"https://github.com/Lovi-0/StreamingCommunity/network/members\">\r\n    <img src=\"https://img.shields.io/github/forks/Lovi-0/StreamingCommunity?style=for-the-badge\" alt=\"Forks\"/>\r\n  </a>\r\n  <a href=\"https://github.com/Lovi-0/StreamingCommunity\">\r\n    <img src=\"https://img.shields.io/github/languages/code-size/Lovi-0/StreamingCommunity?style=for-the-badge\" alt=\"Code Size\"/>\r\n  </a>\r\n  <a href=\"https://github.com/Lovi-0/StreamingCommunity\">\r\n    <img src=\"https://img.shields.io/github/repo-size/Lovi-0/StreamingCommunity?style=for-the-badge\" alt=\"Repo Size\"/>\r\n  </a>\r\n</p>\r\n\r\n# \ud83d\udccb Table of Contents\r\n\r\n- \ud83c\udf10 [Website available](#website-status)\r\n- \ud83d\udee0\ufe0f [Installation](#installation)\r\n    - \ud83d\udce6 [PyPI Installation](#1-pypi-installation)\r\n    - \ud83d\udd04 [Automatic Installation](#2-automatic-installation)\r\n    - \ud83d\udcdd [Manual Installation](#3-manual-installation)\r\n        - \ud83d\udcbb [Win 7](https://github.com/Ghost6446/StreamingCommunity_api/wiki/Installation#win-7)\r\n        - \ud83d\udcf1 [Termux](https://github.com/Ghost6446/StreamingCommunity_api/wiki/Termux)\r\n- \u2699\ufe0f [Configuration](#configuration)\r\n    - \ud83d\udd27 [Default](#default-settings)\r\n    - \ud83d\udce9 [Request](#requests-settings)\r\n    - \ud83d\udce5 [Download](#m3u8_download-settings)\r\n    - \ud83d\udd0d [Parser](#m3u8_parser-settings)\r\n- \ud83d\udc33 [Docker](#docker)\r\n- \ud83c\udf93 [Tutorial](#tutorials)\r\n- \ud83d\udcdd [To do](#to-do)\r\n- \ud83d\udcac [Support](#support)\r\n- \ud83e\udd1d [Contribute](#contributing)\r\n- \u26a0\ufe0f [Disclaimer](#disclaimer)\r\n- \u26a1 [Contributors](#contributors)  \r\n\r\n# Installation\r\n\r\n## 1. PyPI Installation\r\n\r\nInstall directly from PyPI:\r\n\r\n```bash\r\npip install StreamingCommunity\r\n```\r\n\r\n### Creating a Run Script\r\n\r\nCreate `run_streaming.py`:\r\n\r\n```python\r\nfrom StreamingCommunity.run import main\r\n\r\nif __name__ == \"__main__\":\r\n    main()\r\n```\r\n\r\nRun the script:\r\n```bash\r\npython run_streaming.py\r\n```\r\n\r\n## Updating via PyPI\r\n\r\n```bash\r\npip install --upgrade StreamingCommunity\r\n```\r\n\r\n## 2. Automatic Installation\r\n\r\n### Supported Operating Systems \ud83d\udcbf\r\n\r\n| OS              | Automatic Installation Support |\r\n|:----------------|:------------------------------:|\r\n| Windows 10/11   |              \u2714\ufe0f              |\r\n| Windows 7       |              \u274c              |\r\n| Debian Linux    |              \u2714\ufe0f              |\r\n| Arch Linux      |              \u2714\ufe0f              |\r\n| CentOS Stream 9 |              \u2714\ufe0f              |\r\n| FreeBSD         |              \u23f3              |\r\n| MacOS           |              \u2714\ufe0f              |\r\n| Termux          |              \u274c              |\r\n\r\n### Installation Steps\r\n\r\n#### On Windows:\r\n\r\n```powershell\r\n.\\Installer\\win_install.bat\r\n```\r\n\r\n#### On Linux/MacOS/BSD:\r\n\r\n```bash\r\nsudo chmod +x Installer/unix_install.sh && ./Installer/unix_install.sh\r\n```\r\n\r\n### Usage\r\n\r\n#### On Windows:\r\n\r\n```powershell\r\npython .\\test_run.py\r\n```\r\n\r\nor\r\n\r\n```powershell\r\nsource .venv/bin/activate && python test_run.py && deactivate\r\n```\r\n\r\n#### On Linux/MacOS/BSD:\r\n\r\n```bash\r\n./test_run.py\r\n```\r\n\r\n## 3. Manual Installation\r\n\r\n### Requirements \ud83d\udccb\r\n\r\nPrerequisites:\r\n* [Python](https://www.python.org/downloads/) > 3.8\r\n* [FFmpeg](https://www.gyan.dev/ffmpeg/builds/)\r\n\r\n### Install Python Dependencies\r\n\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\n### Usage\r\n\r\n#### On Windows:\r\n\r\n```powershell\r\npython test_run.py\r\n```\r\n\r\n#### On Linux/MacOS:\r\n\r\n```bash\r\npython3 test_run.py\r\n```\r\n\r\n## Update\r\n\r\nKeep your script up to date with the latest features by running:\r\n\r\n### On Windows:\r\n\r\n```powershell\r\npython update.py\r\n```\r\n\r\n### On Linux/MacOS:\r\n\r\n```bash\r\npython3 update.py\r\n```\r\n\r\n<br>\r\n\r\n# Configuration\r\n\r\nYou can change some behaviors by tweaking the configuration file.\r\n\r\nThe configuration file is divided into several main sections:\r\n\r\n## DEFAULT Settings\r\n\r\n```json\r\n{\r\n    \"root_path\": \"Video\",\r\n    \"movie_folder_name\": \"Movie\",\r\n    \"serie_folder_name\": \"TV\",\r\n    \"map_episode_name\": \"%(tv_name)_S%(season)E%(episode)_%(episode_name)\",\r\n    \"not_close\": false\r\n}\r\n```\r\n\r\n- `root_path`: Directory where all videos will be saved\r\n\r\n  ### Path examples:\r\n  * Windows: `C:\\\\MyLibrary\\\\Folder` or `\\\\\\\\MyServer\\\\MyLibrary` (if you want to use a network folder)\r\n  * Linux/MacOS: `Desktop/MyLibrary/Folder`\r\n    `<br/><br/>`\r\n\r\n- `movie_folder_name`: The name of the subdirectory where movies will be stored.\r\n- `serie_folder_name`: The name of the subdirectory where TV series will be stored.\r\n\r\n- `map_episode_name`: Template for TV series episode filenames\r\n\r\n  ### Episode name usage:\r\n\r\n  You can choose different vars:\r\n\r\n\r\n  * `%(tv_name)` : Is the name of TV Show\r\n  * `%(season)` : Is the number of the season\r\n  * `%(episode)` : Is the number of the episode\r\n  * `%(episode_name)` : Is the name of the episode\r\n    `<br/><br/>`\r\n\r\n- `not_close`: If true, continues running after downloading\r\n\r\n    ### qBittorrent Configuration\r\n\r\n    ```json\r\n    {\r\n        \"config_qbit_tor\": {\r\n            \"host\": \"192.168.1.59\",\r\n            \"port\": \"8080\",\r\n            \"user\": \"admin\",\r\n            \"pass\": \"adminadmin\"\r\n        }\r\n    }\r\n    ```\r\n\r\n    To enable qBittorrent integration, follow the setup guide [here](https://github.com/lgallard/qBittorrent-Controller/wiki/How-to-enable-the-qBittorrent-Web-UI).\r\n\r\n<br>\r\n\r\n## REQUESTS Settings\r\n\r\n```json\r\n{\r\n    \"timeout\": 20,\r\n    \"max_retry\": 3\r\n}\r\n```\r\n\r\n- `timeout`: Maximum timeout (in seconds) for each request\r\n- `max_retry`: Number of retry attempts per segment during M3U8 index download\r\n\r\n<br>\r\n\r\n## M3U8_DOWNLOAD Settings\r\n\r\n```json\r\n{\r\n    \"tqdm_delay\": 0.01,\r\n    \"tqdm_use_large_bar\": true,\r\n    \"default_video_workser\": 12,\r\n    \"default_audio_workser\": 12,\r\n    \"cleanup_tmp_folder\": true\r\n}\r\n```\r\n\r\n- `tqdm_delay`: Delay between progress bar updates\r\n- `tqdm_use_large_bar`: Use detailed progress bar (recommended for desktop) set to false for mobile\r\n- `default_video_workser`: Number of threads for video download\r\n- `default_audio_workser`: Number of threads for audio download\r\n- `cleanup_tmp_folder`: Remove temporary .ts files after download\r\n\r\n> [!IMPORTANT]\r\n> Set `tqdm_use_large_bar` to `false` when using Termux or terminals with limited width to prevent display issues\r\n\r\n\r\n<br>\r\n\r\n### Language Settings\r\n\r\nThe following codes can be used for `specific_list_audio` and `specific_list_subtitles`:\r\n\r\n```\r\nara - Arabic       eng - English      ita - Italian     por - Portuguese\r\nbaq - Basque       fil - Filipino     jpn - Japanese    rum - Romanian\r\ncat - Catalan      fin - Finnish      kan - Kannada     rus - Russian\r\nchi - Chinese      fre - French       kor - Korean      spa - Spanish\r\ncze - Czech        ger - German       mal - Malayalam   swe - Swedish\r\ndan - Danish       glg - Galician     may - Malay       tam - Tamil\r\ndut - Dutch        gre - Greek        nob - Norw. Bokm  tel - Telugu\r\n                   heb - Hebrew       nor - Norwegian    tha - Thai\r\nforced-ita         hin - Hindi        pol - Polish      tur - Turkish\r\n                   hun - Hungarian                       ukr - Ukrainian\r\n                   ind - Indonesian                      vie - Vietnamese\r\n```\r\n\r\n> [!IMPORTANT]\r\n> Language code availability may vary by site. Some platforms might:\r\n>\r\n> - Use different language codes\r\n> - Support only a subset of these languages\r\n> - Offer additional languages not listed here\r\n>\r\n> Check the specific site's available options if downloads fail.\r\n\r\n> [!TIP]\r\n> You can configure multiple languages by adding them to the lists:\r\n>\r\n> ```json\r\n> \"specific_list_audio\": [\"ita\", \"eng\", \"spa\"],\r\n> \"specific_list_subtitles\": [\"ita\", \"eng\", \"spa\"]\r\n> ```\r\n\r\n## M3U8_PARSER Settings\r\n\r\n```json\r\n{\r\n    \"force_resolution\": -1,\r\n    \"get_only_link\": false\r\n}\r\n```\r\n\r\n- `force_resolution`: Force specific resolution (-1 for best available, or specify 1080, 720, 360)\r\n- `get_only_link`: Return M3U8 playlist/index URL instead of downloading\r\n\r\n<br>\r\n\r\n# COMMAND\r\n\r\n- Download a specific season by entering its number.\r\n  *  **Example:** `1` will download *Season 1* only.\r\n\r\n-  Use the wildcard `*` to download every available season.\r\n   * **Example:** `*` will download all seasons in the series.\r\n\r\n- Specify a range of seasons using a hyphen `-`.\r\n   * **Example:** `1-2` will download *Seasons 1 and 2*.\r\n\r\n- Enter a season number followed by `-*` to download from that season to the end.\r\n  * **Example:** `3-*` will download from *Season 3* to the final season.\r\n\r\n<br>\r\n\r\n# Docker\r\n\r\nYou can run the script in a docker container, to build the image just run\r\n\r\n```\r\ndocker build -t streaming-community-api .\r\n```\r\n\r\nand to run it use\r\n\r\n```\r\ndocker run -it -p 8000:8000 streaming-community-api\r\n```\r\n\r\nBy 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\r\n\r\n```\r\ndocker run -it -p 8000:8000 -v /path/to/download:/app/Video streaming-community-api\r\n```\r\n\r\n### Docker quick setup with Make\r\n\r\nInside the Makefile (install `make`) are already configured two commands to build and run the container:\r\n\r\n```\r\nmake build-container\r\n\r\n# set your download directory as ENV variable\r\nmake LOCAL_DIR=/path/to/download run-container\r\n```\r\n\r\nThe `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.\r\n\r\n# Website Status \r\n\r\n| Website            | Status |\r\n|:-------------------|:------:|\r\n| 1337xx             |   \u2705   |\r\n| Altadefinizione    |   \u2705   |\r\n| AnimeUnity         |   \u2705   |\r\n| Ilcorsaronero      |   \u2705   |\r\n| CB01New            |   \u2705   |\r\n| DDLStreamItaly     |   \u2705   |\r\n| GuardaSerie        |   \u2705   |\r\n| MostraGuarda       |   \u2705   |\r\n| StreamingCommunity |   \u2705   |\r\n\r\n# Tutorials \r\n\r\n- [Windows Tutorial](https://www.youtube.com/watch?v=mZGqK4wdN-k)\r\n- [Linux Tutorial](https://www.youtube.com/watch?v=0qUNXPE_mTg)\r\n- [Pypy Tutorial](https://www.youtube.com/watch?v=C6m9ZKOK0p4)\r\n- [Compiled .exe Tutorial](https://www.youtube.com/watch?v=pm4lqsxkTVo)\r\n\r\n# To Do \r\n\r\n- Finish [website API](https://github.com/Lovi-0/StreamingCommunity/tree/test_gui_1)\r\n\r\n# Contributing\r\n\r\nContributions are welcome! Steps:\r\n1. Fork the repository\r\n2. Create feature branch (`git checkout -b feature/AmazingFeature`)\r\n3. Commit changes (`git commit -m 'Add some AmazingFeature'`)\r\n4. Push to branch (`git push origin feature/AmazingFeature`)\r\n5. Open Pull Request\r\n\r\n\r\n# Disclaimer\r\n\r\nThis 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.\r\n\r\n## Contributors\r\n\r\n<a href=\"https://github.com/Lovi-0/StreamingCommunity/graphs/contributors\" alt=\"View Contributors\">\r\n  <img src=\"https://contrib.rocks/image?repo=Lovi-0/StreamingCommunity&max=1000&columns=10\" alt=\"Contributors\" />\r\n</a>\r\n\r\n\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": null,
    "version": "2.2.0",
    "project_urls": {
        "Bug Reports": "https://github.com/Lovi-0/StreamingCommunity/issues",
        "Homepage": "https://github.com/Lovi-0/StreamingCommunity",
        "Source": "https://github.com/Lovi-0/StreamingCommunity"
    },
    "split_keywords": [
        "streaming",
        "community"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a042d5bce72b44783f4eadd358a9ef1a769a1befc20c7ab4a32290c274fdb284",
                "md5": "eaf927958a98b0f66f5c2f0973b716af",
                "sha256": "ddd288fc76d7101370994de318d254c51cacbefe670f0011a04e953f8bb90c38"
            },
            "downloads": -1,
            "filename": "StreamingCommunity-2.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "eaf927958a98b0f66f5c2f0973b716af",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 146267,
            "upload_time": "2025-01-01T14:28:53",
            "upload_time_iso_8601": "2025-01-01T14:28:53.544265Z",
            "url": "https://files.pythonhosted.org/packages/a0/42/d5bce72b44783f4eadd358a9ef1a769a1befc20c7ab4a32290c274fdb284/StreamingCommunity-2.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6ba9c6df25a84d01bf02f2229e4ca8bb01dac9e31f5c27e0fd92bd1565b1c774",
                "md5": "e55b80628d2fd869201ed458fc51caf2",
                "sha256": "288c158d8338f375923bfb40f86da4fa40400095778e75a557548bb92a5e975a"
            },
            "downloads": -1,
            "filename": "StreamingCommunity-2.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "e55b80628d2fd869201ed458fc51caf2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 99599,
            "upload_time": "2025-01-01T14:28:56",
            "upload_time_iso_8601": "2025-01-01T14:28:56.607500Z",
            "url": "https://files.pythonhosted.org/packages/6b/a9/c6df25a84d01bf02f2229e4ca8bb01dac9e31f5c27e0fd92bd1565b1c774/StreamingCommunity-2.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-01-01 14:28:56",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Lovi-0",
    "github_project": "StreamingCommunity",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "streamingcommunity"
}
        
Elapsed time: 1.54411s