idm-cli 1.3.0__tar.gz → 1.4.0__tar.gz

idm_cli-1.4.0/MANIFEST.in

@@ -0,0 +1 @@
+include requirements.txt

{idm_cli-1.3.0/idm_cli.egg-info → idm_cli-1.4.0}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: idm-cli
-Version: 1.3.0
+Version: 1.4.0
 Summary: A lightning-fast, universal command-line download manager
 Home-page: https://github.com/rj41-w2/idm-cli
 Author: Rehan
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rj41-w2/idm-cli
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
 Requires-Python: >=3.8
@@ -22,35 +23,43 @@ Requires-Dist: aiodns
 Requires-Dist: Brotli
 Requires-Dist: psutil
 Requires-Dist: platformdirs
-Requires-Dist: pytest
-Requires-Dist: pytest-asyncio
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: packaging; extra == "dev"
 Dynamic: home-page
 Dynamic: license-file
-Dynamic: requires-dist
 Dynamic: requires-python
-Dynamic: summary
 
-# IDM-CLI (Internet Download Manager CLI)
+<div align="center">
 
-*Inspired by the official [Internet Download Manager (IDM)](https://www.internetdownloadmanager.com/)*
+<h1>IDM-CLI</h1>
 
-A lightning-fast, cross-platform command-line download manager written in Python. IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maximize your internet speed. It supports downloading from **YouTube**, **Facebook**, **Instagram**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
+**A lightning-fast, cross-platform command-line download manager written in Python.**
+
+*The official IDM asks you to pay after 30 days — IDM-CLI is 100% free, open-source, and yours to modify!*
+
+[![PyPI version](https://img.shields.io/pypi/v/idm-cli?color=blue&label=pypi%20version)](https://pypi.org/project/idm-cli/)
+[![Downloads](https://static.pepy.tech/badge/idm-cli)](https://pepy.tech/project/idm-cli)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/rj41-w2/idm-cli/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+[![Install](https://img.shields.io/badge/install-pip%20install%20idm--cli-brightgreen)](https://pypi.org/project/idm-cli/)
+
+[Download via PyPI](https://pypi.org/project/idm-cli/) · [Report a Bug](https://github.com/rj41-w2/idm-cli/issues)
+
+</div>
+
+IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maximize your internet speed. It supports downloading from **YouTube**, **Facebook**, **Instagram**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
 
 ## Features
 
 - **Parallel Chunk Engine** — Splits downloads into multiple concurrent chunks using `aiohttp` async sessions to fully saturate your bandwidth.
-- **Universal Downloader** — Paste any direct URL. A built-in HTTP `HEAD` detector automatically recognizes file types and routes them to the parallel engine.
-- **Social Media Support** — Natively supports YouTube, Facebook, and Instagram via a modular extractor architecture with yt-dlp.
+- **Universal Downloader** — Paste any URL. yt-dlp handles 1000+ sites (YouTube, Facebook, Instagram, etc.), with automatic fallback to direct HTTP download for unsupported URLs.
 - **Audio Only / MP3 Conversion** — Download videos as audio. IDM-CLI automatically grabs the best audio stream and uses FFmpeg to convert it to `.mp3`.
 - **Smart Auto-Resume** — Internet dropped? Pressed `Ctrl+C`? No problem. IDM-CLI remembers the exact byte positions of all incomplete chunks. Paste the same link again to resume instantly.
 - **Persistent Queue System** — Add multiple files to a queue with `-Q` and type `start queue` to download them all sequentially.
-- **Browser Extension Integration** — Chrome/Edge extension intercepts downloads and routes them directly into IDM-CLI via Native Messaging.
 - **Interactive UI** — Modern terminal interface powered by `rich` and `questionary` with real-time speed, ETA, and progress bars. Press `p` to pause, `r` to resume.
-- **Cross-Platform** — Works on Windows, macOS, and Linux with platform-specific FFmpeg handling and browser registration.
+- **Cross-Platform** — Works on Windows, macOS, and Linux with platform-specific FFmpeg handling.
 - **Auto-Update Check** — Checks PyPI once a day and notifies you when a new version is available.
 
 ## Prerequisites
@@ -118,22 +127,9 @@ idm "https://facebook.com/..." -Q
 | `<URL>` | Download a video or file |
 | `resume` | Resume or delete incomplete downloads |
 | `start queue` | Process all queued downloads |
-| `install extension` | Guide to install the browser extension |
 | `help` | Show available commands and flags |
 | `exit` | Exit the application |
 
-### Browser Extension
-
-IDM-CLI includes a Chrome/Edge extension that intercepts file downloads automatically. To install it:
-
-```bash
-idm
-# then type:
-install extension
-```
-
-Follow the on-screen guide to load the unpacked extension and link it to IDM-CLI.
-
 ### Troubleshooting: Windows Device Guard
 
 If you get `"idm.exe was blocked by your organization's Device Guard policy"`, run the Python module directly:
@@ -161,69 +157,13 @@ idm_cli/
 │   ├── ytdlp.py             # YouTube/social media extractor
 │   ├── direct.py            # Direct HTTP file downloader
 │   └── winget.py            # Windows Package Manager extractor
-└── extension/
-    ├── extension.py         # Browser extension installer
-    ├── native_host.py       # Native Messaging Host
-    ├── daemon.py            # Queue daemon with PID lock
-    └── browser_extension/   # Chrome/Edge extension source
 ```
 
 ## Contributing
 
-Contributions are welcome — whether it's a bug fix, a new feature, or just improving the docs.
-
-### Reporting Bugs
-
-If you find a bug, [open an issue](https://github.com/rj41-w2/idm-cli/issues/new) with:
-
-- A clear title and description of the problem
-- Steps to reproduce the issue
-- Your OS and Python version (`python --version`)
-- The full error output if there is one
-
-### Suggesting Features
-
-Got an idea? [Open an issue](https://github.com/rj41-w2/idm-cli/issues/new) with the tag `enhancement` and describe:
-
-- What you want to happen and why
-- How it would work from the user's perspective
-- Any alternatives you considered
-
-### Submitting a Pull Request
-
-1. **Fork** the repository from [github.com/rj41-w2/idm-cli](https://github.com/rj41-w2/idm-cli)
-
-2. **Clone your fork** and set it up:
-   ```bash
-   git clone https://github.com/<your-username>/idm-cli.git
-   cd IDM-CLI
-   pip install -r requirements.txt
-   pip install -e .
-   ```
-
-3. **Create a branch** for your change:
-   ```bash
-   git checkout -b fix/short-description
-   ```
-
-4. **Make your changes**, test them, and commit with a clear message:
-   ```bash
-   git commit -m "fix: describe the bug you fixed"
-   ```
-
-5. **Push** to your fork and open a Pull Request against `main`:
-   ```bash
-   git push origin fix/short-description
-   ```
-
-6. In your PR description, explain **what changed** and **why**. Link the issue if there is one.
-
-### Guidelines
+Contributions are welcome. Fork the repo, make your changes on a feature branch, and open a PR against `main`. Keep changes focused and follow the existing code style.
 
-- Keep PRs focused on a single change. Don't mix unrelated fixes.
-- Follow the existing code style — no comments unless absolutely necessary.
-- Test your changes on at least one platform before submitting.
-- If you're adding a feature, update the README and spec if needed.
+For bug reports and feature requests, [open an issue](https://github.com/rj41-w2/idm-cli/issues).
 
 ## License
 

{idm_cli-1.3.0 → idm_cli-1.4.0}/README.md

@@ -1,20 +1,32 @@
-# IDM-CLI (Internet Download Manager CLI)
+<div align="center">
 
-*Inspired by the official [Internet Download Manager (IDM)](https://www.internetdownloadmanager.com/)*
+<h1>IDM-CLI</h1>
 
-A lightning-fast, cross-platform command-line download manager written in Python. IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maximize your internet speed. It supports downloading from **YouTube**, **Facebook**, **Instagram**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
+**A lightning-fast, cross-platform command-line download manager written in Python.**
+
+*The official IDM asks you to pay after 30 days — IDM-CLI is 100% free, open-source, and yours to modify!*
+
+[![PyPI version](https://img.shields.io/pypi/v/idm-cli?color=blue&label=pypi%20version)](https://pypi.org/project/idm-cli/)
+[![Downloads](https://static.pepy.tech/badge/idm-cli)](https://pepy.tech/project/idm-cli)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/rj41-w2/idm-cli/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+[![Install](https://img.shields.io/badge/install-pip%20install%20idm--cli-brightgreen)](https://pypi.org/project/idm-cli/)
+
+[Download via PyPI](https://pypi.org/project/idm-cli/) · [Report a Bug](https://github.com/rj41-w2/idm-cli/issues)
+
+</div>
+
+IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maximize your internet speed. It supports downloading from **YouTube**, **Facebook**, **Instagram**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
 
 ## Features
 
 - **Parallel Chunk Engine** — Splits downloads into multiple concurrent chunks using `aiohttp` async sessions to fully saturate your bandwidth.
-- **Universal Downloader** — Paste any direct URL. A built-in HTTP `HEAD` detector automatically recognizes file types and routes them to the parallel engine.
-- **Social Media Support** — Natively supports YouTube, Facebook, and Instagram via a modular extractor architecture with yt-dlp.
+- **Universal Downloader** — Paste any URL. yt-dlp handles 1000+ sites (YouTube, Facebook, Instagram, etc.), with automatic fallback to direct HTTP download for unsupported URLs.
 - **Audio Only / MP3 Conversion** — Download videos as audio. IDM-CLI automatically grabs the best audio stream and uses FFmpeg to convert it to `.mp3`.
 - **Smart Auto-Resume** — Internet dropped? Pressed `Ctrl+C`? No problem. IDM-CLI remembers the exact byte positions of all incomplete chunks. Paste the same link again to resume instantly.
 - **Persistent Queue System** — Add multiple files to a queue with `-Q` and type `start queue` to download them all sequentially.
-- **Browser Extension Integration** — Chrome/Edge extension intercepts downloads and routes them directly into IDM-CLI via Native Messaging.
 - **Interactive UI** — Modern terminal interface powered by `rich` and `questionary` with real-time speed, ETA, and progress bars. Press `p` to pause, `r` to resume.
-- **Cross-Platform** — Works on Windows, macOS, and Linux with platform-specific FFmpeg handling and browser registration.
+- **Cross-Platform** — Works on Windows, macOS, and Linux with platform-specific FFmpeg handling.
 - **Auto-Update Check** — Checks PyPI once a day and notifies you when a new version is available.
 
 ## Prerequisites
@@ -82,22 +94,9 @@ idm "https://facebook.com/..." -Q
 | `<URL>` | Download a video or file |
 | `resume` | Resume or delete incomplete downloads |
 | `start queue` | Process all queued downloads |
-| `install extension` | Guide to install the browser extension |
 | `help` | Show available commands and flags |
 | `exit` | Exit the application |
 
-### Browser Extension
-
-IDM-CLI includes a Chrome/Edge extension that intercepts file downloads automatically. To install it:
-
-```bash
-idm
-# then type:
-install extension
-```
-
-Follow the on-screen guide to load the unpacked extension and link it to IDM-CLI.
-
 ### Troubleshooting: Windows Device Guard
 
 If you get `"idm.exe was blocked by your organization's Device Guard policy"`, run the Python module directly:
@@ -125,69 +124,13 @@ idm_cli/
 │   ├── ytdlp.py             # YouTube/social media extractor
 │   ├── direct.py            # Direct HTTP file downloader
 │   └── winget.py            # Windows Package Manager extractor
-└── extension/
-    ├── extension.py         # Browser extension installer
-    ├── native_host.py       # Native Messaging Host
-    ├── daemon.py            # Queue daemon with PID lock
-    └── browser_extension/   # Chrome/Edge extension source
 ```
 
 ## Contributing
 
-Contributions are welcome — whether it's a bug fix, a new feature, or just improving the docs.
-
-### Reporting Bugs
-
-If you find a bug, [open an issue](https://github.com/rj41-w2/idm-cli/issues/new) with:
-
-- A clear title and description of the problem
-- Steps to reproduce the issue
-- Your OS and Python version (`python --version`)
-- The full error output if there is one
-
-### Suggesting Features
-
-Got an idea? [Open an issue](https://github.com/rj41-w2/idm-cli/issues/new) with the tag `enhancement` and describe:
-
-- What you want to happen and why
-- How it would work from the user's perspective
-- Any alternatives you considered
-
-### Submitting a Pull Request
-
-1. **Fork** the repository from [github.com/rj41-w2/idm-cli](https://github.com/rj41-w2/idm-cli)
-
-2. **Clone your fork** and set it up:
-   ```bash
-   git clone https://github.com/<your-username>/idm-cli.git
-   cd IDM-CLI
-   pip install -r requirements.txt
-   pip install -e .
-   ```
-
-3. **Create a branch** for your change:
-   ```bash
-   git checkout -b fix/short-description
-   ```
-
-4. **Make your changes**, test them, and commit with a clear message:
-   ```bash
-   git commit -m "fix: describe the bug you fixed"
-   ```
-
-5. **Push** to your fork and open a Pull Request against `main`:
-   ```bash
-   git push origin fix/short-description
-   ```
-
-6. In your PR description, explain **what changed** and **why**. Link the issue if there is one.
-
-### Guidelines
+Contributions are welcome. Fork the repo, make your changes on a feature branch, and open a PR against `main`. Keep changes focused and follow the existing code style.
 
-- Keep PRs focused on a single change. Don't mix unrelated fixes.
-- Follow the existing code style — no comments unless absolutely necessary.
-- Test your changes on at least one platform before submitting.
-- If you're adding a feature, update the README and spec if needed.
+For bug reports and feature requests, [open an issue](https://github.com/rj41-w2/idm-cli/issues).
 
 ## License
 

idm_cli-1.4.0/idm_cli/__init__.py

@@ -0,0 +1,3 @@
+# IDM-CLI Package
+
+__version__ = "1.4.0"

{idm_cli-1.3.0 → idm_cli-1.4.0}/idm_cli/config.py

@@ -6,13 +6,15 @@ import logging
 from logging.handlers import RotatingFileHandler
 from platformdirs import user_data_dir, user_downloads_dir
 
+__all__ = ["CONFIG_DIR", "CONFIG_FILE", "logger", "load_config", "save_config", "setup_logging"]
+
 APP_NAME = "idm-cli"
 APP_AUTHOR = "idm-cli"
 CONFIG_DIR = user_data_dir(APP_NAME, APP_AUTHOR)
 CONFIG_FILE = os.path.join(CONFIG_DIR, "config.json")
 LOG_FILE = os.path.join(CONFIG_DIR, "idm.log")
 
-def _migrate_old_config():
+def _migrate_old_config() -> None:
     old_dir = os.path.expanduser("~/.idm_cli")
     if old_dir == CONFIG_DIR:
         return
@@ -20,6 +22,8 @@ def _migrate_old_config():
         return
     os.makedirs(CONFIG_DIR, exist_ok=True)
     for item in os.listdir(old_dir):
+        if item == "__pycache__":
+            continue
         src = os.path.join(old_dir, item)
         dst = os.path.join(CONFIG_DIR, item)
         if not os.path.exists(dst):
@@ -34,16 +38,22 @@ def _migrate_old_config():
 def _get_default_download_dir() -> str:
     return user_downloads_dir()
 
-def setup_logging():
+def setup_logging() -> logging.Logger:
     _migrate_old_config()
     os.makedirs(CONFIG_DIR, exist_ok=True)
     logger = logging.getLogger("idm_cli")
     logger.setLevel(logging.DEBUG)
     if not logger.handlers:
-        handler = RotatingFileHandler(LOG_FILE, maxBytes=5*1024*1024, backupCount=2)
         formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
-        handler.setFormatter(formatter)
-        logger.addHandler(handler)
+
+        file_handler = RotatingFileHandler(LOG_FILE, maxBytes=5*1024*1024, backupCount=2, encoding="utf-8")
+        file_handler.setFormatter(formatter)
+        logger.addHandler(file_handler)
+
+        stream_handler = logging.StreamHandler()
+        stream_handler.setFormatter(formatter)
+        stream_handler.stream.reconfigure(errors="backslashreplace")
+        logger.addHandler(stream_handler)
     return logger
 
 logger = setup_logging()
@@ -55,7 +65,7 @@ DEFAULT_CONFIG = {
     "last_version": "0.0.0"
 }
 
-def load_config():
+def load_config() -> dict:
     config = DEFAULT_CONFIG.copy()
     if os.path.exists(CONFIG_FILE):
         try:
@@ -66,7 +76,7 @@ def load_config():
             logger.warning(f"Failed to load config: {e}")
     return config
 
-def save_config(config_data):
+def save_config(config_data: dict) -> None:
     os.makedirs(CONFIG_DIR, exist_ok=True)
     try:
         with open(CONFIG_FILE, "w") as f:

idm_cli-1.4.0/idm_cli/downloader/converter.py

@@ -0,0 +1,147 @@
+import os
+import logging
+import subprocess
+from typing import Optional
+
+from rich.table import Table
+
+from idm_cli.ui.utils import console
+
+logger = logging.getLogger(__name__)
+
+VIDEO_EXTENSIONS = {".mp4", ".mkv", ".avi", ".mov", ".webm", ".flv", ".wmv", ".m4v", ".ts", ".mpg", ".mpeg", ".3gp"}
+
+
+def resolve_input_path(path_str: str) -> str:
+    cleaned = path_str.strip()
+    if len(cleaned) >= 2 and cleaned[0] == cleaned[-1] and cleaned[0] in ("'", '"'):
+        cleaned = cleaned[1:-1].strip()
+    return os.path.abspath(os.path.expandvars(os.path.expanduser(cleaned)))
+
+
+def is_local_path(path_str: str) -> bool:
+    try:
+        resolved = resolve_input_path(path_str)
+        return os.path.isfile(resolved) or os.path.isdir(resolved)
+    except (OSError, ValueError):
+        return False
+
+
+def collect_video_files(path_str: str) -> list:
+    resolved = resolve_input_path(path_str)
+    if os.path.isdir(resolved):
+        videos = []
+        for name in sorted(os.listdir(resolved)):
+            full_path = os.path.join(resolved, name)
+            if os.path.isfile(full_path) and os.path.splitext(name)[1].lower() in VIDEO_EXTENSIONS:
+                videos.append(full_path)
+        if not videos:
+            raise ValueError(f"No video files found in folder: {resolved}")
+        return videos
+    if os.path.isfile(resolved):
+        if os.path.splitext(resolved)[1].lower() in VIDEO_EXTENSIONS:
+            return [resolved]
+        supported = ", ".join(sorted(ext.lstrip(".") for ext in VIDEO_EXTENSIONS))
+        raise ValueError(f"Not a supported video format: {resolved} (Supported: {supported})")
+    raise ValueError(f"Path not found: {resolved}")
+
+
+def convert_video_to_audio(video_path: str, output_path: Optional[str] = None) -> str:
+    """
+    Converts a local video file to MP3 using ffmpeg.
+    Never deletes the source video.
+    """
+    if not os.path.exists(video_path):
+        raise FileNotFoundError(f"Video file not found: {video_path}")
+
+    from idm_cli.downloader.muxer import get_ffmpeg_path, _ffmpeg_install_hint
+
+    ffmpeg_bin = get_ffmpeg_path()
+    if not ffmpeg_bin:
+        raise RuntimeError("FFmpeg is not installed! Cannot convert video.")
+
+    if output_path is None:
+        base, _ = os.path.splitext(video_path)
+        output_path = base + ".mp3"
+
+    os.makedirs(os.path.dirname(output_path) or ".", exist_ok=True)
+
+    cmd = [
+        ffmpeg_bin,
+        "-y",
+        "-i", video_path,
+        "-vn",
+        "-q:a", "0",
+        output_path
+    ]
+
+    try:
+        subprocess.run(cmd, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    except subprocess.CalledProcessError as e:
+        logger.error(f"FFmpeg conversion failed: {e.stderr.decode('utf-8', errors='replace')}")
+        raise RuntimeError(f"FFmpeg conversion failed: {e}")
+    except FileNotFoundError:
+        raise RuntimeError(f"FFmpeg is not installed! {_ffmpeg_install_hint()}")
+
+    return output_path
+
+
+def process_conversion(path_str: str, delete_source: bool = False, is_interactive: bool = True) -> bool:
+    from idm_cli.downloader.muxer import get_ffmpeg_path, ensure_ffmpeg
+
+    try:
+        videos = collect_video_files(path_str)
+    except ValueError as e:
+        console.print(f"[bold red]{e}")
+        return False
+
+    if not get_ffmpeg_path() and not ensure_ffmpeg(is_interactive=is_interactive):
+        return False
+
+    total = len(videos)
+    converted_count = 0
+    results = []
+
+    if total > 1:
+        console.print(f"\n[bold cyan]Found {total} videos. Converting to MP3...[/bold cyan]\n")
+
+    try:
+        for index, video in enumerate(videos, start=1):
+            label = os.path.basename(video)
+            prefix = f"({index}/{total}) " if total > 1 else ""
+            try:
+                with console.status(f"[bold cyan]{prefix}Converting {label} to MP3...", spinner="dots"):
+                    output_path = convert_video_to_audio(video)
+                results.append((label, True, output_path))
+                converted_count += 1
+                if delete_source:
+                    try:
+                        os.remove(video)
+                    except OSError as e:
+                        logger.warning(f"Failed to delete source file: {e}")
+            except (RuntimeError, FileNotFoundError, OSError) as e:
+                logger.error(f"Conversion failed for {video}: {e}")
+                results.append((label, False, str(e)))
+    except KeyboardInterrupt:
+        console.print("\n[bold yellow]Conversion interrupted by user[/bold yellow]")
+
+    table = Table(title="Conversion Summary", title_style="bold cyan", border_style="cyan", show_header=False, padding=(0, 2))
+    table.add_column("File", style="cyan")
+    table.add_column("Result", style="white")
+    for label, success, detail in results:
+        if success:
+            table.add_row(label, f"[bold green]OK[/] [dim white]-> {detail}[/]")
+        else:
+            table.add_row(label, f"[bold red]FAILED:[/] {detail}")
+    console.print()
+
+    failed_count = total - converted_count
+    if converted_count == total:
+        console.print(f"[bold green]{converted_count} file(s) converted successfully.[/]")
+    elif converted_count > 0:
+        console.print(f"[bold yellow]{converted_count}/{total} file(s) converted ({failed_count} failed).[/]")
+    else:
+        console.print("[bold red]All conversions failed.[/]")
+    console.print()
+
+    return converted_count > 0