old-tv-extension

0

Описание

Расширение, показывающее старую рекламу

Языки

  • JavaScript67,7%
  • HTML22%
  • CSS10,3%
5 месяцев назад
4 месяца назад
4 месяца назад
4 месяца назад
4 месяца назад
README.md

📺 Old TV Ads — Расширение для Chrome/Firefox

💡 Описание проекта (Что это, зачем нужно)

Расширение для браузеров на базе Chromium (Chrome, Edge, Brave и др.), которое заменяет скучную современную рекламу на YouTube и Rutube на ностальгические рекламные ролики 90-х и 2000-х годов.

Расширение работает в двух режимах:

  1. Замена рекламы: Перехватывает нативную рекламу сайта и заменяет её старым роликом.
  2. Таймер: Показывает случайный рекламный ролик каждые 5-10 минут просмотра, имитируя перерыв на рекламу на старом телевидении.

✅ Полезность задачи (Отличная полезность)

Проект решает понятную проблему (скучная реклама) в выбранной предметной области (браузеры, медиа-контент). Он демонстрирует:

  • Глубокое понимание проблемы блокировки рекламы и взаимодействия с DOM.
  • Практическое применение
    chrome.storage
    для сохранения настроек.
  • Использование
    MutationObserver
    для обработки динамических одностраничных приложений (SPA) типа YouTube.
  • Элементы, которые можно использовать в реальных проектах (например, логика перехвата рекламы через селекторы и работа с
    web_accessible_resources
    ).

🛠️ Требования и установка (Installation)

Требования

  • Браузер на базе Chromium (Google Chrome, Microsoft Edge, Brave и т.д.).
  • Node.js (для запуска CI-скриптов и локальной проверки).

Установка (Загрузка как "Unpacked Extension")

  1. Клонируйте репозиторий:
  2. Добавьте рекламные ролики: Поместите свои рекламные ролики в папку
    ads/
    (например,
    ad1.mp4
    ,
    ad2.mp4
    и т.д.). Убедитесь, что имена файлов соответствуют логике в
    content.js
    (от
    ad1.mp4
    до
    ad18.mp4
    ).
  3. Перейдите в настройки расширений: Откройте
    chrome://extensions/
    в браузере.
  4. Включите режим разработчика: Установите переключатель "Режим разработчика" (Developer mode) в верхнем правом углу.
  5. Загрузите расширение: Нажмите кнопку "Загрузить распакованное расширение" и выберите папку
    src/
    внутри клонированного репозитория.

⚙️ Использование (Usage с примерами)

После установки расширение начнет работать автоматически на YouTube и Rutube.

  1. Просмотр рекламы: Дождитесь показа рекламы по таймеру (5-10 минут) или при появлении нативной рекламы сайта.
  2. Управление через Pop-up меню:
    • Нажмите на иконку расширения в панели браузера.
    • "Пропустить рекламу": Мгновенно закрывает текущий рекламный ролик и возобновляет видео.
    • "Включить/Выключить рекламу": Позволяет временно отключить всю логику расширения, сохраняя настройку между сессиями.

Пример кода (Структура и логика): Основная логика содержится в

src/content.js
.