QuickLaunch - Universal Search Launcher for Android

Universal Search Launcher inspired by KDE Plasma's KRunner, macOS Spotlight, and Windows PowerToys Run

---

🚀 What is QuickLaunch?

QuickLaunch is a lightning-fast universal search launcher for Android that lets you access almost anything on your phone from one unified search interface. Instead of opening multiple apps, everything is just a search away.

QuickLaunch combines the best features from desktop search launchers into a powerful Android app:

• KRunner (KDE Plasma) - Global search, calculator, commands
• Spotlight (macOS) - Speed, minimal UI, instant results
• PowerToys Run (Windows) - Plugin architecture, extensibility
• Alfred (macOS) - Workflow shortcuts, smart ranking

Key Benefits

Feature	Benefit
⚡ Instant Search	Find anything in under 50ms
🧮 Built-in Calculator	Basic math, scientific functions, unit conversions
📁 File Search	Search files by name, type, or extension
📱 Universal App Launcher	Launch any app instantly
📞 Contact Search	Call, message, or email contacts
🔒 Privacy First	All data stays on your device
📱 No Root Required	Works on any Android device

---

📥 Download

Latest APK

• Version: Latest
• Size: ~17 MB
• Requirements: Android 7.0 (API 24) or higher
• No root required

Installation Instructions

1. Download the APK from the link above
2. Enable "Install from unknown sources" in Settings → Security
3. Open the downloaded APK file
4. Install and grant requested permissions as needed

Note: All permissions are optional. The app works without them but with limited features.

---

⚡ Features

🧮 Built-in Calculator

Type mathematical expressions directly for instant results:

Basic Operations:

• Addition: 2+2 → 4
• Subtraction: 10-5 → 5
• Multiplication: 10*5 → 50
• Division: 100/4 → 25

Scientific Functions:

• Trigonometry: sin 45, cos 30, tan 60
• Roots: sqrt 144 → 12, cbrt 27 → 3
• Logarithms: log 100 → 2, ln 2.718
• Factorials: 5! → 120
• Powers: 2^10 → 1024

Unit Conversions:

• Length: 100 km, 1 mile, 1000 mm
• Weight: 50 kg, 100 lbs, 500 g
• Temperature: 32°C, 212°F, 0°C
• Currency: 100 USD, 50 EUR (live rates)
• Digital Storage: 1 TB, 500 MB, 2 GB
• Time: 2 hours, 90 minutes
• Volume: 1 L, 1 gallon, 100 ml
• Area: 1 acre, 100 sqm
• Speed: 100 km/h, 60 mph
• Pressure: 1 atm, 101.325 kPa
• Energy: 1000 J, 1 kWh
• Data Transfer: 100 Mbps, 1 Gbps

📁 File Search

Search files by name, extension, or type:

Search Query	Result
pdf	All PDF documents
photo	All images
download	Download folder contents
.doc	Word documents
.mp3	Music files
.mp4	Video files
.zip	Compressed archives
.apk	Android apps

Supported File Types:

• Documents: PDF, DOC, DOCX, TXT, RTF, XLS, XLSX, PPT, PPTX
• Images: JPG, PNG, GIF, BMP, WEBP, SVG
• Audio: MP3, WAV, FLAC, AAC, OGG, M4A
• Video: MP4, MKV, AVI, MOV, WEBM
• Archives: ZIP, RAR, 7Z, TAR, GZ
• Code: APK, JSON, XML, HTML, CSS, JS

⚙️ Quick Commands

Instant access to settings and system actions:

Command	Action
wifi	Open Wi-Fi settings
bluetooth	Open Bluetooth settings
flashlight	Toggle flashlight
camera	Open camera app
calculator	Open calculator
battery	Battery settings
display	Display settings
sound	Sound settings
dnd	Toggle Do Not Disturb
location	GPS/Location settings
airplane	Airplane mode toggle
hotspot	Mobile hotspot settings
data	Data usage settings
apps	App management
storage	Storage settings
security	Security settings
accounts	Account settings

Web Shortcuts:

