keepassxc-fzf

Интерактивный терминальный интерфейс для управления базами данных KeePass с помощью keepassxc-cli и fzf.

Возможности

• Интерактивный поиск записей с нечётким поиском (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 [ОПЦИИ] [database.kdbx]

Опции:
    -h, --help          Показать справку
    -k, --keyfile FILE  Использовать файл ключа

Переменные окружения:
    KPDB    Путь к базе данных KeePass
    KPKF    Путь к файлу ключа

Приоритет (от высшего к низшему):
    1. Аргументы командной строки (-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	Показать пароль на экране
Ввод	Скопировать пароль и выйти
ESC	Выйти

Стандартная навигация fzf также работает (Ctrl+J/Ctrl+K, стрелки, ввод текста для поиска).

Безопасность

• Буфер обмена автоматически очищается по истечении времени
• Ввод пароля всегда интерактивный — никогда не читается из переменных окружения
• Предварительный просмотр скрывает пароли с помощью *****
• Мастер-пароль передаётся подпроцессам fzf через временный файл с правами chmod 600, а не через переменные окружения, поэтому он не виден в /proc/<pid>/environ
• Временный файл с паролем удаляется при выходе с помощью trap

Устранение неполадок

keepassxc-cli не найден: Установите KeePassXC (sudo apt install keepassxc)

fzf не найден: Установите fzf (sudo apt install fzf)

Буфер обмена не работает: Установите xclip (sudo apt install xclip) или wl-clipboard для Wayland

База данных не открывается: Проверьте пароль, путь к файлу и путь к файлу ключа (если используется)

Лицензия

MIT