keepassxc-fzf

Interface de terminal interativa para gerenciar bancos de dados KeePass usando keepassxc-cli e fzf.

Funcionalidades

• Pesquisa interativa de entradas com fuzzy finder (fzf)
• Pré-visualização de entradas em tempo real (senha oculta)
• Copiar para área de transferência com limpeza automática:
  • Senha (10 segundos)
  • Nome de usuário, URL, Notas (30 segundos)
• Suporte a arquivo de chave
• Configuração via variáveis de ambiente
• Suporte de área de transferência multi-plataforma (xclip, wl-copy, pbcopy)

Requisitos

Obrigatórios

• keepassxc-cli - Cliente de linha de comando do KeePassXC
• fzf - Fuzzy finder de linha de comando
• bash - Shell Unix

Opcionais (área de transferência)

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

Instalação

Instalação rápida (recomendada)

# 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

Dependências

# 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

Instalação manual (a partir do código fonte)

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

Desinstalação

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

Uso

keepassxc-fzf [OPTIONS] [database.kdbx]

Options:
    -h, --help          Mostrar ajuda
    -k, --keyfile FILE  Usar arquivo de chave

Environment variables:
    KPDB    Caminho para o banco de dados KeePass
    KPKF    Caminho para o arquivo de chave

Precedence (highest to lowest):
    1. Argumentos de CLI (-k, caminho do banco de dados)
    2. Variáveis de ambiente (KPDB, KPKF)

Note: KPKF é herdado do ambiente apenas quando o banco de dados também vem de KPDB. Se você passar um caminho de banco de dados na CLI, as credenciais do ambiente são ignoradas para evitar misturar credenciais de diferentes bancos de dados. A senha mestra é sempre inserida interativamente e nunca é lida do ambiente.

Exemplos

# 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

Atalhos de teclado

Tecla	Ação
Ctrl+P	Copiar senha (limpa em 10s)
Ctrl+U	Copiar nome de usuário (limpa em 30s)
Ctrl+L	Copiar URL (limpa em 30s)
Ctrl+N	Copiar notas (limpa em 30s)
Alt+S	Mostrar senha na tela
Enter	Copiar senha e sair
ESC	Sair

Navegação padrão do fzf também funciona (Ctrl+J/Ctrl+K, setas, digitar para pesquisar).

Segurança

• Área de transferência limpa automaticamente após tempo limite
• A entrada de senha é sempre interativa — nunca lida de variáveis de ambiente
• A pré-visualização mascara senhas com *****
• A senha mestra é passada para subprocessos do fzf através de um arquivo temporário chmod 600, não via variáveis de ambiente, então não fica visível em /proc/<pid>/environ
• O arquivo temporário de senha é excluído ao sair via um trap

Solução de problemas

keepassxc-cli não encontrado: Instale o KeePassXC (sudo apt install keepassxc)

fzf não encontrado: Instale o fzf (sudo apt install fzf)

Área de transferência não funcionando: Instale o xclip (sudo apt install xclip) ou wl-clipboard para Wayland

Banco de dados não abre: Verifique a senha, o caminho do arquivo e o caminho do arquivo de chave, se usado

Licença

MIT