Command	Action
yt [query]	Search YouTube
map [place]	Open Google Maps
search [query]	Web search
g [query]	Google search
ddg [query]	DuckDuckGo search

📱 App Launcher

• Launch any installed app instantly
• Recently used apps shown first
• Usage-based smart ranking
• Search by app name or package name
• Show app information and storage size

📞 Contact Search

• Search contacts by name or number
• Quick actions for each contact:
  • 📞 Call - Direct phone call
  • 💬 SMS - Send text message
  • ✉️ Email - Send email
  • 📹 WhatsApp - Open WhatsApp chat
  • 💼 Telegram - Open Telegram chat

📋 Clipboard History

• Automatically save clipboard items
• Pin important items for quick access
• Quick copy action for any item
• Clear history option
• Persistent storage across sessions

⚡ Settings Search

Search through all Android settings:

• Wi-Fi, Bluetooth, Display, Sound
• Apps, Notifications, Battery
• Storage, Security, Users
• Network, VPN, Accounts
• Accessibility, Shortcuts

🌐 Internet Search

Search the web using your preferred provider:

• 🔍 Google (default)
• 🦆 DuckDuckGo
• 🌐 Bing
• 🛡️ Brave Search

---

🔒 Privacy & Security

✅ What We DON'T Do

❌ Never	Why This Matters
No data collection	Your search history stays private
No internet tracking	We don't track your searches
No background monitoring	Only activates when you open the app
No unnecessary permissions	Only requests permissions when needed
No ads or tracking	Completely ad-free experience
No cloud services	All processing happens locally

✅ Optional Permissions

Permission	Purpose	When Needed
READ_EXTERNAL_STORAGE	File search	For finding files on your device
READ_CONTACTS	Contact search	To search and call contacts
CALL_PHONE	Make calls	To initiate calls from the app
BIND_ACCESSIBILITY_SERVICE	Global trigger	For edge swipe gesture
BIND_QUICK_SETTINGS_TILE	Quick settings	To add tile to quick settings

All permissions are optional. The app works without them but with limited features.

🛡️ Security Features

• Sandboxed Storage: App data is isolated from other apps
• No Root Required: Works safely on any Android device
• Minimal Attack Surface: No exposed APIs or background services
• Graceful Degradation: Features requiring denied permissions are simply hidden
• Open Source: Code can be audited for security

---

🏗️ Technical Architecture

Clean Architecture

┌─────────────────────────────────────┐
│         UI / Presentation           │
│  (Activities, ViewModels, Compose)  │
├─────────────────────────────────────┤
│           Domain Layer              │
│    (Use Cases, Models, Interfaces)   │
├─────────────────────────────────────┤
│          Data Layer                 │
│  (Repositories, Providers, Storage) │
└─────────────────────────────────────┘

Modular Search Provider System

Each search category is an independent, modular provider:

SearchEngine (Orchestrator)
    ├── AppsSearchProvider
    ├── ContactsSearchProvider
    ├── CalculatorSearchProvider
    ├── FilesSearchProvider
    ├── CommandsSearchProvider
    ├── SettingsSearchProvider
    ├── ClipboardSearchProvider
    └── InternetSearchProvider

Benefits of Modular Design:

• ✅ Each provider runs independently
• ✅ Failure in one provider doesn't affect others
• ✅ Easy to add new providers
• ✅ Easy to enable/disable features
• ✅ Better testing and maintenance

Performance Design

Goal	Implementation
Fast Launch (<150ms)	Hilt dependency injection
Quick Search (<50ms)	Parallel coroutine searches
Low Memory	Lazy loading, no pre-indexing
Battery Friendly	No background services unless triggered

---

📂 Project Structure

com.quicklaunch/
├── data/
│   ├── local/
│   │   ├── dao/           # Room database operations
│   │   └── datastore/     # Preferences storage
│   ├── repository/        # Repository implementations
│   └── source/            # Search providers
├── di/                    # Hilt dependency injection
├── domain/
│   ├── model/             # Domain models
│   └── repository/        # Repository interfaces
├── presentation/
│   └── ui/                # Activities, ViewModels, Composables
├── service/              # Accessibility & quick settings tiles
└── widget/               # Home screen widget

