Skip to content

๐Ÿš€ Ultimate Linux App Launcher - Auto-detects 6000+ applications, generates beautiful icons, smart categorization. One-line install for all distros! 10x more powerful.

License

Notifications You must be signed in to change notification settings

edellingham/apex-launcher

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ APEX LAUNCHER - The Ultimate Linux Application Launcher

Python License Platform PyQt5 Stars

The most powerful, beautiful, and intelligent application launcher for Linux systems. One-line installation, 6000+ app detection, automatic icon generation, and universal compatibility.

โšก Quick Start

Install with one command:

curl -fsSL https://raw.githubusercontent.com/reza-ygb/apex-launcher/main/apex_install.sh | bash

Launch:

apex-launcher

Done! ๐ŸŽ‰ Start organizing your 6000+ applications instantly.

โœจ Why APEX LAUNCHER?

APEX LAUNCHER is the ultimate evolution of Linux application launchers, designed to handle 6000+ applications with automatic categorization, beautiful modern GUI, and bulletproof crash protection.

๐Ÿ”ฅ KEY FEATURES

  • ๐ŸŽฏ UNIVERSAL COMPATIBILITY: Works on ALL Linux distributions
  • โšก ONE-LINE INSTALLATION: No complex setup required
  • ๐ŸŽจ AUTOMATIC ICON GENERATION: Beautiful icons for every application
  • ๐Ÿง  SMART CATEGORIZATION: AI-powered app organization
  • ๐Ÿ›ก๏ธ BULLETPROOF STABILITY: Never crashes, always works
  • ๐Ÿš€ ULTRA-FAST PERFORMANCE: SQLite caching, optimized scanning
  • ๐Ÿ’Ž MODERN GLASSMORPHISM UI: Beautiful, responsive interface
  • ๐Ÿ” ADVANCED SEARCH: Find any app instantly
  • ๐Ÿ“ฆ MULTI-FORMAT SUPPORT: Desktop apps, CLI tools, Snap, Flatpak, AppImage
  • ๐ŸŒŸ Never see blank icons again!

๐Ÿš€ Ultra-Fast Organization

  • ๐Ÿ“Š Handles 6000+ applications without breaking a sweat
  • โšก Lightning-fast search across all your apps
  • ๐Ÿง  Intelligent categorization using advanced algorithms
  • ๐Ÿ“ฑ Multi-source detection: Desktop, CLI, Snap, Flatpak, AppImage

๐ŸŽฏ Perfect for Arch & Ubuntu

  • ๐Ÿ—๏ธ One-click installation with automatic dependency resolution
  • ๐Ÿ”ง Optimized for both distributions
  • ๐Ÿ“ฆ Supports all package managers: pacman, apt, snap, flatpak
  • โš™๏ธ Auto-configures desktop integration

๐ŸŒŸ Features

๐ŸŽจ Visual Excellence

  • Modern Material Design UI with glassmorphism effects
  • Real-time icon generation with category-based color schemes
  • Smooth animations and hover effects
  • Dark/Light theme adaptation

๐Ÿ” Smart Search & Organization

  • Fuzzy search finds apps even with typos
  • Category-based filtering with 11 intelligent categories
  • Usage statistics and frequently used apps
  • Keyboard shortcuts for power users

๐Ÿ“ฆ Universal Compatibility

  • Desktop Applications (.desktop files)
  • Command Line Tools (PATH executables)
  • Snap Packages (snap list integration)
  • Flatpak Applications (flatpak list integration)
  • AppImage Files (automatic detection)

โšก Performance Optimized

  • SQLite caching for instant startup
  • Multi-threaded scanning for speed
  • Memory efficient icon generation
  • Background updates without UI blocking

๐Ÿš€ ONE-LINE INSTALLATION

Install APEX LAUNCHER on any Linux distribution with a single command:

curl -fsSL https://raw.githubusercontent.com/reza-ygb/apex-launcher/main/apex_install.sh | bash

That's it! The installer will:

  • โœ… Auto-detect your Linux distribution
  • โœ… Install dependencies (Python, PyQt5, Pillow)
  • โœ… Set up desktop integration
  • โœ… Create launcher commands
  • โœ… Ready to use immediately

