
fzf를 사용하여 KeePassXC 데이터베이스 항목을 대화형으로 검색하고 액세스할 수 있는 경량 CLI 도구입니다. 빠르고, 안전하며, 터미널 중심입니다.
keepassxc-cli와 fzf를 사용하여 KeePass 데이터베이스를 관리하기 위한 대화형 터미널 인터페이스입니다.

keepassxc-cli - KeePassXC 명령줄 클라이언트fzf - 명령줄 퍼지 파인더bash - 유닉스 셸xclip (X11)wl-copy (Wayland)pbcopy (macOS)# 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
# 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
# Install to /usr/local/bin (requires sudo)
sudo make install
# Or install to ~/.local/bin
make install PREFIX=~/.local
sudo make uninstall
# Or: make uninstall PREFIX=~/.local
keepassxc-fzf [OPTIONS] [database.kdbx]
Options:
-h, --help 도움말 표시
-k, --keyfile FILE 키파일 사용
Environment variables:
KPDB KeePass 데이터베이스 경로
KPKF 키파일 경로
Precedence (highest to lowest):
1. CLI 인수 (-k, 데이터베이스 경로)
2. 환경 변수 (KPDB, KPKF)
참고: KPKF는 데이터베이스도 KPDB에서 가져올 때만 환경에서 상속됩니다.
CLI에서 데이터베이스 경로를 전달하면, 서로 다른 데이터베이스의 자격 증명이 섞이는 것을 방지하기 위해 환경 변수 자격 증명은 무시됩니다.
마스터 비밀번호는 항상 대화형으로 입력되며 환경에서 읽지 않습니다.
# 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
표준 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
| 키 | 동작 |
|---|
Ctrl+P | 비밀번호 복사 (10초 후 삭제) |
Ctrl+U | 사용자명 복사 (30초 후 삭제) |
Ctrl+L | URL 복사 (30초 후 삭제) |
Ctrl+N | 메모 복사 (30초 후 삭제) |
Alt+S | 화면에 비밀번호 표시 |
Enter | 비밀번호 복사 후 종료 |
ESC | 종료 |