# Qulyp

Локальный менеджер паролей для Windows и Linux — простая альтернатива KeePass.
Все данные лежат в одном зашифрованном файле `.qulyp`, работает без интернета и без серверов.

## Возможности
- **Шифрование:** ключ из мастер-пароля через Argon2id (64 МиБ, 3 прохода), данные — XChaCha20-Poly1305
- **Записи:** логин, пароль, сайт, коды 2FA (TOTP), заметки, папки, избранное, история паролей
- **Генератор паролей** и индикатор стойкости
- **Буфер обмена** очищается сам через 20 с (на Windows пароль не попадает в журнал Win+V)
- **Автоблокировка** при бездействии и (по желанию) при сворачивании окна
- **Синхронизация** между устройствами через любую облачную папку
- Тёмная и светлая тема, горячие клавиши

## Синхронизация
Положите файл хранилища в папку Dropbox, OneDrive, Google Drive, Syncthing или Nextcloud.
Qulyp каждые 2 секунды проверяет, не изменился ли файл, и **сливает** изменения, а не затирает их:
для каждой записи побеждает более свежая версия, старый пароль попадает в историю, удаления тоже синхронизируются.

Кнопка 🔄 вручную объединяет с любым другим файлом `.qulyp` — например, с копией на флешке
или с конфликтной копией, которую создало облако.

## Горячие клавиши
| | |
|---|---|
| `Ctrl+F` | поиск |
| `Ctrl+N` | новая запись |
| `Ctrl+C` / двойной клик | копировать пароль |
| `Ctrl+B` | копировать логин |
| `Ctrl+G` | генератор паролей |
| `Ctrl+L` | заблокировать |
| `↑` `↓`, `Del`, `Esc` | навигация, удаление, отмена |

## Установка
Windows — без прав администратора: exe копируется в `%LOCALAPPDATA%\Programs\Qulyp`, ярлык появляется в «Пуске»
и находится поиском по слову «Qulyp».

```bash
powershell -ExecutionPolicy Bypass -File scripts/install-windows.ps1
```

Флаги: `-Desktop` — ещё ярлык на рабочем столе, `-Uninstall` — удалить.

Linux — бинарник в `~/.local/bin`, пункт в меню приложений:

```bash
sh scripts/install-linux.sh
```

Удаление — `--uninstall`. Файлы хранилищ при удалении не трогаются. Для обновления запустите скрипт ещё раз.

## Сборка вручную
Нужен Rust 1.85+ (<https://rustup.rs>).

```bash
cargo build --release
```

Готовый файл: `target/release/qulyp.exe` (Windows) или `target/release/qulyp` (Linux).

Для Linux (Debian/Ubuntu) нужны пакеты:

```bash
sudo apt install libxkbcommon-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libgl1-mesa-dev
```

Тесты: `cargo test`.

## Важно
Мастер-пароль **нельзя восстановить**. Без него данные не расшифровать — ни вам, ни кому-либо ещё.
Делайте резервные копии файла: рядом с ним Qulyp хранит прошлую версию `*.qulyp.bak`.

## Для разработчиков
Состояние проекта, планы и хвосты — в [`notes/`](notes/), правила ведения — в [`CLAUDE.md`](CLAUDE.md).