---

🛠️ Technology Stack

Component	Technology	Version
Language	Kotlin	1.9.x
UI Framework	Jetpack Compose	1.5.x
Dependency Injection	Hilt	2.48
Database	Room	2.6.x
Async Operations	Kotlin Coroutines + Flow	1.7.x
Architecture	MVVM + Clean Architecture	-
Min SDK	API 24	Android 7.0
Target SDK	API 34	Android 14
Compile SDK	API 34	Android 14

---

📱 How to Use

Trigger Methods

1. 📱 Widget - Add QuickLaunch widget to your home screen
2. ⚡ Quick Settings - Add QuickLaunch tile to your quick settings panel
3. 👆 Accessibility - Swipe from screen edge (if enabled)

Search Flow

┌─────────────┐
│ Open App    │
└──────┬──────┘
       ↓
┌─────────────┐
│ Type Query  │
└──────┬──────┘
       ↓
┌─────────────┐
│ See Results │
└──────┬──────┘
       ↓
┌─────────────┐
│ Tap Action  │
└─────────────┘

Quick Examples

Type This	Get This
2+2	Calculator: 4
sqrt 144	Calculator: 12
100 km to miles	Conversion: 62.14 mi
pdf	List of PDF files
wifi	Wi-Fi settings page
John	John's contact with call/message options
spotify	Spotify app launcher
youtube cat videos	YouTube search
32°C to F	Conversion: 89.6°F
flashlight	Toggle flashlight on/off

---

🌟 Why Choose QuickLaunch?

vs. Default Android Launchers

Feature	Default Launcher	QuickLaunch
Calculator in search	❌	✅
Unit conversion	❌	✅
File search	❌	✅
Quick commands	❌	✅
Scientific calculator	❌	✅
App size	Heavy (30+ MB)	Light (~17 MB)

vs. Other Search Apps

Feature	Other Apps	QuickLaunch
Modular design	❌	✅
Independent providers	❌	✅
No crashes from one provider	❌	✅
Clean architecture	❌	✅
Modern tech stack	❌	✅
Material Design 3	❌	✅

---

🔄 Updates & Roadmap

Coming Soon

• 🌐 Cloud clipboard sync
• 🔌 Plugin system
• 📊 Usage analytics dashboard
• 🎨 Theme customization
• ⌨️ Keyboard shortcuts
• 🔍 Advanced file filters
• 📱 Widget customization
• 🌎 Multi-language support

Changelog

See CHANGELOG.md for version history.

---

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Clone your fork: git clone https://github.com/yourusername/quicklaunch-android.git
3. Create a feature branch: git checkout -b feature/amazing-feature
4. Commit your changes: git commit -m 'Add amazing feature'
5. Push to the branch: git push origin feature/amazing-feature
6. Open a Pull Request

Development Setup

# Clone the repository
git clone https://github.com/quicklaunch/quicklaunch-android.git

# Open in Android Studio
# Build and run on emulator or device

---

🐛 Reporting Issues

If you find a bug or have suggestions:

1. Search existing issues first
2. Create a new issue with detailed information
3. Include:
   • Device model and manufacturer
   • Android version
   • Steps to reproduce
   • Expected vs actual behavior
   • Screenshots if applicable

---

📄 License

This project is open source and available under the MIT License.

MIT License

Copyright (c) 2024 QuickLaunch Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

🙏 Acknowledgments

Inspired by the amazing work of:

• KDE Plasma Team - KRunner
• Apple - macOS Spotlight
• Microsoft - PowerToys Run
• Alfred Team - Alfred Launcher

---

📞 Contact & Support

• 📋 Documentation: Wiki
• 🐛 Bug Reports: Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: support@quicklaunch.app

---

Made with ❤️ for Android users worldwide

Documentation • Releases • Issues • Discussions

⭐ Star us on GitHub if you find QuickLaunch useful!