๐Ÿ“ฆ What Gets Installed:

  • Main launcher: /usr/local/share/apex-launcher/apex_launcher.py
  • Command alias: apex-launcher (works from anywhere)
  • Desktop entry: Available in applications menu
  • Icon cache: ~/.cache/apex-launcher/
  • Configuration: ~/.config/apex-launcher/

๐Ÿ”„ Supported Distributions:

The installer works on ALL major Linux distributions:

  • Ubuntu/Debian โ†’ apt install
  • Arch/Manjaro โ†’ pacman -S
  • Fedora/RHEL โ†’ dnf install
  • openSUSE โ†’ zypper install
  • Alpine โ†’ apk add
  • Others โ†’ Falls back to pip3 install

Alternative: Manual Installation

git clone https://github.com/reza-ygb/apex-launcher.git
cd apex-launcher
chmod +x apex_install.sh
./apex_install.sh

๐ŸŽฏ HOW TO USE

After installation, launch APEX LAUNCHER in multiple ways:

๐Ÿ–ฅ๏ธ From Applications Menu

  • Look for "APEX Launcher" in your system menu
  • Usually found under "Utilities" or "System Tools"

โŒจ๏ธ From Terminal

# Simple command
apex-launcher

# Or run directly
python3 apex_launcher.py

๏ฟฝ Quick Launch Tips

  • Search: Press Ctrl+F or just start typing
  • Categories: Click categories on the left sidebar
  • Refresh: Press F5 to rescan applications
  • Keyboard Navigation: Use arrow keys and Enter

โŒจ๏ธ Keyboard Shortcuts

  • Ctrl+F or / - Focus search box
  • F5 or Ctrl+R - Refresh application list
  • Ctrl+1-9 - Quick category switching
  • Esc - Clear search / Go back

๐Ÿ” Search Tips

  • Fuzzy search: Type "fire" to find "Firefox"
  • Category search: Use "game:" to see only games
  • Type search: Use "snap:" to see only snap packages
  • Command search: Search by executable name

๐Ÿ“Š Application Categories

The launcher intelligently categorizes applications into:

Category Icon Description Examples
Programming ๐Ÿ’ป Development tools & IDEs VS Code, Python, Git
Security ๏ฟฝ Security & hacking tools Wireshark, Nmap, Burp
System โš™๏ธ System utilities htop, systemctl, mount
Internet ๐ŸŒ Browsers & network apps Firefox, Chrome, wget
Media ๐ŸŽฌ Audio/video applications VLC, Spotify, GIMP
Office ๐Ÿ“„ Office & productivity LibreOffice, PDF readers
Graphics ๐ŸŽจ Design & photo editing GIMP, Inkscape, Blender
Games ๐ŸŽฎ Gaming applications Steam, Lutris, emulators
Development ๏ฟฝ Terminal & dev tools Terminal, SSH, Docker
Education ๐Ÿ“š Learning applications Educational software
Other ๐Ÿ“ Uncategorized apps Everything else

๐ŸŽจ Icon Generation System

๐ŸŒˆ Smart Color Coding

Each category has its own color scheme:

  • Programming: Green gradient (Nature/Growth)
  • Security: Red gradient (Alert/Protection)
  • System: Orange gradient (Power/Energy)
  • Internet: Blue gradient (Trust/Communication)
  • Media: Purple gradient (Creativity/Entertainment)
  • Office: Gray gradient (Professional/Business)
  • Graphics: Pink gradient (Artistic/Creative)
  • Games: Indigo gradient (Fun/Entertainment)

๐ŸŽฏ Application-Specific Icons

The system recognizes popular applications and assigns custom symbols:

  • Firefox โ†’ ๐Ÿ”ฅ, Chrome โ†’ ๐ŸŒŽ, VS Code โ†’ ๐Ÿ’ป
  • Terminal โ†’ โšก, File Manager โ†’ ๐Ÿ“, GIMP โ†’ ๐ŸŽจ
  • VLC โ†’ โ–ถ๏ธ, Spotify โ†’ ๐ŸŽต, Steam โ†’ ๐ŸŽฎ
  • And many more...

โš™๏ธ Configuration

๐Ÿ“ File Locations

  • Icons Cache: ~/.cache/apex-launcher/icons/
  • Database: ~/.cache/apex-launcher/apps.db
  • Desktop Entry: ~/.local/share/applications/apex-launcher.desktop
  • Launcher Script: ~/.local/bin/apex-launcher

