🧠 PixelBrain- Your Second Brain for Screenshots

Turn your chaotic screenshot gallery into an organized, searchable, and intelligent knowledge base.

💥 The Problem: “The Screenshot Black Hole”

We’ve all been there. You see something important — a code snippet, a lecture slide, a payment receipt, or a funny meme — and you click screenshot.

But then what?

• It gets buried under 1,000 other photos 📉
• You forget why you took it 🤷‍♂️
• You can never find it when you actually need it 🔍

✅ Result: Valuable information is lost forever in the Digital Abyss.

---

💡 The Solution

PixelBrain is an intelligent mobile app that uses Google Gemini AI to automatically analyze, tag, and organize your screenshots the moment you take them.

It transforms a messy gallery into a structured Second Brain that you can query, search, and relive.

---

📸 See it in Action

---

✨ Key Features

🤖 AI Auto-Classification
Instantly categorizes images into Code, Notes, Events, Memes, or Receipts.

📅 Event Detection
Scans posters/invites and extracts dates automatically to remind you of upcoming hackathons or exams.

💻 Code Scanner
Detects programming code in images and lets you copy text directly to your clipboard.

🔍 Semantic Search
Forget scrolling. Just search "Python Loop" or "Music Fest" to find the exact image.

🎞️ Story Mode
Relive your week with an Instagram-style Recap of your screenshots, complete with lofi background music.

☁️ Cloud Sync (Firebase)
Your brain is backed up. Uninstall the app? No problem. Your data is synced to your device ID.

---

🛠️ Google Tech Stack (Powering the Brain)

Technology	Usage
🤖 Gemini 2.5 Flash	Multimodal AI analyzes screenshots to extract context, summary, and tags
🔥 Firebase Firestore	Real-time cloud database to sync user data and maintain state
💙 Flutter	Cross-platform UI toolkit for a smooth mobile experience
📱 Android / Kotlin	Native integration for permissions + scoped storage access

---

🏗️ Architecture

PixelBrain processes a screenshot from your gallery to the cloud:

graph TD
    A[User Takes Screenshot] -->|Auto-Scan| B(Flutter Gallery Service)
    B -->|Raw Bytes| C{BrainController}
    C -->|Image Data| D[Google Gemini 2.5 Flash]
    D -->|JSON Response| E[Extract: Tags, Dates, Category]
    E -->|Structured Data| F[(Firebase Firestore)]
    F -->|Real-time Stream| G[UI Dashboard]
    G -->|User Interaction| H[ Semantic Search / Copy Code / Stories]

Loading

🚀 Installation & Setup Guide

✅ Prerequisites

Make sure you have the following installed/setup:

• Flutter SDK (3.0+)
• Android Studio / VS Code
• A Google Cloud Project with Gemini API enabled
• A Firebase Project

---

1️⃣ Clone the Repo

git clone https://github.com/yourusername/pixel_brain.git
cd pixel_brain

2️⃣ Setup Gemini API Key

Open this file:

lib/data/services/gemini_service.dart

Add your Gemini API key:

static const String _apiKey = 'YOUR_GEMINI_API_KEY';

3️⃣ Setup Firebase

1. Go to Firebase Console
2. Create a new project
3. Add an Android App
   • Package name: com.example.pixel_brain
4. Download google-services.json
5. Place it here: android/app/google-services.json

---

4️⃣ Run the App

Connect your Android device (USB Debugging ON) and run:

flutter pub get
flutter run

📱 Download APK

Want to try it right now?

⬇️ Download PixelBrain v1.0.apk
(Add your Google Drive / Dropbox link here)

---

---

Built with ❤️ by Aviral Saxena