Releases: aste2d/youtube-immersive
Release list
YouTube Immersive Player
Install
Changelog
Now works on low resolution videos.
Added support for theatre mode.
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
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-labelmatching 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_IDbumped 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
#secondaryinto the menu. The panel now stays open when entering popup/menu areas (e.g.,#contentWrapper) usingevent.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
First public release.
Install: https://raw.githubusercontent.com/AsterHours/youtube-immersive-player/main/youtube-immersive-player.user.js
