 Подробное описание всех настроек и сервисных функций расширения YouTube Embedded RU.
Общие принципы управления расширением, работа с загрузчиком медиа-файлов.
В этой статье:
Описанные в этом документе опции и настройки соответствуют текущей официальной версии расширения, в более ранних* релизах аддона часть настроек может называться иначе, а часть функций в них может отсутствовать.
* Для ознакомления с настройками этих выпусков смотрим соответствующие ссылки в Истории версий расширения.
Общая история изменения настроек в версиях 2018*/2019* описана в статье YouTube Embedded RU : Ретроспектива.
Назначение и способы управления
YouTube Embedded RU – это контекстный "микро-комбайн", заточенный на удобный просмотр, обход блокировок и загрузку медиа-файлов. Расширение является универсальной "открывашкой" ссылок на видео-ролики и видео-фреймов YouTube в режиме "только плейер" (embedded-видео).
Основная функция аддона – быстрый просмотр видео без загрузки описания, "рекомендованного", "каментов" и других элементов дизайна. Функция работает как переключатель режима страниц на YouTube в режим embedded-плейера и обратно, доступна на страницах роликов с адресами (www|m).youtube.com/watch* или www.youtube.com/(embed|shorts)/*. Целевая страница в режиме плейера может быть открыта в отдельной или в текущей вкладке.
Общее описание возможностей аддона приведено в разделе Основные возможности и способ применения.
Все дополнительные функции и настройки доступны через контекстноe меню, запускаются выбором соответствующих пунктов или подбором желаемой комбинации опций в группах настроек.
Контекстное меню для фрейма или видео-объекта вызывается двойным щелчком ПКМ на нём (следует повторно щёлкнуть ПКМ при появлении "штатного" меню стандартного плейера). В браузерах версий CR48+ можно отключить контекстное меню страницы, оставив только управление через кнопку на тулбаре.
Интерфейс управления и настроек
Вызов основной функции (переключения режима плейера) – щелчок по кнопке на тулбаре.
На страницах видео-роликов переключение в режим "embedded-плейер" доступно и через контекстное меню (включая доступ ко всем связанным функциям и/или настройкам).
Контекстное меню динамическое, его конкретные пункты зависят от текущего контекста вызова (страница, ссылка, фрейм, выделенный текст). Максимальное число одновременно доступных пунктов отображается при вызове за ссылке в окне embedded-плейера:
Кроме того, содержимое контекстного меню зависит как от настроек, так и от версии браузера.
В браузерах версий до CR48 оно присутствует только в контексте вкладки и кроме текущих контекстных действий содержит все группы настроек и сервисных функций:
В браузерах версий CR48+ в контексте вкладки отображаются только текущие контекстные действия:
Все группы настроек и сервисных функций в браузерах версий CR48+ доступны в меню значка на тулбаре. Примеры скриншотов с пунктами каждой из групп приведены ниже в описаниях этих групп.
Настройки, связанные с просмотром контента, обрабатываются скриптом-инжектором, автоматически загружаемым на всех страницах YouTube. При этом сам аддон работает только в момент вызова функций в контекстном меню либо при переключении любой из настроек, расширение не имеет постоянного фонового процесса и не занимает память в покое.
Особенности работы с настройками и важные условия их корректного сохранения и последующего применения при просмотре видео на сайте YouTube рассмотрены в материалах статей Дополнительные настройки и сервисные функции и Особенности работы скрипта-инжектора
Для обеспечения корректной работы расширения учитываем важное примечание по настройке браузера!
Переключатель режима проигрывателя
Основная функция расширения, переключающая просмотр на странице YouTube в режим embedded-плейера и обратно, вызывается щелчком по кнопке на тулбаре:
Совет: при желании, в случае достаточно частого использования этого переключателя, любители клавиатурных сокращений могут самостоятельно задать произвольную горячую клавишу для вызова этой функции с помощью штатной функции браузера "Быстрые клавиши" (указать комбинацию клавиш для "Активации расширения").
При попытке вызова на вкладках, не являющихся страницами YouTube, выдаётся сообщение о недопустимом контексте:
Переключение в режим "embedded-плейер" и обратно также доступно и через контекстное меню страницы.
Наименование соответствующих пунктов зависит от текущего контекста вызова:
- "Открыть ссылку в плейере" – откроет ссылку под курсором в режиме "embedded-плейер".
- "Открыть фрейм в плейере" – откроет фрейм под курсором в режиме "embedded-плейер".
- "Переключить на плейер" – откроет фрейм/страницу под курсором в режиме "embedded-плейер".
- "Смотреть видео по ссылке" – откроет страницу YouTube для ссылки под курсором.
- "Смотреть видео в плейере" – откроет страницу YouTube для фрейма под курсором.
- "Перейти на страницу" – откроет страницу YouTube для фрейма (embed/shorts) под курсором.
- "Открыть ссылку из текста" – откроет страницу YouTube для выделенного текста под курсором.
Эта опция отсутствует, если выключена опция "Искать ссылки в выделенном тексте" (в группе настроек интерфейса)
- "Вынести ссылку на панель" – откроет ссылку под курсором в режиме "embedded-плейер" в отдельном* окне.
- "Вынести видео на панель" – откроет фрейм/страницу в режиме "embedded-плейер" в отдельном* окне.
* Тип окна зависит от версии браузера. По умолчанию это будет окно-"панель" (работает только в браузерах версий до CR63). Если ваш браузер не поддерживает такой тип окон, ссылка откроется в новом попап-окне.
Указанные выше пункты доступны только при включении расширенного меню страницы (по умолчанию).
При использовании сокращённого меню страницы будут доступны пункты (также зависят от контекста):
- "YTE: Смотреть видео по ссылке" – откроет ссылку под курсором в режиме "embedded-плейер".
- "YTE: Открыть фрейм в плейере" – откроет фрейм под курсором в режиме "embedded-плейер".
- "YTE: Открыть ссылку из текста" – откроет ссылку из выделенного текста в режиме "embedded-плейер".
Эта опция отсутствует, если выключена опция "Искать ссылки в выделенном тексте" (в группе настроек интерфейса)
Обратное переключение на "обычную" страницу в случае использования сокращённого меню производится на конечной открытой вкладке щелчком по кнопке на тулбаре.
Способ открытия ссылок и переходов определяется настройками опций интерфейса (доступны 3 вариации: в текущей вкладке или в новой активной/фоновой вкладке).
Контекстное меню страниц и ссылок
Кроме переключения режима плейера и открытия ссылок, фреймов или страниц YouTube, в контекстном меню доступны вспомогательные функции, связанные с просмотром или загрузкой видео, а также функции перехода с "обычной" версии сайта на мобильную (и обратно) и функции вызова подключаемого скрипта-загрузчика.
Эти функции также зависят от вызываемого контекста:
- "Смотреть/скачать по ссылке" – группа переходов на внешние сервисы (для ссылки под курсором).
- "Смотреть/скачать видео" – группа переходов на внешние сервисы (для фрейма/страницы).
- "Показать панель загрузчика" – включает и запускает скрипт панели загрузчика.
Отображается только на "обычных" страницах YouTube. Не используется для ссылок, отсутствует в мобильной версии и в режиме "embedded-плейер" (связано с ограничениями скрипта загрузчика в части получения ссылок с текущей страницы).
Пункт отсутствует, если включена настройка "Автоподключение панели загрузчика".
- "Перейти на мобильную версию" – переключает* "обычную" страницу на мобильный режим.
- "Перейти на desktop-версию" – переключает* мобильную страницу на "обычный" режим.
* Этот пункт не отображается, если включена настройка "Автопереход к мобильной версии".
Указанные выше пункты доступны только при включении расширенного меню страницы (по умолчанию).
При использовании сокращённого меню страницы будут доступны пункты (также зависят от контекста):
- "YTE: Смотреть/скачать : InVidious" – откроет ссылку на страницу под курсором в зеркале InVidious.
- "YTE: Скачать медиафайл : SaveFromNet" – откроет ссылку на видео под курсором в сервисе SaveFromNet.
Все внешние переходы в любом случае открываются в новой активной вкладке.
Меню переходов на внешние сервисы (блок опций "Смотреть/скачать")
Группа контекстного меню, вспомогательные переходы, связанные с просмотром или загрузкой видео на внешних сервисах, а также с проверкой региональной доступности конкретной ссылки или страницы.
Доступны во вложенном меню для соответствующего контекста под курсором (на скриншоте – для вкладки):
Название пунктов не зависит от текущего объекта под курсором (передаётся сам URL контекста):
- "Просмотр видео без ограничений" – переход на зеркало* c API InVidious (только просмотр).
- "Смотреть/скачать : InVidious / US" – переход на зеркало* c API InVidious (просмотр + загрузка).
- "Смотреть/скачать : InVidious / DE" – переход на зеркало* c API InVidious (просмотр + загрузка).
- "Смотреть/скачать : InVidious / EU" – переход на зеркало* c API InVidious (просмотр + загрузка).
- "Скачать медиафайл : SaveFromNet" – переход/поиск на сервисе SaveFromNet (просмотр + загрузка).
- "Загрузить видео/аудио : GetVideo" – переход/поиск на сервисе GetVideo (загрузка + конвертор MP3).
- "Доступность видео по регионам" – переход на сервис проверки региональной доступности контекста.
* Градация условная, региональная привязка и возможность загрузки медиа-файлов соответствует текущим сервисам по умолчанию, указана только для отличия при выборе пунктов меню. При необходимости предпочтительные зеркала могут быть найдены самостоятельно и переопределены с помощью соответствующей настройки.
Следует понимать, что все эти функции напрямую зависят от работоспособности сторонних сервисов!
Соответственно, любые проблемы их текущей доступности и функциональности никак не связаны с ошибками расширения.
Все пункты этой группы для отдельных элементов страницы (ссылки, фреймы и т.д.) доступны только при включении расширенного меню страницы (по умолчанию). В меню значка на тулбаре (браузеры версий CR48+) или в меню страницы (версии старше CR48) отображаются всегда и работают только применительно к URL текущей страницы.
Все внешние переходы в любом случае открываются в новой активной вкладке.
Настройки и опции просмотра видео (блок опций "Настройки просмотра")
Группа контекстного меню, настройки и действия, связанные с просмотром видео непосредственно на страницах сервиса YouTube, а также связанные с изменением отображения сайта (мобильный или "обычный" режим).
Доступны во вложенном меню (на скриншоте – для браузеров CR48+, для более старых – в меню страницы):
Название пунктов не зависит от текущего объекта под курсором, настройки применяются к сайту в целом.
В зависимости от версии браузера это меню содержит следующие опции и переключатели:
- "Видео-кодек: только MP4/H264" – ограничивает* автоматический выбор указанным форматом.
Если включено – плейер будет использовать только форматы потока MP4/H.264. Если выключено (по умолчанию) – для видео выбирается формат WEBM/VP9. Этот пункт отсутствует в настройках браузеров до CR48, не поддерживающих воспроизведение форматов MP4/H.264.
- "Видео-кодек: запретить WEBM/VP9" – ограничивает* автоматический выбор указанных форматов.
Если включено – плейер будет использовать только формат потока WEBM/VP8. Если выключено (по умолчанию) – для видео выбирается формат WEBM/VP9. Опция отсутствует в настройках браузеров CR48+ (с поддержкой MP4) и VP8-only браузерах (до CR36, нет поддержки VP9).
- "Видео-поток: не более 30 кадр/сек" – ограничивает* отдачу сервисом роликов с высоким фреймрейтом.
Если включено – скорость воспроизведения принудительно ограничивается частотой 30 кадров в секунду. Если выключено (по умолчанию) – кадровая частота устанавливается сервисом автоматически (до 60 кадров в секунду).
- "Авто-стоп плейера при загрузке" – автоматически останавливает* воспроизведение при загрузке страниц.
Если включено (по умолчанию) – при открытии страницы ролика его воспроизведение автоматически останавливается. Если выключено – используются стандартные настройки YouTube (по умолчанию ролик запускается сразу при загрузке).
- "Отключить буферизацию видео" – ограничивает возможность предзагрузки ролика, экономия трафика.
Если включено – при открытии страницы ролика предзагрузка в буфер запрещается для основного видео. Если выключено (по умолчанию) – используются стандартные настройки YouTube (размер буфера автоматически выбирается при загрузке).
- "Отключить автозапуск следующих" – отключает автовоспроизведение и автопереход к следующему видео.
Если включено – автопереход и автозапуск следующего видео блокируются безусловно. Если выключено (по умолчанию) – используются штатные настройки YouTube, при окончании проигрывания ролика переход к следующему видео происходит в зависимости от ранее сделанных настроек (вручную, на самом сайте).
- "Плейер во всю ширину страницы" – регулирует автовключение широкоформатного режима ("кинотеатр").
Если включено – размер окна фрейма плейера на странице ролика будет во всю ширину экрана (режим "кинотеатр"). Если выключено (по умолчанию) – используется стандартный размер фрейма. Состояние этой опции перекрывается нажатиями кнопки "Режим кинотеатра" на панели управления плейером (и наоборот, сохраняется* и отрабатывает ваше последнее действие, т.е. либо экранная кнопка, либо переключение опции в меню настроек).
* Если эта настройка включена, состояние этой опции проверяется и автоматически восстанавливается инжектором. В этом случае переключение режима кнопкой "Режим кинотеатра" на панели управления плейером будет работать только при переходах в пределах текущей вкладки и до её перезагрузки (или до открытия новой вкладки, т.е. включение опции в меню настроек имеет бо́льший приоритет).
- "Применять цветокоррекцию видео" – регулировка яркости, контраста, насыщенности и баланса цвета.
Применяется на лету, без перезагрузки текущей страницы. В дальнейшем включается автоматически, до изменения этой настройки. Актуально в браузерах, имеющих некорректную цветопередачу видео (в частности, на движках CR49).
Фильтр работает на всех страницах YouTube, включая мобильную версию и режим "embedded-плейера" (в т.ч. и на всех сторонних сайтах, на страницах которых присутствуют фреймы встраиваемого видео с YouTube).
Можно самостоятельной менять CSS фильтра, если не устраивают его параметры по умолчанию. Редактирование стиля доступно через пункт меню "Задать CSS цветовой коррекции" (в нижней части этой группы настроек).
- "Автопереключение на тёмную тему" – принудительная установка штатной "тёмной" темы сайта.
Если включено – при каждом открытии страниц сервиса производится проверка и принудительное включение "ночного режима". Если выключено (по умолчанию) – используются штатные настройки YouTube, установка темы происходит в зависимости от ранее сделанных настроек (вручную, на самом сайте).
- "Отключить загрузку комментариев" – скрывает и удаляет комментарии, ускоряет загрузку страниц.
Если включено – на страницах роликов (в т.ч. и в мобильной версии) применяется простейший фильтр скрытия и удаления "каментов". Если выключено (по умолчанию) – используются стандартные настройки YouTube (комментарии отображаются и подгружаются при прокрутке страницы).
- "Не выводить список рекомендуемых" – скрывает и удаляет этот блок, ускоряет загрузку страниц.
Если включено – на страницах роликов (в т.ч. и в мобильной версии) применяется простейший фильтр скрытия и удаления "саггестов". Если выключено (по умолчанию) – используются стандартные настройки YouTube (ссылки рекомендуемых видео отображаются и подгружаются при прокрутке страницы).
Эта опция также влияет на отображение рекомендуемых видео в режиме "embedded-плейера". При этом настройка работает "в паре" со следующей ("Показать рекомендуемые в плейере"), но имеет меньший приоритет. Если очистка "рекомендуемых" отключена, они выводятся в любом режиме работы страниц.
- "Показать рекомендуемые в плейере" – отменяет скрытие "рекомендуемых" в режиме "embedded-плейера".
Если включено – на страницах роликов в режиме "embedded-плейера" рекомендуемые видео (при паузе) отображаются всегда. Если выключено (по умолчанию) – ссылки рекомендуемых видео отображаются и подгружаются только если выключена настройка "Не выводить список рекомендуемых".
Эта опция также влияет на параметры ключей в URL переходов (применяются при вызове из меню для открытия ссылок в режиме "embedded-плейера").
Настройка сохраняется в куки и автоматически проверяется инжектором. Если эта опция включена – функция очистки блока "рекомендуемых" в режиме "embedded-плейера" игнорируется.
Эта опция недоступна для изменения, если выключена настройка "Не выводить список рекомендуемых". При этом "рекомендуемые" в режиме "embedded-плейера" выводятся в любом случае.
- "Безопасный режим просмотра видео" – включает тематическую и возрастную фильтрацию контента.
По умолчанию выключено. При включении задействует т.н. "детский режим" – фильтр контента, ограничивающий просмотр роликов с "чернухой и ужасами" и прочий "взрослый" контент.
При этом, если конкретный ролик заблокирован таким фильтром, на странице отображается сообщение "Видео недоступно. Чтобы посмотреть это видео, отключите безопасный режим."
Настройка сохраняется в куки и автоматически проверяется (и переустанавливается) инжектором. Если эта опция включена – её отключение средствами сайта YouTube действует только на период переходов в пределах вкладки и до её перезагрузки.
- "Автопереход к мобильной версии" – принудительный автопереход от "обычного" режима на мобильный.
Если включено – при каждом открытии страниц сервиса производится автоматический переход на мобильную версию. При этом открытие основной версии сайта будет блокировано до момента выключения этой опции (не относится к страницам в режиме "embedded-плейера"), независимо от способа вызова (из закладок, по ссылкам, из омнибокса и т.д.).
Если выключено (по умолчанию) – используются штатные настройки YouTube, в большинстве случаев страницы открываются в "обычном" режиме, но могут быть переключены на мобильный и обратно через контекстное меню страницы (пункты меню "Перейти на мобильную версию" или "Перейти на desktop-версию" соответственно).
- "Автоподключение панели загрузчика" – определяет способ вызова и запуска скрипта загрузчика.
Если включено – скрипт загружается и запускается автоматически при открытии любой "обычной" страницы YouTube. Если выключено (по умолчанию) – запуск загрузчика производится только вручную, посредством экранной "кнопки" в блоке проигрывателя или через контекстное меню страницы.
Если включено – в контекстном меню кнопки на тулбаре и/или в меню страницы будут отсутствовать опции, связанные с ручным запуском загрузчика ("Показать панель загрузчика").
- "Автоперезагрузка при изменениях" – производится при любых изменениях настроек просмотра.
Если включено – при переключении любой из настроек просмотра производится автоперезагрузка текущей страницы для немедленного применения изменённой опции настроек. Если выключено (по умолчанию) – настройки сохраняются сразу же, но будут применены только при следующей (пере)загрузке страницы.
Совет: для первоначальной настройки эту опцию желательно отключить, чтобы процесс настройки не прерывался перезагрузками страницы. В дальнейшем опцию можно включить, для оперативного применения разовых переключений.
- "Восстановить настройки в куки" – устранение проблем** после сброса/очистки куков на сайте YouTube.
При выборе этого пункта производится перезапись куки в соответствии со всеми текущими настройками и принудительное восстановление настроек загрузчика в локальном хранилище сайта. Для гарантированного применения настроек текущую страницу следует перезагрузить, чтобы скрипт инжектора "подхватил" все обновлённые установки.
Если в настройках включена опция "Автоперезагрузка при изменениях", текущая вкладка автоматически перезагружается для применения всех настроек сразу. Также принудительная перезагрузка текущей страницы всегда производится при полном сбросе всех настроек или при их восстановлении из резервной копии (при вызове соответствующих пунктов в сервисном меню, в этом случае пункт восстановления настроек вызывается фоновым скриптом автоматически).
- "Задать CSS цветовой коррекции" – правка CSS фильтра цветовой коррекции по умолчанию.
Частная настройка опционального фильтра цветовой коррекции видео (яркость/контраст/насыщенность/баланс). Может быть полезна в некоторых браузерах, имеющих некорректную цветопередачу видео (в частности, на движках CR49).
Сам фильтр включается пунктом меню "Применять цветокоррекцию видео" (в этой же группе настроек). После правки изменения отрабатываются на лету, без перезагрузки текущей страницы.
При вызове этого пункта меню открывается соответствующий диалог редактирования:
Доступные действия указаны в тексте диалога, читаем текст и правим, если не устраивают параметры по умолчанию.)
В окне ввода следует указывать только параметры фильтра, сам оператор фильтра (--webkit-filter, как и параметр !important) вводить НЕ нужно (приведёт к ошибке!). В случае, если "что-то пошло не так", в этом же диалоге можно сбросить настройку, введя цифру 0 или 1 (разница указана в пояснение в диалоге).
* Подробнее о работе и технических особенностях этих функций читаем в статье Особенности работы скрипта-инжектора.
** Для обеспечения корректной работы расширения помним про важное примечание по настройке браузера!
Все пункты этой группы доступны независимо от настроек меню страницы и всегда отображаются либо в меню значка на тулбаре (браузеры версий CR48+) либо в меню страницы (версии старше CR48). Эти настройки непосредственно влияют на работу скриптов инжектора* и применяются только на страницах сайта YouTube.
* В текущих версия расширения инжектор загружается и работает на любых страницах YouTube, включая мобильную версию сайта, embedded-плейер (и все фреймы с ним на сторонних сайтах), страницы каналов, списки и т.д.. Функциональность инжектора зависит от текущей страницы, часть функций в мобильной версии и в режиме "embedded-плейера" не задействуется – в частности, не требуется автостоп или функции очистки, также отсутствует панель управления загрузчиком (неприменимо).
Исходя из этого, все настройки, установленные в блоке "Настройки просмотра", применимы только на страницах сайта YouTube. Попытка изменения этих настроек (через контекстное меню) на любых вкладках, НЕ являющихся страницами YouTube, приведёт к выдаче сообщения об отказе выполнения действия.
Следует помнить, что все опции этих настроек также запоминаются в куках и локальном хранилище браузера и, соответственно, стираются при очистке/сбросе куков либо при очистке локального хранилища сайта YouTube. Кроме того, если куки отключены (или запрещены) в настройках браузера, эти настройки НЕ работают и НЕ применяются в принципе!
Состояние всех этих настроек запоминается в куках браузера сроком на 1 год, работает до следующего переключения (или до первой же очистки куков).
Для обеспечения корректной работы расширения учитываем важное примечание по настройке браузера!
Настройки и опции медиа-загрузчика (блок опций "Настройки загрузчика")
Группа контекстного меню, настройки и действия, связанные с функциями скрипта загрузки аудио и видео файлов непосредственно со страниц сервиса YouTube (подключаемый скрипт загрузчика).
Доступны во вложенном меню (на скриншоте – для браузеров CR48+, для более старых – в меню страницы):
Название пунктов не зависит от текущего объекта под курсором, настройки применяются к сайту в целом.
Вне зависимости от версии браузера это меню содержит следующие опции и переключатели:
- "Показать панель загрузчика" – включает и запускает скрипт панели загрузчика.
Действие аналогично описанному выше пункту "Показать панель загрузчика", вызывает запуск подключаемого загрузчика.
В браузерах версий CR48+ отображается в контекстном меню кнопки на тулбаре и применим только в контексте вкладки, текущая страница которой является "обычной" страницей сайта YouTube. Не работает для мобильной версии и в режиме "embedded-плейер" (связано с ограничениями скрипта загрузчика в части получения ссылок с текущей страницы).
В браузерах версий старше CR48+ отображается в контекстном меню страницы на сайте YouTube и только в случае использования сокращённого меню. Применим только в контексте текущей страницы, если она является "обычной" страницей сайта YouTube. В любом случае отсутствует на страницах в режиме "embedded-плейер" и в мобильной версии сайта (связано с ограничениями скрипта загрузчика в части получения ссылок с текущей страницы).
Этот пункт отсутствует в меню, если включена настройка "Автоподключение панели загрузчика".
- "Загрузчик YouTube Media Direct" – выбор скрипта, применяемого в качестве внешнего загрузчика.
Если включено – в качестве подключаемого загрузчика устанавливается скрипт "YouTube Media Direct" (будут доступны все настройки группы), если выключено – скрипт "YouTube Links" (неприменимые настройки блокируются от изменений).
Выбор скрипта зависит от текущей версии браузера. В движках до CR55 эта опция включается автоматически и не может быть изменена, в этих браузерах применение загрузчика "YouTube Media Direct" устанавливается безусловно (на скриншоте выше пример браузера на движке CR49). В браузерах CR55+ опция по умолчанию выключена, но доступна для изменения.
- "Автовывод форматов текущего ролика" – автоматически создаёт и отображает панель форматов.
Управляет параметром конфигурации загрузчика "showVideoFormats".
Если включено – панель форматов текущего ролика отображается автоматически, сразу же после загрузки скрипта. Если выключено (по умолчанию) – для отображения панели следует нажать экранную кнопку (зависит от выбранного скрипта, в "YouTube Media Direct" отображается справа от логотипа сайта перед строкой поиска) или повторно нажать "красную кнопку" (полоса в верхней части плейера основного видео).
- "Копировать название при щелчке ЛКМ" – копирует название ролика или URL выбранного медиа-файла.
Управляет параметром конфигурации загрузчика "copyToClipboard".
Если включено (по умолчанию) – при щелчке левой кнопкой мыши по любой из кнопок форматов на панели в буфер обмена копируется название текущего ролика. Если включена ещё и опция "Копировать название при щелчке ПКМ" – вместо названия ролика в буфер обмена копируется URL соответствующего медиа-файла (только для "YouTube Media Direct").
Если щелчок выполняется по кнопке формата 22 (720p/MP4), вместо копирования вызывается диалог сохранения файла, имя подставляется автоматически (по названию ролика, может быть изменено вручную перед сохранением). Это связано с особенностью обработки на YouTube ссылок именно этого формата.
- "Копировать название при щелчке ПКМ" – копирует название ролика для вставки при сохранении файла.
Управляет* параметром конфигурации загрузчика "copyOnRightClick".
Если включено (по умолчанию) – при щелчке правой кнопкой мыши по любой из кнопок форматов на панели перед вызовом стандартного контекстного меню браузера в буфер обмена автоматически копируется название текущего ролика.
- "Открыть медиа-файл двойным щелчком" – открывает медиа-файл в новой вкладке браузера.
Управляет* параметром конфигурации загрузчика "doubleClickOpen".
Если включено (по умолчанию) – при двойном щелчке левой кнопкой мыши по любой из кнопок форматов на панели выполняется попытка открытия выбранного медиа-файла в новой вкладке (в некоторых браузерах вместо этого вызывается диалог сохранения файла).
- "Показывать размер всех медиа-файлов" – включает полноразмерную панель форматов.
Управляет параметром конфигурации загрузчика "showVideoSize". Включение немного замедляет работу скрипта.
Если включено (по умолчанию) – под кнопками форматов на панели будет отображаться размер файлов. Если выключено – каждый формат отображается в панели только кнопкой с его названием.
При выключении опции панель становится более компактной (уменьшается вдвое по высоте). При выборе предпочтительного вида панели следует помнить, что размер файла также указан в подсказке к каждой кнопке.
- "Отображать сведения о медиа-файле" – вывод в подсказке информации о кодеках, битрейте и т.д..
Управляет параметром конфигурации загрузчика "tagLinks". Включение немного замедляет работу скрипта.
Если включено (по умолчанию) – в подсказках к кнопкам форматов отображаются все доступные сведения о загружаемых файлах (код формата в терминологии YouTube, видео и/или аудио кодеки, средний битрейт, размер файла).
- "Десятичный размер вместо бинарного" – выбор единицы измерения размера файлов.
Управляет параметром конфигурации загрузчика "useDecUnits".
Если включено (по умолчанию) – для расчёта и отображения размеров медиа-файлов используются "привычные" кило- и мегабайты (10n). Если выключено – используются "новомодные" киби- и мебибайты (2n*10). О различиях между этими единицами можно прочитать здесь.
- "Показывать все недоступные форматы" – отображает форматы с ошибками доступа.
Управляет* параметром конфигурации загрузчика "showErrorFormats".
Если включено – в панели будут отображаться форматы с ошибками доступа (зависит от конкретного ролика). Если выключено (по умолчанию) – на панель будут выведены только однозначно определяемые и доступные для загрузки файлы.
- "Показывать только заданные форматы" – персональное ограничение списка вывода.
Управляет** параметром конфигурации загрузчика "filteredFormats".
Если список пуст (по умолчанию) – на панели отображаются все доступные форматы текущего ролика. При щелчке по этой опции выводится диалог для установки собственного списка желаемых форматов:
Доступные действия указаны в тексте диалога, читаем текст и правим, если не устраивают параметры по умолчанию.)
В окне ввода следует указывать только допустимые параметры фильтра (некорректные значения не приведут к ошибке, но увеличат время обработки). В этом же диалоге можно сбросить настройку, введя любой одиночный символ или оставив строку списка пустой.
Если определён пользовательский список форматов (непустой) – этот пункт будет отмечен "галочкой" как "включенный". При сбросе списка эта отметка снимается.
- "Всегда показывать указанные форматы" – список форматов, обязательных для вывода.
Управляет** параметром конфигурации загрузчика "keepFormats".
Если список пуст (по умолчанию) – на панели отображаются все доступные форматы текущего ролика. При щелчке по этой опции выводится диалог для установки собственного списка обязательных форматов:
Доступные действия указаны в тексте диалога, читаем текст и правим, если не устраивают параметры по умолчанию.)
В окне ввода следует указывать только допустимые параметры фильтра (некорректные значения не приведут к ошибке, но увеличат время обработки). В этом же диалоге можно сбросить настройку, введя любой одиночный символ или оставив строку списка пустой.
Если определён пользовательский список форматов (непустой) – этот пункт будет отмечен "галочкой" как "включенный". При сбросе списка эта отметка снимается.
- "Сбросить все настройки загрузчика" – установка конфигурации загрузка по умолчанию.
При вызове этого пункта все настройки загрузчика сбрасываются и производится их удаление из локального хранилища сайта. При следующем запуске загрузчик автоматически установит параметры по умолчанию (независимо от выбранного скрипта).
В целях защиты от случайного удаления настроек потребуется подтвердить выполнение этого действия:
* Эта опция неприменима к загрузчику "YouTube Links" и будет заблокирована от изменений при его выборе.
** Работоспособность этой функции зависит от конкретного ролика. На практике установка таких списков не имеет особого смысла. Тем не менее, опция оставлена исключительно для полноты интеграции расширения с любым из загрузчиков.
Все пункты этой группы доступны независимо от настроек меню страницы и всегда отображаются либо в меню значка на тулбаре (браузеры версий CR48+) либо в меню страницы (версии старше CR48). Эти настройки непосредственно влияют на работу скрипта загрузчика* и применяются только на страницах сайта YouTube.
* В текущих версия расширения скрипт загрузчика вызывается и работает только на страницах основного сайта YouTube. В мобильной версии сайта и в режиме embedded-плейер (включая все фреймы с ним на сторонних сайтах) загрузчик не подключается и не задействуется.
Исходя из этого, все настройки, установленные в этой группе, применимы только на страницах сайта YouTube. Попытка изменения этих настроек (через контекстное меню) на любых вкладках, НЕ являющихся страницами YouTube, приведёт к выдаче сообщения об отказе выполнения действия.
Следует помнить, что все параметры этих настроек запоминаются в локальном хранилище сайта и, соответственно, стираются при очистке локального хранилища сайта YouTube. В таких случаях следует восстановить настройки, используя пункт "Восстановить настройки в куки" в меню настроек просмотра.
Общие настройки интерфейса расширения (блок опций "Настройки интерфейса")
Группа контекстного меню, настройки и действия, связанные с обработкой внешних ссылок (параметры открытия вкладок), а также связанные с самостоятельным изменением некоторых встроенных параметров расширения.
Доступны во вложенном меню (на скриншоте – для браузеров CR48+, для более старых – в меню страницы):
Название пунктов не зависит от текущего объекта под курсором, настройки применяются к аддону в целом.
В зависимости от версии браузера это меню содержит следующие опции и переключатели:
- "Использовать контекстное меню" – включает меню на любых ссылках/фреймах с YouTube-роликами.
Если включено (по умолчанию) – контекстное меню страницы доступно на любых ссылках/фреймах с YouTube-роликами на любых страницах (не только на самом YouTube). Если выключено – связанные настройки недоступны для изменения. Этот пункт отсутствует в настройках для браузеров версий старше CR48, в них контекстное меню страницы неотключаемое.
- "Расширенное контекстное меню" – определяет содержимое контекстного меню страницы.
Если включено (по умолчанию) – в контекстном меню страницы доступны все функции. Если выключено – будут доступны только наиболее часто используемые функции – просмотр ссылок/фреймов в новой вкладке и скачивание текущего просматриваемого видео.
- "Открывать ссылки в новой вкладке" – определяет способ открытия переходов по ссылкам.
По умолчанию включено, все действия, связанные с открытием ссылок, выполняются в новой вкладке. Если выключено – ссылка/фрейм с видео будет открыта в текущей вкладке. Опция влияет только на открытие ссылок, переключение режима страницы YouTube-ролика всегда производится в текущей вкладке. Все сторонние сервисы загрузки файлов и просмотра заблокированного видео всегда открываются в новой активной вкладке.
- "Открывать ссылки в фоновой вкладке" – определяет активность открываемой новой вкладки.
Работает только если включена предыдущая опция. Если выключено – ссылка/фрейм будет открыта в новой активной вкладке. Опция влияет только на открытие ссылок, переключение режима страницы YouTube-ролика всегда производится в текущей вкладке.
- "Искать ссылки в выделенном тексте" – разрешает поиск/обработку ссылок в выделенном.
Работает на любых страницах для любого выделенного фрагмента текста. Если во фрагменте текста есть корректная ссылка на YouTube-ролик – она будет распознана и открыта, иначе будет выдано сообщение об ошибке.
Если эта опция выключена (по умолчанию) – в контекстном меню страницы будет отсутствовать пункт, связанный с обработкой выделенного текста ("Открыть ссылку из текста")
- "Использовать быструю выгрузку" – обеспечивает незамедлительную выгрузку фонового скрипта.
Если включено (по умолчанию) – фоновый скрипт выгружается сразу же после завершения любого действия или изменения любой настройки. Если выключено – выгрузка фонового скрипта производится браузером автоматически (в зависимости от браузера, порядка 5-10 секунд после выполнения действия).
Включение опции сокращает расход текущей используемой памяти. При интенсивной работе с настройками или частом вызове функций имеет смысл отключить эту настройку.
- "Изменить список серверов InVidious" – правка списка внешних видео-зеркал по умолчанию.
Позволяет изменить список внешних зеркал, работающих с API InVidious и применяемых для просмотра и загрузки роликов через эти сервисы (4 сервера, первые 4 пункта меню в группе опций "Смотреть/скачать").
Эти серверы работают с любым контентом с YouTube, имеют гораздо более "лёгкий" и простой интерфейс страниц, облегчающий просмотр. На большей части серверов также доступна загрузка просматриваемых роликов в различных форматах видео и аудио.
При вызове этого пункта меню открывается соответствующий диалог редактирования:
Доступные действия указаны в тексте диалога, внимательно читаем текст и правим.)
В диалоге редактирования также есть возможность перехода на страницы списков актуальных зеркал InVidious. Эта "фича" может быть полезна для оперативного самостоятельного выбора наиболее подходящих зеркал (по геолокации, скорости доступа и т.д.).
Все пункты этой группы доступны независимо от настроек меню страницы (упрощённый или расширенный) и всегда отображаются либо в меню значка на тулбаре (браузеры версий CR48+) либо в меню страницы (версии старше CR48). Эти настройки непосредственно влияют на перестроение контекстного меню и на действия со вкладками и никак не связаны с URL текущей вкладки (применимы только к самому расширению).
Исходя из того, все настройки, установленные в этом блоке, в браузерах версий CR48+ могут изменяться на любых страницах. В браузерах версий старше CR48 меню отображается только на страницах сайта YouTube, соответственно, переключение опций и выполнение действий возможно только на вкладках этого сайта.
Дополнительные сервисные функции (блок опций "Сервисные функции")
Группа контекстного меню, содержит действия, связанные с копированием, сбросом и восстановлением настроек, а также с проверкой текущей актуальной версии расширения. Эти действия влияют на перестроение контекстного меню, на действия со вкладками и на работу скриптов инжектора.
Доступны во вложенном меню (на скриншоте – для браузеров CR48+, для более старых – в меню страницы):
Название пунктов не зависит от текущего объекта под курсором, опции применяются к аддону в целом.
Это подменю содержит следующие опции и переключатели:
- "Резервная копия настроек в файл" – сохраняет все настройки в файл формата JSON.
При вызове этого пункта меню открывается стандартный диалог сохранения файла.
Имя файла устанавливается автоматически и может быть произвольно изменено при сохранении.
- "Восстановить настройки из файла" – восстанавливает настройки из файл резервной копии.
Восстановление настроек выполняется путём копирования/вставки всего содержимого файла бэкапа в соответствующем диалоговом окне.
При вызове этого пункта меню открывается диалог восстановления настроек:
Доступные действия указаны в тексте диалога, внимательно читаем текст и делаем.)
- "Сброс всех настроек по умолчанию" – сбрасывает все настройки в значения по умолчанию.
Сброс настроек может быть полезен, если вы "хотите начать всё сначала".)
Во избежание случайностей перед сбросом настроек потребуется подтвердить это действие:
После сброса или восстановления настроек будет произведена попытка автоматической переустановки параметров на сайте YouTube (если он открыт в текущей вкладке). В противном случае выдаётся напоминание о необходимости их ручной переустановки (выбором пункта "Восстановить настройки в куки" в блоке "Настройки просмотра").
- "Перезагрузить/обновить в DevMode" – ручная перезагрузка расширения.
Для оперативности и удобства при самостоятельных доработках исходного кода. Исходя из названия, присутствует только при установке расширения в режиме разработчика, при использовании официальных авторских установочных пакетов не отображается.
- "Проверить и скачать обновление" – открывает ссылку на ченч-лог текущей авторской версии.
Ссылка обновляется (на сайте) динамически, поэтому переход всегда будет выполнен на текущую актуальную версию расширения, независимо от его версии, установленной в вашем браузере.
Все пункты этой группы доступны независимо от настроек меню страницы и всегда отображаются либо в меню значка на тулбаре (браузеры версий CR48+) либо в меню страницы (версии старше CR48).
Меню справочных ссылок (блок опций "Справка и поддержка")
Группа контекстного меню, содержит ссылочные переходы на страницы этого сайта. Предназначена для оперативной помощи пользователю в ознакомлении с технической документацией по расширению.
Пункты группы доступны во вложенном меню (на скриншоте – меню значка на тулбаре):
Название пунктов не зависит от текущего объекта под курсором, это обычные статические ссылки.
Конечная точка перехода понятна из названия соответствующего пункта меню этой группы.
Все пункты этой группы доступны независимо от настроек меню страницы и всегда отображаются либо в меню значка на тулбаре (браузеры версий CR48+) либо в меню страницы (версии старше CR48).
Работа с панелью медиа-загрузчика
Одна из функций скрипта инжектора – подключение, запуск и отображение панели загрузки медиа-файлов. Загрузчик работает непосредственно с контентом текущей страницы сервиса, определяет и отображает в виде экранных "кнопок" прямые ссылки на доступные для скачивания файлы в форматах видео и аудио.
Для выполнения этих действий вручную инжектор отрисовывает экранную "кнопку" управления:
- Кнопка отображается только на "обычных" страницах, в мобильной версии и в режиме "embedded" отсутствует.
- Кнопка отображается в виде полосы красного цвета в верхней части видео (5рх, только при наведении курсора).
- Все доступные действия для этой кнопки указаны во всплывающей подсказке (пример на скриншоте выше).
- При некорректной работе панели загрузки её можно перезапустить, щёлкнув по "кнопке" с зажатой клавишей Shift.
В особо "клинических" случаях достаточно просто перезагрузить страницу целиком.
Кроме вызова загрузчика, эта кнопка задействует:
- Переход на embedded-плейер c автозапуском воспроизведения с текущей позиции видео (Ctrl+Shift+щелчок).
- Режим открепления проигрывателя – "плавающий* плейер", всегда виден при прокрутке (Ctrl+щелчок).
* "Плавание" сохраняется до перезагрузки страницы, при этом панель загрузок также "плавает" синхронно.
Открепление доступно только при выключенном широкоэкранном режиме (т.е. НЕ в режиме "кинотеатр", установленном либо на самом сайте соответствующей кнопкой, либо опцией "Плейер во всю ширину страницы"). Соответственно меняется и подсказка к "кнопке" активации загрузчика (эта строчка в широкоэкранном режиме будет отсутствовать).
Для лучшего восприятия цвет "кнопки" меняется в зависимости от зажатых клавиш (жёлтый/синий/оранжевый).
При переходах в пределах вкладки перерисовка кнопки не требуется, но саму панель загрузки придётся вызывать повторно. Также, после первого же вызова панели, навигация во вкладке будет с её перезагрузкой – это не баг, это "фича" самого YouTube.)
Кроме указанного выше способа вызова, доступен как ручной вызов загрузчика через контекстное меню, так и его автоподключение при просмотре любой страницы YouTube (переключатель "Автоподключение панели загрузчика" в блоке "Настройки интерфейса"). Если эта опция выключена (по умолчанию), соответствующие пункты отображаются в контекстном меню страниц, ссылок, фреймов (пункт "Показать панель загрузчика") и в общем меню значка на тулбаре (аналогичный пункт в группе "Настройки загрузчика", присутствует только в браузерах версий CR48+).
В текущей версии расширения панель загрузки выглядит как группа экранных кнопок:
В панели отображаются доступные форматы файлов, набор форматов зависит от конкретного ролика.
Для браузеров версий CR55+ в качестве внешнего загрузчика по умолчанию используется скрипт YouTube Links (оригинальный, с сайта GreasyFork.org). При желании в настройках можно изменить его на  YouTube Media Direct (сжатая копия текущей версии).
Для браузеров версий старше CR55 выбор исключён, скрипт "YouTube Media Direct" устанавливается в качестве загрузчика автоматически и безальтернативно (переключение в меню недоступно).
Различие связано с тем, что оригинальный скрипт "YouTube Links" содержит JS-операторы стандарта ES6, не работающие в браузерах версий старше CR55. Функционально результат работы обоих скриптов абсолютно одинаков, получаемые прямые ссылки на медиа-файлы идентичны в любой версии браузера.
Для лучшего понимания возможностей и способов работы с панелью загрузчика рекомендуется ознакомиться с авторской документацией по этим скриптам (доступна по указанным ссылкам на них).
Следует помнить, что на достаточно слабых компьютерах медиа-загрузчик может дополнительно замедлять работу браузера, особенно – если в настройках НЕ отключён* вывод "рекомендуемых видео".
* Скрипт загрузчика автоматически обрабатывает ВСЕ видеофрагменты в этом блоке при их подгрузке. Кроме того, скрипт загрузчика автоматически пересчитывает ссылки на медиафайлы при переходах по сайту в пределах вкладки. Таким образом, если функция загрузки используется лишь изредка, опцию автозапуска загрузчика желательно оставить выключенной (установка по умолчанию) и использовать его вызов через контекстное меню только по необходимости.
Ссылки для интересующихся
| 
Бармалей · 25.10.2022 · 00:01 ••• Обновление: 20.11.2022 · 14:12
0