diff --git a/README.md b/README.md
new file mode 100644
index 0000000..21ec457
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# TG WS Proxy (Android)
+
+**Локальный SOCKS5-прокси** для Telegram Android, который **ускоряет работу Telegram**, перенаправляя трафик через WebSocket-соединения.
+
+Это мобильный форк популярного SOCKS5/WS прокси, кардинально переработанный для удобного использования на смартфонах. 
+
+> [!CAUTION]
+> ### 🔴 ВАЖНО: VPN по умолчанию использовать для работы прокси больше не нужно!
+
+## 🌟 Что реализовано в Android-версии
+
+Функции управления вынесены в красивый и удобный **Material 3** интерфейс (Jetpack Compose).
+
+- **Полноценный UI:** Настройка порта, пула датацентров и количества WebSocket соединений делается в 2 клика.
+- **Интеграция с Telegram:** Кнопка «Применить в телеграмм» автоматически настроит прокси через систему глубоких ссылок (`tg://socks`) для любого установленного клиента (AyuGram, Plus Messenger, NekoGram и др.).
+- **Стабильная работа в фоне:** Приложение использует «неубиваемый» `Foreground Service` и самоконтроль Wakelock'ов, чтобы Android не "душил" прокси в спящем режиме.
+- **Встроенный просмотрщик логов:** В реальном времени отображаются логии работы для диагностики.
+- **Динамические цвета и темы:** Поддержка светлой и темной тем, а также Material You (в Android 12+).
+
+## 🆕 Что нового (v1.0.4)
+
+- 🕰 **[Старое]** Была возвращена логика ручного вписывания адресов. IP по умолчанию: `149.154.167.220`.
+
+![MyCollages (2)](https://github.com/user-attachments/assets/631d88ad-77f6-4e57-b18b-2be3d30b0c1b)
+
+## Как это работает
+
+```
+Telegram Android → SOCKS5 (по умолчанию 127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC
+```
+
+1. Приложение поднимает локальный SOCKS5-прокси средствами нативного движка на языке **Go**.
+2. Перехватывает подключения к IP-адресам Telegram.
+3. Извлекает DC ID из MTProto-пакета и устанавливает защищенное WebSocket (TLS) соединение.
+4. Эффективно мультиплексирует трафик.
+
+## 🚀 Быстрый старт
+
+1. Перейдите на **[страницу релизов]** и скачайте актуальный `APK`-файл.
+2. Установите приложение на ваш Android-смартфон.
+3. Откройте **TG WS Proxy**.
+4. Выберите требуемый пул IP-адресов.
+5. Нажмите **«Запустить прокси»** — появится уведомление о работе в фоновом режиме.
+6. Нажмите **«Применить в телеграмм»** — откроется клиент Telegram, останется только нажать «Подключить».
+
+## Лицензия
+
+Этот форк распространяется под лицензией **GPLv3**. (Оригинальный код `tg-ws-proxy` доступен под MIT). Файл лицензии приложен к исходному коду.