TUI Experience

🖥️ TUI Experience Guide

MangoFetch features a state-of-the-art Terminal User Interface (TUI) built with ratatui. It provides a full-screen, interactive dashboard to manage your downloads with ease and style.

🚀 Launching the TUI

To enter interactive mode, run:

mangofetch tui

[!SCREENSHOT_PLACEHOLDER: TUI Splash Screen] Captura de la pantalla de bienvenida (Splash Screen) con el logo estilizado de Mango.

---

🧭 Navigation

Tabs

The TUI is organized into several functional tabs. You can navigate them using:

• Tab: Move to the next tab.
• Shift + Tab: Move to the previous tab.
• 1-6: Directly jump to a specific tab.

Tab	Icon	Description
Home	🏠	Quick actions and project summary.
Queue	⬇	Active downloads and real-time progress.
History	📜	Completed and failed downloads.
Settings	⚙	Interactive configuration manager.
About	ℹ	Detailed project info and debug data.
Logs	📋	Real-time internal engine logs.

---

🖱️ Mouse Support

As of v0.5.0, MangoFetch supports intuitive mouse interactions:

• Scrolling: Use the scroll wheel to navigate tables or log views.
• Clicking: Click on the tab headers at the top to switch views instantly.

---

⌨️ Shortcuts & Controls

While in the Queue or History tabs:

• j / Down: Select the next item.
• k / Up: Select the previous item.
• p: Pause the selected download.
• r: Resume the selected download.
• x: Remove the selected item (requires confirmation).
• a: Open the Add Download modal (Paste URL).
• ?: Toggle the Help Modal.

[!SCREENSHOT_PLACEHOLDER: TUI Help Modal Overlay] Captura del modal de ayuda desplegado sobre la pestaña de Queue.

---

🍓 Tropical Themes

MangoFetch allows you to customize the color palette using our collection of tropical fruit themes. Change these in the Settings tab.

• 🥭 Mango: Warm oranges and golds (Default).
• 🍇 Pitaya: Vibrant pinks and deep purples.
• 🥥 Coconut: Natural beiges and browns.
• 🍐 Guayaba: Fresh pink flesh and green skin.
• 🟠 Papaya: Vibrant orange and dark seed accents.
• 🌺 Passionfruit: Electric yellow and deep passion purple.
• 🍒 Lychee: Translucent whites and vibrant red skin.
• ⭐ Starfruit: Bright yellow and green edges.
• 🍇 Mangosteen: Dark purple skin and pure white flesh.
• 🥝 Kiwi: Fuzzy brown and bright green.

[!SCREENSHOT_PLACEHOLDER: TUI Gallery - All Themes Comparison] Un collage mostrando la misma pantalla con los diferentes temas de frutas tropicales.

---

⌨️ Command Mode (Vim-style)

For power users who want CLI speed within the TUI:

1. Press / to enter Command Mode.
2. Type your command (e.g., :download https://...).
3. Press Enter to execute.

Available Commands:

• :d <URL> [quality]: Queue a new download.
• :q: Quit MangoFetch.
• :help: Open the help modal.
• :clear: Clear the logs (while in Logs tab).