https://github.com/bottyivan/launcher-app
Launcher is a modern desktop application launcher for Linux, built with GTK4 and Adwaita
https://github.com/bottyivan/launcher-app
adwaita gtk gtk4 launcher linux linux-app
Last synced: 4 months ago
JSON representation
Launcher is a modern desktop application launcher for Linux, built with GTK4 and Adwaita
- Host: GitHub
- URL: https://github.com/bottyivan/launcher-app
- Owner: BottyIvan
- License: gpl-3.0
- Created: 2025-08-31T16:50:12.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-01T21:17:35.000Z (4 months ago)
- Last Synced: 2025-12-04T11:30:42.575Z (4 months ago)
- Topics: adwaita, gtk, gtk4, launcher, linux, linux-app
- Language: Python
- Homepage:
- Size: 6.32 MB
- Stars: 39
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Launcher
A modern desktop application launcher for Linux
Built with GTK4 and Adwaita | Fast | Extensible | Open Source
📚 Wiki Documentation •
💾 Installation •
📖 Usage Guide •
🤝 Contributing
---
## Overview
**Launcher** provides instant search for installed applications, a built-in calculator, and an extensible architecture for adding custom features. It integrates seamlessly with modern Linux desktop environments.
> [!IMPORTANT]
> **Launcher** is under active development. Features and interfaces may change. Contributions and feedback are welcome!
## ✨ Key Features
- 🚀 **Instant Search** - Find applications as you type with fuzzy matching
- 🎨 **Modern UI** - Beautiful GTK4/Adwaita interface with smooth animations
- ⌨️ **Keyboard-First** - Complete keyboard navigation with visible shortcuts
- 🧮 **Built-in Calculator** - Evaluate expressions without switching apps
- 🔌 **Extensible** - Plugin system for custom functionality
- 🎯 **Smart Results** - Color-coded category tags for quick identification
- 🔒 **Secure** - Flatpak sandboxing support
- ⚡ **Fast** - Optimized for performance with GPU-accelerated animations
- 🌓 **Adaptive Theming** - Automatic dark/light mode support
- 📏 **Responsive Layout** - Compact and default modes for different screen sizes
## 🚀 Quick Start
### Install with Flatpak (Recommended)
```bash
git clone https://github.com/BottyIvan/launcher-app.git
cd launcher-app
flatpak-builder --user --install --force-clean build-dir manifest.yaml
flatpak run cloud.ivanbotty.Launcher
```
### Run from Source
```bash
git clone https://github.com/BottyIvan/launcher-app.git
cd launcher-app
python3 -m cloud.ivanbotty.Launcher
```
### Keyboard Shortcuts
- **Type** - Start searching for applications and commands
- **↑/↓** - Navigate through results
- **Enter** - Launch the selected item
- **Escape** - Close the launcher
- **Ctrl+,** - Open preferences
- **Ctrl+?** or **F1** - Show all keyboard shortcuts
**📚 For detailed installation instructions, see the [Installation Guide](https://github.com/BottyIvan/launcher-app/wiki/Installation).**
## 📖 Documentation
Complete documentation is available in our **[Wiki](https://github.com/BottyIvan/launcher-app/wiki/Home)**:
- **[Home](https://github.com/BottyIvan/launcher-app/wiki/Home)** - Project overview and quick links
- **[Installation](https://github.com/BottyIvan/launcher-app/wiki/Installation)** - Installation for all platforms
- **[Usage Guide](https://github.com/BottyIvan/launcher-app/wiki/Usage-Guide)** - How to use Launcher effectively
- **[Features](https://github.com/BottyIvan/launcher-app/wiki/Features)** - Complete feature list and descriptions
- **[Configuration](https://github.com/BottyIvan/launcher-app/wiki/Configuration)** - Customize Launcher settings
- **[Architecture](https://github.com/BottyIvan/launcher-app/wiki/Architecture)** - Technical design and structure
- **[API Reference](https://github.com/BottyIvan/launcher-app/wiki/API-Reference)** - API documentation for developers
- **[Contributing](https://github.com/BottyIvan/launcher-app/wiki/Contributing)** - Contribution guidelines and dev setup
- **[FAQ](https://github.com/BottyIvan/launcher-app/wiki/FAQ)** - Frequently asked questions and troubleshooting
- **[Changelog](https://github.com/BottyIvan/launcher-app/wiki/Changelog)** - Version history and release notes
- **[License](https://github.com/BottyIvan/launcher-app/wiki/License)** - Licensing information
### UI Enhancement Documentation
See the [UI Enhancements Guide](docs/UI_ENHANCEMENTS.md) for details on the modern interface improvements, including:
- Custom CSS styling following GNOME HIG
- Smooth animations and transitions
- Keyboard-first navigation
- Color-coded category tags
- Responsive layout modes (Compact/Default)
For visual reference, check the [UI Visual Reference](docs/UI_VISUAL_REFERENCE.md).
## 🤝 Contributing
We welcome contributions! Whether you want to:
- Report bugs
- Suggest features
- Improve documentation
- Write code
**Please read our [Contributing Guide](https://github.com/BottyIvan/launcher-app/wiki/Contributing) to get started.**
## 💬 Community & Support
- **Issues**: [GitHub Issues](https://github.com/BottyIvan/launcher-app/issues)
- **Discussions**: Use GitHub Issues for questions
- **Email**: droidbotty@gmail.com
## 📋 Requirements
- Python 3.11+
- GTK4 and Adwaita
- PyGObject 3.44+
**See [Installation Guide](https://github.com/BottyIvan/launcher-app/wiki/Installation) for complete requirements.**
## 📜 License
**GPL-3.0-or-later** - See [LICENSE](LICENSE) file for details.
Learn more: [License Documentation](https://github.com/BottyIvan/launcher-app/wiki/License)
## 🙏 Acknowledgments
- Built with [GTK4](https://gtk.org/) and [Adwaita](https://gnome.pages.gitlab.gnome.org/libadwaita/)
- Icon from [Icons8](https://icons8.it/icon/qW0hxm9M3J5x/ricerca)
- Thanks to all [contributors](https://github.com/BottyIvan/launcher-app/graphs/contributors)
---
Made with ❤️ by Ivan Bottigelli
⭐ Star us on GitHub if you find this project useful!