CipherAuth 🔐

CipherAuth is a secure, cross-platform TOTP (Time-based One-Time Password) authenticator applications designed for simplicity and security. Built with Python and a modern UI powered by CustomTkinter, it provides a safe vault for your two-factor authentication tokens.

🚀 Available on Microsoft Store

CipherAuth is officially available for Windows via the Microsoft Store. Get it here: Get CipherAuth on Microsoft Store

✨ Features

• Encrypted Storage: All your credentials are encrypted with AES-256.
• Modern UI: Clean, dark-themed interface using CustomTkinter.
• Search: Quickly find your accounts with the built-in search bar.
• QR Code Support: View and scan QR codes for easy setup.
• Export/Import: Easily backup and restore your credentials.
• Password Protected: Secured by a master password to prevent unauthorized access.
• Sync: Sync your credentials securely to another device.

🛠️ Development & Compilation

CipherAuth is ready to be compiled for any operating system (Windows, macOS, Linux) without any additional code changes.

Running from Source

1. Clone the repository.

2. Install dependencies:

   pip install -r requirements.txt

   Note for Windows users: PyInstaller packages are commented out in requirements.txt. If you're on Windows and planning to build an executable, uncomment the Windows-specific packages in requirements.txt before installing:

   altgraph==0.17.4
   pefile==2023.2.7
   pyinstaller==6.15.0
   pyinstaller-hooks-contrib==2025.8
   pywin32-ctypes==0.2.3
   

3. Run the application:

   python app/main.py

Compiling with PyInstaller

The project includes a CipherAuth.spec file, making it easy to create a standalone executable for your current OS.

1. Install PyInstaller:

   pip install pyinstaller

2. Build the executable:

   pyinstaller CipherAuth.spec

3. The compiled application will be available in the dist/ folder.

❓ FAQ

How do I add a new account?

Click on the "➕ Add Creds" button in the footer and fill in the account details.

How do I back up my tokens?

Use the "📥 Download" button to export a decrypted version of your credentials. Keep this file safe!

Can I use this on Mac or Linux?

Yes! Since it is written in Python, you can run it from source or compile it using PyInstaller on your respective operating system. For mobile platforms like Linux iOS and Android, CipherAuth-Flutter

Is my data synced to the cloud?

No. CipherAuth is designed to be fully offline for maximum privacy. Your data stays on your device. However, you can sync your credentials across multiple devices on the same network using the built-in Sync feature (🔃). Devices must have the same master password encryption key to synchronize securely.

⚠️ Important Note

Disclaimer: CipherAuth uses high-level encryption secured by your Master Password. If you forget your Master Password, we cannot recover your data. There are no "backdoors" or password recovery options for your security. Please ensure you keep your password in a safe place.

---

Developed with ❤️ using Python and CustomTkinter.