idm-cli 0.0.1__tar.gz

idm_cli-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rehan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

idm_cli-0.0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include requirements.txt
+include README.md
+include LICENSE

idm_cli-0.0.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: idm-cli
+Version: 0.0.1
+Summary: A lightning-fast, universal command-line download manager
+Home-page: https://github.com/rj41-w2/idm-cli
+Author: Rehan
+Author-email: rehanjamilwattoo@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: aiohttp
+Requires-Dist: aiofiles
+Requires-Dist: yt-dlp
+Requires-Dist: pyfiglet
+Requires-Dist: questionary
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# IDM-CLI (Internet Download Manager CLI)
+
+A lightning-fast, powerful, and universal 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 seamlessly supports downloading from **YouTube**, **Facebook**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
+
+## 🚀 Features
+
+- **Blazing Fast Speeds:** Splits downloads into multiple parallel chunks (like traditional IDM) to fully saturate your bandwidth.
+- **Universal Downloader:** Paste any direct URL (e.g., a `.pdf` or `.exe`). The built-in smart HTTP `HEAD` detector automatically recognizes file types and routes them to the parallel engine.
+- **Social Media Support:** Natively supports downloading from **YouTube** and **Facebook** via a modular extractor architecture. Auto-detects pre-muxed (SD/HD) vs separated streams.
+- **Audio Only / MP3 Conversion:** Easily download videos as audio. IDM-CLI automatically grabs the best audio stream and uses `ffmpeg` to perfectly 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 (`-Q`):** Add multiple files or videos to a queue and type `start queue` to automatically download all of them sequentially in the background.
+- **Pristine Downloads Folder:** All temporary chunks and raw media files are kept hidden in `~/.idm_cli/tmp/`. Only the fully assembled, 100% complete files are moved to your `~/Downloads` folder.
+- **Interactive UI:** A beautiful, responsive terminal interface powered by `rich` and `questionary` with real-time speed, ETA, and progress bars.
+- **Pause & Play:** Press `p` to pause the active downloads without losing progress, and `r` to resume them.
+
+## 🛠️ Prerequisites
+
+- **Python 3.8+**
+- **FFmpeg:** Required for muxing video and audio streams, and converting media to `.mp3`. Ensure `ffmpeg` is installed and added to your system's PATH.
+
+## 📦 Installation
+
+Clone the repository and install the required dependencies:
+
+```bash
+git clone https://github.com/rj41-w2/idm-cli.git
+cd IDM-CLI
+pip install -r requirements.txt
+```
+
+*(Note: If you plan to publish this to PyPI, users will simply be able to run `pip install idm-cli`)*
+
+## 💻 Usage
+
+Run the app interactively by simply typing:
+```bash
+idm
+```
+This will open a prompt where you can paste your link, select video resolutions, or choose to queue the download.
+
+### CLI Flags (Fast Mode)
+
+Skip the interactive menus by passing arguments directly!
+
+```bash
+# Download a video with auto-selected 1080p quality
+idm "https://youtube.com/watch?v=..." -q 1080p -v
+
+# Download Audio Only (converts to MP3)
+idm "https://youtube.com/watch?v=..." -a
+
+# Use 16 parallel chunks for maximum speed (default is 8)
+idm "https://example.com/largefile.zip" -c 16
+
+# Add a video to the Queue without downloading it right now
+idm "https://facebook.com/..." -Q
+```
+
+### Queue Management
+
+To start downloading all items currently in your queue, simply type:
+```bash
+idm start queue
+```
+*(You can also just type `start queue` into the interactive `idm` prompt!)*
+
+## ⚙️ Architecture Highlights
+
+- **`downloader.py`:** The core asynchronous engine handling `aiohttp` range requests, chunk merging, and resume states.
+- **`cli.py`:** The interactive orchestration layer utilizing `typer`, `rich`, and `questionary`.
+- **`muxer.py`:** Safe abstraction over `subprocess` calls to `ffmpeg` for media stream merging.
+- **`extractors/`:** Modular plugins (`youtube.py`, `facebook.py`, `direct.py`) for handling specialized metadata retrieval.
+
+## 📄 License
+
+This project is open-source and available under the MIT License.

