feat: initial release of macZIPfixer (ZIPName.app)

README.md

@@ -0,0 +1,28 @@
+# macZIPfixer / ZIPName.app
+
+Утилита с графическим интерфейсом и Drag-and-Drop для macOS, предназначенная для исправления кракозябр («mojibake») в именах файлов, папках и ZIP-архивах.
+
+## Проблема
+При распаковке ZIP-архивов, созданных на Windows без флага UTF-8 (в кодировке OEM CP866 или Windows-1251), штатный разархиватор macOS (Archive Utility / BOMArchiveHelper) интерпретирует байты через MacCyrillic или CP437. В результате имена файлов превращаются в нечитаемые символы (`≠`, `™`, `†`, `Ѓ` и т.д.).
+
+## Возможности
+- **Drag-and-Drop:** просто перетащите поврежденную папку, файл или ZIP-архив в окно программы.
+- **Поддержка ZIP напрямую:** распаковывает ZIP с автоматическим определением и восстановлением русских имен на лету.
+- **Удаление мусора:** автоматически находит и удаляет фантомные файлы блокировки Office (`~$...`), возникающие при битых распаковках.
+- **Рекурсивное исправление:** обходит вложенные папки снизу вверх, переименовывая как файлы, так и сами каталоги.
+- **Бренд-стиль:** тёмная тема в фирменном стиле (Carbon + Red `#ff2d20`).
+
+## Установка и запуск
+
+Приложение уже собрано в `.app` и установлено в `/Applications/ZIPName.app`.
+
+Для ручного запуска из терминала:
+```bash
+python3 app.py
+```
+
+Для сборки `.app`:
+```bash
+./build.sh
+cp -R dist/ZIPName.app /Applications/
+```