https://github.com/beastcodz/winkey

WinKey is a lightweight Electron app that generates TOTP codes for two-factor authentication. It’s clean, simple, and designed to keep your accounts secure without fuss.
https://github.com/beastcodz/winkey

Last synced: 5 months ago
JSON representation

WinKey is a lightweight Electron app that generates TOTP codes for two-factor authentication. It’s clean, simple, and designed to keep your accounts secure without fuss.

• Host: GitHub
• URL: https://github.com/beastcodz/winkey
• Owner: BeastCodZ
• Created: 2025-05-20T22:21:36.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-06-21T03:35:23.000Z (8 months ago)
• Last Synced: 2025-07-13T08:17:03.349Z (7 months ago)
• Language: JavaScript
• Homepage:
• Size: 151 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# WinKey



> **Your slick, no-nonsense Electron 2FA Authenticator —**  

> *because security shouldn’t be ugly or complicated.*

---

## What is WinKey?

WinKey is an Electron-based Two-Factor Authentication (2FA) app designed to provide a clean, aesthetic, and easy-to-use experience for generating Time-based One-Time Passwords (TOTP). This lightweight desktop authenticator simplifies the process of securing your online accounts with an elegant interface and reliable token generation.

---

## ✨ What’s New in v2

  - **✅ Google Drive Sync** — backup & restore your secrets with a click.

  - **✅ Improved UI** — more aesthetic, smoother interaction.

  - **✅ Basic backup system** — local and remote backups before overwriting.

  - **⚙️ Clean multi-user codebase (experimental)** — prepping for multiple accounts.

## 🚧 Roadmap / Coming Soon

- 🔐 Encryption for stored secrets — so your secrets.json is useless to thieves.

- 🔑 bcrypt — hashed local passwords to guard your local database.

- 🧩 GitHub login option — log in with your GitHub account.

- 👥 Fully-fledged multi-account login — switch between different cloud accounts seamlessly.

---

## Peek the goods

![Login Screen](https://github.com/user-attachments/assets/3cb387f6-6f02-4699-960a-ce88b66f8560)

![Dashboard](https://github.com/user-attachments/assets/fcd9e253-7e69-44fc-8136-22842d162beb)

![Add Code Screen](https://github.com/user-attachments/assets/7c69616c-daa7-423b-b8ce-62765bc731c3)

![Sync Menu](https://github.com/user-attachments/assets/881e051a-a088-4177-b4a0-eb93c309504c)

## ⚡ Features that matters

- RFC 6238 TOTP generation — trusted, time-based codes.

- Simple Electron Builder setup — clone, build, run.

- Google Drive Integration — secure cloud backup in your own cloud we manual backups.

---

## Heads-up: Known issues

- **No encryption on stored secrets.**  

  Handle your `secrets.json` like it’s gold. If someone gets it, they get your keys.  

  Find your secrets.json here:  

  `C:\Users\[Your Username]\AppData\Roaming\winkey`

- **No auto backups.**  

  Make sure to sync manually for now. Automatic backup in V3.

---

## Tech stack & toolkit

- **Electron** v32 — power your desktop app with web tech  

- **bcrypt** — hashed passwords (To be implemented soon)  

- **otplib** — TOTP engine  

- **qrcode** — instant QR code generation (To be implemented soon)

---

## License

ISC License © BeastCodZ

---

## Disclaimer

*WinKey is a personal project and comes as-is. Don’t trust it blindly with your crown jewels. — I’m not your IT department.*

---

> **Lock down your accounts with taste. Use WinKey.**