From b1a86e2d19fd24d83049ab2547ce939043d4b9a2 Mon Sep 17 00:00:00 2001 From: m4xx1m Date: Sat, 10 Oct 2026 16:58:06 +0300 Subject: [PATCH] docs: add installation instructions for packaged release zip --- README.md | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index fb8c8a9..427afce 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,28 @@ # GQ to ORG Redirector -Простое и ультралегкое расширение для Google Chrome (Manifest V3), которое автоматически перенаправляет запросы с доменов `.gq` на соответствующие `.org` (например, `rutracker.gq` -> `rutracker.org`). +Простое и ультралегкое расширение для Google Chrome и Chromium-браузеров (Manifest V3), которое автоматически перенаправляет запросы с доменов `.gq` на соответствующие `.org` (например, `rutracker.gq` -> `rutracker.org`). ## Особенности - **Работает до обращения к сети:** перехват происходит на уровне движка Chromium (`declarativeNetRequest`), поэтому не возникает проблем с DNS, HSTS или отсутствующими SSL-сертификатами. - **Сохраняет структуру ссылок:** сохраняет все пути и GET-параметры запроса (`?t=...`). - **0 МБ оперативной памяти:** не использует фоновые сервисы (`service_worker`). -## Установка в Google Chrome -1. Откройте `chrome://extensions/`. -2. Включите **«Режим разработчика»** (Developer mode) в правом верхнем углу. -3. Нажмите **«Загрузить распакованное»** (Load unpacked) и выберите папку с этим расширением. +## Установка готового расширения из Релизов + +1. Перейдите в [Релизы репозитория](https://git.them4x.net/m4xx1m/gq-to-org-redirector/releases) и скачайте архив `gq-to-org-redirector.zip` из последнего релиза. +2. Распакуйте архив в постоянную папку на компьютере (например, в `Документы` или отдельную папку расширений; не удаляйте её, так как браузер загружает файлы оттуда). +3. Откройте в браузере страницу управления расширениями: + ```text + chrome://extensions/ + ``` +4. Включите тумблер **«Режим разработчика»** (Developer mode) в правом верхнем углу. +5. В левом верхнем углу нажмите **«Загрузить распакованное»** (Load unpacked) и выберите папку с распакованным архивом. +6. *(Опционально)* Если вы открываете ссылки в режиме инкогнито, нажмите **«Сведения»** на карточке расширения и включите тумблер **«Разрешить использование в режиме инкогнито»**. + +## Установка из исходного кода (для разработки) + +1. Клонируйте репозиторий: + ```bash + git clone git@git.them4x.net:m4xx1m/gq-to-org-redirector.git + ``` +2. Откройте `chrome://extensions/`, включите «Режим разработчика», нажмите «Загрузить распакованное» и выберите папку репозитория.