StreamingCommunity 3.2.1__tar.gz → 3.2.7__tar.gz

{streamingcommunity-3.2.1/StreamingCommunity.egg-info → streamingcommunity-3.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: StreamingCommunity
-Version: 3.2.1
+Version: 3.2.7
 Home-page: https://github.com/Lovi-0/StreamingCommunity
 Author: Lovi-0
 Project-URL: Bug Reports, https://github.com/Lovi-0/StreamingCommunity/issues
@@ -18,14 +18,13 @@ Requires-Dist: certifi
 Requires-Dist: psutil
 Requires-Dist: unidecode
 Requires-Dist: curl_cffi
-Requires-Dist: dnspython
 Requires-Dist: jsbeautifier
 Requires-Dist: pathvalidate
 Requires-Dist: pycryptodomex
 Requires-Dist: ua-generator
 Requires-Dist: qbittorrent-api
 Requires-Dist: pyTelegramBotAPI
-Requires-Dist: beautifulsoup4
+Requires-Dist: pywidevine
 Dynamic: author
 Dynamic: description
 Dynamic: description-content-type
@@ -149,7 +148,7 @@ python run_streaming.py
 Download HTTP Live Streaming (HLS) content from m3u8 URLs.
 
 ```python
-from StreamingCommunity.Download import HLS_Downloader
+from StreamingCommunity import HLS_Downloader
 
 # Initialize with m3u8 URL and optional output path
 downloader = HLS_Downloader(
@@ -170,7 +169,7 @@ See [HLS example](./Test/Download/HLS.py) for complete usage.
 Direct MP4 file downloader with support for custom headers and referrer.
 
 ```python
-from StreamingCommunity.Download import MP4_downloader
+from StreamingCommunity import MP4_downloader
 
 # Basic usage
 downloader = MP4_downloader(
@@ -202,7 +201,7 @@ See [MP4 example](./Test/Download/MP4.py) for complete usage.
 Download content via torrent magnet links.
 
 ```python
-from StreamingCommunity.Download import TOR_downloader
+from StreamingCommunity import TOR_downloader
 
 # Initialize torrent client
 client = TOR_downloader()
@@ -526,8 +525,6 @@ To enable qBittorrent integration, follow the setup guide [here](https://github.
         "default_video_workser": 12,
         "default_audio_workser": 12,
         "segment_timeout": 8,
-        "download_audio": true,
-        "merge_audio": true,
         "specific_list_audio": [
             "ita"
         ],
@@ -552,7 +549,6 @@ To enable qBittorrent integration, follow the setup guide [here](https://github.
 
 #### Audio Settings
 - `download_audio`: Whether to download audio tracks
-- `merge_audio`: Whether to merge audio with video
 - `specific_list_audio`: List of audio languages to download
   * Can be changed with `--specific_list_audio ita,eng`
 
@@ -839,3 +835,5 @@ API non ufficiale per accedere ai contenuti del sito italiano StreamingCommunity
 # 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.
+
+> **Note:** DASH downloads require a valid L3 CDM (Content Decryption Module) to proceed. This project does not provide, include, or facilitate obtaining any CDM. Users are responsible for ensuring compliance with all applicable laws and requirements regarding DRM and decryption modules.

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/README.md

@@ -111,7 +111,7 @@ python run_streaming.py
 Download HTTP Live Streaming (HLS) content from m3u8 URLs.
 
 ```python
-from StreamingCommunity.Download import HLS_Downloader
+from StreamingCommunity import HLS_Downloader
 
 # Initialize with m3u8 URL and optional output path
 downloader = HLS_Downloader(
@@ -132,7 +132,7 @@ See [HLS example](./Test/Download/HLS.py) for complete usage.
 Direct MP4 file downloader with support for custom headers and referrer.
 
 ```python
-from StreamingCommunity.Download import MP4_downloader
+from StreamingCommunity import MP4_downloader
 
 # Basic usage
 downloader = MP4_downloader(
@@ -164,7 +164,7 @@ See [MP4 example](./Test/Download/MP4.py) for complete usage.
 Download content via torrent magnet links.
 
 ```python
-from StreamingCommunity.Download import TOR_downloader
+from StreamingCommunity import TOR_downloader
 
 # Initialize torrent client
 client = TOR_downloader()
@@ -488,8 +488,6 @@ To enable qBittorrent integration, follow the setup guide [here](https://github.
         "default_video_workser": 12,
         "default_audio_workser": 12,
         "segment_timeout": 8,
-        "download_audio": true,
-        "merge_audio": true,
         "specific_list_audio": [
             "ita"
         ],
@@ -514,7 +512,6 @@ To enable qBittorrent integration, follow the setup guide [here](https://github.
 
 #### Audio Settings
 - `download_audio`: Whether to download audio tracks
-- `merge_audio`: Whether to merge audio with video
 - `specific_list_audio`: List of audio languages to download
   * Can be changed with `--specific_list_audio ita,eng`
 
@@ -801,3 +798,5 @@ API non ufficiale per accedere ai contenuti del sito italiano StreamingCommunity
 # 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.
+
+> **Note:** DASH downloads require a valid L3 CDM (Content Decryption Module) to proceed. This project does not provide, include, or facilitate obtaining any CDM. Users are responsible for ensuring compliance with all applicable laws and requirements regarding DRM and decryption modules.

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Player/Helper/Vixcloud/util.py

@@ -90,9 +90,13 @@ class SeasonManager:
         Parameters:
             - number (int): The season number (1-based index)
         """
+        if len(self.seasons) == 1:
+            return self.seasons[0]
+        
         for season in self.seasons:
             if season.number == number:
                 return season
+            
         return None
     
     def __len__(self) -> int:

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Player/hdplayer.py

@@ -18,8 +18,8 @@ REQUEST_VERIFY = config_manager.get_bool('REQUESTS', 'verify')
 
 
 class VideoSource:
-    def __init__(self, proxy=None):
-        self.client = httpx.Client(headers={'user-agent': get_userAgent()}, timeout=MAX_TIMEOUT, proxy=proxy, verify=REQUEST_VERIFY)
+    def __init__(self):
+        self.client = httpx.Client(headers={'user-agent': get_userAgent()}, timeout=MAX_TIMEOUT, verify=REQUEST_VERIFY)
 
     def extractLinkHdPlayer(self, response):
         """Extract iframe source from the page."""

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Player/mixdrop.py

@@ -25,7 +25,7 @@ class VideoSource:
 
     def __init__(self, url: str):
         self.url = url
-        self.redirect_url: str | None = None
+        self.redirect_url: str = None
         self._init_headers()
 
     def _init_headers(self) -> None:

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Player/vixcloud.py

@@ -25,7 +25,7 @@ console = Console()
 
 
 class VideoSource:
-    def __init__(self, url: str, is_series: bool, media_id: int = None, proxy: str = None):
+    def __init__(self, url: str, is_series: bool, media_id: int = None):
         """
         Initialize video source for streaming site.
         
@@ -36,7 +36,6 @@ class VideoSource:
         """
         self.headers = {'user-agent': get_userAgent()}
         self.url = url
-        self.proxy = proxy
         self.is_series = is_series
         self.media_id = media_id
         self.iframe_src = None
@@ -58,7 +57,7 @@ class VideoSource:
             }
 
         try:
-            response = httpx.get(f"{self.url}/iframe/{self.media_id}", headers=self.headers, params=params, timeout=MAX_TIMEOUT, proxy=self.proxy, verify=REQUEST_VERIFY)
+            response = httpx.get(f"{self.url}/iframe/{self.media_id}", headers=self.headers, params=params, timeout=MAX_TIMEOUT, verify=REQUEST_VERIFY)
             response.raise_for_status()
 
             # Parse response with BeautifulSoup to get iframe source
@@ -123,12 +122,12 @@ class VideoSource:
             logging.error(f"Error getting content: {e}")
             raise
 
-    def get_playlist(self) -> str | None:
+    def get_playlist(self) -> str:
         """
         Generate authenticated playlist URL.
 
         Returns:
-            str | None: Fully constructed playlist URL with authentication parameters, or None if content unavailable
+            str: Fully constructed playlist URL with authentication parameters, or None if content unavailable
         """
         if not self.window_parameter:
             return None

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Site/altadefinizione/film.py

@@ -12,10 +12,9 @@ from rich.console import Console
 
 # Internal utilities
 from StreamingCommunity.Util.os import os_manager
-from StreamingCommunity.Util.message import start_message
 from StreamingCommunity.Util.headers import get_headers
+from StreamingCommunity.Util.message import start_message
 from StreamingCommunity.Util.config_json import config_manager
-from StreamingCommunity.Lib.Downloader import HLS_Downloader
 from StreamingCommunity.TelegramHelp.telegram_bot import get_bot_instance, TelegramSession
 
 
@@ -25,6 +24,7 @@ from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
 
 
 # Player
+from StreamingCommunity import HLS_Downloader
 from StreamingCommunity.Api.Player.supervideo import VideoSource
 
 

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Site/altadefinizione/series.py

@@ -11,7 +11,6 @@ from rich.prompt import Prompt
 
 # Internal utilities
 from StreamingCommunity.Util.message import start_message
-from StreamingCommunity.Lib.Downloader import HLS_Downloader
 from StreamingCommunity.TelegramHelp.telegram_bot import get_bot_instance, TelegramSession
 
 
@@ -29,6 +28,7 @@ from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
 
 
 # Player
+from StreamingCommunity import HLS_Downloader
 from StreamingCommunity.Api.Player.supervideo import VideoSource
 
 

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Site/animeunity/serie.py

@@ -12,7 +12,6 @@ from rich.prompt import Prompt
 # Internal utilities
 from StreamingCommunity.Util.os import os_manager
 from StreamingCommunity.Util.message import start_message
-from StreamingCommunity.Lib.Downloader import MP4_downloader
 from StreamingCommunity.TelegramHelp.telegram_bot import TelegramSession, get_bot_instance
 
 
@@ -24,6 +23,7 @@ from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
 
 
 # Player
+from StreamingCommunity import MP4_downloader
 from StreamingCommunity.Api.Player.vixcloud import VideoSourceAnime
 
 

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Site/animeworld/film.py

@@ -9,7 +9,6 @@ from rich.console import Console
 # Internal utilities
 from StreamingCommunity.Util.os import os_manager
 from StreamingCommunity.Util.message import start_message
-from StreamingCommunity.Lib.Downloader import MP4_downloader
 
 
 # Logic class
@@ -19,6 +18,7 @@ from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
 
 
 # Player
+from StreamingCommunity import MP4_downloader
 from StreamingCommunity.Api.Player.sweetpixel import VideoSource
 
 

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Site/animeworld/serie.py

@@ -1,7 +1,6 @@
 # 11.03.24
 
 import os
-import logging
 from typing import Tuple
 
 
@@ -13,7 +12,6 @@ from rich.prompt import Prompt
 # Internal utilities
 from StreamingCommunity.Util.os import os_manager
 from StreamingCommunity.Util.message import start_message
-from StreamingCommunity.Lib.Downloader import MP4_downloader
 
 
 # Logic class
@@ -24,6 +22,7 @@ from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
 
 
 # Player
+from StreamingCommunity import MP4_downloader
 from StreamingCommunity.Api.Player.sweetpixel import VideoSource
 
 

{streamingcommunity-3.2.1 → streamingcommunity-3.2.7}/StreamingCommunity/Api/Site/cb01new/film.py

@@ -10,7 +10,6 @@ from rich.console import Console
 # Internal utilities
 from StreamingCommunity.Util.os import os_manager
 from StreamingCommunity.Util.message import start_message
-from StreamingCommunity.Lib.Downloader import HLS_Downloader
 
 
 # Logic class
@@ -19,6 +18,7 @@ from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
 
 
 # Player
+from StreamingCommunity import HLS_Downloader
 from StreamingCommunity.Api.Player.maxstream import VideoSource
 
 

streamingcommunity-3.2.7/StreamingCommunity/Api/Site/crunchyroll/__init__.py

@@ -0,0 +1,103 @@
+# 16.03.25
+
+import sys
+import subprocess
+from urllib.parse import quote_plus
+
+
+# External library
+from rich.console import Console
+from rich.prompt import Prompt
+
+
+# Internal utilities
+from StreamingCommunity.Api.Template import get_select_title
+from StreamingCommunity.Api.Template.config_loader import site_constant
+from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
+
+
+# Logic class
+from .site import title_search, table_show_manager, media_search_manager
+from .film import download_film
+from .series import download_series
+
+# Variable
+indice = 8
+_useFor = "Anime"
+_priority = 0
+_engineDownload = "hls"
+_deprecate = False
+
+msg = Prompt()
+console = Console()
+
+
+def get_user_input(string_to_search: str = None):
+    """
+    Asks the user to input a search term.
+    Handles both Telegram bot input and direct input.
+    """
+    if string_to_search is None:
+        string_to_search = msg.ask(f"\n[purple]Insert a word to search in [green]{site_constant.SITE_NAME}").strip()
+
+    return string_to_search
+
+def process_search_result(select_title, selections=None):
+    """
+    Handles the search result and initiates the download for either a film or series.
+    
+    Parameters:
+        select_title (MediaItem): The selected media item
+        selections (dict, optional): Dictionary containing selection inputs that bypass manual input
+                                    {'season': season_selection, 'episode': episode_selection}
+    """
+    if select_title.type == 'tv':
+        season_selection = None
+        episode_selection = None
+
+        if selections:
+            season_selection = selections.get('season')
+            episode_selection = selections.get('episode')
+            
+        download_series(select_title, season_selection, episode_selection)
+    
+    else:
+        download_film(select_title)
+
+# search("Game of Thrones", selections={"season": "1", "episode": "1-3"})
+def search(string_to_search: str = None, get_onlyDatabase: bool = False, direct_item: dict = None, selections: dict = None):
+    """
+    Main function of the application for search.
+
+    Parameters:
+        string_to_search (str, optional): String to search for
+        get_onylDatabase (bool, optional): If True, return only the database object
+        direct_item (dict, optional): Direct item to process (bypass search)
+        selections (dict, optional): Dictionary containing selection inputs that bypass manual input
+                                    {'season': season_selection, 'episode': episode_selection}
+    """
+    if direct_item:
+        select_title = MediaItem(**direct_item)
+        process_search_result(select_title, selections)
+        return
+    
+    # Get the user input for the search term
+    string_to_search = get_user_input(string_to_search)
+    
+    # Perform the database search
+    len_database = title_search(quote_plus(string_to_search))
+
+    # If only the database is needed, return the manager
+    if get_onlyDatabase:
+        return media_search_manager
+    
+    if len_database > 0:
+        select_title = get_select_title(table_show_manager, media_search_manager, len_database)
+        process_search_result(select_title, selections)
+    
+    else:
+        console.print(f"\n[red]Nothing matching was found for[white]: [purple]{string_to_search}")
+
+        # If no results are found, ask again
+        string_to_search = get_user_input()
+        search(string_to_search, get_onlyDatabase, None, selections)

streamingcommunity-3.2.7/StreamingCommunity/Api/Site/crunchyroll/film.py

@@ -0,0 +1,82 @@
+# 16.03.25
+
+import os
+from urllib.parse import urlparse, parse_qs
+
+
+# External library
+from rich.console import Console
+
+
+# Internal utilities
+from StreamingCommunity.Util.message import start_message
+from StreamingCommunity.Util.config_json import config_manager
+from StreamingCommunity.Util.os import os_manager, get_wvd_path
+
+
+# Logic class
+from StreamingCommunity.Api.Template.config_loader import site_constant
+from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
+
+
+# Player
+from StreamingCommunity import DASH_Downloader
+from .util.get_license import get_playback_session, get_auth_token, generate_device_id
+
+
+# Variable
+console = Console()
+max_timeout = config_manager.get_int("REQUESTS", "timeout")
+
+
+def download_film(select_title: MediaItem) -> str:
+    """
+    Downloads a film using the provided film ID, title name, and domain.
+
+    Parameters:
+        - select_title (MediaItem): The selected media item.
+
+    Return:
+        - str: output path if successful, otherwise None
+    """
+    start_message()
+    console.print(f"[bold yellow]Download:[/bold yellow] [red]{site_constant.SITE_NAME}[/red] → [cyan]{select_title.name}[/cyan] \n")
+
+    # Define filename and path for the downloaded video
+    mp4_name = os_manager.get_sanitize_file(select_title.name) + ".mp4"
+    mp4_path = os.path.join(site_constant.MOVIE_FOLDER, mp4_name.replace(".mp4", ""))
+
+    # Generate mpd and license URLs
+    url_id = select_title.get('url').split('/')[-1]
+    device_id = generate_device_id()
+    mpd_url, mpd_headers = get_playback_session(get_auth_token(device_id), device_id, url_id)
+    parsed_url = urlparse(mpd_url)
+    query_params = parse_qs(parsed_url.query)
+
+    # Download the episode
+    r_proc = DASH_Downloader(
+        cdm_device=get_wvd_path(),
+        license_url='https://www.crunchyroll.com/license/v1/license/widevine',
+        mpd_url=mpd_url,
+        output_path=os.path.join(mp4_path, mp4_name),
+    )
+    r_proc.parse_manifest(custom_headers=mpd_headers)
+
+    # Create headers for license request
+    license_headers = mpd_headers.copy()
+    license_headers.update({
+        "x-cr-content-id": url_id,
+        "x-cr-video-token": query_params['playbackGuid'][0],
+    })
+
+    if r_proc.download_and_decrypt(custom_headers=license_headers):
+        r_proc.finalize_output()
+
+    # Get final output path and status
+    status = r_proc.get_status()
+
+    if status['error'] is not None and status['path']:
+        try: os.remove(status['path'])
+        except Exception: pass
+
+    return status['path'], status['stopped']

streamingcommunity-3.2.7/StreamingCommunity/Api/Site/crunchyroll/series.py

@@ -0,0 +1,186 @@
+# 16.03.25
+
+import os
+from typing import Tuple
+from urllib.parse import urlparse, parse_qs
+
+
+# External library
+from rich.console import Console
+from rich.prompt import Prompt
+
+
+# Internal utilities
+from StreamingCommunity.Util.message import start_message
+from StreamingCommunity.Util.os import os_manager, get_wvd_path
+
+
+# Logic class
+from .util.ScrapeSerie import GetSerieInfo, delete_stream_episode
+from StreamingCommunity.Api.Template.Util import (
+    manage_selection, 
+    map_episode_title,
+    validate_selection, 
+    validate_episode_selection, 
+    display_episodes_list
+)
+from StreamingCommunity.Api.Template.config_loader import site_constant
+from StreamingCommunity.Api.Template.Class.SearchType import MediaItem
+
+
+# Player
+from StreamingCommunity import DASH_Downloader
+from .util.get_license import get_playback_session, get_auth_token, generate_device_id
+
+
+# Variable
+msg = Prompt()
+console = Console()
+
+
+def download_video(index_season_selected: int, index_episode_selected: int, scrape_serie: GetSerieInfo) -> Tuple[str,bool]:
+    """
+    Downloads a specific episode from a specified season.
+
+    Parameters:
+        - index_season_selected (int): Season number
+        - index_episode_selected (int): Episode index
+        - scrape_serie (GetSerieInfo): Scraper object with series information
+
+    Returns:
+        - str: Path to downloaded file
+        - bool: Whether download was stopped
+    """
+    start_message()
+
+    # Get episode information
+    obj_episode = scrape_serie.selectEpisode(index_season_selected, index_episode_selected-1)
+    console.print(f"[bold yellow]Download:[/bold yellow] [red]{site_constant.SITE_NAME}[/red] → [bold magenta]{obj_episode.get('name')}[/bold magenta] ([cyan]S{index_season_selected}E{index_episode_selected}[/cyan]) \n")
+
+    # Define filename and path for the downloaded video
+    mp4_name = f"{map_episode_title(scrape_serie.series_name, index_season_selected, index_episode_selected, obj_episode.get('name'))}.mp4"
+    mp4_path = os_manager.get_sanitize_path(os.path.join(site_constant.SERIES_FOLDER, scrape_serie.series_name, f"S{index_season_selected}"))
+
+    # Generate mpd and license URLs
+    url_id = obj_episode.get('url').split('/')[-1]
+    device_id = generate_device_id()
+    token_mpd = get_auth_token(device_id)
+    
+    mpd_url, mpd_headers = get_playback_session(token_mpd, device_id, url_id)
+    parsed_url = urlparse(mpd_url)
+    query_params = parse_qs(parsed_url.query)
+
+    # Download the episode
+    r_proc = DASH_Downloader(
+        cdm_device=get_wvd_path(),
+        license_url='https://www.crunchyroll.com/license/v1/license/widevine',
+        mpd_url=mpd_url,
+        output_path=os.path.join(mp4_path, mp4_name),
+    )
+    r_proc.parse_manifest(custom_headers=mpd_headers)
+
+    # Create headers for license request
+    license_headers = mpd_headers.copy()
+    license_headers.update({
+        "x-cr-content-id": url_id,
+        "x-cr-video-token": query_params['playbackGuid'][0],
+    })
+
+    if r_proc.download_and_decrypt(custom_headers=license_headers):
+        r_proc.finalize_output()
+
+    # Get final output path and status
+    status = r_proc.get_status()
+
+    if status['error'] is not None and status['path']:
+        try: os.remove(status['path'])
+        except Exception: pass
+
+    # Delete episode stream
+    delete_stream_episode(url_id, query_params['playbackGuid'][0], mpd_headers)
+
+    return status['path'], status['stopped']
+
+def download_episode(index_season_selected: int, scrape_serie: GetSerieInfo, download_all: bool = False, episode_selection: str = None) -> None:
+    """
+    Handle downloading episodes for a specific season.
+
+    Parameters:
+        - index_season_selected (int): Season number
+        - scrape_serie (GetSerieInfo): Scraper object with series information
+        - download_all (bool): Whether to download all episodes
+        - episode_selection (str, optional): Pre-defined episode selection that bypasses manual input
+    """
+    # Get episodes for the selected season
+    episodes = scrape_serie.getEpisodeSeasons(index_season_selected)
+    episodes_count = len(episodes)
+
+    if download_all:
+        for i_episode in range(1, episodes_count + 1):
+            path, stopped = download_video(index_season_selected, i_episode, scrape_serie)
+
+            if stopped:
+                break
+
+        console.print(f"\n[red]End downloaded [yellow]season: [red]{index_season_selected}.")
+
+    else:
+        if episode_selection is not None:
+            last_command = episode_selection
+            console.print(f"\n[cyan]Using provided episode selection: [yellow]{episode_selection}")
+
+        else:
+            last_command = display_episodes_list(episodes)
+        
+        # Prompt user for episode selection
+        list_episode_select = manage_selection(last_command, episodes_count)
+        list_episode_select = validate_episode_selection(list_episode_select, episodes_count)
+
+        # Download selected episodes if not stopped
+        for i_episode in list_episode_select:
+            path, stopped = download_video(index_season_selected, i_episode, scrape_serie)
+
+            if stopped:
+                break
+
+def download_series(select_season: MediaItem, season_selection: str = None, episode_selection: str = None) -> None:
+    """
+    Handle downloading a complete series.
+
+    Parameters:
+        - select_season (MediaItem): Series metadata from search
+        - season_selection (str, optional): Pre-defined season selection that bypasses manual input
+        - episode_selection (str, optional): Pre-defined episode selection that bypasses manual input
+    """
+    scrape_serie = GetSerieInfo(select_season.url.split("/")[-1])
+
+    # Get total number of seasons 
+    seasons_count = scrape_serie.getNumberSeason()
+    
+    # Prompt user for season selection and download episodes
+    console.print(f"\n[green]Seasons found: [red]{seasons_count}")
+
+    # If season_selection is provided, use it instead of asking for input
+    if season_selection is None:
+        index_season_selected = msg.ask(
+            "\n[cyan]Insert season number [yellow](e.g., 1), [red]* [cyan]to download all seasons, "
+            "[yellow](e.g., 1-2) [cyan]for a range of seasons, or [yellow](e.g., 3-*) [cyan]to download from a specific season to the end"
+        )
+
+    else:
+        index_season_selected = season_selection
+        console.print(f"\n[cyan]Using provided season selection: [yellow]{season_selection}")
+
+    # Validate the selection
+    list_season_select = manage_selection(index_season_selected, seasons_count)
+    list_season_select = validate_selection(list_season_select, seasons_count)
+    
+    # Loop through the selected seasons and download episodes
+    for i_season in list_season_select:
+        if len(list_season_select) > 1 or index_season_selected == "*":
+            # Download all episodes if multiple seasons are selected or if '*' is used
+            download_episode(i_season, scrape_serie, download_all=True)
+            
+        else:
+            # Otherwise, let the user select specific episodes for the single season
+            download_episode(i_season, scrape_serie, download_all=False, episode_selection=episode_selection)