Skip to content

Releases: aste2d/youtube-immersive

YouTube Immersive Player

Choose a tag to compare

@aste2d aste2d released this 21 Oct 16:14
d6b34f8

Install

Changelog

Now works on low resolution videos.

image1

Added support for theatre mode.

image2

Fixed chapter button issue
image3

How to configure(English / 简体中文 / 日本語)


How to configure (English)

Where: Open the installed userscript in your userscript manager (Tampermonkey → Dashboard → click the script name).
At the top of the file you’ll find a centralized CONFIG block.

How: Change true / false, then Save. No new shortcuts are added; defaults preserve previous behavior.

const CONFIG = {
  ENABLE_INLINE_RECS: true,              // immersive right panel
  ALLOW_RIGHT_ON_NORMAL: true,           // show drawer in normal mode
  ALLOW_RIGHT_ON_THEATER: true,          // show drawer overlay in theater (non-fullscreen)

  TOGGLE_WITH_MMB_ON_VIDEO: true,        // middle-click on video toggles drawer (non-fullscreen)
  TOGGLE_WITH_V_KEY: true,               // press V toggles drawer (ignored in inputs/comments)
  OPEN_RIGHT_ON_CHAPTER_BUTTON: true,    // clicking .ytp-chapter-title.ytp-button toggles drawer

  AUTO_HIDE_SECONDARY_ON_LEAVE: true,    // auto-collapse when leaving the drawer
  KEEP_SECONDARY_WHEN_OVER_POPUP: true,  // don't collapse when entering popup menus

  HIDE_PLAY_PAUSE_BEZEL: true,           // hide large Play/Pause bezel
  HIDE_ALL_BEZELS: false,                // hide all bezels (aggressive)

  FIX_POPUP_MENU_ON_TOP: true,           // raise popup z-index above the drawer

  MMB_ACTS_AS_V_IN_FULLSCREEN: true      // in fullscreen: MMB outside recommendations -> block default & simulate native "V"
};

Examples

  • Keep the drawer open while using the three-dot menu: keep KEEP_SECONDARY_WHEN_OVER_POPUP: true.
  • Disable auto-collapse completely: set AUTO_HIDE_SECONDARY_ON_LEAVE: false.
  • Hide every overlay icon, not just Play/Pause: set HIDE_ALL_BEZELS: true.
  • If another extension manages z-index: set FIX_POPUP_MENU_ON_TOP: false.
  • Don’t want MMB behavior in fullscreen: set MMB_ACTS_AS_V_IN_FULLSCREEN: false.
  • Prefer not to toggle via chapter title button: set OPEN_RIGHT_ON_CHAPTER_BUTTON: false.

如何进行设置(简体中文)

位置: 在用户脚本管理器中打开脚本(Tampermonkey → 控制面板 → 点击脚本名称)。
文件顶部有集中式的 CONFIG 配置区。

方式:true / false 改为所需的值后保存。不会新增快捷键;默认行为与以往版本保持一致。

const CONFIG = {
  ENABLE_INLINE_RECS: true,              // 启用沉浸式右侧推荐栏
  ALLOW_RIGHT_ON_NORMAL: true,           // 普通模式显示右侧抽屉
  ALLOW_RIGHT_ON_THEATER: true,          // 剧场模式(非全屏)覆盖式显示抽屉

  TOGGLE_WITH_MMB_ON_VIDEO: true,        // 非全屏:对视频中键切换抽屉
  TOGGLE_WITH_V_KEY: true,               // 按 V 切换抽屉(输入/评论中无效)
  OPEN_RIGHT_ON_CHAPTER_BUTTON: true,    // 点击 .ytp-chapter-title.ytp-button 切换抽屉

  AUTO_HIDE_SECONDARY_ON_LEAVE: true,    // 鼠标移出抽屉自动折叠
  KEEP_SECONDARY_WHEN_OVER_POPUP: true,  // 移入弹出菜单时不折叠

  HIDE_PLAY_PAUSE_BEZEL: true,           // 隐藏“播放/暂停”大图标
  HIDE_ALL_BEZELS: false,                // 隐藏所有 overlay(更激进)

  FIX_POPUP_MENU_ON_TOP: true,           // 提升弹层层级到抽屉之上

  MMB_ACTS_AS_V_IN_FULLSCREEN: true      // 全屏:中键点非推荐元素→ 阻止默认并模拟原生“V”
};

常见场景

  • 操作“三点更多”菜单时不让抽屉收起:保留 KEEP_SECONDARY_WHEN_OVER_POPUP: true
  • 完全关闭自动折叠:将 AUTO_HIDE_SECONDARY_ON_LEAVE 设为 false
  • 不只屏蔽播放/暂停,而是全部图标:将 HIDE_ALL_BEZELS 设为 true
  • 若由其他扩展管理层级:将 FIX_POPUP_MENU_ON_TOP 设为 false
  • 不希望全屏下中键触发原生 V:将 MMB_ACTS_AS_V_IN_FULLSCREEN 设为 false
  • 不想通过章节标题按钮切换:将 OPEN_RIGHT_ON_CHAPTER_BUTTON 设为 false

