site specific search - panuozzo77/StreamingCommunity GitHub Wiki

Site-Specific Search

This document explains how to search for content on individual streaming sites in StreamingCommunity, allowing you to target specific sources for your media.

Overview

StreamingCommunity supports multiple streaming sites, each with its own content library and features. Site-specific search allows you to search directly on a particular site when you know where to look for your content.

Available Sites

The application dynamically loads available site modules, which may include:

  • altadefinizione: Italian streaming site for movies
  • animeunity: Anime streaming site
  • animeworld: Anime streaming site
  • cb01new: Italian streaming site for movies and TV shows
  • ddlstreamitaly: Italian streaming site requiring authentication
  • guardaserie: Italian streaming site for TV series
  • mostraguarda: Italian streaming site for movies and TV shows
  • streamingcommunity: Italian streaming site for movies and TV shows
  • 1337xx: Torrent site for various content

The exact list of available sites may vary based on your installation and updates to the project.

Using Site-Specific Search

From the Command Line

You can search a specific site directly from the command line using the site-specific argument:

python test_run.py --sitename_search -s "your search terms"

Replace sitename_search with the actual site argument (e.g., --animeworld_search).

If you don't provide search terms with the -s flag, you'll be prompted to enter them.

From the Interactive Menu

When running StreamingCommunity without command line arguments:

  1. Start the application:

    python test_run.py
  2. When presented with the site selection menu, enter the number corresponding to your desired site

  3. Enter your search terms when prompted

Site Categories

Sites are categorized by the type of content they primarily offer:

  • Film: Sites focusing on movies
  • Serie: Sites focusing on TV series
  • Anime: Sites focusing on anime content
  • Film_Serie: Sites offering both movies and TV series
  • Other: Miscellaneous sites, including torrent sites

These categories are color-coded in the interactive menu for easy identification.

Search Process

The search process varies slightly between sites but generally follows this pattern:

  1. Enter Search Terms: Type what you're looking for
  2. View Results: See a list of matching content
  3. Select Content: Choose an item from the results
  4. Select Format/Quality: Choose download options if available
  5. Download Content: The content is downloaded according to your configuration settings

Site-Specific Features

Each site may have unique features or requirements:

Movies Sites (altadefinizione, cb01new, etc.)

  • Select movie quality/resolution
  • Choose audio language if available
  • Select subtitle language if available

TV Series Sites (guardaserie, streamingcommunity, etc.)

  • Select season
  • Select episode(s)
  • Choose quality/resolution
  • Select audio and subtitle options

Anime Sites (animeunity, animeworld, etc.)

  • Select season/series
  • Select episode(s)
  • Choose subtitled or dubbed versions if available

Torrent Sites (1337xx, etc.)

  • Select from available torrents
  • View seeders/leechers information
  • Download via integrated torrent client

Authentication Requirements

Some sites require authentication:

  • ddlstreamitaly: Requires ips4_device_key, ips4_member_id, and ips4_login_key to be configured in the SITE_EXTRA section of your configuration file

Example Workflows

Searching for a Movie

  1. Select a movie site (e.g., altadefinizione):

    python test_run.py --altadefinizione_search
  2. Enter search terms:

    Enter search terms: inception
    
  3. View and select from results:

    Results for "inception":
    
    1. Inception (2010)
    2. Inception: The Cobol Job (2010)
    ...
    
    Select an item: 1
    
  4. Select quality and download options as prompted

Searching for a TV Series

  1. Select a TV series site (e.g., guardaserie):

    python test_run.py --guardaserie_search
  2. Enter search terms:

    Enter search terms: breaking bad
    
  3. View and select from results:

    Results for "breaking bad":
    
    1. Breaking Bad (2008-2013)
    2. El Camino: A Breaking Bad Movie (2019)
    ...
    
    Select an item: 1
    
  4. Select season:

    Available seasons:
    
    1. Season 1
    2. Season 2
    ...
    
    Select a season: 1
    
  5. Select episode(s) and download options as prompted

Tips for Effective Site-Specific Searching

  • Know your sites: Familiarize yourself with which sites specialize in what content
  • Use specific search terms: Include year, full title, or alternative titles for better results
  • Check multiple sites: If you don't find what you're looking for on one site, try another
  • Remember site indices: Note the index numbers of your favorite sites for quicker access

Related Documentation

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