StreamingCommunity 2.5.2__py3-none-any.whl → 2.5.5__py3-none-any.whl

StreamingCommunity/Lib/Downloader/HLS/segments.py

@@ -1,573 +1,446 @@
-# 18.04.24
-
-import os
-import sys
-import time
-import queue
-import signal
-import logging
-import binascii
-import threading
-
-from queue import PriorityQueue
-from urllib.parse import urljoin, urlparse
-from concurrent.futures import ThreadPoolExecutor, as_completed
-
-
-# External libraries
-import httpx
-from tqdm import tqdm
-
-
-# Internal utilities
-from StreamingCommunity.Util.console import console
-from StreamingCommunity.Util.headers import get_headers, random_headers
-from StreamingCommunity.Util.color import Colors
-from StreamingCommunity.Util._jsonConfig import config_manager
-from StreamingCommunity.Util.os import os_manager
-from StreamingCommunity.Util.call_stack import get_call_stack
-
-
-# Logic class
-from ...M3U8 import (
-    M3U8_Decryption,
-    M3U8_Ts_Estimator,
-    M3U8_Parser,
-    M3U8_UrlFix
-)
-from ...FFmpeg.util import print_duration_table, format_duration
-from .proxyes import main_test_proxy
-
-# Config
-TQDM_DELAY_WORKER = config_manager.get_float('M3U8_DOWNLOAD', 'tqdm_delay')
-TQDM_USE_LARGE_BAR = config_manager.get_int('M3U8_DOWNLOAD', 'tqdm_use_large_bar')
-
-REQUEST_MAX_RETRY = config_manager.get_int('REQUESTS', 'max_retry')
-REQUEST_VERIFY = False
-
-THERE_IS_PROXY_LIST = os_manager.check_file("list_proxy.txt")
-PROXY_START_MIN = config_manager.get_float('REQUESTS', 'proxy_start_min')
-PROXY_START_MAX = config_manager.get_float('REQUESTS', 'proxy_start_max')
-
-DEFAULT_VIDEO_WORKERS = config_manager.get_int('M3U8_DOWNLOAD', 'default_video_workser')
-DEFAULT_AUDIO_WORKERS = config_manager.get_int('M3U8_DOWNLOAD', 'default_audio_workser')
-
-
-
-# Variable
-max_timeout = config_manager.get_int("REQUESTS", "timeout")
-
-
-
-class M3U8_Segments:
-    def __init__(self, url: str, tmp_folder: str, is_index_url: bool = True):
-        """
-        Initializes the M3U8_Segments object.
-
-        Parameters:
-            - url (str): The URL of the M3U8 playlist.
-            - tmp_folder (str): The temporary folder to store downloaded segments.
-            - is_index_url (bool): Flag indicating if `m3u8_index` is a URL (default True).
-        """
-        self.url = url
-        self.tmp_folder = tmp_folder
-        self.is_index_url = is_index_url
-        self.expected_real_time = None
-        self.max_timeout = max_timeout
-        
-        self.tmp_file_path = os.path.join(self.tmp_folder, "0.ts")
-        os.makedirs(self.tmp_folder, exist_ok=True)
-
-        # Util class
-        self.decryption: M3U8_Decryption = None 
-        self.class_ts_estimator = M3U8_Ts_Estimator(0) 
-        self.class_url_fixer = M3U8_UrlFix(url)
-
-        # Sync
-        self.queue = PriorityQueue()
-        self.stop_event = threading.Event()
-        self.downloaded_segments = set()
-        self.base_timeout = 1.0
-        self.current_timeout = 5.0
-
-        # Stopping
-        self.interrupt_flag = threading.Event()
-        self.download_interrupted = False
-
-        # OTHER INFO
-        self.info_maxRetry = 0
-        self.info_nRetry = 0
-        self.info_nFailed = 0
-
-    def __get_key__(self, m3u8_parser: M3U8_Parser) -> bytes:
-        """
-        Retrieves the encryption key from the M3U8 playlist.
-
-        Parameters:
-            - m3u8_parser (M3U8_Parser): The parser object containing M3U8 playlist information.
-
-        Returns:
-            bytes: The encryption key in bytes.
-        """
-
-        # Construct the full URL of the key
-        key_uri = urljoin(self.url, m3u8_parser.keys.get('uri'))
-        parsed_url = urlparse(key_uri)
-        self.key_base_url = f"{parsed_url.scheme}://{parsed_url.netloc}/"
-        logging.info(f"Uri key: {key_uri}")
-
-        # Make request to get porxy
-        try:
-            response = httpx.get(
-                url=key_uri, 
-                headers={'User-Agent': get_headers()},
-                timeout=max_timeout
-            )
-            response.raise_for_status()
-
-        except Exception as e:
-            raise Exception(f"Failed to fetch key from {key_uri}: {e}")
-
-        # Convert the content of the response to hexadecimal and then to bytes
-        hex_content = binascii.hexlify(response.content).decode('utf-8')
-        byte_content = bytes.fromhex(hex_content)
-        logging.info(f"URI: Hex content: {hex_content}, Byte content: {byte_content}")
-        
-        #console.print(f"[cyan]Find key: [red]{hex_content}")
-        return byte_content
-    
-    def parse_data(self, m3u8_content: str) -> None:
-        """
-        Parses the M3U8 content to extract segment information.
-
-        Parameters:
-            - m3u8_content (str): The content of the M3U8 file.
-        """
-        m3u8_parser = M3U8_Parser()
-        m3u8_parser.parse_data(uri=self.url, raw_content=m3u8_content)
-
-        self.expected_real_time = m3u8_parser.get_duration(return_string=False)
-        self.expected_real_time_s = m3u8_parser.duration
-
-        # Check if there is an encryption key in the playlis
-        if m3u8_parser.keys is not None:
-            try:
-
-                # Extract byte from the key
-                key = self.__get_key__(m3u8_parser)
-                
-            except Exception as e:
-                raise Exception(f"Failed to retrieve encryption key {e}.")
-
-            iv = m3u8_parser.keys.get('iv')
-            method = m3u8_parser.keys.get('method')
-            logging.info(f"M3U8_Decryption - IV: {iv}, method: {method}")
-
-            # Create a decryption object with the key and set the method
-            self.decryption = M3U8_Decryption(key, iv, method)
-
-        # Store the segment information parsed from the playlist
-        self.segments = m3u8_parser.segments
-
-        # Fix URL if it is incomplete (missing 'http')
-        for i in range(len(self.segments)):
-            segment_url = self.segments[i]
-
-            if "http" not in segment_url:
-                self.segments[i] = self.class_url_fixer.generate_full_url(segment_url)
-                logging.info(f"Generated new URL: {self.segments[i]}, from: {segment_url}")
-
-        # Update segments for estimator
-        self.class_ts_estimator.total_segments = len(self.segments)
-        logging.info(f"Segmnets to download: [{len(self.segments)}]")
-
-        # Proxy
-        if THERE_IS_PROXY_LIST:
-            console.log("[red]Start validation proxy.")
-            self.valid_proxy = main_test_proxy(self.segments[0])
-            console.log(f"[cyan]N. Valid ip: [red]{len(self.valid_proxy)}")
-
-            if len(self.valid_proxy) == 0:
-                sys.exit(0)
-
-    def get_info(self) -> None:
-        """
-        Makes a request to the index M3U8 file to get information about segments.
-        """
-        if self.is_index_url:
-
-            try:
-
-                # Send a GET request to retrieve the index M3U8 file
-                response = httpx.get(
-                    self.url, 
-                    headers={'User-Agent': get_headers()}, 
-                    timeout=max_timeout,
-                    follow_redirects=True
-                )
-                response.raise_for_status()
-
-                # Save the M3U8 file to the temporary folder
-                path_m3u8_file = os.path.join(self.tmp_folder, "playlist.m3u8")
-                open(path_m3u8_file, "w+").write(response.text) 
-
-                # Parse the text from the M3U8 index file
-                self.parse_data(response.text)  
-
-            except Exception as e:
-                print(f"Error during M3U8 index request: {e}")
-
-        else:
-            # Parser data of content of index pass in input to class
-            self.parse_data(self.url)
-    
-    def setup_interrupt_handler(self):
-        """
-        Set up a signal handler for graceful interruption.
-        """
-        def interrupt_handler(signum, frame):
-            if not self.interrupt_flag.is_set():
-                console.log("\n[red] Stopping download gracefully...")
-                self.interrupt_flag.set()
-                self.download_interrupted = True
-                self.stop_event.set()
-
-        if threading.current_thread() is threading.main_thread():
-            signal.signal(signal.SIGINT, interrupt_handler)
-        else:
-            print("Signal handler must be set in the main thread")
-
-    def make_requests_stream(self, ts_url: str, index: int, progress_bar: tqdm, backoff_factor: float = 1.5) -> None:
-        """
-        Downloads a TS segment and adds it to the segment queue with retry logic.
-
-        Parameters:
-            - ts_url (str): The URL of the TS segment.
-            - index (int): The index of the segment.
-            - progress_bar (tqdm): Progress counter for tracking download progress.
-            - retries (int): The number of times to retry on failure (default is 3).
-            - backoff_factor (float): The backoff factor for exponential backoff (default is 1.5 seconds).
-        """       
-        for attempt in range(REQUEST_MAX_RETRY):
-            if self.interrupt_flag.is_set():
-                return
-            
-            try:
-                start_time = time.time()
-                
-                # Make request to get content
-                if THERE_IS_PROXY_LIST:
-
-                    # Get proxy from list
-                    proxy = self.valid_proxy[index % len(self.valid_proxy)]
-                    logging.info(f"Use proxy: {proxy}")
-
-                    with httpx.Client(proxies=proxy, verify=REQUEST_VERIFY) as client:  
-                        if 'key_base_url' in self.__dict__:
-                            response = client.get(
-                                url=ts_url, 
-                                headers=random_headers(self.key_base_url), 
-                                timeout=max_timeout, 
-                                follow_redirects=True
-                            )
-                             
-                        else:
-                            response = client.get(
-                                url=ts_url, 
-                                headers={'User-Agent': get_headers()}, 
-                                timeout=max_timeout, 
-                                follow_redirects=True
-                            )
-
-                else:
-                    with httpx.Client(verify=REQUEST_VERIFY) as client_2:
-                        if 'key_base_url' in self.__dict__:
-                            response = client_2.get(
-                                url=ts_url, 
-                                headers=random_headers(self.key_base_url), 
-                                timeout=max_timeout, 
-                                follow_redirects=True
-                            )
-
-                        else:
-                            response = client_2.get(
-                                url=ts_url, 
-                                headers={'User-Agent': get_headers()}, 
-                                timeout=max_timeout, 
-                                follow_redirects=True
-                            )
-
-                # Validate response and content
-                response.raise_for_status()
-                segment_content = response.content
-                content_size = len(segment_content)
-                duration = time.time() - start_time
-
-                # Decrypt if needed and verify decrypted content
-                if self.decryption is not None:
-                    try:
-                        segment_content = self.decryption.decrypt(segment_content)
-                        
-                    except Exception as e:
-                        logging.error(f"Decryption failed for segment {index}: {str(e)}")
-                        self.interrupt_flag.set()   # Interrupt the download process
-                        self.stop_event.set()       # Trigger the stopping event for all threads
-                        break                       # Stop the current task immediately
-
-                # Update progress and queue
-                self.class_ts_estimator.update_progress_bar(content_size, duration, progress_bar)
-
-                # Add the segment to the queue
-                self.queue.put((index, segment_content))
-
-                # Track successfully downloaded segments
-                self.downloaded_segments.add(index)  
-                progress_bar.update(1)
-
-                # Break out of the loop on success
-                return
-
-            except Exception as e:
-                logging.info(f"Attempt {attempt + 1} failed for segment {index} - '{ts_url}': {e}")
-                
-                # Update stat variable class
-                if attempt > self.info_maxRetry:
-                    self.info_maxRetry = ( attempt + 1 )
-                self.info_nRetry += 1
-
-                if attempt + 1 == REQUEST_MAX_RETRY:
-                    console.log(f"[red]Final retry failed for segment: {index}")
-                    self.queue.put((index, None))  # Marker for failed segment
-                    progress_bar.update(1)
-                    self.info_nFailed += 1
-
-                    #break
-                
-                sleep_time = backoff_factor * (2 ** attempt)
-                logging.info(f"Retrying segment {index} in {sleep_time} seconds...")
-                time.sleep(sleep_time)
-
-    def write_segments_to_file(self):
-        """
-        Writes segments to file with additional verification.
-        """
-        buffer = {}
-        expected_index = 0
-        segments_written = set()
-        
-        with open(self.tmp_file_path, 'wb') as f:
-            while not self.stop_event.is_set() or not self.queue.empty():
-                if self.interrupt_flag.is_set():
-                    break
-                
-                try:
-                    index, segment_content = self.queue.get(timeout=self.current_timeout)
-
-                    # Successful queue retrieval: reduce timeout
-                    self.current_timeout = max(self.base_timeout, self.current_timeout / 2)
-
-                    # Handle failed segments
-                    if segment_content is None:
-                        if index == expected_index:
-                            expected_index += 1
-                        continue
-
-                    # Write segment if it's the next expected one
-                    if index == expected_index:
-                        f.write(segment_content)
-                        segments_written.add(index)
-                        f.flush()
-                        expected_index += 1
-
-                        # Write any buffered segments that are now in order
-                        while expected_index in buffer:
-                            next_segment = buffer.pop(expected_index)
-
-                            if next_segment is not None:
-                                f.write(next_segment)
-                                segments_written.add(expected_index)
-                                f.flush()
-
-                            expected_index += 1
-                    
-                    else:
-                        buffer[index] = segment_content
-
-                except queue.Empty:
-                    self.current_timeout = min(self.max_timeout, self.current_timeout * 1.25)
-
-                    if self.stop_event.is_set():
-                        break
-
-                except Exception as e:
-                    logging.error(f"Error writing segment {index}: {str(e)}")
-    
-    def download_streams(self, description: str, type: str):
-        """
-        Downloads all TS segments in parallel and writes them to a file.
-
-        Parameters:
-            - description: Description to insert on tqdm bar
-            - type (str): Type of download: 'video' or 'audio'
-        """
-        self.setup_interrupt_handler()
-
-        # Get config site from prev stack
-        frames = get_call_stack()
-        logging.info(f"Extract info from: {frames}")
-        config_site = str(frames[-4]['folder_base'])
-        logging.info(f"Use frame: {frames[-1]}")
-
-        # Workers to use for downloading
-        TQDM_MAX_WORKER = 0
-
-        # Select audio workers from folder of frames stack prev call.
-        try:
-            VIDEO_WORKERS = int(config_manager.get_dict('SITE', config_site)['video_workers'])
-        except:
-            #VIDEO_WORKERS = os.cpu_count()
-            VIDEO_WORKERS = DEFAULT_VIDEO_WORKERS
-
-        try:
-            AUDIO_WORKERS = int(config_manager.get_dict('SITE', config_site)['audio_workers'])
-        except:
-            #AUDIO_WORKERS = os.cpu_count()
-            AUDIO_WORKERS = DEFAULT_AUDIO_WORKERS
-
-        # Differnt workers for audio and video
-        if "video" in str(type):
-            TQDM_MAX_WORKER = VIDEO_WORKERS
-
-        if "audio" in str(type):
-            TQDM_MAX_WORKER = AUDIO_WORKERS
-
-        #console.print(f"[cyan]Video workers[white]: [green]{VIDEO_WORKERS} [white]| [cyan]Audio workers[white]: [green]{AUDIO_WORKERS}")
-
-        # Custom bar for mobile and pc
-        if TQDM_USE_LARGE_BAR:
-            bar_format = (
-                f"{Colors.YELLOW}[HLS] {Colors.WHITE}({Colors.CYAN}{description}{Colors.WHITE}): "
-                f"{Colors.RED}{{percentage:.2f}}% "
-                f"{Colors.MAGENTA}{{bar}} "
-                f"{Colors.WHITE}[ {Colors.YELLOW}{{n_fmt}}{Colors.WHITE} / {Colors.RED}{{total_fmt}} {Colors.WHITE}] "
-                f"{Colors.YELLOW}{{elapsed}} {Colors.WHITE}< {Colors.CYAN}{{remaining}}{{postfix}} {Colors.WHITE}]"
-            )
-        else:
-            bar_format = (
-                f"{Colors.YELLOW}Proc{Colors.WHITE}: "
-                f"{Colors.RED}{{percentage:.2f}}% "
-                f"{Colors.WHITE}| "
-                f"{Colors.CYAN}{{remaining}}{{postfix}} {Colors.WHITE}]"
-            )
-
-        # Create progress bar
-        progress_bar = tqdm(
-            total=len(self.segments), 
-            unit='s',
-            ascii='░▒█',
-            bar_format=bar_format,
-            mininterval=0.05
-        )
-
-        try:
-
-            # Start writer thread
-            writer_thread = threading.Thread(target=self.write_segments_to_file)
-            writer_thread.daemon = True
-            writer_thread.start()
-
-            # Configure workers and delay
-            max_workers = len(self.valid_proxy) if THERE_IS_PROXY_LIST else TQDM_MAX_WORKER
-            delay = max(PROXY_START_MIN, min(PROXY_START_MAX, 1 / (len(self.valid_proxy) + 1))) if THERE_IS_PROXY_LIST else TQDM_DELAY_WORKER
-
-            # Download segments with completion verification
-            with ThreadPoolExecutor(max_workers=max_workers) as executor:
-                futures = []
-                for index, segment_url in enumerate(self.segments):
-                    # Check for interrupt before submitting each task
-                    if self.interrupt_flag.is_set():
-                        break
-
-                    time.sleep(delay)
-                    futures.append(executor.submit(self.make_requests_stream, segment_url, index, progress_bar))
-
-                # Wait for futures with interrupt handling
-                for future in as_completed(futures):
-                    if self.interrupt_flag.is_set():
-                        break
-                    try:
-                        future.result()
-                    except Exception as e:
-                        logging.error(f"Error in download thread: {str(e)}")
-
-                # Interrupt handling for missing segments
-                if not self.interrupt_flag.is_set():
-                    total_segments = len(self.segments)
-                    completed_segments = len(self.downloaded_segments)
-                    
-                    if completed_segments < total_segments:
-                        missing_segments = set(range(total_segments)) - self.downloaded_segments
-                        logging.warning(f"Missing segments: {sorted(missing_segments)}")
-                        
-                        # Retry missing segments with interrupt check
-                        for index in missing_segments:
-                            if self.interrupt_flag.is_set():
-                                break
-
-                            try:
-                                self.make_requests_stream(self.segments[index], index, progress_bar)
-                                
-                            except Exception as e:
-                                logging.error(f"Failed to retry segment {index}: {str(e)}")
-
-        except Exception as e:
-            logging.error(f"Download failed: {str(e)}")
-            raise
-
-        finally:
-
-            # Clean up resources
-            self.stop_event.set()
-            writer_thread.join(timeout=30)
-            progress_bar.close()
-
-            # Check if download was interrupted
-            if self.download_interrupted:
-                console.log("[red] Download was manually stopped.")
-
-        # Clean up
-        self.stop_event.set()
-        writer_thread.join(timeout=30)
-        progress_bar.close()
-
-        # Final verification
-        try:
-            final_completion = (len(self.downloaded_segments) / total_segments) * 100
-            if final_completion < 99.9:  # Less than 99.9% complete
-                missing = set(range(total_segments)) - self.downloaded_segments
-                raise Exception(f"Download incomplete ({final_completion:.1f}%). Missing segments: {sorted(missing)}")
-            
-        except:
-            pass
-
-        # Verify output file
-        if not os.path.exists(self.tmp_file_path):
-            raise Exception("Output file missing")
-        
-        file_size = os.path.getsize(self.tmp_file_path)
-        if file_size == 0:
-            raise Exception("Output file is empty")
-
-        # Display additional info when there is missing stream file
-        if self.info_nFailed > 0:
-
-            # Get expected time
-            ex_hours, ex_minutes, ex_seconds = format_duration(self.expected_real_time_s)
-            ex_formatted_duration = f"[yellow]{int(ex_hours)}[red]h [yellow]{int(ex_minutes)}[red]m [yellow]{int(ex_seconds)}[red]s"
-            console.print(f"[cyan]Max retry per URL[white]: [green]{self.info_maxRetry}[green] [white]| [cyan]Total retry done[white]: [green]{self.info_nRetry}[green] [white]| [cyan]Missing TS: [red]{self.info_nFailed} [white]| [cyan]Duration: {print_duration_table(self.tmp_file_path, None, True)} [white]| [cyan]Expected duation: {ex_formatted_duration} \n")
-
-            if self.info_nRetry >= len(self.segments) * 0.3:
-                console.print("[yellow]⚠ Warning:[/yellow] Too many retries detected! Consider reducing the number of [cyan]workers[/cyan] in the [magenta]config.json[/magenta] file. This will impact [bold]performance[/bold]. \n")
-
-        # Info to return
-        return {'type': type, 'nFailed': self.info_nFailed}
+# 18.04.24
+
+import os
+import sys
+import time
+import queue
+import signal
+import logging
+import binascii
+import threading
+from queue import PriorityQueue
+from urllib.parse import urljoin, urlparse
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from typing import Dict
+
+
+# External libraries
+import httpx
+from tqdm import tqdm
+
+
+# Internal utilities
+from StreamingCommunity.Util.color import Colors
+from StreamingCommunity.Util.console import console
+from StreamingCommunity.Util.headers import get_headers, random_headers
+from StreamingCommunity.Util._jsonConfig import config_manager
+from StreamingCommunity.Util.os import os_manager
+
+
+# Logic class
+from ...M3U8 import (
+    M3U8_Decryption,
+    M3U8_Ts_Estimator,
+    M3U8_Parser,
+    M3U8_UrlFix
+)
+from .proxyes import main_test_proxy
+
+# Config
+TQDM_DELAY_WORKER = config_manager.get_float('M3U8_DOWNLOAD', 'tqdm_delay')
+USE_LARGE_BAR = not ("android" in sys.platform or "ios" in sys.platform)
+REQUEST_MAX_RETRY = config_manager.get_int('REQUESTS', 'max_retry')
+REQUEST_VERIFY = False
+THERE_IS_PROXY_LIST = os_manager.check_file("list_proxy.txt")
+PROXY_START_MIN = config_manager.get_float('REQUESTS', 'proxy_start_min')
+PROXY_START_MAX = config_manager.get_float('REQUESTS', 'proxy_start_max')
+DEFAULT_VIDEO_WORKERS = config_manager.get_int('M3U8_DOWNLOAD', 'default_video_workser')
+DEFAULT_AUDIO_WORKERS = config_manager.get_int('M3U8_DOWNLOAD', 'default_audio_workser')
+MAX_TIMEOOUT = config_manager.get_int("REQUESTS", "timeout")
+
+
+
+class M3U8_Segments:
+    def __init__(self, url: str, tmp_folder: str, is_index_url: bool = True):
+        """
+        Initializes the M3U8_Segments object.
+
+        Parameters:
+            - url (str): The URL of the M3U8 playlist.
+            - tmp_folder (str): The temporary folder to store downloaded segments.
+            - is_index_url (bool): Flag indicating if `m3u8_index` is a URL (default True).
+        """
+        self.url = url
+        self.tmp_folder = tmp_folder
+        self.is_index_url = is_index_url
+        self.expected_real_time = None
+        self.tmp_file_path = os.path.join(self.tmp_folder, "0.ts")
+        os.makedirs(self.tmp_folder, exist_ok=True)
+
+        # Util class
+        self.decryption: M3U8_Decryption = None 
+        self.class_ts_estimator = M3U8_Ts_Estimator(0, self) 
+        self.class_url_fixer = M3U8_UrlFix(url)
+
+        # Sync
+        self.queue = PriorityQueue()
+        self.stop_event = threading.Event()
+        self.downloaded_segments = set()
+        self.base_timeout = 0.5
+        self.current_timeout = 3.0
+
+        # Stopping
+        self.interrupt_flag = threading.Event()
+        self.download_interrupted = False
+
+        # OTHER INFO
+        self.info_maxRetry = 0
+        self.info_nRetry = 0
+        self.info_nFailed = 0
+
+        self.active_retries = 0 
+        self.active_retries_lock = threading.Lock()
+
+    def __get_key__(self, m3u8_parser: M3U8_Parser) -> bytes:
+        key_uri = urljoin(self.url, m3u8_parser.keys.get('uri'))
+        parsed_url = urlparse(key_uri)
+        self.key_base_url = f"{parsed_url.scheme}://{parsed_url.netloc}/"
+        
+        try:
+            client_params = {'headers': {'User-Agent': get_headers()}, 'timeout': MAX_TIMEOOUT}
+            response = httpx.get(url=key_uri, **client_params)
+            response.raise_for_status()
+
+            hex_content = binascii.hexlify(response.content).decode('utf-8')
+            return bytes.fromhex(hex_content)
+            
+        except Exception as e:
+            raise Exception(f"Failed to fetch key: {e}")
+    
+    def parse_data(self, m3u8_content: str) -> None:
+        m3u8_parser = M3U8_Parser()
+        m3u8_parser.parse_data(uri=self.url, raw_content=m3u8_content)
+
+        self.expected_real_time_s = m3u8_parser.duration
+
+        if m3u8_parser.keys:
+            key = self.__get_key__(m3u8_parser)    
+            self.decryption = M3U8_Decryption(
+                key, 
+                m3u8_parser.keys.get('iv'), 
+                m3u8_parser.keys.get('method')
+            )
+
+        self.segments = [
+            self.class_url_fixer.generate_full_url(seg)
+            if "http" not in seg else seg
+            for seg in m3u8_parser.segments
+        ]
+        self.class_ts_estimator.total_segments = len(self.segments)
+
+        # Proxy
+        if THERE_IS_PROXY_LIST:
+            console.log("[red]Start validation proxy.")
+            self.valid_proxy = main_test_proxy(self.segments[0])
+            console.log(f"[cyan]N. Valid ip: [red]{len(self.valid_proxy)}")
+
+            if len(self.valid_proxy) == 0:
+                sys.exit(0)
+
+    def get_info(self) -> None:
+        if self.is_index_url:
+            try:
+                client_params = {'headers': {'User-Agent': get_headers()}, 'timeout': MAX_TIMEOOUT}
+                response = httpx.get(self.url, **client_params)
+                response.raise_for_status()
+                
+                self.parse_data(response.text)
+                with open(os.path.join(self.tmp_folder, "playlist.m3u8"), "w") as f:
+                    f.write(response.text)
+                    
+            except Exception as e:
+                raise RuntimeError(f"M3U8 info retrieval failed: {e}")
+    
+    def setup_interrupt_handler(self):
+        """
+        Set up a signal handler for graceful interruption.
+        """
+        def interrupt_handler(signum, frame):
+            if not self.interrupt_flag.is_set():
+                console.log("\n[red] Stopping download gracefully...")
+                self.interrupt_flag.set()
+                self.download_interrupted = True
+                self.stop_event.set()
+
+        if threading.current_thread() is threading.main_thread():
+            signal.signal(signal.SIGINT, interrupt_handler)
+        else:
+            print("Signal handler must be set in the main thread")
+
+    def _get_http_client(self, index: int = None):
+        client_params = {
+            'headers': random_headers(self.key_base_url) if hasattr(self, 'key_base_url') else {'User-Agent': get_headers()},
+            'timeout': MAX_TIMEOOUT,
+            'follow_redirects': True,
+            'http2': False
+        }
+        
+        if THERE_IS_PROXY_LIST and index is not None and hasattr(self, 'valid_proxy'):
+            client_params['proxies'] = self.valid_proxy[index % len(self.valid_proxy)]
+        
+        return httpx.Client(**client_params)
+                            
+    def download_segment(self, ts_url: str, index: int, progress_bar: tqdm, backoff_factor: float = 1.1) -> None:
+        """
+        Downloads a TS segment and adds it to the segment queue with retry logic.
+
+        Parameters:
+            - ts_url (str): The URL of the TS segment.
+            - index (int): The index of the segment.
+            - progress_bar (tqdm): Progress counter for tracking download progress.
+            - backoff_factor (float): The backoff factor for exponential backoff (default is 1.5 seconds).
+        """       
+        for attempt in range(REQUEST_MAX_RETRY):
+            if self.interrupt_flag.is_set():
+                return
+            
+            try:
+                with self._get_http_client(index) as client:
+                    start_time = time.time()
+                    response = client.get(ts_url)
+        
+                    # Validate response and content
+                    response.raise_for_status()
+                    segment_content = response.content
+                    content_size = len(segment_content)
+                    duration = time.time() - start_time
+
+                    # Decrypt if needed and verify decrypted content
+                    if self.decryption is not None:
+                        try:
+                            segment_content = self.decryption.decrypt(segment_content)
+                            
+                        except Exception as e:
+                            logging.error(f"Decryption failed for segment {index}: {str(e)}")
+                            self.interrupt_flag.set()   # Interrupt the download process
+                            self.stop_event.set()       # Trigger the stopping event for all threads
+                            break                       # Stop the current task immediately
+
+                    self.class_ts_estimator.update_progress_bar(content_size, duration, progress_bar)
+                    self.queue.put((index, segment_content))
+                    self.downloaded_segments.add(index)  
+                    progress_bar.update(1)
+                    return
+
+            except Exception as e:
+                logging.info(f"Attempt {attempt + 1} failed for segment {index} - '{ts_url}': {e}")
+                
+                if attempt > self.info_maxRetry:
+                    self.info_maxRetry = ( attempt + 1 )
+                self.info_nRetry += 1
+
+                if attempt + 1 == REQUEST_MAX_RETRY:
+                    console.log(f"[red]Final retry failed for segment: {index}")
+                    self.queue.put((index, None))  # Marker for failed segment
+                    progress_bar.update(1)
+                    self.info_nFailed += 1
+                    return
+                
+                with self.active_retries_lock:
+                    self.active_retries += 1
+                
+                sleep_time = backoff_factor * (2 ** attempt)
+                logging.info(f"Retrying segment {index} in {sleep_time} seconds...")
+                time.sleep(sleep_time)
+                
+                with self.active_retries_lock:
+                    self.active_retries -= 1
+
+    def write_segments_to_file(self):
+        """
+        Writes segments to file with additional verification.
+        """
+        buffer = {}
+        expected_index = 0
+        
+        with open(self.tmp_file_path, 'wb') as f:
+            while not self.stop_event.is_set() or not self.queue.empty():
+                if self.interrupt_flag.is_set():
+                    break
+                
+                try:
+                    index, segment_content = self.queue.get(timeout=self.current_timeout)
+
+                    # Successful queue retrieval: reduce timeout
+                    self.current_timeout = max(self.base_timeout, self.current_timeout / 2)
+
+                    # Handle failed segments
+                    if segment_content is None:
+                        if index == expected_index:
+                            expected_index += 1
+                        continue
+
+                    # Write segment if it's the next expected one
+                    if index == expected_index:
+                        f.write(segment_content)
+                        f.flush()
+                        expected_index += 1
+
+                        # Write any buffered segments that are now in order
+                        while expected_index in buffer:
+                            next_segment = buffer.pop(expected_index)
+
+                            if next_segment is not None:
+                                f.write(next_segment)
+                                f.flush()
+
+                            expected_index += 1
+                    
+                    else:
+                        buffer[index] = segment_content
+
+                except queue.Empty:
+                    self.current_timeout = min(MAX_TIMEOOUT, self.current_timeout * 1.1)
+                    if self.stop_event.is_set():
+                        break
+
+                except Exception as e:
+                    logging.error(f"Error writing segment {index}: {str(e)}")
+    
+    def download_streams(self, description: str, type: str):
+        """
+        Downloads all TS segments in parallel and writes them to a file.
+
+        Parameters:
+            - description: Description to insert on tqdm bar
+            - type (str): Type of download: 'video' or 'audio'
+        """
+        self.get_info()
+        self.setup_interrupt_handler()
+
+        progress_bar = tqdm(
+            total=len(self.segments), 
+            unit='s',
+            ascii='░▒█',
+            bar_format=self._get_bar_format(description),
+            mininterval=0.05
+        )
+
+        try:
+            writer_thread = threading.Thread(target=self.write_segments_to_file)
+            writer_thread.daemon = True
+            writer_thread.start()
+
+            # Configure workers and delay
+            max_workers = self._get_worker_count(type)
+            delay = max(PROXY_START_MIN, min(PROXY_START_MAX, 1 / (len(self.valid_proxy) + 1))) if THERE_IS_PROXY_LIST else TQDM_DELAY_WORKER
+            
+            # Download segments with completion verification
+            with ThreadPoolExecutor(max_workers=max_workers) as executor:
+                futures = []
+                for index, segment_url in enumerate(self.segments):
+
+                    # Check for interrupt before submitting each task
+                    if self.interrupt_flag.is_set():
+                        break
+
+                    time.sleep(delay)
+                    futures.append(executor.submit(self.download_segment, segment_url, index, progress_bar))
+
+                # Wait for futures with interrupt handling
+                for future in as_completed(futures):
+                    if self.interrupt_flag.is_set():
+                        break
+                    try:
+                        future.result()
+                    except Exception as e:
+                        logging.error(f"Error in download thread: {str(e)}")
+
+                # Interrupt handling for missing segments
+                if not self.interrupt_flag.is_set():
+                    total_segments = len(self.segments)
+                    completed_segments = len(self.downloaded_segments)
+                    
+                    if completed_segments < total_segments:
+                        missing_segments = set(range(total_segments)) - self.downloaded_segments
+                        logging.warning(f"Missing segments: {sorted(missing_segments)}")
+                        
+                        # Retry missing segments with interrupt check
+                        for index in missing_segments:
+                            if self.interrupt_flag.is_set():
+                                break
+
+                            try:
+                                self.download_segment(self.segments[index], index, progress_bar)
+                                
+                            except Exception as e:
+                                logging.error(f"Failed to retry segment {index}: {str(e)}")
+
+        finally:
+            self._cleanup_resources(writer_thread, progress_bar)
+
+        if not self.interrupt_flag.is_set():
+            self._verify_download_completion()
+
+        return self._generate_results(type)
+    
+    def _get_bar_format(self, description: str) -> str:
+        """
+        Generate platform-appropriate progress bar format.
+        """
+        if not USE_LARGE_BAR:
+            return (
+                f"{Colors.YELLOW}Proc{Colors.WHITE}: "
+                f"{Colors.RED}{{percentage:.2f}}% "
+                f"{Colors.WHITE}| "
+                f"{Colors.CYAN}{{remaining}}{{postfix}} {Colors.WHITE}]"
+            )
+            
+        else:
+            return (
+                f"{Colors.YELLOW}[HLS] {Colors.WHITE}({Colors.CYAN}{description}{Colors.WHITE}): "
+                f"{Colors.RED}{{percentage:.2f}}% "
+                f"{Colors.MAGENTA}{{bar}} "
+                f"{Colors.WHITE}[ {Colors.YELLOW}{{n_fmt}}{Colors.WHITE} / {Colors.RED}{{total_fmt}} {Colors.WHITE}] "
+                f"{Colors.YELLOW}{{elapsed}} {Colors.WHITE}< {Colors.CYAN}{{remaining}}{{postfix}} {Colors.WHITE}]"
+            )
+    
+    def _get_worker_count(self, stream_type: str) -> int:
+        """
+        Calculate optimal parallel workers based on stream type and infrastructure.
+        """
+        base_workers = {
+            'video': DEFAULT_VIDEO_WORKERS,
+            'audio': DEFAULT_AUDIO_WORKERS
+        }.get(stream_type.lower(), 1)
+
+        if THERE_IS_PROXY_LIST:
+            return min(len(self.valid_proxy), base_workers * 2)
+        return base_workers
+    
+    def _generate_results(self, stream_type: str) -> Dict:
+        """Package final download results."""
+        return {
+            'type': stream_type,
+            'nFailed': self.info_nFailed,
+            'stopped': self.download_interrupted
+        }
+    
+    def _verify_download_completion(self) -> None:
+        """Validate final download integrity."""
+        total = len(self.segments)
+        if len(self.downloaded_segments) / total < 0.999:
+            missing = sorted(set(range(total)) - self.downloaded_segments)
+            raise RuntimeError(f"Download incomplete ({len(self.downloaded_segments)/total:.1%}). Missing segments: {missing}")
+        
+    def _cleanup_resources(self, writer_thread: threading.Thread, progress_bar: tqdm) -> None:
+        """Ensure resource cleanup and final reporting."""
+        self.stop_event.set()
+        writer_thread.join(timeout=30)
+        progress_bar.close()
+        
+        if self.download_interrupted:
+            console.print("\n[red]Download terminated by user")
+            
+        if self.info_nFailed > 0:
+            self._display_error_summary()
+
+    def _display_error_summary(self) -> None:
+        """Generate final error report."""
+        console.print(f"\n[cyan]Retry Summary: "
+                     f"[white]Max retries: [green]{self.info_maxRetry} "
+                     f"[white]Total retries: [green]{self.info_nRetry} "
+                     f"[white]Failed segments: [red]{self.info_nFailed}")
+        
+        if self.info_nRetry > len(self.segments) * 0.3:
+            console.print("[yellow]Warning: High retry count detected. Consider reducing worker count in config.")