keepassxc-fzf

Interaktive Terminal-Oberfläche zur Verwaltung von KeePass-Datenbanken mit keepassxc-cli und fzf.

Funktionen

• Interaktive Eintragssuche mit Fuzzy-Finder (fzf)
• Echtzeit-Eintragsvorschau (Passwort maskiert)
• In die Zwischenablage kopieren mit automatischem Löschen:
  • Passwort (10 Sekunden)
  • Benutzername, URL, Notizen (30 Sekunden)
• Unterstützung für Schlüsseldateien
• Konfiguration über Umgebungsvariablen
• Plattformübergreifende Zwischenablage-Unterstützung (xclip, wl-copy, pbcopy)

Voraussetzungen

Erforderlich

• keepassxc-cli - KeePassXC-Befehlszeilenclient
• fzf - Befehlszeilen-Fuzzy-Finder
• bash - Unix-Shell

Optional (Zwischenablage)

• xclip (X11)
• wl-copy (Wayland)
• pbcopy (macOS)

Installation

Schnellinstallation (empfohlen)

# Install to /usr/local/bin (requires sudo)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | sudo bash

# Or install to ~/.local/bin (no sudo required)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | PREFIX=~/.local bash

Abhängigkeiten

# Debian/Ubuntu
sudo apt install keepassxc fzf xclip

# Arch Linux
sudo pacman -S keepassxc fzf xclip

# Fedora
sudo dnf install keepassxc fzf xclip

# macOS
brew install keepassxc fzf

Manuelle Installation (aus dem Quellcode)

git clone https://github.com/creusvictor/keepassxc-fzf.git
cd keepassxc-fzf

# Install to /usr/local/bin (requires sudo)
sudo make install

# Or install to ~/.local/bin
make install PREFIX=~/.local

Deinstallation

sudo make uninstall
# Or: make uninstall PREFIX=~/.local

Verwendung

keepassxc-fzf [OPTIONS] [database.kdbx]

Options:
    -h, --help          Hilfe anzeigen
    -k, --keyfile FILE  Schlüsseldatei verwenden

Environment variables:
    KPDB    Pfad zur KeePass-Datenbank
    KPKF    Pfad zur Schlüsseldatei

Priorität (höchste zu niedrigste):
    1. Befehlszeilenargumente (-k, Datenbankpfad)
    2. Umgebungsvariablen (KPDB, KPKF)

Hinweis: KPKF wird nur aus der Umgebung übernommen, wenn die Datenbank
auch von KPDB stammt. Wenn Sie einen Datenbankpfad über die Befehlszeile
übergeben, werden die Umgebungsanmeldeinformationen ignoriert, um eine
Vermischung von Anmeldeinformationen verschiedener Datenbanken zu vermeiden.
Das Master-Passwort wird immer interaktiv eingegeben und niemals aus der
Umgebung gelesen.

Beispiele

# Basic usage
keepassxc-fzf ~/passwords.kdbx

# With keyfile
keepassxc-fzf -k ~/key.key ~/passwords.kdbx

# Using environment variables
export KPDB="$HOME/passwords.kdbx"
export KPKF="$HOME/key.key"
keepassxc-fzf

Tastenkombinationen

Standard-fzf-Navigation funktioniert ebenfalls (Ctrl+J/Ctrl+K, Pfeiltasten, Eingabe zum Suchen).

Sicherheit

• Zwischenablage wird nach Zeitüberschreitung automatisch gelöscht
• Passworteingabe erfolgt immer interaktiv – wird niemals aus Umgebungsvariablen gelesen
• Vorschau maskiert Passwörter mit *****
• Das Master-Passwort wird an fzf-Unterprozesse über eine temporäre Datei mit chmod 600 übergeben, nicht über Umgebungsvariablen, damit es nicht in /proc/<pid>/environ sichtbar ist
• Die temporäre Passwortdatei wird beim Beenden über ein trap gelöscht

Fehlerbehebung

keepassxc-cli nicht gefunden: KeePassXC installieren (sudo apt install keepassxc)

fzf nicht gefunden: fzf installieren (sudo apt install fzf)

Zwischenablage funktioniert nicht: xclip installieren (sudo apt install xclip) oder wl-clipboard für Wayland

Datenbank lässt sich nicht öffnen: Passwort, Dateipfad und ggf. Schlüsseldateipfad überprüfen

Lizenz

MIT