ytfetch 1.2.0__tar.gz → 2.1.0__tar.gz

{ytfetch-1.2.0 → ytfetch-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ytfetch
-Version: 1.2.0
+Version: 2.1.0
 Summary: A wrapper for yt-dlp with custom simple fetching flags
 Project-URL: Homepage, https://github.com/voidsnax/ytFetch
 Author: voidsnax
@@ -12,13 +12,12 @@ Requires-Dist: colorama
 Requires-Dist: yt-dlp[curl-cffi,default]
 Description-Content-Type: text/markdown
 
-# ytfetch
+# ytFetch
 
-**ytfetch** simplifies media downloading and playlist management by adding smart Fetching, playlist searching, and streamlined format handling on top of the powerful [yt-dlp](https://github.com/yt-dlp/yt-dlp) engine.
+**ytfetch** simplifies media downloading and playlist management by adding  playlist searching, and streamlined format handling on top of the powerful [yt-dlp](https://github.com/yt-dlp/yt-dlp) engine.
 
 ## ✨ Features
 
-* **Smart Fetching:** Apply limits to multiple playlists or map specific ranges in a single download.
 * **Search:** Use `-list` to display or search across single or multiple playlists contents.
 * **Direct Download:** Single flag to download in legacy `avc/h.264` and `mp3` format and audio only extraction.
 * **Video Quality:** Mention preffered video quality directly.
@@ -68,7 +67,6 @@ Download builds from [here](https://ffmpeg.org/download.html)
   Check this [guide](https://github.com/yt-dlp/yt-dlp/wiki/EJS) for more info.
   Also check [yt-dlp dependency](https://github.com/yt-dlp/yt-dlp#dependencies) for optional dependencies.
 
-*Note: `yt-dlp` should also be available in your system PATH for using the `-list` flag. If the package is installed in a virtual environment (venv) or isolated using tools like `uv`, ensure yt-dlp added to your system env PATH.*
 
 ## 📦 Installation
 
@@ -94,14 +92,17 @@ usage: ytfetch URL ... [OPTIONS] [yt-dlp OPTIONS]
 
 options:
   -h                         Show this help message and exit
-  -help                      Show yt-dlp help message
+  --help                     Show yt-dlp help message and exit
   -avcmp3                    Download video in AVC (h.264) & audio in mp3 format
   -q QUALITY                 Video quality (e.g., 1080, 720). Default is 1080
   -mp3                       Extract audio only as MP3
   -audio                     Extract audio only
-  -fetch RANGE [RANGE ...]   Alternate for --playlist-items. Single value applies globally
-                             Multiple value must match number of playlist URLs provided
   -list [NAME]               List playlist contents. Accepts values for searching across playlist
+
+output template aliases:
+  -o autonumber/num   -> playlist-numbered naming
+  -o music/song       -> title + artist naming
+  -o default          -> default naming
 ```
 
 ### Examples
@@ -126,17 +127,6 @@ Extract Audio Only in Mp3
 ```bash
 ytfetch "VIDEO_URL" -mp3
 ```
-#### Smart Fetching
-
-Global Limit
-```bash
-ytfetch "PLAYLIST_URL_1" "PLAYLIST_URL_2" -fetch "1-10"
-```
-Mapped Ranges
-```bash
-ytfetch "PLAYLIST_A" "PLAYLIST_B"  -fetch "1-5" "10-15"
-```
-*Note: The number of fetch arguments must match the number of URLs*
 
 #### Listing and Searching
 
@@ -148,10 +138,6 @@ Search through a playlist
 ```bash
 ytfetch "PLAYLIST_URL" -list "remix"
 ```
-Combined Fetch & Search
-```bash
-ytfetch "PLAYLIST_URL"  -fetch ":50" -list "search_word"
-```
 
 #### Passthrough Options
 
@@ -169,6 +155,11 @@ Limit Speed
 ```bash
 ytfetch -r "500K" "VIDEO_URL"
 ```
+Selected range Search
+```bash
+ytfetch "PLAYLIST_URL"  -I ":50" -list "search_word"
+```
+*and so on...*
 
 ## 🔖 License
 

{ytfetch-1.2.0 → ytfetch-2.1.0}/README-pypi.md

@@ -1,10 +1,9 @@
-# ytfetch
+# ytFetch
 
-**ytfetch** simplifies media downloading and playlist management by adding smart Fetching, playlist searching, and streamlined format handling on top of the powerful [yt-dlp](https://github.com/yt-dlp/yt-dlp) engine.
+**ytfetch** simplifies media downloading and playlist management by adding playlist searching, and streamlined format handling on top of the powerful [yt-dlp](https://github.com/yt-dlp/yt-dlp) engine.
 
 ## ✨ Features
 
-* **Smart Fetching:** Apply limits to multiple playlists or map specific ranges in a single download.
 * **Search:** Use `-list` to display or search across single or multiple playlists contents.
 * **Direct Download:** Single flag to download in legacy `avc/h.264` and `mp3` format and audio only extraction.
 * **Video Quality:** Mention preffered video quality directly.
@@ -21,7 +20,6 @@ Download builds from [here](https://ffmpeg.org/download.html)
   Check this [guide](https://github.com/yt-dlp/yt-dlp/wiki/EJS) for more info.
   Also check [yt-dlp dependency](https://github.com/yt-dlp/yt-dlp#dependencies) for optional dependencies.
 
-*Note: `yt-dlp` should also be available in your system PATH for using the `-list` flag. If the package is installed in a virtual environment (venv) or isolated using tools like `uv`, ensure yt-dlp added to your system env PATH.*
 
 ## 📦 Installation
 
@@ -33,8 +31,8 @@ pip install ytfetch
 
 ### via source
 ```bash
-git clone <your-repo-url>
-cd <your-repo>
+git clone https://github.com/voidsnax/ytFetch.git
+cd ytFetch
 pip install -e .
 ```
 
@@ -47,15 +45,17 @@ usage: ytfetch URL ... [OPTIONS] [yt-dlp OPTIONS]
 
 options:
   -h                         Show this help message and exit
-  -help                      Show yt-dlp help messag
+  --help                     Show yt-dlp help messag and exit
   -avcmp3                    Download video in AVC (h.264) & audio in mp3 format
   -q QUALITY                 Video quality (e.g., 1080, 720). Default is 1080
   -mp3                       Extract audio only as MP3
-  -audio                     Extract audio only
-  -fetch RANGE [RANGE ...]   Alternate for --playlist-items. Single value applies globally
-                             Multiple value must number of playlist URLs provided
-                             match number of playlist URLs provided
+  -audio                     Extract best audio
   -list [NAME]               List playlist contents. Accepts values for searching across playlist
+
+output template aliases:
+  -o autonumber/num   -> playlist-numbered naming
+  -o music/song       -> title + artist naming
+  -o default          -> default naming
 ```
 
 ### Examples
@@ -80,17 +80,6 @@ Extract Audio Only in Mp3
 ```bash
 ytfetch "VIDEO_URL" -mp3
 ```
-#### Smart Fetching
-
-Global Limit
-```bash
-ytfetch "PLAYLIST_URL_1" "PLAYLIST_URL_2" -fetch "1-10"
-```
-Mapped Ranges
-```bash
-ytfetch "PLAYLIST_A" "PLAYLIST_B"  -fetch "1-5" "10-15"
-```
-*Note: The number of fetch arguments must match the number of URLs*
 
 #### Listing and Searching
 
@@ -102,10 +91,6 @@ Search through a playlist
 ```bash
 ytfetch "PLAYLIST_URL" -list "remix"
 ```
-Combined Fetch & Search
-```bash
-ytfetch "PLAYLIST_URL"  -fetch ":50" -list "search_word"
-```
 
 #### Passthrough Options
 
@@ -123,6 +108,11 @@ Limit Speed
 ```bash
 ytfetch -r "500K" "VIDEO_URL"
 ```
+Selected range Search
+```bash
+ytfetch "PLAYLIST_URL"  -I ":50" -list "search_word"
+```
+*and so on...*
 
 ## 🔖 License
 

{ytfetch-1.2.0 → ytfetch-2.1.0}/README.md

@@ -1,10 +1,9 @@
-# ytfetch
+# ytFetch
 
-**ytfetch** simplifies media downloading and playlist management by adding smart Fetching, playlist searching, and streamlined format handling on top of the powerful [yt-dlp](https://github.com/yt-dlp/yt-dlp) engine.
+**ytfetch** simplifies media downloading and playlist management by adding  playlist searching, and streamlined format handling on top of the powerful [yt-dlp](https://github.com/yt-dlp/yt-dlp) engine.
 
 ## ✨ Features
 
-* **Smart Fetching:** Apply limits to multiple playlists or map specific ranges in a single download.
 * **Search:** Use `-list` to display or search across single or multiple playlists contents.
 * **Direct Download:** Single flag to download in legacy `avc/h.264` and `mp3` format and audio only extraction.
 * **Video Quality:** Mention preffered video quality directly.
@@ -54,7 +53,6 @@ Download builds from [here](https://ffmpeg.org/download.html)
   Check this [guide](https://github.com/yt-dlp/yt-dlp/wiki/EJS) for more info.
   Also check [yt-dlp dependency](https://github.com/yt-dlp/yt-dlp#dependencies) for optional dependencies.
 
-*Note: `yt-dlp` should also be available in your system PATH for using the `-list` flag. If the package is installed in a virtual environment (venv) or isolated using tools like `uv`, ensure yt-dlp added to your system env PATH.*
 
 ## 📦 Installation
 
@@ -80,14 +78,17 @@ usage: ytfetch URL ... [OPTIONS] [yt-dlp OPTIONS]
 
 options:
   -h                         Show this help message and exit
-  -help                      Show yt-dlp help message
+  --help                     Show yt-dlp help message and exit
   -avcmp3                    Download video in AVC (h.264) & audio in mp3 format
   -q QUALITY                 Video quality (e.g., 1080, 720). Default is 1080
   -mp3                       Extract audio only as MP3
   -audio                     Extract audio only
-  -fetch RANGE [RANGE ...]   Alternate for --playlist-items. Single value applies globally
-                             Multiple value must match number of playlist URLs provided
   -list [NAME]               List playlist contents. Accepts values for searching across playlist
+
+output template aliases:
+  -o autonumber/num   -> playlist-numbered naming
+  -o music/song       -> title + artist naming
+  -o default          -> default naming
 ```
 
 ### Examples
@@ -112,17 +113,6 @@ Extract Audio Only in Mp3
 ```bash
 ytfetch "VIDEO_URL" -mp3
 ```
-#### Smart Fetching
-
-Global Limit
-```bash
-ytfetch "PLAYLIST_URL_1" "PLAYLIST_URL_2" -fetch "1-10"
-```
-Mapped Ranges
-```bash
-ytfetch "PLAYLIST_A" "PLAYLIST_B"  -fetch "1-5" "10-15"
-```
-*Note: The number of fetch arguments must match the number of URLs*
 
 #### Listing and Searching
 
@@ -134,10 +124,6 @@ Search through a playlist
 ```bash
 ytfetch "PLAYLIST_URL" -list "remix"
 ```
-Combined Fetch & Search
-```bash
-ytfetch "PLAYLIST_URL"  -fetch ":50" -list "search_word"
-```
 
 #### Passthrough Options
 
@@ -155,6 +141,11 @@ Limit Speed
 ```bash
 ytfetch -r "500K" "VIDEO_URL"
 ```
+Selected range Search
+```bash
+ytfetch "PLAYLIST_URL"  -I ":50" -list "search_word"
+```
+*and so on...*
 
 ## 🔖 License
 

{ytfetch-1.2.0 → ytfetch-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ytfetch"
-version = "1.2.0"
+version = "2.1.0"
 description = "A wrapper for yt-dlp with custom simple fetching flags"
 authors = [
     { name = "voidsnax" }

ytfetch-2.1.0/src/ytfetch/cli.py

@@ -0,0 +1,48 @@
+import argparse
+
+def parse_arguments():
+    parser = argparse.ArgumentParser(
+        usage = "ytfetch URL ... [OPTIONS] [yt-dlp OPTIONS]",
+        description="ytfetch: yt-dlp wrapper with some flexible args.",
+        epilog = ("output template aliases:\n"
+            "-o autonumber/num   -> playlist-numbered naming\n"
+            "-o music/song       -> title + artist naming\n"
+            "-o default          -> default naming\n\n"
+            "Docs & issues: https://github.com/voidsnax/ytFetch"
+        ),
+        formatter_class=AlignedHelpFormatter,
+        allow_abbrev=False,
+        add_help=False
+    )
+
+    parser.add_argument("-h", action="help", help="Show this help message and exit")
+    parser.add_argument("--help", action="store_true", help="Show yt-dlp help message and exit")
+    parser.add_argument("-q", metavar="QUALITY", nargs="?", default="default",
+        help="Video quality (e.g., 1080, 720). Default will pick best video"
+    )
+    parser.add_argument("-avcmp3", action="store_true",
+        help="Download video in AVC (h.264) & audio in mp3 format"
+    )
+    parser.add_argument("-mp3", action="store_true", help="Extract audio only as MP3")
+    parser.add_argument("-audio", action="store_true", help="Extract audio only (bestaudio)")
+
+    parser.add_argument("-list", metavar="NAME", nargs="?", const="default",
+        help="List playlist contents. Accepts values for searching across playlist"
+    )
+
+    args, unknown_args = parser.parse_known_args()
+    return args, unknown_args
+
+
+class AlignedHelpFormatter(argparse.HelpFormatter):
+    def __init__(self, *args, **kwargs):
+        kwargs['max_help_position'] = 35  # default is 24
+        super().__init__(*args, **kwargs)
+    def _fill_text(self, text, width, indent):
+        # Preserve newlines in Description and Epilog
+        # splitlines(keepends=True) ensures not losing of double newlines
+        return ''.join(indent + line for line in text.splitlines(keepends=True))
+
+    def _split_lines(self, text, width):
+        # Preserve newlines in help
+        return text.splitlines()

{ytfetch-1.2.0 → ytfetch-2.1.0}/src/ytfetch/formatter.py

@@ -4,7 +4,6 @@ from .utils import is_android
 
 init(autoreset=True)
 
-
 # --- Custom Loggers ---
 class YTFetchLogger:
     def debug(self, msg):
@@ -24,7 +23,13 @@ class YTFetchLogger:
             print(f"\n{clean_msg}")
 
         if "Merging formats" in msg:
-            print(msg.replace("[Merger] ", ""))
+            print(msg)
+
+        if "Adding metadata" in msg:
+            print(msg)
+
+        if "Adding thumbnail" in msg:
+            print(msg)
 
     def info(self, msg):
         pass
@@ -37,8 +42,13 @@ class YTFetchLogger:
     def error(self, msg):
         print(f"\n{msg}")
 
-class ErrorOnlyLogger:
-    def debug(self, msg): pass
+class ListLogger:
+    def debug(self, msg):
+        if "Downloading playlist:" in msg:
+            playlist_title = msg.replace("[download] Downloading playlist: ", "")
+            playlist_string = f"▶ Playlist: {playlist_title}"
+            print(f"▶ Playlist: {Fore.CYAN}{playlist_title}{Fore.RESET}")
+            print("-" * len(playlist_string))
     def info(self, msg): pass
     def warning(self, msg): pass
     def error(self, msg): print(msg)

ytfetch-2.1.0/src/ytfetch/main.py

@@ -0,0 +1,100 @@
+import sys
+import signal
+
+signal.signal(signal.SIGINT, lambda x, y: sys.exit(0))
+
+import yt_dlp
+from colorama import Fore
+from urllib.parse import urlsplit
+
+from .cli import parse_arguments
+from .utils import (
+    format_selector,
+    print_error
+    )
+from .formatter import (
+    ListLogger,
+    YTFetchLogger,
+    progress_hook
+    )
+
+signal.signal(signal.SIGINT, signal.default_int_handler)
+
+def process_urls(cli_args, extra_ydl_args):
+
+    if cli_args.help:
+        yt_dlp.parse_options(["-h"])
+
+    ydl_args = []
+
+    # --- List ---
+    if cli_args.list:
+        ydl_args.extend(["--flat-playlist", "--print", "%(playlist_index)s - %(title)s"])
+
+        if cli_args.list != 'default':
+            list_val = cli_args.list
+            parsed = urlsplit(list_val) # to skip urls
+            if all([parsed.scheme, parsed.netloc]):
+                extra_ydl_args.append(list_val)
+            else:
+                ydl_args.extend(["--match-filters", f"title ~= '(?i){list_val}'"])
+
+    else:
+        # --- format selection ---
+        ydl_args.extend(["--format", format_selector(cli_args)])
+
+        # --- audio quality ---
+        if cli_args.q == 'default':
+            a_quality = '2'
+        else:
+            a_quality = cli_args.q
+
+        # --- mp3 ---
+        if cli_args.mp3:
+            ydl_args.extend(["-x",  "--audio-format", "mp3", "--audio-quality", a_quality])
+
+        # --- audio ---
+        elif cli_args.audio:
+            ydl_args.extend(["-x", "--audio-quality", a_quality])
+
+        # --- avcmp3 ---
+        elif cli_args.avcmp3:
+            ydl_args.extend(["--merge-output-format", "mp4", "--postprocessor-args", "ffmpeg:-c:v copy -c:a libmp3lame -b:a 192k"])
+
+        # --- default output template ---
+        ydl_args.extend(["-o", "%(title)s.%(ext)s"])
+
+    # --- final parsing ---
+    ydl_args.extend(extra_ydl_args)
+    _, _, urls, ydl_opts = yt_dlp.parse_options(ydl_args)
+
+    if not urls:
+        print_error("Provide atleast one URL...")
+        return
+
+    # --- output template aliases ---
+    if ydl_opts.get('outtmpl', {}).get('default') in ['autonumber', 'num']: # type: ignore
+        ydl_opts["outtmpl"] = {'default': '%(playlist_autonumber)s - %(title)s.%(ext)s'}
+    elif ydl_opts.get('outtmpl', {}).get('default') in ['music', 'song']: # type: ignore
+        ydl_opts["outtmpl"] = {'default': '%(title)s - %(artist,uploader)s.%(ext)s'}
+    elif ydl_opts.get('outtmpl', {}).get('default') == 'default': # type: ignore
+        ydl_opts["outtmpl"] = {}
+
+    # --- logger ---
+    if not cli_args.list: ydl_opts['progress_hooks'] = [progress_hook]
+    if not ydl_opts.get('verbose'):
+        ydl_opts['logger'] = ListLogger() if cli_args.list else YTFetchLogger() # type: ignore
+
+    # --- download ---
+    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        ydl.download(urls)
+
+def main():
+    try:
+        args, extra_args = parse_arguments()
+        process_urls(args, extra_args)
+    except KeyboardInterrupt:
+        print(f"\n\n{Fore.YELLOW}Process aborted by user{Fore.RESET}")
+        sys.exit(1)
+    except Exception as e:
+        print_error(f"Unexpected error: {e}")

ytfetch-2.1.0/src/ytfetch/utils.py

@@ -0,0 +1,27 @@
+import sys
+from colorama import Fore, init
+
+init(autoreset=True)
+
+def format_selector(args):
+    height = args.q.rstrip("p")
+
+    if args.mp3 or args.audio:
+        return "bestaudio/best"
+
+    if args.avcmp3:
+        if height != "default":
+            return f"bestvideo[vcodec^=avc1][height<={height}]+bestaudio/best[vcodec^=avc1][height<={height}]"
+
+        return f"bestvideo[vcodec^=avc1]+bestaudio/best[vcodec^=avc1]"
+
+    if height != "default":
+        return f"bestvideo[height<={height}]+bestaudio/best[height<={height}]"
+
+    return f"bestvideo+bestaudio/best"
+
+def print_error(msg):
+    print(f"{Fore.RED}{msg}")
+
+def is_android():
+    return hasattr(sys, 'getandroidapilevel')

ytfetch-1.2.0/src/ytfetch/cli.py

@@ -1,44 +0,0 @@
-import argparse
-
-
-def parse_arguments():
-    parser = argparse.ArgumentParser(
-        usage = "ytfetch URL ... [OPTIONS] [yt-dlp OPTIONS] ",
-        description="ytfetch: yt-dlp wrapper with flexible args.",
-        epilog = "type yt-dlp -h for yt-dlp options \n"
-        "Doc & issues: https://github.com/voidsnax/ytFetch",
-        formatter_class=AlignedHelpFormatter,
-        allow_abbrev=False
-    )
-
-    parser.add_argument("url", nargs="+", metavar="URL")
-    parser.add_argument("-avcmp3", action="store_true",
-                        help="Download video in AVC (h.264) & audio in mp3 format")
-    parser.add_argument("-q", metavar="QUALITY", nargs="?", default="default",
-                        help="Video quality (e.g., 1080, 720). Default will pick best video")
-    parser.add_argument("-mp3", action="store_true",
-                        help="Extract audio only as MP3")
-    parser.add_argument("-audio", action="store_true",
-                        help="Extract audio only (bestaudio)")
-    parser.add_argument("-fetch", metavar="RANGE", nargs="+",
-                        help="Alternate for --playlist-items. Single value applies globally\n"
-                        "Multiple values must match number of playlist URLs provided")
-    parser.add_argument("-list", metavar="NAME", nargs="?", const="default",
-                        help="List playlist contents. Accepts values for searching across playlist")
-
-    args, unknown_args = parser.parse_known_args()
-    return args, unknown_args
-
-
-class AlignedHelpFormatter(argparse.HelpFormatter):
-    def __init__(self, *args, **kwargs):
-        kwargs['max_help_position'] = 35  # default is 24
-        super().__init__(*args, **kwargs)
-    def _fill_text(self, text, width, indent):
-        # Preserve newlines in Description and Epilog
-        # splitlines(keepends=True) ensures not losing of double newlines
-        return ''.join(indent + line for line in text.splitlines(keepends=True))
-
-    def _split_lines(self, text, width):
-        # Preserve newlines in help
-        return text.splitlines()

ytfetch-1.2.0/src/ytfetch/main.py

@@ -1,160 +0,0 @@
-import sys
-import signal
-
-signal.signal(signal.SIGINT, lambda x, y: sys.exit(0))
-
-import subprocess
-import yt_dlp
-from colorama import Fore
-
-from .cli import parse_arguments
-from .utils import (
-    parse_passthrough_args,
-    validate_fetch_ranges,
-    format_selector,
-    print_error,
-    is_ytdlp_available
-    )
-from .formatter import (
-    YTFetchLogger,
-    ErrorOnlyLogger,
-    progress_hook
-    )
-
-signal.signal(signal.SIGINT, signal.default_int_handler)
-
-
-def process_urls(custom_args, raw_ytdlp_args):
-    urls = custom_args.url
-    passthrough_opts = parse_passthrough_args(raw_ytdlp_args)
-
-    ydl_opts = {
-        'outtmpl': '%(title)s.%(ext)s',
-        'logger': YTFetchLogger(),
-        'progress_hooks': [progress_hook],
-    }
-
-    ydl_opts.update(passthrough_opts)
-
-    # --- List ---
-    if not is_ytdlp_available():
-        print_error("yt-dlp cant be accesed via terminal, Make sure its available in system PATH")
-        return
-    if custom_args.list:
-        base_cmd = [
-            "yt-dlp",
-            "--flat-playlist",
-            "--print", "%(playlist_index)s - %(title)s"
-        ]
-
-        passthrough_args = [arg for arg in raw_ytdlp_args if arg not in urls]
-        base_cmd.extend(passthrough_args)
-        command = []
-
-        ydl_opts['extract_flat'] = 'in_playlist'
-        ydl_opts['logger'] = ErrorOnlyLogger()
-
-        search_mode = False
-
-        fetch_ranges = custom_args.fetch
-        if fetch_ranges:
-            if len(fetch_ranges) >1:
-                validate_fetch_ranges(fetch_ranges,urls)
-                for fetch_range in fetch_ranges:
-                    command.append(base_cmd + [ "--playlist-items", fetch_range])
-            else:
-                command.append(base_cmd + ["--playlist-items", fetch_ranges[0]])
-        else:
-            command.append(base_cmd)
-
-        # make sure command is a list of list
-        if len(command) == 1 and len(urls) > 1:
-            command = [cmd.copy() for cmd in [command[0]] * len(urls)]
-
-
-        if custom_args.list != 'default':
-            search_mode = True
-            list_val = custom_args.list
-            search_pattern = list_val.lower()
-        for url, cmd in zip(urls, command):
-            # currently for title fetching this is more reliable
-            with yt_dlp.YoutubeDL(ydl_opts) as ydl:  #type: ignore
-                try:
-                    info = ydl.extract_info(url, download=False)
-                    if 'entries' not in info:
-                        print(f"Single Video: {info.get('title')}")
-                    else:
-                        title = f"▶ Playlist: {info.get('title')}"
-                        print(f"▶ Playlist: {Fore.CYAN}{info.get('title')}{Fore.RESET}")
-                        print(f"{"-" * len(title)}")
-                except Exception as e:
-                    print(f"Error getting {url} title: {e}")
-            try:
-                cmd.append(url)
-                # print(cmd)
-                result = subprocess.run(cmd, capture_output=True, text=True)
-                found_match = False
-                for line in result.stdout.splitlines():
-                    idx, title = line.split(" - ", 1)
-                    video = f"{Fore.YELLOW}{idx}{Fore.RESET} - {title}"
-                    if search_mode:
-                        if search_pattern in line.lower():
-                            found_match = True
-                            print(video)
-                    else:
-                        print(video)
-                if not found_match and search_mode:
-                    print(f"No match found for {Fore.YELLOW}{search_pattern}{Fore.RESET}")
-            except Exception as e:
-                print_error(f"Error listing {url}: {e}")
-
-        return
-
-    # --- format selection ---
-    ydl_opts['format'] = format_selector(custom_args)
-
-    if custom_args.mp3:
-        ydl_opts['postprocessors'] = [{
-            'key': 'FFmpegExtractAudio',
-            'preferredcodec': 'mp3',
-            'preferredquality': '192',
-        }]
-
-    elif custom_args.avcmp3:
-        ydl_opts['merge_output_format'] = 'mp4'
-        ydl_opts['postprocessor_args'] = {
-            'ffmpeg': ['-c:v', 'copy', '-c:a', 'libmp3lame', '-b:a', '192k']
-        }
-
-    # --- Download ---
-    def run_download(url, playlist_items=None):
-        opts = ydl_opts.copy()
-        if playlist_items:
-            opts['playlist_items'] = playlist_items
-        with yt_dlp.YoutubeDL(opts) as ydl:  #type:ignore
-            try:
-                ydl.download([url])
-            except Exception as e:
-                # print(f"Download error for {url}: {e}")
-                pass
-
-    fetch_ranges = custom_args.fetch
-    if fetch_ranges:
-        if len(fetch_ranges) == 1:
-            for url in urls:
-                run_download(url, fetch_ranges[0])
-        else:
-            validate_fetch_ranges(fetch_ranges,urls)
-            for url, rng in zip(urls, fetch_ranges):
-                run_download(url, rng)
-    else:
-        for url in urls:
-            run_download(url)
-
-def main():
-    try:
-        custom_args, ytdlp_args = parse_arguments()
-        process_urls(custom_args, ytdlp_args)
-    except KeyboardInterrupt:
-        print(f"\n\n{Fore.YELLOW}Process aborted by user{Fore.RESET}")
-        sys.exit(1)

ytfetch-1.2.0/src/ytfetch/utils.py

@@ -1,70 +0,0 @@
-import shutil
-import sys
-from colorama import Fore, init
-from yt_dlp.options import create_parser
-
-init(autoreset=True)
-
-def parse_passthrough_args(args_list):
-    """
-    Parses unknown arguments using yt-dlp's internal parser.
-    Returns a dictionary containing ONLY the options explicitly passed by the user.
-    """
-    parser = create_parser()
-    try:
-        parsed, _ = parser.parse_known_args(args_list)
-    except Exception as e:
-        print(e,end='')
-        sys.exit(1)
-
-    opts = vars(parsed) # convert to dict
-
-    # Filter out defaults to return ONLY user-provided args
-    # create a baseline parser to see what the defaults are
-    base_parser = create_parser()
-    base_parsed, _ = base_parser.parse_args([])
-    base_opts = vars(base_parsed)
-
-    # Build dictionary of only changed items
-    final_opts = {}
-    for key, value in opts.items():
-        # Only keep the option if the user changed it from the default
-        if base_opts[key] != value:
-            final_opts[key] = value
-
-    return final_opts
-
-
-def validate_fetch_ranges(fetch_ranges, urls):
-    if len(fetch_ranges) != len(urls):
-        print_error(f"Error: Provided {len(fetch_ranges)} fetch ranges for {len(urls)} URLs.")
-        sys.exit(1)
-
-
-def format_selector(args):
-    height = args.q.rstrip("p")
-
-    if args.mp3 or args.audio:
-        return "bestaudio/best"
-
-    if args.avcmp3:
-        if height != "default":
-            return f"bestvideo[vcodec^=avc1][height<={height}]+bestaudio/best[vcodec^=avc1][height<={height}]"
-
-        return f"bestvideo[vcodec^=avc1]+bestaudio/best[vcodec^=avc1]"
-
-    if height != "default":
-        return f"bestvideo[height<={height}]+bestaudio/best[height<={height}]"
-
-    return f"bestvideo+bestaudio/best"
-
-def print_error(msg):
-    print(f"{Fore.RED}{msg}")
-
-def is_android():
-    return hasattr(sys, 'getandroidapilevel')
-
-def is_ytdlp_available():
-    """Return True if yt-dlp is available in the system PATH."""
-    return shutil.which("yt-dlp") is not None
-