設定方法(日本語)

場所: ユーザースクリプトマネージャでスクリプトを開く(Tampermonkey → ダッシュボード → スクリプト名)。
ファイル先頭に集中管理された CONFIG セクションがあります。

方法: true / false を必要に応じて変更し、保存します。新しいショートカットは追加されず、既定の挙動は従来どおりです。

const CONFIG = {
  ENABLE_INLINE_RECS: true,              // 右側の没入型パネルを有効化
  ALLOW_RIGHT_ON_NORMAL: true,           // 通常モードで右ドロワーを表示
  ALLOW_RIGHT_ON_THEATER: true,          // シアターモード(非全画面)でオーバーレイ表示

  TOGGLE_WITH_MMB_ON_VIDEO: true,        // 非全画面:動画上の中クリックで切替
  TOGGLE_WITH_V_KEY: true,               // V キーで切替(入力/コメント中は無効)
  OPEN_RIGHT_ON_CHAPTER_BUTTON: true,    // .ytp-chapter-title.ytp-button クリックで切替

  AUTO_HIDE_SECONDARY_ON_LEAVE: true,    // #secondary から離れたら自動折りたたみ
  KEEP_SECONDARY_WHEN_OVER_POPUP: true,  // ポップアップへ入る場合は折りたたまない

  HIDE_PLAY_PAUSE_BEZEL: true,           // 大きい再生/一時停止ベゼルを非表示
  HIDE_ALL_BEZELS: false,                // すべてのベゼルを非表示(強力)

  FIX_POPUP_MENU_ON_TOP: true,           // ポップアップの z-index をドロワーより前面に

  MMB_ACTS_AS_V_IN_FULLSCREEN: true      // 全画面:おすすめ以外での中クリック→ デフォルト無効 & 原生「V」を送信
};

よくある調整

  • 三点メニュー操作中にドロワーを閉じない:KEEP_SECONDARY_WHEN_OVER_POPUP: true のまま。
  • 自動折りたたみを無効化:AUTO_HIDE_SECONDARY_ON_LEAVE: false
  • 再生/一時停止だけでなく全オーバーレイを消す:HIDE_ALL_BEZELS: true
  • 別拡張が重なり順を管理する場合:FIX_POPUP_MENU_ON_TOP: false
  • 全画面での中クリック挙動を無効にしたい:MMB_ACTS_AS_V_IN_FULLSCREEN: false
  • 章タイトルボタンで切替したくない:OPEN_RIGHT_ON_CHAPTER_BUTTON: false

YouTube Immersive Player

Choose a tag to compare

@aste2d aste2d released this 18 Oct 04:10
72e262a

YouTube Immersive Player v1.48

Release date: 2025-10-18

Changelog (since v1.45)

Added

  • Centralized CONFIG (feature toggles). Behavior is now user-configurable via flags:
    • ENABLE_INLINE_RECS – immersive right panel (default ON)
    • ALLOW_RIGHT_ON_NORMAL – show right panel in normal mode (ON)
    • TOGGLE_WITH_MMB_ON_VIDEO – middle-click video to toggle panel (ON)
    • TOGGLE_WITH_V_KEY – press V to toggle panel (ON)
    • AUTO_HIDE_SECONDARY_ON_LEAVE – auto-collapse on mouse leave (ON)
    • KEEP_SECONDARY_WHEN_OVER_POPUP – do not collapse when moving into popup menus (ON)
    • HIDE_PLAY_PAUSE_BEZEL – hide the large Play/Pause bezel (ON)
    • HIDE_ALL_BEZELS – hide all bezels (OFF)
    • FIX_POPUP_MENU_ON_TOP – raise popup z-index above the right panel (ON)
  • Targeted bezel suppression (Play/Pause only) using aria-label matching in English and Chinese, with fallbacks.

Changed

  • Restructured comments and code sections for clarity (styles, masthead height, popup detection, interactions, init, observers).
  • CSS is now assembled from flags; STYLE_ID bumped to avoid stale style injections.
  • Defaults preserve v1.45 behavior; no new shortcuts.

Fixed

  • Three-dot menu being covered by the right panel. Popup containers (ytd-popup-container, tp-yt-iron-dropdown, ytd-menu-popup-renderer) now render above #secondary.
  • Large Play/Pause icon flashing on spacebar/left-click. Hidden by default via HIDE_PLAY_PAUSE_BEZEL.
  • Right panel collapsing when moving the cursor from #secondary into the menu. The panel now stays open when entering popup/menu areas (e.g., #contentWrapper) using event.composedPath() and ancestor checks.

How to configure (English)

Where: open the installed userscript in your userscript manager (Tampermonkey → Dashboard → click the script name).
At the top of the file you’ll find a centralized CONFIG block.

How: change true / false, then Save. No new shortcuts are added; defaults preserve v1.45 behavior.

