Files
macZIPfixer/README.md
T

29 lines
2.0 KiB
Markdown

# 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/
```