TUI Picker

A beautiful terminal application launcher and app store for TUI (Text User Interface) applications. Browse, install, and launch 200+ terminal apps with an intuitive tabbed interface.

Features

🚀 Tabbed Interface

• Launcher Tab - Browse and launch your installed TUI apps
• App Store Tab - Discover and install 200+ awesome TUI applications
• Switch between tabs with ←/→ arrow keys

📦 200+ Apps Available

Organized into categories:

• System Monitors: btop, htop, bottom, glances, nvtop, zenith
• File Managers: yazi, ranger, nnn, lf, broot, mc, vifm
• Text Editors: vim, nvim, nano, micro, helix, emacs
• Music/Media: cava, ncmpcpp, cmus, spotify-tui, ncspot
• Network Tools: bandwhich, gping, trippy, yt-dlp, rtorrent
• Git/Dev: lazygit, tig, gitui, k9s, lazydocker, dive
• Productivity: taskwarrior-tui, calcurse, sc-im, glow
• RSS/News: newsboat, tuir, hacker-news-tui
• Chat: weechat, irssi, gomuks, telegram-tui
• Fun: cmatrix, asciiquarium, pipes.sh, cbonsai, hollywood
• Image/Video: chafa, viu, timg, mpv
• System Info: fastfetch, neofetch, cpufetch, macchina
• Disk Tools: ncdu, duf, dust, diskonaut, gdu
• Database: pgcli, mycli, litecli, gobang
• Other: ttyper, fzf, tmux, zellij, and many more!

✨ Smart Features

• ✓ Checkmarks show installed apps in the store
• 🔄 Auto-refresh after installation
• 📂 Category tags for easy browsing
• ⌨️ Vim-style keyboard navigation
• 🎨 Beautiful color-coded interface

Installation

Prerequisites

• Python 3.6+
• One of: paru, yay, or pacman (for installing apps)

Quick Install

# Download
curl -o tui-picker https://raw.githubusercontent.com/DiamondEyesFox/tui-picker/master/tui-picker
chmod +x tui-picker

# Move to your PATH
mv tui-picker ~/bin/tui-picker
# or
sudo mv tui-picker /usr/local/bin/tui-picker

From Source

git clone https://github.com/DiamondEyesFox/tui-picker.git
cd tui-picker
chmod +x tui-picker
./tui-picker

Usage

Launch the App

tui-picker

Controls

Global

• ←/→ - Switch between Launcher and Store tabs
• ↑/↓ - Navigate through items
• Home/End - Jump to first/last item
• r - Refresh the current list
• q/ESC - Quit

Launcher Tab

• Enter - Launch selected app

Store Tab

• Enter - Install selected app (or show if already installed)

Screenshots

Launcher Tab

┌─ LAUNCHER ─┐        APP STORE
═════════════════════════════════════════════════════════
←→ Switch Tabs | ↑↓ Navigate | Enter Launch | r Refresh | q Quit
═════════════════════════════════════════════════════════
▶ btop          Resource monitor with better graphs
  cava          Console audio visualizer
  fastfetch     System info with logo
  yazi          Blazing fast file manager

Store Tab

  LAUNCHER        ┌─ APP STORE ─┐
═════════════════════════════════════════════════════════
←→ Switch Tabs | ↑↓ Navigate | Enter Install | r Refresh | q Quit
═════════════════════════════════════════════════════════
▶ [✓] btop               Resource monitor with better...  [System Monitor]
  [ ] lazygit            Simple terminal UI for git       [Development]
  [✓] ranger             Vi-inspired file manager         [File Manager]
  [ ] spotify-tui        Spotify terminal client          [Music/Media]

Popular Apps Included

Most Featured on r/unixporn

• btop - The #1 system monitor
• cava - Audio visualizer (in almost every music setup)
• fastfetch/neofetch - System info fetchers
• cmatrix - Classic matrix effect
• pipes.sh - Animated pipes screensaver
• ranger/yazi - File managers
• lazygit - Git TUI
• tmux/zellij - Terminal multiplexers

How It Works

1. Dynamic Detection: Scans all 200+ apps from the store catalog
2. Real-time Check: Uses shutil.which() to detect installed executables
3. Package Manager Integration: Automatically uses paru, yay, or pacman
4. Smart Installation: Installs packages and immediately shows them in launcher

Contributing

Want to add more TUI apps? Edit the STORE_APPS list in the script:

# Add your app here (name, package_name, command, description, category)
("app-name", "package-name", "command", "Description here", "Category"),

License

MIT License - feel free to use and modify!

Credits

Created with ❤️ for the terminal enthusiast community.

Inspired by the amazing TUI apps showcased on r/unixporn.