const CONFIG = {
  ENABLE_INLINE_RECS: true,            // immersive right panel
  ALLOW_RIGHT_ON_NORMAL: true,         // show panel in normal mode
  TOGGLE_WITH_MMB_ON_VIDEO: true,      // middle-click video toggles panel
  TOGGLE_WITH_V_KEY: true,             // press V toggles panel

  AUTO_HIDE_SECONDARY_ON_LEAVE: true,  // auto-collapse when leaving the panel
  KEEP_SECONDARY_WHEN_OVER_POPUP: true,// don't collapse when entering popup menus

  HIDE_PLAY_PAUSE_BEZEL: true,         // hide large Play/Pause bezel
  HIDE_ALL_BEZELS: false,              // hide all bezels (aggressive)

  FIX_POPUP_MENU_ON_TOP: true          // raise popup z-index above the panel
};

Examples:

  • Keep panel open while using the three-dot menu: keep KEEP_SECONDARY_WHEN_OVER_POPUP: true.
  • Disable auto-collapse completely: set AUTO_HIDE_SECONDARY_ON_LEAVE: false.
  • Hide every overlay icon, not just Play/Pause: set HIDE_ALL_BEZELS: true.
  • If another extension manages z-index: set FIX_POPUP_MENU_ON_TOP: false.

如何进行设置(简体中文)

位置:在用户脚本管理器中打开脚本(Tampermonkey → 控制面板 → 点击脚本名称)。
在文件顶部可以看到集中式的 CONFIG 开关区。

方式:将 true / false 改为你需要的值,然后保存。不会新增快捷键;默认行为与 v1.45 保持一致。

const CONFIG = {
  ENABLE_INLINE_RECS: true,            // 启用沉浸式右侧推荐栏
  ALLOW_RIGHT_ON_NORMAL: true,         // 普通模式显示右栏
  TOGGLE_WITH_MMB_ON_VIDEO: true,      // 中键点击视频切换右栏
  TOGGLE_WITH_V_KEY: true,             // 按 V 切换右栏

  AUTO_HIDE_SECONDARY_ON_LEAVE: true,  // 鼠标移出右栏自动折叠
  KEEP_SECONDARY_WHEN_OVER_POPUP: true,// 移向弹出菜单时不折叠

  HIDE_PLAY_PAUSE_BEZEL: true,         // 隐藏“播放/暂停”大图标
  HIDE_ALL_BEZELS: false,              // 隐藏所有 bezel(更激进)

  FIX_POPUP_MENU_ON_TOP: true          // 提升弹层层级到右栏之上
};

常见场景:

  • 操作“三点更多”菜单时不让右栏收起:保持 KEEP_SECONDARY_WHEN_OVER_POPUP: true
  • 完全关闭自动折叠:将 AUTO_HIDE_SECONDARY_ON_LEAVE 设为 false
  • 不只屏蔽播放/暂停,而是全部提示:将 HIDE_ALL_BEZELS 设为 true
  • 若由其他扩展控制层级:将 FIX_POPUP_MENU_ON_TOP 设为 false

設定方法(日本語)

場所:ユーザースクリプトマネージャでスクリプトを開く(Tampermonkey → ダッシュボード → スクリプト名)。
ファイル先頭に CONFIG セクションがあります。

方法:true / false を必要に応じて変更し、保存します。新しいショートカットは追加されません。既定値は v1.45 の挙動を維持します。

const CONFIG = {
  ENABLE_INLINE_RECS: true,            // 右側の没入型パネルを有効化
  ALLOW_RIGHT_ON_NORMAL: true,         // 通常モードで右パネルを表示
  TOGGLE_WITH_MMB_ON_VIDEO: true,      // 動画の中クリックで切替
  TOGGLE_WITH_V_KEY: true,             // V キーで切替

  AUTO_HIDE_SECONDARY_ON_LEAVE: true,  // パネルから離れたら自動で折りたたみ
  KEEP_SECONDARY_WHEN_OVER_POPUP: true,// ポップアップに入る場合は折りたたまない

  HIDE_PLAY_PAUSE_BEZEL: true,         // 大きい再生/一時停止ベゼルを非表示
  HIDE_ALL_BEZELS: false,              // すべてのベゼルを非表示(強力)

  FIX_POPUP_MENU_ON_TOP: true          // ポップアップを右パネルより前面に
};

よくある調整:

  • 三点メニュー操作中に右パネルを閉じない:KEEP_SECONDARY_WHEN_OVER_POPUP: true のまま。
  • 自動折りたたみを無効化:AUTO_HIDE_SECONDARY_ON_LEAVE: false
  • 再生/一時停止だけでなく全オーバーレイを消す:HIDE_ALL_BEZELS: true
  • 別の拡張が重なり順を管理する場合:FIX_POPUP_MENU_ON_TOP: false

YouTube Immersive Player v1.45

Choose a tag to compare

@aste2d aste2d released this 16 Oct 17:36
6cc1ce1