Skip to content

Repository navigation

README.md

Latest commit

 

History

History
147 lines (115 loc) · 9.35 KB

README.md

File metadata and controls

147 lines (115 loc) · 9.35 KB
Raw

Quick Search

A fast, private Android search app and launcher. Search apps, app shortcuts, contacts, files, calendar events, notes, bookmarks, reminders, notification history, device settings, and the web, and use built-in tools like a calculator, unit and currency converters, alarms and timers, and AI Search, all from a single search bar. Built with Kotlin and Jetpack Compose using Material 3 design.

Get it on Google Play Get it on F-Droid Get it on GitHub

License: MIT

📸 Screenshots
Screenshot 1 Screenshot 2 Screenshot 3
Screenshot 5 Screenshot 6 Screenshot 7

✨ Key Features

🔍 Unified Search

  • Apps: Smart ranking that tolerates typos and matches acronyms (yt → YouTube) and nicknames. Long-press an app for its shortcuts.
  • App Shortcuts: Launch app shortcuts, custom deep links, and Tasker tasks alongside app results.
  • Contacts: Call or text, with multi-number support and WhatsApp, Telegram, Signal, and Google Meet actions. Long-press actions to customize them or add them to Home.
  • Files: Search device files and folders.
  • Calendar Events: Search your calendar events.
  • Notes: Write and search notes, plus a Quick Note in the Widgets Panel.
  • Bookmarks: Save any website or link and find it from search. Import Chrome desktop bookmarks from an exported HTML file.
  • Reminders: Create reminders in plain language, e.g. Laundry in 2 hrs, and search them later.
  • Notification History: Search notifications received after access is granted.
  • Device & App Settings: Jump straight to Android settings or Quick Search settings.
  • Screen Time: Search Screen Time to check daily phone usage.
  • Top Matches: See the best result across all categories, with configurable categories and priority.
  • App Suggestions: Swipe between New & Updated, Pinned, and Most Used apps. Drag one pinned app onto another to create a folder.
  • Search History: Switch between recent queries and recently opened results.
  • Aliases & Triggers: Prefix a query with an alias to target a section, engine, or tool. Long-press any result to set a trigger word that opens it automatically.

🌐 Web & AI

  • 30 Search Engines: Google, ChatGPT, Gemini, Perplexity, Claude, Kagi, DuckDuckGo, YouTube, Spotify, Reddit, Wikipedia, and more. Reorder, disable, or assign aliases (ggl → Google). Installed browsers and custom engines can be added too.
  • Web Suggestions: Suggestions as you type, with a configurable count.
  • AI Search: AI answers with follow-up questions and optional personal context. Works with Gemini, OpenAI, Claude, Groq, Meta AI, and OpenCode, or any OpenAI-compatible provider. Add a Tavily key for web results on models without built-in search.
  • Custom AI Tools: Build your own AI-powered tools (requires an API key).

🧰 Tools

  • Calculator: Math expressions, with calculator buttons on the numeric keyboard.
  • Unit Converter: Length, mass, temperature, area, volume, time, speed, data, energy, power, pressure, angle, and frequency.
  • Currency Converter: Live exchange rates, no API key needed (100 USD to EUR).
  • Date & Time: Natural-language dates, differences, offsets, and time arithmetic.
  • Alarms & Timers: 2:45pm sets an alarm; 15 min starts a timer.
  • More: World clock, weather, dictionary, hex/RGB color visualizer, and Tasker integration.

🏠 Launcher & Home

  • Set as Launcher: Use Quick Search as your home screen, with app lock, Android Private Space support, more system app shortcuts, and customizable swipe and double-tap gestures.
  • At a Glance: Today's events, reminders, alarms and timers, media controls, missed and ongoing calls, OTP codes, weather, battery and device status, app notifications, and AI-powered Custom Info. Also available as a widget for any launcher.
  • Widgets Panel: Swipe right to open a side panel for any Android widget, and pin widgets to Home. Works with or without Quick Search as your launcher.
  • Home Screen Widgets: Search, custom buttons, media controls, note, countdown, and At a Glance widgets with extensive customization.
  • More Ways to Launch: Default assistant, Quick Settings tile, overlay mode over other apps, system-wide edge swipe, notch gestures (tap the camera cutout), and a floating button.
  • SpeedBump: Add a short delay before chosen apps open to break habitual opening, even when launched from other launchers.

🎨 Customization

  • Themes: Mono, Forest, Aurora, and Sunset themes; Material You; custom accent colors; AMOLED black.
  • Backgrounds: Use your wallpaper or any image, with transparency and blur controls.
  • Layout: Compact card-less layout, bottom search bar, mic button for voice typing, font size, system font, and themed icons.
  • Backup & Restore: Import/export settings, plus automatic Android backup.

View all features

🚀 Installation

Requirements

  • Android 7.0 (API 24) or higher

Download

Build from Source

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.

🛡️ Permissions & Privacy

All permissions are optional and only unlock the features that need them. Search runs locally on your device. See the Privacy Policy for details.

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

🏗️ Architecture

  • Language: Kotlin
  • UI: Jetpack Compose with Material 3
  • Architecture: MVVM with StateFlow and unidirectional data flow
  • Persistence: Modular SharedPreferences (encrypted for API keys) and Room for notes, bookmarks, and notification history
  • Widgets: Jetpack Glance
  • Build: Gradle Kotlin DSL with version catalogs; standard and fdroid flavors; :benchmark module for baseline profiles
  • Min SDK: 24 (Android 7.0) | Target SDK: 37

Project Structure

app/src/main/java/com/tk/quicksearch/
├── app/                  # Activities (search, launcher), startup, app-level handlers
├── search/               # Search core, data/preferences, result types, search screen UI
├── searchEngines/        # Web search engines, aliases, secondary search
├── tools/                # Calculator, unit/date tools, alarms, AI Search, Tasker
├── settings/             # Settings screens and navigation
├── widgetsPanel/         # Widgets Panel and Home widgets
├── widgets/              # Glance home-screen widgets
├── reminders/            # Reminder parsing and scheduling
├── customInfo/           # Scheduled AI Custom Info for At a Glance
├── appNotifications/     # App notification sources for At a Glance
├── media/                # Media session controls
├── pinnedNotifications/  # Shortcuts and notes pinned to the notification shade
├── overlay/              # Draw-over-other-apps mode
├── edgeGesture/          # System-wide edge swipe launcher
├── notchGesture/         # Notch / camera cutout tap gestures
├── floatingButton/       # Floating launch button
├── tile/                 # Quick Settings tile
├── onboarding/           # First-launch setup
└── shared/               # Shared UI components, theme, and utilities

Contributors and coding agents: see AGENTS.md for the architecture map and conventions.

📄 License

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

📞 Contact

Made with ❤️ for Android