plexo-cli 0.1.0__tar.gz → 0.1.2__tar.gz

plexo_cli-0.1.2/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.env

plexo_cli-0.1.2/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.5
+Name: plexo-cli
+Version: 0.1.2
+Summary: Multi-network bandwidth bonding download engine & CLI
+Author-email: Jagjot Singh <gotogether@gmail.com>
+License-Expression: MIT
+Keywords: bandwidth-aggregation,download-accelerator,multi-interface,network-bonding,proxy,torrent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: urllib3>=2.0.0
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# ⚡ Plexo CLI (`plexo-cli`)
+
+[![PyPI version](https://img.shields.io/pypi/v/plexo-cli.svg?color=blue)](https://pypi.org/project/plexo-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/plexo-cli.svg)](https://pypi.org/project/plexo-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-36%20passed-success.svg)](tests/)
+
+> **Universal, lightweight, terminal-first multi-network bandwidth bonding and torrent engine.**  
+> Combines Wi-Fi, Ethernet, and Mobile 5G tethering into one unified high-speed pipe directly from your command line.
+
+---
+
+## 🚀 Key Features
+
+* **🌐 Multi-Socket Bandwidth Bonding:** Binds parallel download workers to distinct physical network interfaces using source-IP socket routing (`urllib3.PoolManager(source_address=(NIC_IP, 0))`).
+* **🧲 BitTorrent Multi-Homing Swarm:** Slices BitTorrent peer swarms across multiple network adapters simultaneously with SHA-1 piece verification.
+* **🎬 Watch While Downloading (`--sequential`):** Prioritizes file headers (moov container) and opening frames so media players like **VLC** can stream video immediately from byte 0.
+* **🪞 Multi-Source Mirror Bonding (`-m / --mirror`):** Pulls chunks simultaneously across distinct server mirrors (e.g. Mirror A on Wi-Fi, Mirror B on 5G) to bypass server-side IP throttling.
+* **🛡️ Per-Adapter Data Quotas (`-q / --quota`):** Protects mobile hotspot data caps (e.g. `-q usb=1.5GB`). When the cap is reached, that connection rests while unlimited Wi-Fi finishes the rest.
+* **📂 Selective Torrent Downloads (`--list`, `--select`):** Inspect contents of multi-file season packs and download only the specific episodes you need.
+* **📋 Background Clipboard Watcher (`plexo watch`):** IDM-style daemon that monitors the system clipboard and auto-captures `.mp4`, `.mkv`, `.zip`, `.iso`, or `magnet:` links.
+* **⚡ Zero-Touch Local Acceleration Proxy (`plexo proxy`):** Runs a local forward proxy (`127.0.0.1:8899`) to bond traffic for `pip`, `curl`, `git`, and `huggingface-cli`.
+* **💾 Smart Checkpointing & Instant Resume (`.plexo`):** Non-destructive NTFS/ext4 sparse file pre-allocation with zero-overhead resume on interrupted downloads.
+
+---
+
+## 📦 Installation
+
+### From PyPI
+```bash
+pip install plexo-cli
+```
+
+### From Source (Editable Mode)
+```bash
+git clone https://github.com/anmolkapil/plexo.git
+cd plexo/packages/plexo-cli
+pip install -e .
+```
+
+---
+
+## 🛠️ CLI Command Reference
+
+### 1. Discover Active Interfaces: `plexo adapters`
+Scans and validates all active physical, Ethernet, and wireless interfaces, verifying outward internet reachability via canary probes:
+```bash
+plexo adapters
+```
+
+*Example Output:*
+```text
++-------------------+---------------+----------+---------+--------+
+| Adapter Name      | IP Address    | Type     | State   | Canary |
++-------------------+---------------+----------+---------+--------+
+| Wi-Fi (Hostel)    | 192.168.1.104 | Wi-Fi    | UP      | ONLINE |
+| Phone 5G USB      | 192.168.43.55 | Ethernet | UP      | ONLINE |
++-------------------+---------------+----------+---------+--------+
+```
+
+---
+
+### 2. Bonded HTTP Downloads: `plexo download`
+
+#### Basic Parallel Download
+```bash
+plexo download "https://example.com/largefile.zip" -o "largefile.zip"
+```
+
+#### Watch While Downloading (`--sequential`)
+Download chunks in strict chronological order so you can open and watch the video in VLC within 30 seconds:
+```bash
+plexo download "https://example.com/movie.mp4" --sequential -o "movie.mp4"
+```
+
+#### Multi-Source Mirror Bonding (`-m / --mirror`)
+Distribute chunk downloads across multiple server mirrors and multiple adapters:
+```bash
+plexo download "https://mirror1.com/ubuntu.iso" -m "https://mirror2.com/ubuntu.iso" -o "ubuntu.iso"
+```
+
+#### Protect Mobile Data Caps (`-q / --quota`)
+Specify a maximum data quota for any adapter by name or IP:
+```bash
+# Cap Phone USB tethering to 1.5 GB, let Wi-Fi pull the rest:
+plexo download "<url>" -q "usb=1.5GB"
+
+# Cap a specific network IP to 500 MB:
+plexo download "<url>" -q "192.168.43.55=500MB"
+```
+
+#### Authenticated / Protected Filelockers (`--cookie`, `--referer`, `-H`)
+```bash
+plexo download "<protected-url>" \
+  --cookie "session_token=abcdef123456" \
+  --referer "https://filelocker.com/view" \
+  -H "Authorization: Bearer my_token"
+```
+
+---
+
+### 3. BitTorrent Swarm Multi-Homing: `plexo torrent`
+
+#### Magnet Links & `.torrent` Files
+```bash
+# Magnet URI:
+plexo torrent "magnet:?xt=urn:btih:EXAMPLE_HASH&dn=Debian" -o "D:\Downloads"
+
+# Local .torrent file:
+plexo torrent "debian.torrent" -o "D:\Downloads"
+```
+
+#### Inspect Torrent Files (`--list`)
+```bash
+plexo torrent "magnet:?xt=urn:btih:..." --list
+```
+
+#### Download Selected Files (`--select`)
+Download only specific files or episodes from large torrents:
+```bash
+# Download only Episode 1 (index 1):
+plexo torrent "magnet:?xt=urn:btih:..." --select 1
+
+# Download multiple episodes:
+plexo torrent "magnet:?xt=urn:btih:..." --select 1,2,5
+```
+
+#### Sequential Torrent Playback (`--sequential`)
+```bash
+plexo torrent "magnet:?xt=urn:btih:..." --sequential -o "D:\Movies"
+```
+
+---
+
+### 4. Background Clipboard Watcher: `plexo watch`
+Listens in the background for copied download links (`.mp4`, `.mkv`, `.zip`, `.iso`, `magnet:`, etc.):
+
+```bash
+# Interactive mode (prompts [Y/n] when a downloadable URL is copied):
+plexo watch
+
+# Headless / Auto-download mode:
+plexo watch -a -o "D:\Downloads"
+
+# Auto-download with sequential streaming:
+plexo watch -a --sequential -o "D:\Movies"
+```
+
+---
+
+### 5. Local Acceleration Proxy: `plexo proxy`
+Accelerate development tools across bonded network connections:
+
+```bash
+# Start proxy on default port 8899:
+plexo proxy --port 8899
+```
+
+In another terminal, direct tools to use the proxy:
+```bash
+# Accelerate pip:
+pip install torch torchvision --proxy http://127.0.0.1:8899
+
+# Accelerate curl / Hugging Face CLI:
+export HTTPS_PROXY="http://127.0.0.1:8899"
+curl -O https://example.com/dataset.tar.gz
+```
+
+---
+
+### 6. Probe Server Capabilities: `plexo info`
+Inspect remote server headers, file size, MIME type, and byte-range support:
+```bash
+plexo info "https://example.com/file.zip"
+```
+
+---
+
+## 🧪 Verification & Testing
+
+The package includes a comprehensive automated test suite testing live sockets, mock mirrors, sparse file allocation, torrent bencoding, QoS quota enforcement, and clipboard regex extractors:
+
+```bash
+pytest packages/plexo-cli -v
+```
+```text
+tests/test_adapter.py     PASSED (3/3)
+tests/test_sparse.py      PASSED (3/3)
+tests/test_torrent.py     PASSED (4/4)
+tests/test_engine.py      PASSED (5/5)
+tests/test_watcher.py     PASSED (12/12)
+tests/test_mirror.py      PASSED (9/9)
+============================= 36 passed in 10.10s =============================
+```
+
+---
+
+## 📄 License
+MIT © Anmol Kapil & Jagjot Singh

plexo_cli-0.1.2/README.md

@@ -0,0 +1,199 @@
+# ⚡ Plexo CLI (`plexo-cli`)
+
+[![PyPI version](https://img.shields.io/pypi/v/plexo-cli.svg?color=blue)](https://pypi.org/project/plexo-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/plexo-cli.svg)](https://pypi.org/project/plexo-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-36%20passed-success.svg)](tests/)
+
+> **Universal, lightweight, terminal-first multi-network bandwidth bonding and torrent engine.**  
+> Combines Wi-Fi, Ethernet, and Mobile 5G tethering into one unified high-speed pipe directly from your command line.
+
+---
+
+## 🚀 Key Features
+
+* **🌐 Multi-Socket Bandwidth Bonding:** Binds parallel download workers to distinct physical network interfaces using source-IP socket routing (`urllib3.PoolManager(source_address=(NIC_IP, 0))`).
+* **🧲 BitTorrent Multi-Homing Swarm:** Slices BitTorrent peer swarms across multiple network adapters simultaneously with SHA-1 piece verification.
+* **🎬 Watch While Downloading (`--sequential`):** Prioritizes file headers (moov container) and opening frames so media players like **VLC** can stream video immediately from byte 0.
+* **🪞 Multi-Source Mirror Bonding (`-m / --mirror`):** Pulls chunks simultaneously across distinct server mirrors (e.g. Mirror A on Wi-Fi, Mirror B on 5G) to bypass server-side IP throttling.
+* **🛡️ Per-Adapter Data Quotas (`-q / --quota`):** Protects mobile hotspot data caps (e.g. `-q usb=1.5GB`). When the cap is reached, that connection rests while unlimited Wi-Fi finishes the rest.
+* **📂 Selective Torrent Downloads (`--list`, `--select`):** Inspect contents of multi-file season packs and download only the specific episodes you need.
+* **📋 Background Clipboard Watcher (`plexo watch`):** IDM-style daemon that monitors the system clipboard and auto-captures `.mp4`, `.mkv`, `.zip`, `.iso`, or `magnet:` links.
+* **⚡ Zero-Touch Local Acceleration Proxy (`plexo proxy`):** Runs a local forward proxy (`127.0.0.1:8899`) to bond traffic for `pip`, `curl`, `git`, and `huggingface-cli`.
+* **💾 Smart Checkpointing & Instant Resume (`.plexo`):** Non-destructive NTFS/ext4 sparse file pre-allocation with zero-overhead resume on interrupted downloads.
+
+---
+
+## 📦 Installation
+
+### From PyPI
+```bash
+pip install plexo-cli
+```
+
+### From Source (Editable Mode)
+```bash
+git clone https://github.com/anmolkapil/plexo.git
+cd plexo/packages/plexo-cli
+pip install -e .
+```
+
+---
+
+## 🛠️ CLI Command Reference
+
+### 1. Discover Active Interfaces: `plexo adapters`
+Scans and validates all active physical, Ethernet, and wireless interfaces, verifying outward internet reachability via canary probes:
+```bash
+plexo adapters
+```
+
+*Example Output:*
+```text
++-------------------+---------------+----------+---------+--------+
+| Adapter Name      | IP Address    | Type     | State   | Canary |
++-------------------+---------------+----------+---------+--------+
+| Wi-Fi (Hostel)    | 192.168.1.104 | Wi-Fi    | UP      | ONLINE |
+| Phone 5G USB      | 192.168.43.55 | Ethernet | UP      | ONLINE |
++-------------------+---------------+----------+---------+--------+
+```
+
+---
+
+### 2. Bonded HTTP Downloads: `plexo download`
+
+#### Basic Parallel Download
+```bash
+plexo download "https://example.com/largefile.zip" -o "largefile.zip"
+```
+
+#### Watch While Downloading (`--sequential`)
+Download chunks in strict chronological order so you can open and watch the video in VLC within 30 seconds:
+```bash
+plexo download "https://example.com/movie.mp4" --sequential -o "movie.mp4"
+```
+
+#### Multi-Source Mirror Bonding (`-m / --mirror`)
+Distribute chunk downloads across multiple server mirrors and multiple adapters:
+```bash
+plexo download "https://mirror1.com/ubuntu.iso" -m "https://mirror2.com/ubuntu.iso" -o "ubuntu.iso"
+```
+
+#### Protect Mobile Data Caps (`-q / --quota`)
+Specify a maximum data quota for any adapter by name or IP:
+```bash
+# Cap Phone USB tethering to 1.5 GB, let Wi-Fi pull the rest:
+plexo download "<url>" -q "usb=1.5GB"
+
+# Cap a specific network IP to 500 MB:
+plexo download "<url>" -q "192.168.43.55=500MB"
+```
+
+#### Authenticated / Protected Filelockers (`--cookie`, `--referer`, `-H`)
+```bash
+plexo download "<protected-url>" \
+  --cookie "session_token=abcdef123456" \
+  --referer "https://filelocker.com/view" \
+  -H "Authorization: Bearer my_token"
+```
+
+---
+
+### 3. BitTorrent Swarm Multi-Homing: `plexo torrent`
+
+#### Magnet Links & `.torrent` Files
+```bash
+# Magnet URI:
+plexo torrent "magnet:?xt=urn:btih:EXAMPLE_HASH&dn=Debian" -o "D:\Downloads"
+
+# Local .torrent file:
+plexo torrent "debian.torrent" -o "D:\Downloads"
+```
+
+#### Inspect Torrent Files (`--list`)
+```bash
+plexo torrent "magnet:?xt=urn:btih:..." --list
+```
+
+#### Download Selected Files (`--select`)
+Download only specific files or episodes from large torrents:
+```bash
+# Download only Episode 1 (index 1):
+plexo torrent "magnet:?xt=urn:btih:..." --select 1
+
+# Download multiple episodes:
+plexo torrent "magnet:?xt=urn:btih:..." --select 1,2,5
+```
+
+#### Sequential Torrent Playback (`--sequential`)
+```bash
+plexo torrent "magnet:?xt=urn:btih:..." --sequential -o "D:\Movies"
+```
+
+---
+
+### 4. Background Clipboard Watcher: `plexo watch`
+Listens in the background for copied download links (`.mp4`, `.mkv`, `.zip`, `.iso`, `magnet:`, etc.):
+
+```bash
+# Interactive mode (prompts [Y/n] when a downloadable URL is copied):
+plexo watch
+
+# Headless / Auto-download mode:
+plexo watch -a -o "D:\Downloads"
+
+# Auto-download with sequential streaming:
+plexo watch -a --sequential -o "D:\Movies"
+```
+
+---
+
+### 5. Local Acceleration Proxy: `plexo proxy`
+Accelerate development tools across bonded network connections:
+
+```bash
+# Start proxy on default port 8899:
+plexo proxy --port 8899
+```
+
+In another terminal, direct tools to use the proxy:
+```bash
+# Accelerate pip:
+pip install torch torchvision --proxy http://127.0.0.1:8899
+
+# Accelerate curl / Hugging Face CLI:
+export HTTPS_PROXY="http://127.0.0.1:8899"
+curl -O https://example.com/dataset.tar.gz
+```
+
+---
+
+### 6. Probe Server Capabilities: `plexo info`
+Inspect remote server headers, file size, MIME type, and byte-range support:
+```bash
+plexo info "https://example.com/file.zip"
+```
+
+---
+
+## 🧪 Verification & Testing
+
+The package includes a comprehensive automated test suite testing live sockets, mock mirrors, sparse file allocation, torrent bencoding, QoS quota enforcement, and clipboard regex extractors:
+
+```bash
+pytest packages/plexo-cli -v
+```
+```text
+tests/test_adapter.py     PASSED (3/3)
+tests/test_sparse.py      PASSED (3/3)
+tests/test_torrent.py     PASSED (4/4)
+tests/test_engine.py      PASSED (5/5)
+tests/test_watcher.py     PASSED (12/12)
+tests/test_mirror.py      PASSED (9/9)
+============================= 36 passed in 10.10s =============================
+```
+
+---
+
+## 📄 License
+MIT © Anmol Kapil & Jagjot Singh

{plexo_cli-0.1.0 → plexo_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plexo-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Multi-network bandwidth bonding download engine & CLI"
 readme = "README.md"
 requires-python = ">=3.9"

{plexo_cli-0.1.0 → plexo_cli-0.1.2}/src/plexo/__init__.py

@@ -1,4 +1,4 @@
 """Plexo CLI: Multi-network bandwidth bonding download accelerator."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 __author__ = "Jagjot Singh"

{plexo_cli-0.1.0 → plexo_cli-0.1.2}/src/plexo/cli.py

@@ -1,6 +1,6 @@
 """Command Line Interface for Plexo.
 
-Exposes subcommands: download, adapters, proxy, info.
+Exposes subcommands: download, adapters, proxy, torrent, watch, info.
 """
 
 from __future__ import annotations
@@ -76,16 +76,56 @@ def list_adapters(show_all: bool):
 
 @main.command(name="download")
 @click.argument("url")
+@click.option("-m", "--mirror", "mirrors", multiple=True, help="Alternative mirror URL(s) for the same file.")
 @click.option("-o", "--output", "output_path", type=click.Path(), default=None, help="Output destination path.")
 @click.option("--chunk-size", default=8, type=int, help="Chunk size in MB (default: 8 MB).")
 @click.option("--workers", default=2, type=int, help="Workers per network adapter (default: 2).")
-def download_file(url: str, output_path: Optional[str], chunk_size: int, workers: int):
-    """Download a file using bonded multi-network connections."""
+@click.option("-H", "--header", "headers_list", multiple=True, help="Custom HTTP header (e.g. -H 'Auth: token').")
+@click.option("--cookie", default=None, help="Custom Cookie header for protected sites/filelockers.")
+@click.option("--referer", default=None, help="Custom Referer URL for sites requiring origin verification.")
+@click.option("--sequential", is_flag=True, help="Download in sequential order (watch media while downloading).")
+@click.option("-q", "--quota", "quota_list", multiple=True, help="Data cap for adapter (e.g. -q usb=1.5GB).")
+def download_file(
+    url: str,
+    mirrors: tuple[str, ...],
+    output_path: Optional[str],
+    chunk_size: int,
+    workers: int,
+    headers_list: tuple[str, ...],
+    cookie: Optional[str],
+    referer: Optional[str],
+    sequential: bool,
+    quota_list: tuple[str, ...],
+):
+    """Download a file using bonded multi-network connections and mirrors."""
+    from .core.qos import parse_size_str
     adapters = get_bonded_pool()
     if not adapters:
         console.print("[bold red]Error: No active online network adapters detected.[/bold red]")
         raise click.Abort()
 
+    # Parse custom headers
+    parsed_headers = {}
+    for h in headers_list:
+        if ":" in h:
+            k, v = h.split(":", 1)
+            parsed_headers[k.strip()] = v.strip()
+
+    # Parse adapter data quotas
+    parsed_quotas = {}
+    for q in quota_list:
+        if "=" in q:
+            ident, s_val = q.split("=", 1)
+            parsed_quotas[ident.strip()] = parse_size_str(s_val.strip())
+
+    # Parse alternative mirror URLs
+    parsed_mirrors = []
+    for m in mirrors:
+        for sub_m in m.split(","):
+            sub_m = sub_m.strip()
+            if sub_m and sub_m not in parsed_mirrors and sub_m != url:
+                parsed_mirrors.append(sub_m)
+
     dashboard = TerminalDashboard(console=console)
     chunk_bytes = chunk_size * 1024 * 1024
 
@@ -95,10 +135,16 @@ def download_file(url: str, output_path: Optional[str], chunk_size: int, workers
         adapters=adapters,
         chunk_size=chunk_bytes,
         workers_per_adapter=workers,
+        custom_headers=parsed_headers,
+        cookie=cookie,
+        referer=referer,
+        sequential=sequential,
+        quotas=parsed_quotas,
+        mirrors=parsed_mirrors,
     )
 
     probe = engine._prepare()
-    dashboard.setup(probe.filename, probe.total_bytes, adapters)
+    dashboard.setup(probe.filename, probe.total_bytes, adapters, mirrors=engine.mirrors)
 
     start_time = time.time()
     with dashboard.progress:
@@ -112,7 +158,7 @@ def download_file(url: str, output_path: Optional[str], chunk_size: int, workers
     with SparseFileWriter(final_path, total_bytes) as writer:
         checksum = writer.calculate_checksum()
 
-    dashboard.finish(final_path.name, total_bytes, elapsed, checksum)
+    dashboard.finish(final_path.name, total_bytes, elapsed, checksum, mirrors=engine.mirrors)
 
 
 @main.command(name="proxy")
@@ -126,26 +172,64 @@ def start_proxy(host: str, port: int):
 @main.command(name="torrent")
 @click.argument("source")
 @click.option("-o", "--output-dir", default=".", help="Directory to save downloaded files.")
-def download_torrent(source: str, output_dir: str):
+@click.option("--sequential", is_flag=True, help="Download pieces in sequential order (watch media while downloading).")
+@click.option("--list", "list_files", is_flag=True, help="List all files in the torrent and exit.")
+@click.option("--select", "select_files", default=None, help="Download only specific file numbers (e.g. --select 1,2).")
+@click.option("-q", "--quota", "quota_list", multiple=True, help="Data cap for adapter (e.g. -q usb=1.5GB).")
+def download_torrent(
+    source: str,
+    output_dir: str,
+    sequential: bool,
+    list_files: bool,
+    select_files: Optional[str],
+    quota_list: tuple[str, ...],
+):
     """Download a torrent or magnet link across bonded network adapters."""
+    from .core.qos import parse_size_str
     from .torrent.metadata import parse_magnet, parse_torrent_file
     from .torrent.client import TorrentBondingEngine
 
+    if source.startswith("magnet:?"):
+        meta = parse_magnet(source)
+    else:
+        meta = parse_torrent_file(source)
+
+    if list_files:
+        table = Table(title=f"[bold green]Torrent Contents: {meta.name}[/bold green]")
+        table.add_column("#", style="bold yellow", justify="right")
+        table.add_column("File Name / Path", style="cyan")
+        table.add_column("Size", style="magenta", justify="right")
+        for f in meta.files:
+            size_str = f"{f.size_mb:.2f} MB" if f.size_mb < 1024 else f"{f.size_gb:.2f} GB"
+            table.add_row(str(f.index), f.path, size_str)
+        console.print(table)
+        console.print(
+            "\n[dim]To download specific files, run:[/dim]\n"
+            f"  plexo torrent \"{source}\" --select 1,2 -o \"{output_dir}\"\n"
+        )
+        return
+
     adapters = get_bonded_pool()
     if not adapters:
         console.print("[bold red]Error: No active online network adapters detected.[/bold red]")
         raise click.Abort()
 
-    if source.startswith("magnet:?"):
-        meta = parse_magnet(source)
-    else:
-        meta = parse_torrent_file(source)
+    selected_indices = None
+    if select_files:
+        selected_indices = [int(s.strip()) for s in select_files.split(",") if s.strip().isdigit()]
+
+    parsed_quotas = {}
+    for q in quota_list:
+        if "=" in q:
+            ident, s_val = q.split("=", 1)
+            parsed_quotas[ident.strip()] = parse_size_str(s_val.strip())
 
     console.print(
         Panel.fit(
             f"[bold cyan]Plexo Torrent Swarm Engine[/bold cyan]\n"
             f"Name: [bold yellow]{meta.name}[/bold yellow]\n"
             f"Info Hash: [dim]{meta.info_hash_hex}[/dim]\n"
+            f"Selected Files: [green]{len(selected_indices) if selected_indices else 'All'}[/green] / {len(meta.files)}\n"
             f"Active Network Links: [bold green]{len(adapters)}[/bold green]",
             border_style="cyan",
         )
@@ -154,7 +238,14 @@ def download_torrent(source: str, output_dir: str):
     dashboard = TerminalDashboard(console=console)
     dashboard.setup(meta.name, meta.total_length, adapters)
 
-    engine = TorrentBondingEngine(metadata=meta, output_dir=output_dir, adapters=adapters)
+    engine = TorrentBondingEngine(
+        metadata=meta,
+        output_dir=output_dir,
+        adapters=adapters,
+        sequential=sequential,
+        selected_files=selected_indices,
+        quotas=parsed_quotas,
+    )
 
     start_time = time.time()
     with dashboard.progress:
@@ -170,6 +261,22 @@ def download_torrent(source: str, output_dir: str):
     dashboard.finish(final_path.name, total_bytes, elapsed, checksum)
 
 
+@main.command(name="watch")
+@click.option("--auto-download", "-y", is_flag=True, help="Automatically download detected links without prompting.")
+@click.option("-o", "--output-dir", default=None, help="Directory to save downloaded files.")
+@click.option("-i", "--poll-interval", default=1.0, type=float, help="Clipboard polling interval in seconds (default: 1.0).")
+def watch_clipboard(auto_download: bool, output_dir: Optional[str], poll_interval: float):
+    """Monitor clipboard for download URLs and magnet links."""
+    from .ui.watcher import ClipboardWatcher
+    watcher = ClipboardWatcher(
+        poll_interval=poll_interval,
+        auto_download=auto_download,
+        output_dir=output_dir,
+        console=console,
+    )
+    watcher.run()
+
+
 @main.command(name="info")
 def show_info():
     """Display Plexo environment and bonding capabilities."""