From 311bcb4399157fa8875ebc90832e982f251b4e92 Mon Sep 17 00:00:00 2001
From: "kek.of" <nanoray.yt@yandex.ru>
Date: Sun, 15 Mar 2026 23:53:29 +0500
Subject: [PATCH] Create README.md

---
 macos/README.md | 90 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 macos/README.md

diff --git a/macos/README.md b/macos/README.md
new file mode 100644
index 0000000..3d4f2fb
--- /dev/null
+++ b/macos/README.md
@@ -0,0 +1,90 @@
+# TG WS Proxy — macOS
+
+macOS-версия [tg-ws-proxy](https://github.com/Flowseal/tg-ws-proxy) с нативным menu bar приложением.
+
+## Установка
+
+### Из исходников
+
+```bash
+# Клонируй репозиторий
+git clone https://github.com/Flowseal/tg-ws-proxy
+cd tg-ws-proxy
+
+# Перейди в папку с билдом macOS
+cd macos
+
+# Установи зависимости
+pip install -r requirements_macos.txt
+
+# Запуск
+python macos.py
+```
+
+### Сборка .app
+
+```bash
+pip install pyinstaller
+pyinstaller macos.spec
+# Результат: dist/TgWsProxy.app
+```
+
+## GUI
+
+Приложение живёт в menu bar (строка меню вверху экрана). Нет иконки в Dock.
+
+**Меню:**
+- **Открыть в Telegram** — откроет `tg://socks?...` ссылку, Telegram сам добавит прокси
+- **Перезапустить прокси** — горячий перезапуск
+- **Настройки…** — окно с полями Host, Port, DC IPs, Verbose
+- **Открыть логи** — откроет файл логов в TextEdit
+- **Выход** — остановить прокси и закрыть
+
+## Конфигурация
+
+Хранится в `~/Library/Application Support/TgWsProxy/config.json`:
+
+```json
+{
+  "port": 1080,
+  "host": "127.0.0.1",
+  "dc_ip": [
+    "2:149.154.167.220",
+    "4:149.154.167.220"
+  ],
+  "verbose": false
+}
+```
+
+Логи: `~/Library/Application Support/TgWsProxy/proxy.log`
+
+## Настройка Telegram Desktop
+
+### Автоматически
+Нажми **«Открыть в Telegram»** в меню строки меню.
+
+### Вручную
+1. Telegram → **Настройки** → **Продвинутые настройки** → **Тип подключения** → **Прокси**
+2. Добавь прокси:
+   - **Тип:** SOCKS5
+   - **Сервер:** `127.0.0.1`
+   - **Порт:** `1080`
+   - **Логин/Пароль:** пусто
+
+## Зависимости
+
+| Библиотека | Назначение |
+|-----------|------------|
+| `rumps` | macOS menu bar framework |
+| `cryptography` | MTProto obfuscation (из оригинала) |
+| `psutil` | Проверка запущенных копий |
+
+## Отличия от Windows-версии
+
+| | Windows | macOS |
+|---|---|---|
+| GUI-фреймворк | pystray + tkinter | rumps |
+| Конфиг | `%APPDATA%\TgWsProxy\` | `~/Library/Application Support/TgWsProxy/` |
+| Иконка в трее | Системный трей | Menu bar (строка меню) |
+| Сборка | PyInstaller → .exe | PyInstaller → .app |
+| Автообновление | - | + |