Skip to content

About

EQ any audio you find on the web

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

🎧 Ears: Bass Boost, EQ Any Audio! (Chrome Extension)

Ears — это расширение для Chrome (Manifest V3), которое позволяет эквализировать звук в любых вкладках браузера в реальном времени: усиливать бас, приглушать высокие, поднимать вокал и сохранять собственные пресеты.

Что изменилось в этом README

Старое описание было про Android/APK, а этот репозиторий содержит именно Chrome extension. README обновлён под актуальный формат проекта и реальные файлы в репозитории.

✨ Возможности

  • Параметрический эквалайзер с интерактивными точками фильтров.
  • Быстрый пресет Bass Boost.
  • Сохранение, удаление, импорт и экспорт пользовательских пресетов.
  • Спектральный визуализатор.
  • Поддержка работы с несколькими активными вкладками.
  • Кнопка запуска в отдельном окне (Full Window).

📦 Установка (локально, для разработки)

  1. Скачайте/клонируйте репозиторий.
  2. Откройте chrome://extensions.
  3. Включите Developer mode.
  4. Нажмите Load unpacked.
  5. Выберите папку этого проекта.

После установки нажмите на иконку Ears в панели расширений, чтобы подключить текущую вкладку к эквалайзеру.

🧭 Как пользоваться

  1. Откройте вкладку с аудио/видео.
  2. Нажмите на иконку расширения Ears.
  3. Вкладка будет добавлена в активные для обработки звука.
  4. Настройте фильтры на вкладке Controls.
  5. При необходимости сохраните пресет (кнопка + Save Preset).
  6. Для переноса настроек используйте Export Presets / Import Presets.

🏗️ Структура проекта

  • manifest.json — конфигурация расширения (MV3, permissions, background worker).
  • popup.html, popup.css, popup.js — UI/логика всплывающего окна и контролов EQ.
  • bg.js — background service worker.
  • offscreen.html, offscreen.js — offscreen-документ для обработки аудиопотока.
  • snap.svg-min.js — библиотека для работы с SVG в UI.
  • ears*.png, earstile*.* — иконки и графические ассеты.

🔐 Разрешения

Расширение использует следующие группы разрешений (см. manifest.json):

  • tabCapture, tabs, activeTab — для захвата и обработки аудио активных вкладок.
  • storage — для сохранения пользовательских пресетов и настроек.
  • scripting, offscreen, downloads — для служебной логики расширения, offscreen-обработки и экспорта пресетов.
  • host_permissions: <all_urls> — доступ к вкладкам с любыми адресами для применения EQ к аудио.

🧪 Разработка и проверка

Проект не требует сборки: это unpacked extension с готовыми статическими файлами.

Быстрые проверки после изменений:

python -m json.tool manifest.json >/dev/null
node --check bg.js
node --check popup.js
node --check offscreen.js

🌐 Публикация

Страница расширения в Chrome Web Store указана внутри интерфейса (popup.html).

⚠️ Disclaimer

Сильное усиление частот может повредить слух и/или акустику. Используйте эквалайзер ответственно.

About

EQ any audio you find on the web

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages