command line arguments - panuozzo77/StreamingCommunity GitHub Wiki

Command Line Arguments

This document explains the various command line arguments available in StreamingCommunity. These arguments allow you to customize the behavior of the application directly from the command line without modifying the configuration file.

Basic Usage

The basic syntax for running StreamingCommunity with command line arguments is:

python test_run.py [options]

Available Arguments

Configuration Overrides

These arguments override settings in the configuration file:

Argument Type Description
--add_siteName boolean Enable or disable adding the site name to the file name
--not_close boolean If set to true, the script will not close the console after execution
--default_video_worker integer Number of workers for video during M3U8 download
--default_audio_worker integer Number of workers for audio during M3U8 download
--specific_list_audio string Comma-separated list of specific audio languages to download (e.g., ita,eng)
--specific_list_subtitles string Comma-separated list of specific subtitle languages to download (e.g., eng,spa)
--movie_folder_name string Custom name for the movie folder
--serie_folder_name string Custom name for the TV series folder
--anime_folder_name string Custom name for the anime folder
--map_episode_name string Template for episode filenames

Search Options

These arguments control the search behavior:

Argument Type Description
--global flag Perform a global search across multiple sites
-s, --search string Specify search terms

Site-Specific Options

The application supports site-specific search options, allowing you to limit your query to a particular website. You can use either short or long versions of these arguments, depending on your preference. These options are passed directly to the search engine of the chosen site.

Short Option Long Option
-ANI --animeworld_search
-ANI1 --animeunity_search
-STR --streamingcommunity_search
-STR1 --streamingwatch_search
-RAI --raiplay_search
-DDL --ddlstreamitaly_search
-GUA --guardaserie_search
-ALT --altadefinizione_search
-133 --1337xx_search

💡 Run the application with --help to view a dynamically generated list of all available options based on the current configuration and supported sites.

Direct Download via Command Line Arguments

StreamingCommunity now [since 05-03-2025] supports direct, non-interactive downloading of series episodes and films using command line arguments. This allows you to specify the series, site, season, and episodes to download without going through the interactive prompts.

New Arguments for Direct Download

Argument Type Description Required with --download-series
--download-series string Name of the series to download non-interactively Yes
--site string Site to download from (number corresponding to the site, e.g., 0 for StreamingCommunity) Yes
--index string Index inserted by the user (used to select the correct search result) Yes
--dl-season string Season number or range to download (e.g., 1, 1-3, or * for all seasons) Yes
--dl-episodes string Episode number(s), range, or * (e.g., 5, 4-6, or * for all episodes) Yes
  • The --site argument corresponds to the numeric site identifiers used within StreamingCommunity. For example, 0 typically refers to StreamingCommunity.
  • The --index argument should match the index number of the desired series result as displayed by the software.
  • You can specify ranges for seasons and episodes using hyphens (e.g., 1-3 means seasons 1 through 3).
  • Use * to indicate all seasons or episodes.
  • These arguments allow fully automated downloads without any interactive input.

Examples

Basic Configuration Overrides

# 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

Search Options

# Use global search with specific search terms
python test_run.py --global -s "cars"

# Search on a specific site
python test_run.py --altadefinizione_search -s "matrix"

Combined Options

You can combine multiple options in a single command:

python test_run.py --global -s "avengers" --default_video_worker 16 --specific_list_subtitles eng,ita --not_close true

Downloading

python test_run.py --download-series "Star Wars - Andor" --site 0 --index 0 --dl-season 1 --dl-episodes 2-3

Getting Help

To see all available options, use the help flag:

python test_run.py --help

This will display a complete list of arguments, including dynamically generated site-specific options.

Notes

  • Boolean arguments accept true or false values
  • String arguments with multiple values should be comma-separated without spaces
  • If you don't specify a search term with -s, you'll be prompted to enter one
  • Site-specific search options are mutually exclusive with the global search option

Related Documentation

⚠️ **GitHub.com Fallback** ⚠️