Joe Julian
76 lines
1.5 KiB
Markdown
76 lines
1.5 KiB
Markdown
# KeePassGO
|
|
|
|
KeePassGO is a Go-based KeePass-compatible password manager targeting desktop first, with future Android support.
|
|
|
|
## Current Capabilities
|
|
|
|
- KDBX load and save
|
|
- password-only, key-file-only, and composite master-key flows through the desktop product UI
|
|
- master-key changes for existing vault sessions
|
|
- WebDAV-backed open and save support in the session layer
|
|
- password generation profiles
|
|
- gRPC integration surface for trusted automation
|
|
- template, attachment, group, history, and recycle-bin persistence
|
|
|
|
## Run
|
|
|
|
```bash
|
|
go run .
|
|
```
|
|
|
|
Phone-sized preview:
|
|
|
|
```bash
|
|
go run . -mode phone
|
|
```
|
|
|
|
## Test
|
|
|
|
```bash
|
|
go test ./...
|
|
go tool golangci-lint run ./...
|
|
```
|
|
|
|
KDBX security and KDF compatibility notes are documented in [`docs/kdbx-compatibility.md`](./docs/kdbx-compatibility.md).
|
|
|
|
## Build
|
|
|
|
Desktop build:
|
|
|
|
```bash
|
|
go build ./...
|
|
```
|
|
|
|
## Android Packaging
|
|
|
|
KeePassGO uses Gio, so Android packaging is done with `gogio`.
|
|
|
|
The repo now has automated tests for the packaging contract:
|
|
- default APK build arguments
|
|
- required Android SDK / NDK / JDK layout checks
|
|
|
|
Those are covered by normal test runs:
|
|
|
|
```bash
|
|
go test ./...
|
|
```
|
|
|
|
Install:
|
|
|
|
```bash
|
|
go install gioui.org/cmd/gogio@latest
|
|
```
|
|
|
|
Package:
|
|
|
|
```bash
|
|
gogio -target android .
|
|
```
|
|
|
|
You will need the Android SDK and NDK installed and configured for real device or release packaging.
|
|
|
|
## Automation
|
|
|
|
Desktop automation is resolved through the secure gRPC API rather than synthetic auto-type.
|
|
See [`docs/desktop-automation.md`](./docs/desktop-automation.md).
|