getit-cli 0.2.0

Universal file hosting downloader with TUI - supports GoFile, PixelDrain, MediaFire, 1Fichier, Mega.nz

getit

Universal file hosting downloader with a beautiful Terminal UI

Download files from GoFile, PixelDrain, MediaFire, 1Fichier, and Mega.nz with a single command.

---

🌟 Why GetIt?

GetIt transforms the mundane task of downloading files from various hosting services into a seamless, visual experience. Whether you are a casual user wanting a simple download or a power user needing batch processing and encryption support, GetIt handles it all with style.

✨ Features

• Broad Host Support: Seamlessly download from GoFile, PixelDrain, MediaFire, 1Fichier, and Mega.nz.
• Stunning TUI: innovative terminal interface that provides real-time progress visualization, speed metrics, and active management.
• Robust CLI: Complete command-line control for scripting and headless operations.
• Performance First:
  • Concurrent Downloads: Maximize bandwidth by downloading multiple files at once.
  • Smart Resume: Automatically resumes interrupted downloads where possible.
  • Speed Limiting: strict bandwidth controls for background usage.
• Advanced Capabilities:
  • Recursive Folder Support: Downloads entire directory structures.
  • Security: Handles password-protected links and fully decrypts Mega.nz AES-CTR encryptions.
  • Integrity: Auto-verifies MD5/SHA256 checksums to ensure file safety.
• Cross-Platform: Runs flawlessly on macOS, Linux, and Windows.

🚀 Quick Start

Installation

Install via pip (recommended):

pip install getit-cli

Or using Homebrew (macOS/Linux):

brew tap ahmedeltigani/getit
brew install getit

Basic Usage

Download a single file:

getit download https://gofile.io/d/abc123

Launch the interactive TUI:

getit tui

Batch download from a file:

getit download -f urls.txt

📖 Comprehensive Guide

Command Line Interface

The CLI is designed for efficiency.

getit download <URL> [OPTIONS]

Common Options:

• -o, --output DIR: Specify target directory (default: ./downloads).
• -c, --concurrent NUM: Set max simultaneous downloads (default: 4).
• -p, --password TEXT: Provide password for protected resources.
• -l, --limit SPEED: Set a speed cap (e.g., 1M, 500K).
• --no-resume: Force restart of downloads.

Interactive TUI Controls

Manage your queue effortlessly with keyboard shortcuts:

Key	Action	Description
a	Add URLs	Add one or more URLs with optional folder grouping
b	Batch Import	Load multiple URLs from a file
p	Pause/Resume	Toggle state of selected download
c	Cancel	Stop and remove selected download
s	Settings	Configure global preferences
q	Quit	Exit the application

Host Specifics

Host	Files	Folders	Password	Encryption	Notes
GoFile	✅	✅	✅	-	Handles rate limits & guest tokens automatically.
PixelDrain	✅	✅	-	-	Supports lists and individual files.
1Fichier	✅	-	✅	-	Manages wait times between downloads.
Mega.nz	✅	✅	-	✅	Features full client-side decryption.

Configuration

GetIt looks for config.json in:

• macOS: ~/Library/Application Support/getit/
• Linux: ~/.config/getit/
• Windows: %APPDATA%\getit\

Example config.json:

{
  "download_dir": "~/Downloads/getit",
  "max_concurrent_downloads": 4,
  "enable_resume": true,
  "gofile_token": "your_token_here"
}

🛠 Development

We welcome contributions!

1. Clone: git clone https://github.com/ahmedeltigani/getit.git
2. Setup: pip install -e ".[dev]"
3. Test: pytest

Production Readiness

For detailed information about the project's production readiness status, risk register, and mitigation plans, see the Production Readiness Scorecard.

Architecture Overview

• core/downloader.py: Async engine handling HTTP streams and decryption.
• core/manager.py: Semaphore-based orchestrator for concurrency.
• extractors/: Modular logic for each file host.
• tui/app.py: Textual-based interface implementation.

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.