🔗 TurtlPass Ecosystem

🐢 Firmware • 💾 Protobuf • 💻 Host • 🌐 Chrome • 📱 Android

---

🌐 TurtlPass Chrome Extension

A secure, hardware-backed password generator that connects your browser to the TurtlPass USB device via Web Serial & Protobuf. Passwords are generated on-device, and when you press the physical button, the device emulates a keyboard and types your password — safely and locally, without ever exposing it online.

---

⚡ Features

• 🔒 Hardware-assisted password generation
• 🧩 Communicates with the device via Protobuf
• 🌐 Auto-detects the active Domain
• 💾 Remembers your Account ID
• ⌨️ One-button password typing (no clipboard needed)
• 👁 Press Ctrl to reveal/hide your password

---

🧠 Architecture Overview

The Chrome Extension handles hashing and serialization, while the MCU validates input, generates the password using a KDF, and types it directly via USB keyboard emulation.

+--------------------------+     Protobuf over USB     +------------------+
|     Chrome Extension     |  <--------------------->  | TurtlPass Device |
|--------------------------|                           |------------------|
| Hash(Argon2ID + SHA-512) |    Serialized Commands:   |     Generate     |
|            of            |   → genPassword(hash) →   |     Password     |
| Domain + AccountID + PIN |    ← isSuccess(bool) ←    |      (KDF)       |
+--------------------------+                           +------------------+
             |                                                   |
             └──────────< Types password via HID keyboard <──────┘

---

📦 Installation

1. Download and unzip this repository
2. Go to Chrome Extensions: chrome://extensions
3. Enable Developer mode
4. Click Load Unpacked → select the unzipped folder
5. Done! 🚀

---

🚀 Usage

1. Open a login page (e.g., GitHub Login)
2. Click the TurtlPass icon — the domain auto-fills
3. Enter your Account ID (auto-saved next time)
4. Click Get Password and enter your 6-digit PIN
5. Choose your TurtlPass device → click Connect
6. Press the device button — it types your password securely in the focused input field

---

🌐 Supported Browsers

Browser	Status
Google Chrome	✅ Supported
Gener8	✅ Supported

Not supported: Firefox, Brave, Opera, Safari, Arc

---

🧰 Troubleshooting

If the extension cannot connect to the device:

chrome://flags/#enable-experimental-web-platform-features

Enable the Web Serial API feature.

---

📚 Dependencies

• Web Serial API – USB device communication
• Protocol Buffers – Message serialization
• Argon2 Browser – Password hashing
• SHA-512 JS – Entropy mixing
• Lottie Web – Animations
• Material Components for Web – UI styling

---

📜 License

This repository is licensed under the MIT License.