⚡ AutoFill Pro v3.0

AutoFill Pro is a high-performance, secure, and feature-rich Chrome Extension (Manifest V3) designed to streamline form filling and automate repetitive web workflows. Packed with Local Offline OCR (Tesseract WASM), ICAO Doc 9303 Passport MRZ Parser, Auto Actions Macro Engine, Point-and-Click Visual Form Capture, and Zero-Knowledge End-to-End Encrypted (E2EE) Cloud Synchronization.

---

🌟 Key Features

🛂 1. Passport & Document MRZ Parser

• ICAO Doc 9303 Standard: Parses 2-line (TD3 / Passports) and 3-line (TD1 / ID cards) Machine Readable Zones (MRZ) with checksum validation.
• Smart Field Extraction: Automatically extracts Passport Number, Given Name, Surname, Date of Birth, Expiry Date, Gender, Nationality, NID, and Addresses.
• 1-Click Profile Generation: Convert parsed passport documents directly into active AutoFill profiles.

📄 2. Offline Client-Side OCR (Tesseract WASM)

• 100% Private & Local: Uses WebAssembly-based Tesseract engine directly in your browser—no document images are ever uploaded to external servers.
• Image Scan Recognition: Extract form values directly from image files (.png, .jpg, .jpeg, .webp, .bmp).

📊 3. Excel & CSV Data Engine (Batch Autofill & Macro Stepper)

• RFC 4180 CSV & TSV Parser: Upload .csv, .tsv, or paste tab-separated rows directly from Microsoft Excel or Google Sheets.
• 1-Click Bulk Profile Conversion: Convert entire tables of applicant/employee records into individual AutoFill Profiles instantly.
• Active Row Navigator for Auto Actions: Step through spreadsheet rows (Row 1, Row 2...) directly from the Popup or Options page, seamlessly resolving {excel.ColumnName} placeholders during macro autofill.
• Built-in Sample Data & Export: Includes built-in sample applicant datasets and UTF-8 BOM CSV export.

📸 4. Visual Form Capture

• Point-and-Click Overlay: Capture form inputs, select dropdowns, textareas, checkboxes, and radio buttons interactively on any webpage.
• Smart Selector Resolution: Automatically generates resilient CSS Selectors, input names, and XPath expressions.

⚡ 5. Auto Actions Engine (Macro Sequence)

• Automated Workflow Sequences: Define automated action steps (fill, click, delay, select) triggered automatically upon visiting target URL patterns.
• Condition Matching: Exact match, prefix match, or regular expression matching per domain or path.

🔐 6. Client-Side End-to-End Encryption (E2EE)

• Zero-Knowledge Architecture: Profile data is encrypted locally inside the extension using AES-GCM 256-bit before cloud sync.
• Key Derivation: Secure PBKDF2 key derivation with 100,000 iterations and SHA-256 using your Master Password.

☁️ 7. Cloud Sync & Google Sign-In

• 1-Click Google Login: Seamless Google Authentication with native Chrome Identity support.
• Automatic Sync: Sync profiles, hotkeys, and settings across multiple devices with periodic background auto-sync.
• Real-time Search: Search profiles dynamically by name, phone number, NID, or field contents.

🎯 8. Multi-Tier Dropdown & Dynamic Matching

• 4-Tier Select Matching:
  1. Exact option value
  2. Exact option text label
  3. Option text prefix (starts-with)
  4. Substring text match (with length threshold guards)
• Modern Framework Support: Dispatches native DOM focus, input, change, and blur events to ensure full compatibility with React, Vue, and Angular forms.

---

🚀 Setup & Installation

Option 1: Load from Source (Developer Mode)

1. Download the latest autofill-pro-v3.0.zip release or clone this repository:

   git clone https://github.com/bdyusuf2016/autofill-pro.git

2. Open Google Chrome and navigate to chrome://extensions/.
3. Enable Developer mode toggle in the top-right corner.
4. Click Load unpacked in the top-left corner.
5. Select the autofill-pro directory.
6. The AutoFill Pro extension icon ⚡ will appear in your Chrome toolbar!

---

⚙️ Configuration

Firebase Cloud Sync Setup (Optional for Self-Hosting)

AutoFill Pro includes built-in cloud synchronization out-of-the-box. If you want to use your own Firebase project:

1. Create a project on Firebase Console.
2. Enable Authentication (Email/Password & Google Sign-In providers).
3. Enable Realtime Database.
4. Copy firebase-config.example.js to firebase-config.js and add your project keys:

   const firebaseConfig = {
     apiKey: "YOUR_API_KEY",
     authDomain: "YOUR_PROJECT_ID.firebaseapp.com",
     databaseURL: "https://YOUR_PROJECT_ID-default-rtdb.firebaseio.com",
     projectId: "YOUR_PROJECT_ID",
     storageBucket: "YOUR_PROJECT_ID.appspot.com",
     messagingSenderId: "YOUR_SENDER_ID",
     appId: "YOUR_APP_ID"
   };

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl+Shift+F (Windows/Linux) / Cmd+Shift+F (Mac)	Fill Active Profile on current webpage
Ctrl+Shift+U (Windows/Linux) / Cmd+Shift+U (Mac)	Open Profile Selector Menu
Custom per-profile hotkeys	Configurable under Settings & Hotkeys tab

---

🌐 Localization Support

AutoFill Pro supports multilingual interfaces:

• 🇬🇧 English (en)
• 🇧🇩 Bengali / বাংলা (bn)

Switch language anytime via the Settings tab in the Options page.

---

📂 Project Structure

autofill-pro/
├── manifest.json              # Chrome Manifest V3 configuration
├── popup.html / popup.js      # Quick popup launcher & active profile selector
├── options.html / options.js  # Full management dashboard & settings
├── content.js                 # Form filling engine & DOM injector
├── background.js              # Service worker, alarms & context menus
├── passport-parser.js         # ICAO Doc 9303 MRZ & Passport Parser
├── excel-engine.js            # CSV, TSV & Excel Data Engine
├── ocr-parser.js              # Tesseract OCR & Document text parser
├── sample-data.csv            # Sample applicant data for Excel testing
├── crypto-helper.js           # AES-GCM 256-bit E2EE crypto module
├── firebase-auth.js           # Google & Firebase Authentication
├── firebase-sync.js           # Realtime Database sync engine
├── url-rule-matcher.js        # Domain & URL regex rule processor
├── hotkey-manager.js          # Keyboard shortcut manager
├── tessdata/                  # Tesseract offline trained language data
└── _locales/                  # English and Bengali localization dictionaries

---

📄 License & Author

• Author: Md. Yusuf Ali (GitHub: @bdyusuf2016)
• Organization: Yusuf Computer & IT
• License: MIT License