StreamingCommunity icon indicating copy to clipboard operation
StreamingCommunity copied to clipboard

Script to download movies and TV series.

video working

Overview.

This repository provide a simple script designed to facilitate the downloading of films and series from a popular streaming community platform. The script allows users to download individual films, entire series, or specific episodes, providing a seamless experience for content consumers.

Join us

You can chat, help improve this repo, or just hang around for some fun in the Git_StreamingCommunity Discord Server

Table of Contents

  • INSTALLATION

    • Requirement
    • Usage
    • Update
  • FEATURES

  • USAGE AND OPTIONS

  • TUTORIAL

Requirement

Make sure you have the following prerequisites installed on your system:

Installation

Install the required Python libraries using the following command:

pip install -r requirements.txt

Usage

Run the script with the following command:

On Windows:

python run.py

On Linux/MacOS:

python3 run.py

Update

Keep your script up to date with the latest features by running:

On Windows:

python update.py

On Linux/MacOS:

python3 update.py

Features

  • Download Single Film: Easily download individual movies with a simple command.
  • Download Specific Episodes or Entire Series: Seamlessly retrieve specific episodes or entire series using intuitive commands. Specify a range of episodes with square brackets notation, e.g., [5-7], or download all episodes with an asterisk (*).
  • Download Subtitles: Automatically fetch subtitles if available for downloaded content. (Note: To disable this feature, see Configuration)
  • Sync Audio and Video: Ensure perfect synchronization between audio and video during the download process for an enhanced viewing experience.

Configuration

You can change some behaviors by tweaking the configuration file.

{
  "root_path": "videos",
  "movies_folder_name": "Movies",
  "series_folder_name": "Series",
  "download_subtitles": true,
  "download_default_language": true,
  "selected_language": "English",
  "max_worker": 20
}

Options

Key Default Value Description Value Example
root_path videos Path where the script will add movies and tv series folders (see Path Examples). Do not put trailing slash. media/streamingcommunity
movies_folder_name Movies The folder name where all the movies will be placed. Do not put trailing slash. downloaded-movies
series_folder_name Series The folder name where all the TV Series will be placed. Do not put trailing slash. mytvseries
download_subtitles true Whether or not you want all the found subtitles to be downloaded. false
download_default_language true Whether or not you want to download only the default Italian audio language. false
selected_language English If "download_default_language" is False the script will download this language. French
max_worker 20 How many workers will cooperate to download .ts file. High value may slow down your pc. 30

[!IMPORTANT] If you're on Windows you'll need to use double black slashes. On Linux/MacOS, one slash is fine.

Path examples:

  • Windows: C:\\MyLibrary\\Folder or \\\\MyServer\\MyLibrary (if you want to use a network folder).
  • Linux/MacOS: Desktop/MyLibrary/Folder

Tutorial

For a detailed walkthrough, refer to the video tutorial