idm_cli-0.0.1/README.md

@@ -0,0 +1,77 @@
+# IDM-CLI (Internet Download Manager CLI)
+
+A lightning-fast, powerful, and universal 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 seamlessly supports downloading from **YouTube**, **Facebook**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
+
+## 🚀 Features
+
+- **Blazing Fast Speeds:** Splits downloads into multiple parallel chunks (like traditional IDM) to fully saturate your bandwidth.
+- **Universal Downloader:** Paste any direct URL (e.g., a `.pdf` or `.exe`). The built-in smart HTTP `HEAD` detector automatically recognizes file types and routes them to the parallel engine.
+- **Social Media Support:** Natively supports downloading from **YouTube** and **Facebook** via a modular extractor architecture. Auto-detects pre-muxed (SD/HD) vs separated streams.
+- **Audio Only / MP3 Conversion:** Easily download videos as audio. IDM-CLI automatically grabs the best audio stream and uses `ffmpeg` to perfectly 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 (`-Q`):** Add multiple files or videos to a queue and type `start queue` to automatically download all of them sequentially in the background.
+- **Pristine Downloads Folder:** All temporary chunks and raw media files are kept hidden in `~/.idm_cli/tmp/`. Only the fully assembled, 100% complete files are moved to your `~/Downloads` folder.
+- **Interactive UI:** A beautiful, responsive terminal interface powered by `rich` and `questionary` with real-time speed, ETA, and progress bars.
+- **Pause & Play:** Press `p` to pause the active downloads without losing progress, and `r` to resume them.
+
+## 🛠️ Prerequisites
+
+- **Python 3.8+**
+- **FFmpeg:** Required for muxing video and audio streams, and converting media to `.mp3`. Ensure `ffmpeg` is installed and added to your system's PATH.
+
+## 📦 Installation
+
+Clone the repository and install the required dependencies:
+
+```bash
+git clone https://github.com/rj41-w2/idm-cli.git
+cd IDM-CLI
+pip install -r requirements.txt
+```
+
+*(Note: If you plan to publish this to PyPI, users will simply be able to run `pip install idm-cli`)*
+
+## 💻 Usage
+
+Run the app interactively by simply typing:
+```bash
+idm
+```
+This will open a prompt where you can paste your link, select video resolutions, or choose to queue the download.
+
+### CLI Flags (Fast Mode)
+
+Skip the interactive menus by passing arguments directly!
+
+```bash
+# Download a video with auto-selected 1080p quality
+idm "https://youtube.com/watch?v=..." -q 1080p -v
+
+# Download Audio Only (converts to MP3)
+idm "https://youtube.com/watch?v=..." -a
+
+# Use 16 parallel chunks for maximum speed (default is 8)
+idm "https://example.com/largefile.zip" -c 16
+
+# Add a video to the Queue without downloading it right now
+idm "https://facebook.com/..." -Q
+```
+
+### Queue Management
+
+To start downloading all items currently in your queue, simply type:
+```bash
+idm start queue
+```
+*(You can also just type `start queue` into the interactive `idm` prompt!)*
+
+## ⚙️ Architecture Highlights
+
+- **`downloader.py`:** The core asynchronous engine handling `aiohttp` range requests, chunk merging, and resume states.
+- **`cli.py`:** The interactive orchestration layer utilizing `typer`, `rich`, and `questionary`.
+- **`muxer.py`:** Safe abstraction over `subprocess` calls to `ffmpeg` for media stream merging.
+- **`extractors/`:** Modular plugins (`youtube.py`, `facebook.py`, `direct.py`) for handling specialized metadata retrieval.
+
+## 📄 License
+
+This project is open-source and available under the MIT License.

idm_cli-0.0.1/idm_cli/__init__.py

@@ -0,0 +1 @@
+# IDM-CLI Package