Quick Search

A fast & powerful Android app that lets you search across apps, app shortcuts, contacts, calendar events, device files, device settings, app settings, and the web, plus access tools like calculator, unit converter, etc—all from a single search bar. Built with Kotlin and Jetpack Compose using Material 3 design.

📸 Screenshots

✨ Key Features

🔍 Unified Search

• Apps: Search and launch installed applications with smart ranking. App search ignores typos and allows abbreviations. Long press apps to access their shortcuts (if available).
• App Shortcuts: Find and launch app shortcuts (including custom deep links and search/browser shortcuts) alongside app results.
• Contacts: Find and call/text contacts with multi-number support and integrations such as WhatsApp, Telegram, Signal, Google Meet, and more. Long press contact actions to customize them.
• Calendar Events: Search your calendar events from the search bar.
• Notes: Write notes and search them from the search bar. Swipe left on the home screen for a quick note.
• Files: Search device files and folders (images, videos, documents, etc.)
• Device Settings: Search Android system settings
• App Settings: Find and open Quick Search app settings directly from the search bar
• Top Matches: Turn this on to see the top result for your query across all categories. You can also enable or disable categories and adjust their priority.
• Web: Search the web using 25 search engines with customizable shortcuts and web suggestions. Browsers can be added as search engines.
• Calculator: Built-in calculator for math expressions (+, -, *, /, brackets); optional alias to open calculator mode
• Unit Converter: Convert units from the search bar (length, mass, temperature, area, volume, time, speed, data, energy, power, pressure, angle, frequency, and more)
• Currency Converter: Convert between currencies with live exchange rates directly from the search bar
• World Clock: Check the current time across different time zones by searching for city names
• Date & Time: Natural-language date parsing, differences, offsets, and time arithmetic from the search bar (optional alias)
• AI Search: AI search with AI-powered answers using models and optional personal context
• AI Providers: Configure API keys for multiple providers - Gemini, OpenAI, Claude, Groq - at the same time, plus custom AI providers using any OpenAI-compatible API
• Custom AI Tools: Create your own AI tools (requires an API key)
• App Suggestions: Swipe left or right on the suggestions row to switch between New & Updated, Pinned, and Most Used apps
• Search History: View search history and swipe left or right in the expanded history to switch between recent queries and recently opened results
• Overlay Mode: Enable to make the search bar appear over other apps, anywhere—changes how you access search from any screen
• Home Screen Widget: Search widget and custom buttons widget with extensive customization options
• Launch Options: Widget, Quick Settings Tile, Digital Assistant & set as Launcher
• Triggers: Long-press any result to set a trigger. The app opens it automatically when you type the trigger word and press space.

🎨 Customization & New Features

• App Themes: Choose from multiple visual themes (Mono, Forest, Aurora, Sunset) for the app's appearance
• Material You: Use your device's color palette from Material You for the app's theme and accent colors
• Bottom Search Bar: Option for bottom-positioned search bar for improved accessibility
• Font Size Control: Customize font size throughout the app for better readability
• Custom Backgrounds: Select any picture from your device for the app background, with transparency and blur controls
• App Management: View app details or bulk uninstall apps from search results settings
• Shortcut Management: Enable, disable, or add custom shortcuts including search queries, URLs, and app activities
• Import/Export Settings: Backup and restore your Quick Search configuration and preferences

Search Shortcuts

Configure custom keyboard shortcuts for search engines and add them at the start of a query to quickly trigger the respective search engine:

• ggl → Google
• ytb → YouTube
• mps → Google Maps
• And more...

AI Search

Enable AI-powered answers by:

1. Getting a Gemini API key from Google AI Studio
2. Adding the key in Settings → Search Engines → AI Search
3. Optionally add personal context for personalized answers
4. Choose any models of your choice

Search Engines

• Supported (25): AI Search, Google, ChatGPT, Gemini, Perplexity, Grok, Google Maps, Google Drive, Google Photos, Google Play, YouTube, YouTube Music, Spotify, Reddit, Amazon, X (Twitter), Facebook Marketplace, Bing, DuckDuckGo, Brave, Startpage, You.com, AI Mode, Claude, Wikipedia—each can be reordered or disabled. You also have option to add custom search engines.
• Browsers: Add installed browsers as search engines
• AI Search: AI answers with Gemini API integration; choose among several Gemini and Gemma models; optional personal context
• AI Providers: Support for multiple providers at once (OpenAI, Claude, Groq), plus custom AI providers via any OpenAI-compatible API
• Style: Choose between inline or compact styles

