AspansQulyp/README.md
deni.reyton 57a62778c1
Some checks failed
CI / linux (push) Failing after 35s
CI / windows (push) Has been cancelled
README: исправлен раздел «Установка»
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 15:46:04 +05:00

75 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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).