mangofetch Fast, Tropical, Pure Rust. A headless, UI-agnostic download engine SDK & TUI/CLI frontend

• mangofetch
  • Overview
  • Using as a Rust SDK (mangofetch-core)
  • CLI/TUI Installation
  • Key Features (v0.5.3)
  • Technical Architecture
  • The Core Engine Lifecycle
  • Command Reference
  • Roadmap & Milestones
  • Acknowledgments
  • Contributing
  • License

MangoFetch is a fast and simple media downloader built in Rust. It's designed to be powerful but easy to use, keeping the heavy lifting of downloading away from the interface you're using.

At its heart is mangofetch-core, a lightweight and headless engine. Built on Tokio and Reqwest, it uses a simple API with Rust Traits to handle YouTube, Torrents (Magnet), SoundCloud, Instagram, and over 1000+ other platforms thanks to yt-dlp and ffmpeg.

For everyone else, MangoFetch comes with mangofetch-cli. It's a handy TUI (Terminal User Interface) that looks great and works even better, featuring easy settings, mouse support, and 11 fun Tropical Fruit color palettes to choose from.

Unlike big, clunky GUI downloaders, MangoFetch is built to be part of your project. If you're making a Discord bot, a web server, or your own custom app, you can just plug mangofetch-core right into your Rust code.

Add it to your Cargo.toml:

[dependencies]
mangofetch-core = { git = "https://github.com/julesklord/mangofetch-cli" }

Why use mangofetch-core?

• Simple Telemetry: Check progress easily using standard tokio::sync::mpsc channels. No UI blocking or complicated setup needed.
• Unified Traits: Whether it's a direct link, a torrent, or a TikTok video, you can talk to them all through the same PlatformDownloader trait.
• Easy Dependencies: The engine takes care of managing and checking external tools like yt-dlp and ffmpeg in its own space.
• Reliable Queue: A smart download manager that handles retries and network hiccups automatically.

The fastest way to install the CLI directly to your system path:

cargo install mangofetch-cli

For developers who want the absolute bleeding edge:

git clone https://github.com/julesklord/mangofetch-cli.git
cd mangofetch-cli
cargo build --release
# The compiled binary will be available at: target/release/mangofetch

mangofetch <command> <link>

mangofetch tui (run the tui interactive dashboard)

• Supports 1000+ Sites: Smooth integration with yt-dlp to work with almost any video site out there.
• Headless Core: A clean design that lets you use the download engine as a standalone Rust library.
• Interactive TUI: A responsive dashboard with 11 Tropical Fruit Themes (Mango, Pitaya, Guayaba, Passionfruit, and more).
• Easy Mouse Support: Use your mouse to scroll through your queue and click on tabs.
• Vim-Style Commands: For the power users, you can use quick : commands to get things done fast.
• P2P & Torrents: Works with magnet links and decentralized file sharing.
• Smart Downloading: Uses multi-segment downloads and clever connection handling to keep things fast and avoid rate limits.

MangoFetch is well-organized, keeping things clean and modular. This design makes the core engine portable, easy to test, and separate from how it's shown on screen.

graph TD
    User([Terminal / App User]) -->|CLI / Events| Frontend(CLI / Bot / Custom GUI)

    subgraph MangoFetch Workspace
        Frontend -->|Dispatch & Read MPSC| Core(mangofetch-core)

        subgraph Core Engine
            Core --> Manager[Manager: Queue & Recovery]
            Core --> Registry[Platform Registry]
            Manager --> IO[Tokio Async I/O]
            Registry --> Ext_Native[Native Extractors]
            Registry --> Ext_Generic[Generic Extractor]
        end

        Frontend -.->|Dynamic Linking| SDK(mangofetch-plugin-sdk)
    end

    Ext_Generic -->|Wraps| YTDLP[yt-dlp Binary]
    Ext_Native -->|Muxes Audio/Video| FFmpeg[FFmpeg Binary]
    Ext_Native -->|BitTorrent / P2P| RQBit[librqbit]
    YTDLP -.-> Network((Internet))
    IO -.-> Network
    IO --> Disk[(Local Storage)]

• mangofetch-core: The heart of the system. It handles the download queue and works with sites like YouTube, Instagram, and TikTok. It also manages yt-dlp and ffmpeg for you, even downloading them if they aren't on your system.
• mangofetch-cli: A simple frontend built with clap and ratatui. It's fast, looks great, and shows you everything that's happening in real-time.
• mangofetch-plugin-sdk: A toolkit for adding new features to MangoFetch while it's running.

The mangofetch-core queue is smart and reliable. It handles many downloads at once, and if something goes wrong with one, it just retries later without stopping everything else.

stateDiagram-v2
    [*] --> Queued : Submit URL
    Queued --> FetchingMetadata : Worker Thread Picks Item
    FetchingMetadata --> Active : Media Info Resolved
    FetchingMetadata --> Error : Network/Parse Failure

    state Active {
        [*] --> Allocating
        Allocating --> Downloading : Progress Stream via MPSC
        Downloading --> Muxing : Audio+Video Merge (FFmpeg)
        Muxing --> [*]
    }

    Active --> Paused : User Pauses
    Paused --> Active : User Resumes
    Active --> Seeding : BitTorrent Complete
    Seeding --> Complete : Seed Goal Reached
    Active --> Complete : Success
    Active --> Error : Interruption / Connection Drop
    Error --> Queued : Retry Logic Triggered (Auto-Recovery)
    Complete --> [*]

• Fast Progress Reporting: Uses background channels to show progress without slowing down the app. This keeps the interface smooth and responsive.
• Self-Healing Tools: Automatically finds and sets up the external tools it needs (ffmpeg, yt-dlp).
• Smart Parsing: Tries to handle links directly first, only using extra tools when it really needs to.

For a full list of commands and how to use the TUI, check out our Official Wiki.

• Installation Guide
• CLI Command Reference
• TUI Interactive Guide
• Technical Architecture

• OmniGet — A big inspiration for this project. Huge thanks to tonhowft for the original ideas and engine logic.
• yt-dlp — The amazing tool that does the heavy lifting for so many sites.

Pull requests are always welcome. We have a few rules to keep the code clean, so if you're planning a big change, just open an issue first so we can chat about it. Check out CONTRIBUTING.md for more info.

Built by Jules, gemini-cli assistant and claude.
Released under the GPL-3.0 License.