๐Ÿ”ง Customization

You can customize the launcher by editing the configuration in the source code:

  • Categories: Modify AdvancedApplicationDetector.categories
  • Icon Colors: Edit IconGenerator.category_icons
  • App-Specific Icons: Update IconGenerator.app_specific_icons

๐Ÿ› ๏ธ Advanced Features

๐Ÿ“Š Statistics & Analytics

  • Usage tracking for most-used applications
  • Category distribution analysis
  • Launch frequency statistics
  • Performance metrics

๐Ÿš€ Performance Optimizations

  • SQLite caching for instant subsequent launches
  • Icon caching to avoid regeneration
  • Multi-threaded scanning for large application lists
  • Memory-efficient image processing

๐Ÿ”„ Auto-Update System

  • Background scanning for new applications
  • Smart cache invalidation
  • Incremental updates instead of full rescans
  • Change detection for modified applications

๐Ÿ› Troubleshooting

โŒ Common Issues

"No applications found"

# Force refresh the application database
python3 apex_launcher.py --force-refresh

# Or clear cache and rescan
rm -rf ~/.cache/apex-launcher/
python3 apex_launcher.py

"Icons not generating"

# Check Pillow installation
python3 -c "from PIL import Image; print('Pillow OK')"

# Install missing fonts
sudo apt install fonts-dejavu fonts-liberation  # Ubuntu
sudo pacman -S ttf-dejavu ttf-liberation        # Arch

"PyQt5 import error"

# Ubuntu/Debian
sudo apt install python3-pyqt5

# Arch Linux  
sudo pacman -S python-pyqt5

# Or via pip
pip3 install PyQt5

๐Ÿ” Debug Mode

# Run with verbose output
python3 apex_launcher.py --debug

# Check application detection
python3 -c "
from apex_launcher import AdvancedApplicationDetector
detector = AdvancedApplicationDetector()
apps = detector.detect_applications(force_refresh=True)
print(f'Found {sum(len(v) for v in apps.values())} total applications')
"

๐Ÿค Contributing

We welcome contributions! Here's how you can help:

๐Ÿ› Bug Reports

  • Use the GitHub Issues page
  • Include your distribution, Python version, and error messages
  • Provide steps to reproduce the issue

๐Ÿ’ก Feature Requests

  • Suggest new features via GitHub Issues
  • Explain the use case and benefit
  • Consider contributing code if possible

๐Ÿ”ง Code Contributions

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes with tests
  4. Submit a pull request

๐Ÿ“ Documentation

  • Improve this README
  • Add code comments
  • Create tutorials or guides

๐Ÿ“‹ System Requirements

Minimum Requirements

  • Python: 3.7+
  • RAM: 512MB available
  • Storage: 100MB for cache and icons
  • Desktop Environment: Any Linux DE with .desktop support

Recommended Setup

  • Python: 3.9+
  • RAM: 2GB available
  • Storage: 500MB for extensive icon cache
  • Desktop Environment: GNOME, KDE, XFCE, or similar

Supported Distributions

  • โœ… Arch Linux (+ derivatives like Manjaro, EndeavourOS)
  • โœ… Ubuntu (+ derivatives like Linux Mint, Pop!_OS)
  • โœ… Fedora (+ derivatives like Nobara)
  • โœ… openSUSE (Leap & Tumbleweed)
  • โœ… Debian (Stable, Testing, Unstable)
  • โœ… Most other Linux distributions with minor modifications

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ™ Acknowledgments

  • PyQt5 team for the excellent GUI framework
  • Pillow team for image processing capabilities
  • Linux Desktop community for .desktop file standards
  • Material Design for UI/UX inspiration
  • All contributors who helped improve this project

๐ŸŒŸ Star the Project

If you find this launcher useful, please โญ star the repository on GitHub! It helps other users discover this tool and motivates further development.


๐Ÿ’ช Experience the Ultimate in Application Management with APEX LAUNCHER! ๐Ÿš€

Made with โค๏ธ for the Linux community

About

๐Ÿš€ Ultimate Linux App Launcher - Auto-detects 6000+ applications, generates beautiful icons, smart categorization. One-line install for all distros! 10x more powerful.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 80.4%
  • Shell 19.6%