overlay-manager

TUI application for managing Gentoo Portage overlays.

Browse, search, add, remove, and sync Gentoo overlays from a fast terminal interface built with ratatui.

Features

• Browse available overlays from the official Gentoo registry and GitHub
• Search overlays and packages with real-time filtering (Esc keeps filter, double-Esc clears)
• Detail panel shows description, owner, disk size, last sync date, and installed packages
• Sync freshness colored indicators: [✓] green (< 1 day), [~] yellow (< 7 days), [!] red (older), [?] yellow (never synced / no git metadata)
• Install/uninstall overlays with a single keystroke — writes to /etc/portage/repos.conf/
• Sync a single overlay (emaint sync -r) or all at once (emaint sync -a)
• View all packages an overlay provides with latest versions, descriptions, and USE flags
• Cache age shown in status bar — know when to refresh
• Confirmation dialogs for destructive actions
• Animated spinners during sync and cache refresh
• Runs as your user — privileged operations escalate via doas or sudo on demand (password asked once); sync continues in the background while you keep browsing

Preview

Installation

From source

git clone https://github.com/Darllowin/Overlay-manager.git
cd overlay-manager
cargo build --release
cp target/release/overlay-manager /usr/local/bin/

Gentoo

eselect repository add darllowin_overlay git https://github.com/Darllowin/darllowin-overlay.git
emaint sync -r darllowin_overlay
emerge app-portage/overlay-manager

Requirements

• Rust 1.95+
• doas or sudo for write operations
• emaint (part of sys-apps/portage) for syncing

Usage

overlay-manager        # launch TUI (asks for doas/sudo password on first privileged action)

Keybindings

Key	Action
j/k/↑/↓	Navigate list
g/G	Top / bottom
Tab	Browse ↔ Installed tabs
/	Search / filter
Esc	Exit search (keep filter) · second Esc clears the filter · background the running sync
a	Add overlay + sync
S	Sync all overlays · re-show the log of a running sync
d	Remove overlay (config + files, with confirmation)
r	Refresh overlay cache
Enter	View all packages in selected overlay (with search and descriptions)
h	Help
q	Quit

License

MIT