Skip to content

drmakerr/DrPasswords

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Dr. Passwords 🔐

A physical open-source password manager built with ESP32-S3


🎬 Watch the video

Watch the video


🚀 Features

  • 🔐 Store passwords locally (no cloud)
  • ⌨️ Type passwords automatically (HID keyboard emulation)
  • 👤 Username / Password / Username+TAB+Password modes
  • 🔢 Built-in TOTP (2FA) generator
  • 📟 On-device UI (screen + buttons)
  • ⚙️ Settings page (add / edit / delete passwords)
  • 🔑 Generate strong random passwords
  • 🌐 Wi-Fi assisted time sync for TOTP

🧠 Concept

This project is inspired by hardware crypto wallets.

Instead of trusting cloud services, your passwords are stored in a physical device that you control.


🛠️ Hardware

Main board

  • ESP32-S3 (recommended)

Optional parts

  • RTC module (for offline time keeping)
  • Compact USB adapter (for flash-drive style form factor)

🔗 Components & Links

Component Link
LILYGO ESP32-S3 Buy here
RTC Module Buy here
USB-C to USB-C Adapter Buy here
USB-C to USB-A Adapter Buy here

💡 Some links may be affiliate links that help support the project.


⚡ How it works

🔐 Password Mode

  • Select account
  • Device types:
    • username
    • password
    • both automatically

🔢 TOTP Mode

  • Generates 2FA codes (like Google Authenticator)
  • Works based on time + secret key
  • Can auto-type the code via USB

⚙️ Settings Mode

  • Connect to device Wi-Fi
  • Open local page
  • Add / edit / delete accounts
  • Generate passwords

📦 Status

Version 1 (Prototype)

More features coming soon 👇


🔮 Roadmap

  • Bluetooth HID support
  • Encrypted storage
  • Backup & restore
  • Fingerprint / local unlock
  • Better UI/UX
  • Hardware improvements

⚠️ Important Notice

This project is for educational and personal use only.

❌ Selling this project is NOT allowed
❌ Commercial use is NOT allowed

✅ Only the original creator (Dr. Maker) has the right to commercialize this project.


❤️ Support the project

If you like this project and want to support its development:

Support me


🤝 Contributing

This is an open-source project — let’s build it together!

You can help by:

  • improving the code
  • suggesting features
  • improving UI/UX
  • enhancing security
  • testing on different devices

👨‍💻 Author

Dr. Maker


📄 License

This project uses a custom non-commercial license.
Commercial use and selling are not allowed.

See the LICENSE file for details.

About

Open-source physical password manager built with ESP32-S3 with HID typing and TOTP support.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages