AspansQulyp/README.md
deni.reyton 54c484300f
Some checks failed
CI / windows (push) Waiting to run
CI / linux (push) Has been cancelled
Установка: ярлык в «Пуске», .desktop для Linux, иконка в exe
- scripts/install-windows.ps1: exe в %LOCALAPPDATA%\Programs\Qulyp + ярлык (-Desktop, -Uninstall)
- scripts/install-linux.sh: ~/.local/bin + .desktop + SVG-иконка (--uninstall)
- build.rs вшивает иконку и описание в exe через winresource
- Растр иконки вынесен в src/icon_pixels.rs (общий для окна и build.rs)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 15:45:39 +05:00

72 lines
4.0 KiB
Markdown
Raw 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%Programsulyp\`\,\ ярлык\ в\ \«Пуске\»\)\:\
\
\`\`\`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).