keepassxc-fzf

keepassxc-cli と fzf を使った KeePass データベース管理のための対話型ターミナルインターフェース。

特徴

• ファジーファインダー (fzf) による対話型エントリ検索
• リアルタイムエントリプレビュー (パスワードはマスク表示)
• クリップボードにコピーし、自動消去:
  • パスワード (10 秒)
  • ユーザー名、URL、メモ (30 秒)
• キーファイル対応
• 環境変数による設定
• マルチプラットフォームのクリップボード対応 (xclip, wl-copy, pbcopy)

必要条件

必須

• keepassxc-cli - KeePassXC コマンドラインクライアント
• fzf - コマンドラインファジーファインダー
• bash - Unix シェル

オプション (クリップボード)

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

インストール

クイックインストール (推奨)

# /usr/local/bin にインストール (sudo が必要)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | sudo bash

# または ~/.local/bin にインストール (sudo 不要)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | PREFIX=~/.local bash

依存関係

# 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

手動インストール (ソースから)

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

# /usr/local/bin にインストール (sudo が必要)
sudo make install

# または ~/.local/bin にインストール
make install PREFIX=~/.local

アンインストール

sudo make uninstall
# または: make uninstall PREFIX=~/.local

使用方法

keepassxc-fzf [オプション] [データベース.kdbx]

オプション:
    -h, --help          ヘルプを表示
    -k, --keyfile FILE  キーファイルを使用

環境変数:
    KPDB    KeePass データベースへのパス
    KPKF    キーファイルへのパス

優先順位 (高い順):
    1. CLI 引数 (-k, データベースパス)
    2. 環境変数 (KPDB, KPKF)

注意: KPKF は、データベースも KPDB から取得された場合にのみ環境から継承されます。
CLI でデータベースパスを渡した場合、異なるデータベースの認証情報が混ざるのを防ぐため、環境変数の認証情報は無視されます。
マスターパスワードは常に対話的に入力され、環境変数から読み取られることはありません。

例

# 基本的な使い方
keepassxc-fzf ~/passwords.kdbx

# キーファイルを使用
keepassxc-fzf -k ~/key.key ~/passwords.kdbx

# 環境変数を使用
export KPDB="$HOME/passwords.kdbx"
export KPKF="$HOME/key.key"
keepassxc-fzf

キーバインド

キー	アクション
Ctrl+P	パスワードをコピー (10秒で消去)
Ctrl+U	ユーザー名をコピー (30秒で消去)
Ctrl+L	URL をコピー (30秒で消去)
Ctrl+N	メモをコピー (30秒で消去)
Alt+S	パスワードを画面に表示
Enter	パスワードをコピーして終了
ESC	終了

標準の fzf ナビゲーションも使用可能 (Ctrl+J/Ctrl+K、矢印キー、タイプ検索)。

セキュリティ

• タイムアウト後にクリップボードを自動消去
• パスワード入力は常に対話的 — 環境変数から読み取られることはありません
• プレビューではパスワードを ***** でマスク
• マスターパスワードは chmod 600 の一時ファイルを介して fzf サブプロセスに渡されるため、/proc/<pid>/environ には表示されません
• 一時パスワードファイルは trap により終了時に削除されます

トラブルシューティング

keepassxc-cli が見つからない: KeePassXC をインストールしてください (sudo apt install keepassxc)

fzf が見つからない: fzf をインストールしてください (sudo apt install fzf)

クリップボードが動作しない: xclip をインストールしてください (sudo apt install xclip)。または Wayland の場合は wl-clipboard をインストールしてください

データベースが開かない: パスワード、ファイルパス、および使用する場合はキーファイルパスを確認してください

ライセンス

MIT