PrivacyKit

Private browser toolbox — полезные инструменты, которые работают прямо на вашем устройстве.

Без аккаунтов · Без сборки · Без серверной обработки пользовательских файлов

---

✦ Что такое PrivacyKit?

PrivacyKit — компактный набор повседневных веб-инструментов для ссылок, QR-кодов, файлов, изображений, текста и небольших developer-задач.

Главная идея проекта проста: там, где это возможно, обработка выполняется внутри браузера. Пользователю не нужно регистрироваться или отправлять файл на сервер только ради того, чтобы посчитать SHA-256, уменьшить изображение или очистить ссылку.

Проект написан на обычных HTML + CSS + JavaScript и подходит для размещения на GitHub Pages.

---

🧰 Инструменты

Инструмент	Что делает	Обработка
🔗 Link Cleaner	Удаляет utm_*, fbclid, gclid, yclid и другие tracking-параметры	Локально
▦ QR Generator	Создаёт QR-код из ссылки или текста и сохраняет PNG	Локально
⌗ QR Reader	Читает QR с изображения или камеры	Локально
🔐 Password Generator	Создаёт стойкие пароли через Web Crypto	Локально
# File Hash	SHA-256 / SHA-1 / SHA-384 / SHA-512 + сравнение хэшей	Локально
🔎 File Inspector	MIME, расширение, сигнатура, HEX preview, SHA-256 и preview текста	Локально
🖼️ Image Studio	Resize, сжатие, JPG/PNG/WebP, изменение качества, очистка метаданных	Локально
{ } JSON Formatter	Проверяет, форматирует и минифицирует JSON	Локально
</> Base64	UTF-8 encode / decode	Локально
✦ Text Cleaner	Удаляет zero-width символы, лишние пробелы и пустые строки	Локально

---

🆕 PrivacyKit v0.4

В этой версии проект подготовлен не только как демо, но и как нормальный GitHub-репозиторий.

QR Reader

Можно:

• загрузить изображение с QR-кодом;
• использовать камеру устройства;
• скопировать распознанное содержимое;
• сразу открыть результат, если это ссылка;
• остановить камеру автоматически после успешного распознавания.

Для камеры проект лучше открывать через HTTPS или localhost. GitHub Pages подходит для этого сценария.

File Inspector

Перетащите файл — PrivacyKit покажет:

• имя;
• размер;
• расширение;
• MIME type;
• сигнатуру первых байт;
• дату последнего изменения;
• разрешение изображения, если оно доступно;
• HEX preview первых байт;
• безопасный preview текстовых файлов;
• SHA-256 по запросу.

Поддерживается распознавание нескольких распространённых сигнатур, включая PNG, JPEG, GIF, WebP, PDF, ZIP, GZIP, RAR, 7-Zip, Windows EXE и ELF.

---

🔒 Privacy-first подход

PrivacyKit специально устроен максимально просто.

Ваш файл / текст / ссылка
          │
          ▼
       Браузер
          │
          ▼
  Результат на устройстве

У проекта нет собственного backend для работы основных инструментов.

Важно

• Image Studio использует Canvas API браузера.
• Хэши считаются через Web Crypto API.
• QR-коды генерируются локальной копией QRCode.js.
• QR Reader использует возможности браузера для распознавания QR.
• Введённые данные не требуется отправлять во внешний API PrivacyKit.

---

🚀 Быстрый запуск

Проект не требует npm install, сборщика или базы данных.

Вариант 1 — просто открыть

Откройте:

index.html

Большая часть функций будет работать сразу.

Вариант 2 — локальный сервер

Рекомендуемый вариант:

python -m http.server 8080

После этого откройте:

http://localhost:8080

Так надёжнее работают Clipboard API и функции, которым нужен безопасный контекст браузера.

---

🌐 Публикация на GitHub Pages

1. Создайте новый репозиторий на GitHub.
2. Загрузите содержимое папки проекта в корень репозитория.
3. Откройте Settings.
4. Перейдите в Pages.
5. В Build and deployment выберите публикацию из ветки.
6. Выберите ветку main и папку / (root).
7. Сохраните настройки.

Сборка не требуется: index.html уже находится в корне проекта.

После публикации адрес обычно имеет вид:

https://USERNAME.github.io/REPOSITORY/

---

📁 Структура проекта

PrivacyKit/
├── assets/
├── .gitignore
├── .nojekyll
├── CHANGELOG.md
├── LICENSE
├── README.md
├── app.js
├── favicon.svg
├── index.html
├── qrcode.min.js
├── qrcodejs-LICENSE.txt
└── styles.css

---

🧩 Технологии

• HTML5
• CSS3
• Vanilla JavaScript
• Web Crypto API
• Canvas API
• MediaDevices API
• Barcode Detection API
• File API
• Clipboard API
• LocalStorage — только для настройки темы
• QRCode.js — локальная копия библиотеки генерации QR

Никакого framework lock-in и обязательного build step.

---

🗺️ Roadmap

Следующие версии

• Password Strength Checker
• UUID / Nano ID Generator
• URL Encode / Decode
• Unix Timestamp Converter
• Image color picker
• Duplicate file checker
• PWA + полноценный offline mode
• Горячий поиск по инструментам
• Избранные инструменты
• Улучшенная доступность и keyboard shortcuts

---

🧪 Проверка перед публикацией

Перед релизом рекомендуется проверить:

• Link Cleaner на чистой ссылке и URL с UTM;
• создание и скачивание QR;
• QR Reader с PNG/JPG;
• доступ к камере через HTTPS/localhost;
• SHA-256 на небольшом тестовом файле;
• Image Studio на JPG/PNG/WebP;
• мобильную версию;
• светлую и тёмную тему.

---

📜 Лицензия

Сам PrivacyKit распространяется по MIT License — см. LICENSE.

Для локально включённой библиотеки QRCode.js сохранён отдельный файл лицензии:

qrcodejs-LICENSE.txt

---

PrivacyKit

Small tools. Local processing. Less unnecessary data sharing.

v0.4