View all features

🚀 Installation

Requirements

• Android 7.0 (API 24) or higher
• Target SDK: Android 15 (API 36)

Build from Source

# Clone the repository
git clone https://github.com/teja2495/quick-search.git
cd quick-search

# Google Play / GitHub releases (includes Play in-app review & updates)
./gradlew assembleStandardRelease

# F-Droid build (no Google Play libraries bundled)
./gradlew assembleFdroidRelease

See docs/FDROID.md for publishing to F-Droid.

Download

• Google Play Store: Get the app from Google Play Store for automatic updates
• F-Droid: Install from F-Droid for repository-based updates
• APK Release: Download the latest APK from the Releases page

🛡️ Permissions & Privacy

Quick Search prioritizes your privacy. All permissions are optional, only used to unlock additional features. All search processing happens locally on your device. For detailed information, see our Privacy Policy.

Key Points:

• No ads or analytics
• Encrypted storage for API keys
• Granular permission controls
• Local data processing

🏗️ Architecture

Built with modern Android development practices:

• Language: Kotlin 2.0.21
• UI: Jetpack Compose with Material 3 (BOM 2025.12.01)
• Architecture: MVVM with ViewModels and StateFlow (unidirectional data flow)
• State Management: Single source of truth with sealed classes for type-safe states
• Persistence: SharedPreferences with encryption for sensitive data (Gemini API keys)
• Widgets: Jetpack Glance App Widget framework
• Build System: Gradle Kotlin DSL (8.12.3) with version catalogs
• Min SDK: 24 (Android 7.0) | Target SDK: 36 (Android 15)

Project Structure

app/src/main/java/com/tk/quicksearch/
├── app/                    # Application entry point and app-level handlers
├── navigation/             # Navigation management with animated transitions
├── shared/                 # Shared components and utilities
│   ├── ui/                 # Shared UI components and Material 3 theming
│   │   ├── components/     # Reusable UI components
│   │   └── theme/          # Theming, colors, and design tokens
│   └── util/               # Shared utility functions
├── search/                 # Main search functionality
│   ├── models/             # Data models (AppInfo, ContactInfo, DeviceFile, etc.)
│   ├── data/               # Data layer with repositories and preferences
│   ├── core/               # SearchViewModel, state management, unified search
│   ├── apps/               # App search, icons, and management
│   ├── appShortcuts/       # App shortcut search and actions
│   ├── contacts/           # Contact search with messaging integrations
│   ├── files/              # File search and management
│   ├── deviceSettings/     # Device settings search
│   ├── searchScreen/       # Main search UI and layout orchestration
│   ├── overlay/            # Overlay mode (search over other apps)
│   ├── webSuggestions/     # Web search suggestions
│   ├── fuzzy/              # Fuzzy search engine
│   ├── searchHistory/      # Recent items tracking and display
│   └── common/             # Shared utilities and handlers
├── searchEngines/          # Search engine integration and management
│   ├── compact/            # Compact mode UI
│   ├── inline/             # Inline mode UI
│   └── shared/             # Shared search engine components
├── tools/                  # Specialized tools and utilities
│   ├── calculator/         # Calculator functionality
│   └── aiSearch/            # AI Search (Gemini API integration)
├── settings/               # Settings screens (restructured)
│   ├── appearanceSettings/ # Appearance and theme settings
│   ├── appShortcutsSettings/# App shortcuts configuration
│   ├── searchEngineSettings/# Search engine settings
│   ├── navigation/         # Settings navigation
│   └── shared/             # Shared settings components
├── onboarding/             # First-launch setup flow
├── widgets/                # Home screen widgets (Glance framework)
├── tile/                   # Quick Settings tile service
└── util/                   # Legacy utility functions (most moved to shared/util/)

Key Architectural Patterns

• Feature-based organization: Code organized by feature domain
• Repository pattern: Data layer abstraction
• Sealed classes: Type-safe state management
• Three-phase initialization: Optimized startup performance
• Modular preferences: Specialized preference management classes

📄 License

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

📞 Contact

• Email: tejakarlapudi.apps@gmail.com
• Issues: GitHub Issues

---

Made with ❤️ for Android