mpv-player · sfan5 · Feb 17, 2025 · Jan 19, 2025 · Feb 3, 2025 · Feb 4, 2025
diff --git a/DOCS/interface-changes/console-menu.txt b/DOCS/interface-changes/console-menu.txt
@@ -0,0 +1 @@
+add `console-background_alpha` `console-menu_outline_size` `console-menu_outline_color` `console-corner_radius` `console-selected_color` and `console-selected_back_color` script-opts
diff --git a/DOCS/man/console.rst b/DOCS/man/console.rst
@@ -100,9 +100,6 @@ Shift+TAB
 Ctrl+l
     Clear all log messages from the console.
 
-MBTN_RIGHT
-    Hide the console.
-
 MBTN_MID
     Paste text (uses the primary selection on X11 and Wayland).
 
@@ -169,6 +166,32 @@ Configurable Options
 
     Set the font border size used for the REPL and the console.
 
+``background_alpha``
+    Default: 20
+
+    The transparency of the menu's background. Ranges from 0 (opaque) to 255
+    (fully transparent).
+
+``padding``
+    Default: 10
+
+    The padding of the menu.
+
+``menu_outline_size``
+    Default: 0
+
+    The size of the menu's border.
+
+``menu_outline_color``
+    Default: #FFFFFF
+
+    The color of the menu's border.
+
+``corner_radius``
+    Default: 8
+
+    The radius of the menu's corners.
+
 ``margin_x``
     Default: same as ``--osd-margin-x``
 
@@ -185,6 +208,16 @@ Configurable Options
     Whether to scale the console with the window height. Can be ``yes``, ``no``,
     or ``auto``, which follows the value of ``--osd-scale-by-window``.
 
+``selected_color``
+    Default: ``#222222``
+
+    The color of the selected item.
+
+``selected_back_color``
+    Default: ``#FFFFFF``
+
+    The background color of the selected item.
+
 ``case_sensitive``
     Default: no on Windows, yes on other platforms.
 

diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
@@ -289,13 +289,13 @@ Alt+2 (and Command+2 on macOS)
 Command + f (macOS only)
     Toggle fullscreen (see also ``--fs``).
 
-(The following keybindings open a selector in the console that lets you choose
-from a list of items by typing part of the desired item, by clicking the desired
+(The following keybindings open a menu in the console that lets you choose from
+a list of items by typing part of the desired item, by clicking the desired
 item, or by navigating them with keybindings: ``Down`` and ``Ctrl+n`` go down,
 ``Up`` and ``Ctrl+p`` go up, ``Page down`` and ``Ctrl+f`` scroll down one page,
 and ``Page up`` and ``Ctrl+b`` scroll up one page.)
 
-In track selectors, selecting the current tracks disables it.
+In track menus, selecting the current tracks disables it.
 
 g-p
     Select a playlist entry.

diff --git a/DOCS/man/osc.rst b/DOCS/man/osc.rst
@@ -38,15 +38,15 @@ pl prev
     left-click      play previous file in playlist
     shift+L-click   show the playlist
     middle-click    show the playlist
-    right-click     open the playlist selector
+    right-click     open the playlist menu
     =============   ================================================
 
 pl next
     =============   ================================================
     left-click      play next file in playlist
     shift+L-click   show the playlist
     middle-click    show the playlist
-    right-click     open the playlist selector
+    right-click     open the playlist menu
     =============   ================================================
 
 title
@@ -57,7 +57,7 @@ title
     left-click      show file and track info
     shift+L-click   show the path
     middle-click    show the path
-    right-click     open the history selector
+    right-click     open the history menu
     =============   ================================================
 
 cache
@@ -76,15 +76,15 @@ skip back
     left-click      go to beginning of chapter / previous chapter
     shift+L-click   show chapters
     middle-click    show chapters
-    right-click     open the chapter selector
+    right-click     open the chapter menu
     =============   ================================================
 
 skip frwd
     =============   ================================================
     left-click      go to next chapter
     shift+L-click   show chapters
     middle-click    show chapters
-    right-click     open the chapter selector
+    right-click     open the chapter menu
     =============   ================================================
 
 time elapsed
@@ -117,14 +117,14 @@ audio and sub
     left-click      cycle audio/sub tracks forward
     shift+L-click   cycle audio/sub tracks backwards
     middle-click    cycle audio/sub tracks backwards
-    right-click     open the audio/sub track selector
+    right-click     open the audio/sub track menu
     mouse wheel     cycle audio/sub tracks forward/backwards
     =============   ================================================
 
 vol
     =============   ================================================
     left-click      toggle mute
-    right-click     open the audio device selector
+    right-click     open the audio device menu
     mouse wheel     volume up/down
     =============   ================================================
 
@@ -218,7 +218,7 @@ Configurable Options
     seekbar or separately if ``seekbarstyle`` is set to ``bar``.
 
 ``seekrangealpha``
-    Default: 200
+    Default: 20
 
     Alpha of the seekable ranges, 0 (opaque) to 255 (fully transparent).
 

diff --git a/DOCS/man/select.rst b/DOCS/man/select.rst
@@ -31,7 +31,7 @@ PGDN and Ctrl+f
 
 MBTN_LEFT
     Confirm the selection of the highlighted item, or close the console if
-    clicking above the first item or below the last item.
+    clicking outside of the menu rectangle.
 
 WHEEL_UP
     Scroll up.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		add `console-background_alpha` `console-menu_outline_size` `console-menu_outline_color` `console-corner_radius` `console-selected_color` and `console-selected_back_color` script-opts