keepassxc-fzf

Interfaccia terminale interattiva per la gestione di database KeePass utilizzando keepassxc-cli e fzf.

Funzionalità

• Ricerca interattiva delle voci con fuzzy finder (fzf)
• Anteprima in tempo reale delle voci (password mascherata)
• Copia negli appunti con cancellazione automatica:
  • Password (10 secondi)
  • Nome utente, URL, Note (30 secondi)
• Supporto per file chiave
• Configurazione tramite variabili d'ambiente
• Supporto per appunti su più piattaforme (xclip, wl-copy, pbcopy)

Requisiti

Obbligatori

• keepassxc-cli - Client da riga di comando di KeePassXC
• fzf - Fuzzy finder da riga di comando
• bash - Shell Unix

Opzionali (appunti)

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

Installazione

Installazione rapida (consigliata)

# 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

Dipendenze

# 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

Installazione manuale (da sorgente)

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

Disinstallazione

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

Utilizzo

keepassxc-fzf [OPTIONS] [database.kdbx]

Opzioni:
    -h, --help          Mostra aiuto
    -k, --keyfile FILE  Usa file chiave

Variabili d'ambiente:
    KPDB    Percorso del database KeePass
    KPKF    Percorso del file chiave

Precedenza (dalla più alta alla più bassa):
    1. Argomenti CLI (-k, percorso database)
    2. Variabili d'ambiente (KPDB, KPKF)

Nota: KPKF viene ereditato dall'ambiente solo quando il database proviene anch'esso da KPDB. Se si passa un percorso del database tramite CLI, le credenziali d'ambiente vengono ignorate per evitare di mescolare credenziali da database diversi. La password principale viene sempre inserita interattivamente e non viene mai letta dall'ambiente.

Esempi

# 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

Tasti di scelta rapida

Tasto	Azione
Ctrl+P	Copia password (cancella dopo 10s)
Ctrl+U	Copia nome utente (cancella dopo 30s)
Ctrl+L	Copia URL (cancella dopo 30s)
Ctrl+N	Copia note (cancella dopo 30s)
Alt+S	Mostra password a schermo
Invio	Copia password ed esci
ESC	Esci

Anche la navigazione standard di fzf funziona (Ctrl+J/Ctrl+K, frecce, digitare per cercare).

Sicurezza

• Gli appunti si cancellano automaticamente dopo il timeout
• L'inserimento della password è sempre interattivo — mai letto da variabili d'ambiente
• L'anteprima maschera le password con *****
• La password principale viene passata ai sottoprocessi fzf tramite un file temporaneo con chmod 600, non tramite variabili d'ambiente, quindi non è visibile in /proc/<pid>/environ
• Il file temporaneo della password viene eliminato all'uscita tramite un trap

Risoluzione dei problemi

keepassxc-cli non trovato: Installa KeePassXC (sudo apt install keepassxc)

fzf non trovato: Installa fzf (sudo apt install fzf)

Appunti non funzionanti: Installa xclip (sudo apt install xclip) o wl-clipboard per Wayland

Il database non si apre: Verifica password, percorso del file e percorso del file chiave se usato

Licenza

MIT