Quick Start

⚡ Quick Start Guide

Start downloading your favorite media with MangoFetch in less than a minute.

1. Verify Dependencies

First, ensure you have FFmpeg and yt-dlp installed. Run:

mangofetch check

2. Your First Download

Download a video from YouTube (or any of the 1000+ supported sites):

mangofetch download "https://www.youtube.com/watch?v=aqz-KE-bpKQ"

By default, this will download the best quality available to your user's download directory.

3. Advanced CLI Download

Want audio only in a specific folder?

mangofetch download "URL" --audio-only --output ./Music

4. Enter Interactive Mode (TUI)

For a more visual experience, launch the dashboard:

mangofetch tui

[!SCREENSHOT_PLACEHOLDER: TUI Queue Tab with an Active Download] Captura de la pestaña Queue mostrando una descarga activa con la nueva barra de progreso.

Basic TUI Navigation:

• Tab: Switch between tabs (or categories in Queue/History).
• / or :: Enter command mode (type :q to exit).
• p: Pause a download.
• r: Resume a download.
• q (press twice quickly): Quick quit (double-q).
• a: Add new download.
• 1-6: Jump directly to a tab (1=Home, 2=Queue, 3=History, 4=Settings, 5=About, 6=Logs).

5. Toggle Animations

Prefer a static interface? Disable animations in the Settings tab or via CLI:

mangofetch config set appearance.animations false

6. Change the Theme

Don't like orange? Switch to Passionfruit (Yellow/Purple):

mangofetch config set appearance.tui_theme passionfruit

Or change it directly in the Settings tab of the TUI.

---

Ready for more?

• Check the CLI Reference for power-user flags.
• Explore the TUI Experience for all shortcuts.