# Winbox macOS Wrapper

Небольшая оболочка для запуска официального `winbox64.exe` в Wine на macOS.
Проект восстановлен по идее и launcher-скрипту [nrlquaker/winbox-mac](https://github.com/nrlquaker/winbox-mac), но намеренно не распространяет готовый `.app`, Wine, Winbox.exe или другие сторонние бинарники.

## Для чего нужен

Скрипт задаёт отдельный Wine-префикс и запускает указанный пользователем файл Winbox.
Это позволяет не смешивать настройки Winbox с другими Wine-приложениями и удобно
передавать стандартные аргументы запуска.

Проект **не является официальным продуктом MikroTik** и не связан с MikroTik.
Winbox, Wine и их товарные знаки принадлежат соответствующим правообладателям.

## Что входит и чего нет

В репозитории есть только Bash-скрипт запуска и документация. В нём нет:

- `winbox64.exe`;
- Wine или его библиотек;
- готового macOS-приложения, установщика DMG или ZIP-релиза;
- сохранённых учётных данных, адресов роутеров и конфигураций.

Winbox следует получить с официального сайта MikroTik, а Wine — установить из
проверенного вами источника. Это важно и для безопасности, и для соблюдения
условий распространения сторонних компонентов.

## Требования

- macOS;
- установленный `wine64`, совместимый с вашим Mac;
- локальный путь к официальному `winbox64.exe`;
- Bash 3.2 или новее.

На Apple Silicon используйте сборку Wine, которая поддерживает нужную вам
архитектуру; проект не поставляет Rosetta, Wine или готовые runtime-библиотеки.

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

```bash
git clone https://github.dfv24.com/fofanov.dmitry/winbox-macos-wrapper.git
cd winbox-macos-wrapper
chmod +x bin/winbox-macos

WINBOX_EXE="$HOME/Downloads/winbox64.exe" ./bin/winbox-macos
```

По умолчанию Wine-префикс создаётся в
`~/Library/Application Support/com.mikrotik.winbox`. Чтобы изолировать тестовую
установку, передайте другой путь:

```bash
WINEPREFIX="$HOME/Library/Application Support/com.example.winbox-test" \
WINBOX_EXE="$HOME/Downloads/winbox64.exe" \
./bin/winbox-macos
```

## Параметры и переменные окружения

| Переменная | Назначение | Значение по умолчанию |
|---|---|---|
| `WINBOX_EXE` | Обязательный абсолютный или относительный путь к `winbox64.exe` | нет |
| `WINE64_BIN` | Исполняемый файл Wine | `wine64` из `PATH` |
| `WINEPREFIX` | Каталог настроек Wine | `~/Library/Application Support/com.mikrotik.winbox` |
| `WINEDEBUG` | Уровень диагностического вывода Wine | `fixme-esync` |

Аргументы после имени скрипта передаются Winbox без изменений. Не передавайте
пароли в аргументах командной строки: они могут быть видны в списке процессов и
истории оболочки.

```bash
WINBOX_EXE="$HOME/Downloads/winbox64.exe" \
./bin/winbox-macos 192.0.2.1 admin
```

## Проверка

Проверить синтаксис launcher-скрипта можно без Wine и Winbox:

```bash
bash -n bin/winbox-macos
```

При запуске скрипт проверяет наличие Wine и файла Winbox до создания процесса.

## Происхождение и лицензия

Основа запуска и идея отдельного Wine-префикса взяты из
[`nrlquaker/winbox-mac`](https://github.com/nrlquaker/winbox-mac), лицензированного
по MIT. Изменённый код и документация также распространяются по [MIT License](LICENSE).
Лицензия относится только к коду этого репозитория; она не предоставляет прав на
Winbox, Wine или другие сторонние компоненты.