Features

LemonUp provides a complete addon management experience from your terminal.

Addon Management

Install Addons

• Paste a URL: GitHub, TukUI, WoWInterface, or Wago.io links are automatically detected
• Wago.io Search: Search and install addons directly from Wago.io (requires your own API key)
• ElvUI and TukUI: Can be installed in a single press!
• Automatic folder detection: Parses addon structure to identify all included folders
• Dependency tracking: Links sub-folders (e.g., ElvUI_Options, ElvUI_Libraries). Keep an eye on all the libraries your addons are installing

Intelligent Onboarding

LemonUp makes it easy to get started with an automated first-run experience.

• Auto-Detection: Scans common installation paths for World of Warcraft across Windows, macOS, and Linux.
• Deep Scan: Stuck? Run a deep scan to find WoW in non-standard directories (e.g., custom mounts or external drives).
• Responsive Feedback: Interactive progress view during scans, fully interruptible at any time.

User Experience

Designed for speed and efficiency, LemonUp prioritizes a keyboard-first workflow.

• Vim-style Navigation: Navigate any list with h, j, k, and l.
• Global Shortcuts: Quick keys to jump between screens (Install, Manage, Config).
• Interactive TUI: Powered by Ink and Bun for a fluid, application-like feel in your terminal.

Update Addons

• Git-based Tracking: GitHub-hosted addons are tracked using exact commit hashes for pinpoint accuracy.
• Batch Updates: Update all addons directly from the Manage screen with a single key (U).
• Concurrent Processing: Configurable limits for parallel downloads to maximize speed without overloading your connection.

Manage Addons

• View installed addons: See all tracked addons with version info
• Remove addons: Uninstall and clean up all associated folders
• Scan for addons: Detect manually installed addons
• Show/Hide libraries: Toggle visibility of library dependencies

Background Update Checking

LemonUp can automatically check for addon updates in the background while the TUI is running.

• Configurable interval: 30 minutes to 4 hours
• Header badge: Shows count of pending updates
• Toast notifications: Alerts when updates are found
• Can be disabled: Turn off if you prefer manual checking

WTF Folder Backup

Automatically backs up your WTF folder before updates to protect your settings.

• Automatic backups: Triggers before addon updates
• Configurable retention: Keep 1-10 backup copies
• Timestamped directories: Easy to find and restore
• Toggle on/off: Disable if you manage backups elsewhere

Theming

Switch between dark and light themes to match your terminal.

• Dark theme (default): High contrast for dark terminals
• Light theme: Optimized for light terminal backgrounds
• Configurable in the settings menu

Game Flavor Support

Manage addons for any WoW version:

Flavor	Directory
Retail	_retail_/Interface/AddOns
Classic / Era	_classic_/Interface/AddOns (WIP)
Cata	_cata_/Interface/AddOns (Planned)

Default paths are auto-detected based on your operating system.

Platform Support

Platform	Status
Linux	Full support
macOS	Full support
Windows	Full support