Initial commit

README.md

@@ -0,0 +1,65 @@
+# xray-sub
+
+Небольшой TUI-скрипт для выбора сервера из JSON-подписки Xray.
+
+## Установка на Arch Linux
+
+Установите зависимости:
+
+```bash
+sudo pacman -S --needed bash curl jq coreutils systemd
+```
+
+Для действий с системными файлами нужен один из инструментов повышения прав: `sudo`, `doas`, `run0` или `pkexec`.
+
+Сделайте скрипт исполняемым:
+
+```bash
+chmod +x main.sh
+```
+
+По желанию установите как команду:
+
+```bash
+sudo install -m 755 main.sh /usr/local/bin/xray-sub
+```
+
+## Запуск
+
+Из папки проекта:
+
+```bash
+./main.sh
+```
+
+Если установлено в систему:
+
+```bash
+xray-sub
+```
+
+Первый запуск попросит ссылку на JSON-подписку, путь к конфигу Xray и имя systemd-службы.
+
+Полезные команды:
+
+```bash
+xray-sub --setup    # заново пройти настройку
+xray-sub --refresh  # обновить подписку
+xray-sub --help     # справка
+```
+
+## Что делает
+
+Скрипт скачивает JSON-подписку, показывает список серверов в терминальном меню, записывает выбранный сервер в конфиг Xray и при необходимости перезапускает службу Xray.
+
+В меню можно выбрать сервер, обновить подписку, а также запустить, остановить, перезапустить службу или посмотреть её статус.
+
+## Где хранит файлы
+
+Пользовательские файлы хранятся в `~/.xray-sub/`:
+
+- `config` — настройки скрипта и последний выбранный сервер.
+- `sub.json` — кэш скачанной подписки.
+- `backups/` — папка для резервных файлов.
+
+Конфиг Xray записывается туда, куда вы указали при настройке. По умолчанию это `/etc/xray/config.json`.