PassForge

Android autofill provider for KeePass databases. Supports both .kdbx and .csv formats with Credential Manager and Autofill Service integration.

Features

• Read .kdbx (KeePass) databases with master password
• Read .csv exports from KeePass and other password managers
• Android Credential Manager provider (Android 14+)
• Autofill Service for app and browser compatibility
• Minimal dark UI
• Targets Android 16 (API 36), compatible with GrapheneOS

Setup

1. Install the app
2. Open PassForge and select your .kdbx or .csv file
3. For .kdbx: enter master password to unlock
4. Enable PassForge as a provider (one or both):

Enable Credential Manager (Android 14+)

1. Open Android Settings
2. Go to Passwords & accounts (or "Passwords & autofill")
3. Tap Passwords or Credential providers
4. Enable PassForge

Enable Autofill Service (broader app support)

1. Open Android Settings
2. Go to System → Languages & input → Autofill service
   • Or: Settings → Passwords & autofill → Autofill service
3. Select PassForge

Enable Display Over Other Apps

PassForge needs the "Display over other apps" permission to show autofill suggestion popups above other apps. On first launch, PassForge will automatically prompt you to grant this permission.

If you skipped it:

1. Open Android Settings
2. Go to Apps → PassForge → Display over other apps
3. Toggle Allow

Without this permission, the autofill popup may not appear when you tap into login fields.

Browser Setup (Brave, Chrome, Firefox)

After enabling PassForge as a provider:

1. Brave (required setting change):
   • Open Brave Settings → Passwords and autofill
   • Set Brave to use the other/system autofill service (not Brave's built-in password manager)
   • On login pages, tap and hold the email/username field, then tap Autofill to open PassForge suggestions
2. Chrome: Navigate to a login page → tap username/password field → PassForge suggestions appear above keyboard
3. Firefox: May require enabling autofill in Firefox settings: Menu → Settings → Logins and passwords → Autofill
4. If no suggestions appear, ensure the database is unlocked in PassForge app first

Troubleshooting:

• If credentials don't appear, open PassForge and verify "Unlocked X entries" is shown
• Some apps require Autofill Service; others work with Credential Manager only
• Try enabling both services for maximum compatibility

CSV Format

Supports standard KeePass CSV exports with headers:

Supported Headers
Title, Name, Account
Username, User, Login, Email
Password, Pass
URL, Website, Web Site, Login_URI
Notes, Comments
Group, Folder

Creating a CSV Password File

You can create a password CSV file using any spreadsheet application or text editor.

Option 1: Using a Spreadsheet (Excel, Google Sheets, LibreOffice)

1. Create a new spreadsheet with these column headers in row 1:

   Title | Username | Password | URL | Notes | Group
   

2. Add your passwords in subsequent rows
3. Export/Save As CSV format

Option 2: Using a Text Editor

Create a file with .csv extension:

"Title","Username","Password","URL","Notes","Group"
"GitHub","johndoe","MyP@ssword123","https://github.com/login","Work account","Development"
"Gmail","john@gmail.com","GmailPass!","https://mail.google.com","Personal","Email"

Option 3: Export from Other Password Managers

• KeePass/KeePassXC: File > Export > CSV
• Bitwarden: Tools > Export Vault > CSV
• 1Password: File > Export > CSV
• LastPass: Account Options > Advanced > Export

Sample CSV

See sample.csv in this repository for a working example:

"Title","Username","Password","URL","Notes","Group"
"GitHub","johndoe","MyS3cur3P@ss!","https://github.com/login","Personal account","Development"
"Gmail","john.doe@gmail.com","Gm@ilP@ssw0rd","https://mail.google.com","Main email","Email"

Important Notes:

• CSV files can have headers in row 1, or start directly with data
• If no headers: columns must be in order: Title, Username, Password, URL, Notes, Group
• Use quotes around fields containing commas or special characters
• CSV files are not encrypted - store securely and consider deleting after use

License

MIT