Skip to content

YouTube Immersive Player

Latest

Choose a tag to compare

@aste2d aste2d released this 21 Oct 16:14
· 43 commits to main since this release
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