keepassxc-fzf

Interface interactive en terminal pour gérer les bases de données KeePass avec keepassxc-cli et fzf.

Fonctionnalités

• Recherche interactive d'entrées avec le chercheur flou (fzf)
• Aperçu en temps réel des entrées (mot de passe masqué)
• Copie dans le presse-papiers avec effacement automatique :
  • Mot de passe (10 secondes)
  • Nom d'utilisateur, URL, Notes (30 secondes)
• Prise en charge des fichiers de clé
• Configuration via variables d'environnement
• Support multi-plateforme du presse-papiers (xclip, wl-copy, pbcopy)

Prérequis

Obligatoires

• keepassxc-cli - Client en ligne de commande KeePassXC
• fzf - Chercheur flou en ligne de commande
• bash - Shell Unix

Optionnel (presse-papiers)

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

Installation

Installation rapide (recommandée)

# Installer dans /usr/local/bin (nécessite sudo)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | sudo bash

# Ou installer dans ~/.local/bin (pas besoin de sudo)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | PREFIX=~/.local bash

Dépendances

# 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

Installation manuelle (à partir des sources)

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

# Installer dans /usr/local/bin (nécessite sudo)
sudo make install

# Ou installer dans ~/.local/bin
make install PREFIX=~/.local

Désinstallation

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

Utilisation

keepassxc-fzf [OPTIONS] [database.kdbx]

Options :
    -h, --help          Afficher l'aide
    -k, --keyfile FILE  Utiliser un fichier de clé

Variables d'environnement :
    KPDB    Chemin vers la base de données KeePass
    KPKF    Chemin vers le fichier de clé

Ordre de priorité (du plus élevé au plus bas) :
    1. Arguments CLI (-k, chemin de la base de données)
    2. Variables d'environnement (KPDB, KPKF)

Remarque : KPKF n'est hérité de l'environnement que lorsque la base de données
provient également de KPDB. Si vous passez un chemin de base de données en CLI,
les informations d'identification de l'environnement sont ignorées pour éviter
de mélanger des identifiants de différentes bases de données.
Le mot de passe maître est toujours saisi interactivement et n'est jamais lu
depuis l'environnement.

Exemples

# Utilisation de base
keepassxc-fzf ~/passwords.kdbx

# Avec fichier de clé
keepassxc-fzf -k ~/key.key ~/passwords.kdbx

# Utilisation de variables d'environnement
export KPDB="$HOME/passwords.kdbx"
export KPKF="$HOME/key.key"
keepassxc-fzf

Raccourcis clavier

Touche	Action
Ctrl+P	Copier le mot de passe (effacement après 10s)
Ctrl+U	Copier le nom d'utilisateur (effacement après 30s)
Ctrl+L	Copier l'URL (effacement après 30s)
Ctrl+N	Copier les notes (effacement après 30s)
Alt+S	Afficher le mot de passe à l'écran
Enter	Copier le mot de passe et quitter
Échap	Quitter

La navigation standard de fzf fonctionne également (Ctrl+J/Ctrl+K, flèches, taper pour rechercher).

Sécurité

• Le presse-papiers s'efface automatiquement après le délai imparti
• La saisie du mot de passe est toujours interactive — jamais lue depuis les variables d'environnement
• L'aperçu masque les mots de passe avec *****
• Le mot de passe maître est transmis aux sous-processus fzf via un fichier temporaire avec chmod 600, et non via les variables d'environnement, donc il n'est pas visible dans /proc/<pid>/environ
• Le fichier temporaire du mot de passe est supprimé à la sortie via un trap

Dépannage

keepassxc-cli introuvable : Installez KeePassXC (sudo apt install keepassxc)

fzf introuvable : Installez fzf (sudo apt install fzf)

Le presse-papiers ne fonctionne pas : Installez xclip (sudo apt install xclip) ou wl-clipboard pour Wayland

La base de données ne s'ouvre pas : Vérifiez le mot de passe, le chemin du fichier et le chemin du fichier de clé si utilisé

Licence

MIT