{"id":30771930,"url":"https://github.com/bottyivan/launcher-app","last_synced_at":"2025-12-11T22:43:57.748Z","repository":{"id":312602586,"uuid":"1047979346","full_name":"BottyIvan/launcher-app","owner":"BottyIvan","description":"Launcher is a modern desktop application launcher for Linux, built with GTK4 and Adwaita","archived":false,"fork":false,"pushed_at":"2025-12-01T21:17:35.000Z","size":6622,"stargazers_count":39,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-04T11:30:42.575Z","etag":null,"topics":["adwaita","gtk","gtk4","launcher","linux","linux-app"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BottyIvan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-31T16:50:12.000Z","updated_at":"2025-12-01T21:17:39.000Z","dependencies_parsed_at":"2025-08-31T21:16:22.273Z","dependency_job_id":"9a3ead24-fcf2-4984-8752-7f55863129a4","html_url":"https://github.com/BottyIvan/launcher-app","commit_stats":null,"previous_names":["bottyivan/launcher-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BottyIvan/launcher-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BottyIvan%2Flauncher-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BottyIvan%2Flauncher-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BottyIvan%2Flauncher-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BottyIvan%2Flauncher-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BottyIvan","download_url":"https://codeload.github.com/BottyIvan/launcher-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BottyIvan%2Flauncher-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27671920,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-11T02:00:11.302Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adwaita","gtk","gtk4","launcher","linux","linux-app"],"created_at":"2025-09-05T00:07:29.724Z","updated_at":"2025-12-11T22:43:57.743Z","avatar_url":"https://github.com/BottyIvan.png","language":"Python","readme":"# Launcher\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./cloud/ivanbotty/Launcher/resources/cloud.ivanbotty.Launcher.svg\" alt=\"Launcher Icon\" width=\"128\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cstrong\u003eA modern desktop application launcher for Linux\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    Built with GTK4 and Adwaita | Fast | Extensible | Open Source\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/BottyIvan/launcher-app/wiki/Home\"\u003e📚 Wiki Documentation\u003c/a\u003e •\n    \u003ca href=\"https://github.com/BottyIvan/launcher-app/wiki/Installation\"\u003e💾 Installation\u003c/a\u003e •\n    \u003ca href=\"https://github.com/BottyIvan/launcher-app/wiki/Usage-Guide\"\u003e📖 Usage Guide\u003c/a\u003e •\n    \u003ca href=\"https://github.com/BottyIvan/launcher-app/wiki/Contributing\"\u003e🤝 Contributing\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Overview\n\n**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.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./assets/Screenshot From 2025-11-09 21-55-46.png\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n\u003e [!IMPORTANT]\n\u003e **Launcher** is under active development. Features and interfaces may change. Contributions and feedback are welcome!\n\n## ✨ Key Features\n\n- 🚀 **Instant Search** - Find applications as you type with fuzzy matching\n- 🎨 **Modern UI** - Beautiful GTK4/Adwaita interface with smooth animations\n- ⌨️ **Keyboard-First** - Complete keyboard navigation with visible shortcuts\n- 🧮 **Built-in Calculator** - Evaluate expressions without switching apps\n- 🔌 **Extensible** - Plugin system for custom functionality\n- 🎯 **Smart Results** - Color-coded category tags for quick identification\n- 🔒 **Secure** - Flatpak sandboxing support\n- ⚡ **Fast** - Optimized for performance with GPU-accelerated animations\n- 🌓 **Adaptive Theming** - Automatic dark/light mode support\n- 📏 **Responsive Layout** - Compact and default modes for different screen sizes\n\n## 🚀 Quick Start\n\n### Install with Flatpak (Recommended)\n\n```bash\ngit clone https://github.com/BottyIvan/launcher-app.git\ncd launcher-app\nflatpak-builder --user --install --force-clean build-dir manifest.yaml\nflatpak run cloud.ivanbotty.Launcher\n```\n\n### Run from Source\n\n```bash\ngit clone https://github.com/BottyIvan/launcher-app.git\ncd launcher-app\npython3 -m cloud.ivanbotty.Launcher\n```\n\n### Keyboard Shortcuts\n\n- **Type** - Start searching for applications and commands\n- **↑/↓** - Navigate through results\n- **Enter** - Launch the selected item\n- **Escape** - Close the launcher\n- **Ctrl+,** - Open preferences\n- **Ctrl+?** or **F1** - Show all keyboard shortcuts\n\n**📚 For detailed installation instructions, see the [Installation Guide](https://github.com/BottyIvan/launcher-app/wiki/Installation).**\n\n## 📖 Documentation\n\nComplete documentation is available in our **[Wiki](https://github.com/BottyIvan/launcher-app/wiki/Home)**:\n\n- **[Home](https://github.com/BottyIvan/launcher-app/wiki/Home)** - Project overview and quick links\n- **[Installation](https://github.com/BottyIvan/launcher-app/wiki/Installation)** - Installation for all platforms\n- **[Usage Guide](https://github.com/BottyIvan/launcher-app/wiki/Usage-Guide)** - How to use Launcher effectively\n- **[Features](https://github.com/BottyIvan/launcher-app/wiki/Features)** - Complete feature list and descriptions\n- **[Configuration](https://github.com/BottyIvan/launcher-app/wiki/Configuration)** - Customize Launcher settings\n- **[Architecture](https://github.com/BottyIvan/launcher-app/wiki/Architecture)** - Technical design and structure\n- **[API Reference](https://github.com/BottyIvan/launcher-app/wiki/API-Reference)** - API documentation for developers\n- **[Contributing](https://github.com/BottyIvan/launcher-app/wiki/Contributing)** - Contribution guidelines and dev setup\n- **[FAQ](https://github.com/BottyIvan/launcher-app/wiki/FAQ)** - Frequently asked questions and troubleshooting\n- **[Changelog](https://github.com/BottyIvan/launcher-app/wiki/Changelog)** - Version history and release notes\n- **[License](https://github.com/BottyIvan/launcher-app/wiki/License)** - Licensing information\n\n### UI Enhancement Documentation\n\nSee the [UI Enhancements Guide](docs/UI_ENHANCEMENTS.md) for details on the modern interface improvements, including:\n- Custom CSS styling following GNOME HIG\n- Smooth animations and transitions\n- Keyboard-first navigation\n- Color-coded category tags\n- Responsive layout modes (Compact/Default)\n\nFor visual reference, check the [UI Visual Reference](docs/UI_VISUAL_REFERENCE.md).\n\n## 🤝 Contributing\n\nWe welcome contributions! Whether you want to:\n- Report bugs\n- Suggest features\n- Improve documentation\n- Write code\n\n**Please read our [Contributing Guide](https://github.com/BottyIvan/launcher-app/wiki/Contributing) to get started.**\n\n## 💬 Community \u0026 Support\n\n- **Issues**: [GitHub Issues](https://github.com/BottyIvan/launcher-app/issues)\n- **Discussions**: Use GitHub Issues for questions\n- **Email**: droidbotty@gmail.com\n\n## 📋 Requirements\n\n- Python 3.11+\n- GTK4 and Adwaita\n- PyGObject 3.44+\n\n**See [Installation Guide](https://github.com/BottyIvan/launcher-app/wiki/Installation) for complete requirements.**\n\n## 📜 License\n\n**GPL-3.0-or-later** - See [LICENSE](LICENSE) file for details.\n\nLearn more: [License Documentation](https://github.com/BottyIvan/launcher-app/wiki/License)\n\n## 🙏 Acknowledgments\n\n- Built with [GTK4](https://gtk.org/) and [Adwaita](https://gnome.pages.gitlab.gnome.org/libadwaita/)\n- Icon from [Icons8](https://icons8.it/icon/qW0hxm9M3J5x/ricerca)\n- Thanks to all [contributors](https://github.com/BottyIvan/launcher-app/graphs/contributors)\n\n---\n\n\u003cp align=\"center\"\u003e\n    Made with ❤️ by \u003ca href=\"https://github.com/BottyIvan\"\u003eIvan Bottigelli\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    ⭐ Star us on GitHub if you find this project useful!\n\u003c/p\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbottyivan%2Flauncher-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbottyivan%2Flauncher-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbottyivan%2Flauncher-app/lists"}