Skip to content

An AI-powered Android navigator that uses Gemini 2.0 Flash to shout sarcastic Hindi insults when you miss a turn in Google Maps.

Notifications You must be signed in to change notification settings

Devansh-Maurya/StrictNav

Repository files navigation

🧭 StrictNav: The AI Map Shouter

Kotlin Gemini AI Android SDK License

StrictNav is not your typical navigator. Inspired by the legendary frustrated driving instructors of Lucknow, this app uses Google's latest Gemini 3 Flash AI to "shout" at you in sarcastic, aggressive Hindi whenever you miss a turn in Google Maps.


✨ Features

  • 🤬 AI-Powered Insults (Gemini 3): Dynamic, context-aware insults generated in real-time by Gemini 3 Flash.
  • 🎙️ Multimodal Audio: Native "shouting" voice output directly from the AI for maximum emotional impact.
  • 🎭 Cultural Personas: Choose your instructor's flavor!
    • Lucknowi: Tehzeeb-filled sharp sarcasm.
    • Haryanvi: Rustic, direct, and unapologetically blunt.
    • Delhi: Urban, impatient "Bhai" culture.
    • Bihari: Witty and colloquial scolding.
  • 🛰️ Background Monitoring: Uses NotificationListenerService to detect rerouting events from Google Maps even when the app is in the background.
  • 📊 Real-time Event Logs: A built-in log viewer to watch the AI's "thought process" as it crafts your next humiliation.
  • 🔊 Robust Fallbacks: Intelligent failover to high-impact "Shouty" System TTS if AI audio generation is restricted.

🚀 How It Works

  1. Sense: The app monitors system notifications for keywords like "Rerouting" or "Recalculating" from Google Maps.
  2. Think & Speak: A single multimodal request is sent to Gemini.
  3. Outcome: Within milliseconds, you receive both a sharp Hindi text insult and a high-quality audio clip of a frustrated instructor yelling at you.

🛠️ Technical Stack

  • UI: Jetpack Compose (Modern, Reactive UI)
  • Networking: OkHttp with Kotlin Serialization
  • AI: Google Generative AI (Gemini 3 Flash)
  • Audio Control: Android MediaPlayer API
  • Detection: Notification Listener Service

⚙️ Setup Instructions

Prerequisites

Installation

  1. Clone the repository:
    git clone https://github.com/Devansh-Maurya/StrictNav.git
  2. Create a local.properties file in the root directory:
    GEMINI_API_KEY=your_api_key_here
  3. Build and Run the project in Android Studio.

Firebase Setup (Optional)

To enable analytics and detailed tracking:

  1. Create a project in the Firebase Console.
  2. Add an Android app with the package name com.antrix.dev.strictnav.
  3. Download the google-services.json file and place it in the app/ directory.
  4. (Optional) Connect to the Firebase CLI using firebase init if you want to use Hosting or other features.

Permissions Required

  • Notification Access: To detect route changes in Google Maps.
  • Internet: To connect with the Gemini AI engine.

📸 UI Preview

Home Screen Cultural Personas Real-Time Logs
Home Screen Preview Cultural Personas UI Real-Time Logs Preview

(Note: Add actual screenshots here after generating items)


🤝 Contributing

StrictNav is an open-source project. Feel free to submit PRs for:

  • New cultural personas (Delhi, Punjab, etc.)
  • Improved detection logic
  • UI/UX refinements

📜 License

Distributed under the MIT License. See LICENSE for more information.


"शाबाश! पूरा शहर घूमने का इरादा है क्या?! अगली बार दिमाग घर पर मत छोड़िएगा।" — Your StrictNav Instructor

About

An AI-powered Android navigator that uses Gemini 2.0 Flash to shout sarcastic Hindi insults when you miss a turn in Google Maps.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages