Документация

Расширение EffeTune для браузера

Расширение одновременно обрабатывает звук до четырёх вкладок, для каждой из которых используется собственный стереофонический Effect Pipeline. Оно подходит для прослушивания видео- или музыкального сайта без запуска приложения для компьютера и настройки виртуального аудиоустройства.

Совместимость и установка

Используйте расширение на ПК с Chrome 116 или новее либо с совместимой версией Microsoft Edge на Chromium. Firefox, Safari, мобильные браузеры и приватный режим не поддерживаются. В каждой вкладке используется стереоцепочка эффектов.

Расширение из магазина устанавливайте в самом магазине. Для локального пакета распакуйте effetune-extension-<version>.zip в папку, которую будете хранить. Откройте chrome://extensions в Chrome или edge://extensions в Edge, включите Developer mode, выберите Load unpacked и укажите эту папку. Load unpacked не устанавливает ZIP-файл; после замены файлов перезагрузите расширение на этой странице.

Запуск, сравнение и остановка

  1. Откройте вкладку со звуком, который хотите обработать, и начните воспроизведение.
  2. Откройте расширение EffeTune на панели инструментов браузера.
  3. Выберите Start on this tab. Когда цепочка готова, состояние меняется с Starting… на Processing.

Чтобы добавить вкладку, откройте в ней расширение и выберите Start on this tab. В окне показаны все сеансы. Одновременно можно обрабатывать до четырёх вкладок; перед запуском пятой остановите одну из них. Bypass позволяет слушать вкладку без эффектов, сохраняя сеанс. Stop возвращает эту вкладку к обычному воспроизведению, не прерывая остальные.

Обработка продолжается после закрытия всплывающего окна или редактора. При повторном открытии показываются текущая вкладка и фактическое состояние. После перезапуска браузера начните новый сеанс вручную: расширение не захватывает вкладки автоматически.

Редактирование цепочки и пресеты

Выберите Edit pipeline, чтобы открыть EffeTune Pipeline Editor. Как и в EffeTune, можно добавлять, переставлять, включать и отключать эффекты, менять параметры и использовать доступные анализаторы. Saved preset и Apply to selected tab в окне расширения меняют всю цепочку без открытия редактора. В редакторе откройте Pipeline Presets, чтобы сохранить полный пресет цепочки с помощью Save as. Чтобы импортировать или экспортировать полные пресеты, откройте Settings и выберите Import preset… или Export preset. Выберите вкладку в заголовке редактора, чтобы увидеть её цепочку и показания анализаторов. Если активных сеансов нет, Offline pipeline позволяет изменить цепочку по умолчанию для следующего запуска. В окне расширения выберите вкладку, к которой нужно применить пресет.

Нажмите Visualizer в заголовке редактора, чтобы увидеть обработанный звук выбранной вкладки в Visualizer; нажмите ещё раз, чтобы вернуться к цепочке. Если обработка на этой вкладке не запущена, Visualizer показывает «Start EffeTune on a tab to show Visualizer.». Названия треков и обложки в расширении не отображаются. Share и Import Link работают так же, как в веб-приложении, а созданные ссылки открываются в веб-версии. Композиции и пресеты Visualizer хранятся в расширении и не синхронизируются с веб- или настольным приложением.

Сохранённые настройки и пресеты остаются в расширении и не синхронизируются автоматически с веб- или настольным приложением. Если пресету нужны неподдерживаемая маршрутизация, эффект или недоступный внешний ресурс, он не применяется, а текущая цепочка сохраняется.

Чтобы использовать в Room EQ или Crosstalk Cancellation измерение из веб- или настольного приложения, экспортируйте его там в JSON. В редакторе расширения откройте Settings, выберите Import measurement…, затем укажите этот JSON-файл. Для Crosstalk Cancellation или фазовой коррекции Room EQ включите импульсные характеристики в экспорт. Импортированные измерения сразу появляются в списке Measurement в Room EQ, остаются в хранилище браузера расширения и автоматически не синхронизируются. Чтобы удалить импортированную копию, выберите её в этом списке и нажмите Delete рядом со списком. После подтверждения все использующие её назначения Room EQ и Crosstalk Cancellation будут очищены до удаления копии.

Чтобы выбрать сохранённые данные для переноса, откройте Settings > Backup / Restore в редакторе. Тот же файл .effetune_backup подходит для веб- и настольного приложения и может содержать сохранённые пресеты цепочки, пресеты отдельных эффектов, пресеты Visualizer, импульсные характеристики и импортированные измерения. Цепочка с неподдерживаемой в расширении маршрутизацией или эффектами остаётся сохранённой, и её можно снова включить в резервную копию, хотя применить её в расширении нельзя. Правила URL и настройка Sample rate расширения в файл не входят.

Пресеты по URL и частота дискретизации

В Settings откройте URL rules…, добавьте шаблон, выберите сохранённый пресет и включите правило. Шаблон имеет вид host/path, например example.com/music/*; * соответствует любому тексту. Используется первое подходящее включённое правило. Регистр имени хоста не учитывается; протокол, параметры запроса и фрагмент игнорируются. Меняйте порядок правил для настройки приоритета, отключайте или удаляйте ненужные.

Обработку каждой вкладки по-прежнему нужно запускать вручную. Пресет выбирается при запуске и изменении URL; если совпадений нет, используется цепочка по умолчанию. Изменения правил действуют со следующего запуска или перехода. Редактирование цепочки, выбранной правилом, обновляет соответствующий сохранённый пресет. Остальные изменения, в том числе после ручного применения пресета, обновляют цепочку по умолчанию. Удаление пресета отключает его правила и возвращает использующие их вкладки к цепочке по умолчанию.

Sample rate в Settings задаёт частоту для всех активных вкладок: Auto, 44.1 kHz, 48 kHz, 96 kHz или 192 kHz. В режиме Auto частоту выбирает браузер. При изменении обработка всех вкладок ненадолго перезапускается с сохранением захвата. Если вкладка не может работать на новой частоте, она возвращается к обычному воспроизведению; выберите другую частоту и запустите обработку этой вкладки снова.

Разрешения, ограничения и помощь

Расширение захватывает звук только вкладок, в которых вы явно запустили обработку. Оно читает их URL, в том числе после перехода на другую страницу, чтобы выбрать сохранённый пресет. Оно не читает содержимое страниц, не внедряет скрипты, не использует микрофон, не записывает и не отправляет звук.

Стереоцепочки поддерживают Bus Routing с Main и Bus 1–4, включая параллельные тракты эффектов. В расширении недоступны более двух каналов, выполнение новых измерений и управление устройствами, Music Library, пакетное преобразование файлов, а также функции настольного приложения, зависящие от устройств или путей к файлам.

Некоторый защищённый контент может быть недоступен для захвата; расширение не обходит защиту. Если захват не запускается, EffeTune останавливает обработку, а вкладка возвращается к обычному воспроизведению. Проверьте, что во вкладке есть звук, и снова выберите Start on this tab. При Needs attention сделайте то же самое. Если пресет не применился, текущая цепочка сохранена; смените пресет или подготовьте нужные ресурсы.