Keyden

A clean and elegant macOS menu bar TOTP authenticator

English · 中文

✨ Features

📦 Installation

Homebrew (Recommended)

brew install --cask tasselx/tap/keyden

Manual Download

Download the latest DMG from Releases

⚠️ FAQ

Screen Recording Permission Issue

Since the app is not signed with a paid Apple Developer account, macOS may not properly recognize the screen recording permission after installing a new version.

Solution:

1. Open "System Settings" → "Privacy & Security" → "Screen Recording"
2. Find Keyden and click "-" to remove the authorization
3. Reopen Keyden, the system will request permission again
4. Click "+" to add Keyden and grant permission

Keychain Access Prompt

After installing a new version, macOS may prompt you to authorize Keychain access. This is normal because the app signature changes with each update.

Solution:

Simply click "Always Allow" or "Allow" when prompted. Your TOTP secrets are stored securely in the macOS Keychain and will remain intact after the update.

"Keyden is damaged and can't be opened" Error

Since the app is not notarized by Apple, macOS Gatekeeper may block it and show a "damaged" error message.

Solution:

Open Terminal and run:

xattr -cr /Applications/Keyden.app

This removes the quarantine attribute and allows the app to run normally.

🚀 Usage

1. Launch Keyden - icon appears in menu bar
2. Click "+" to add TOTP accounts (scan QR or enter manually)
3. Click any code to copy to clipboard
4. Right-click for more options (pin, delete, export QR)

Command Line Interface (CLI)

Keyden includes a CLI tool for scripts and automation.

Installation:

• One-Click Install: Right-click any account → "Copy CLI Command" → prompted to install if not found
• From Settings: Settings → General → CLI Tool → Install
• Manual: The CLI is bundled inside the app at Keyden.app/Contents/Resources/CLI/keyden

# Usage
keyden get GitHub                    # Get TOTP code for GitHub
keyden get GitHub:user@example.com   # Specific account (issuer:account format)
keyden get GitHub user@example.com   # Same as above (space separated)
keyden list                          # List all accounts with codes
keyden search google                 # Search accounts
keyden help                          # Show help

# Use in scripts
CODE=$(keyden get GitHub)
echo "Your code is: $CODE"

# Auto-fill example (copy to clipboard)
keyden get GitHub | pbcopy

💡 Tip: When you have multiple accounts under the same issuer (e.g., multiple GitHub accounts), use the issuer:account format to specify which one.

GitHub Gist Sync

1. Go to Settings → Sync
2. Create a GitHub Personal Access Token with gist scope
3. Enter your token and enable sync
4. Your tokens will be synced to a private Gist

🔗 Quick Start - Enable 2FA on Popular Platforms

💡 Tip: For platforms not listed, 2FA settings are typically found in Account Settings → Security or Privacy & Security.

🛠 Build from Source

Requirements: macOS 12.0+ / Xcode 15.0+

git clone https://github.com/tasselx/Keyden.git
cd Keyden

make build      # Build universal app
make dmg        # Create DMG installer
make clean      # Clean build artifacts

make build-arm      # Apple Silicon only
make build-intel    # Intel only
make build-all      # Universal

🧰 Tech Stack

• SwiftUI + AppKit - Native macOS UI
• CryptoKit - TOTP generation
• Keychain Services - Secure storage
• Vision Framework - QR code scanning

☕ Donate

If you find Keyden helpful, consider buying me a coffee ☕

Your sponsorship can help me purchase an Apple Developer account, which will allow the app to be properly signed and notarized — no more "damaged" warnings!

🎯 Also by Author

⭐ Star History

_{MIT License © tasselx}