Collection of mpv user scripts.
command_palette and search_menu are documented here, all other scripts are documented directly in the script via code comment at the beginning of the script.
command_palette is a searchable menu for:
mpv v0.40 has a built-in script named select.lua that is similar to command_palette.lua.
Run the following command line:
powershell -executionpolicy bypass -nologo -noexit -noprofile -command "irm https://raw.githubusercontent.com/stax76/mpv-scripts/refs/heads/main/powershell/command_palette_installer.ps1 | iex"
Or follow these steps:
<mpv conf folder>/scripts/command_palette.lua
<mpv conf folder>/script-opts/command_palette.conf
<mpv conf folder>/script-modules/extended-menu.lua
sudo apt install mediainfo
command_palette.conf
as use_mediainfo=yes
Add bindings to input.conf:
Ctrl+p script-message-to command_palette show-command-palette "Command Palette" # Command Palette
F1 script-message-to command_palette show-command-palette "Bindings" # Bindings
F2 script-message-to command_palette show-command-palette "Properties" # Properties
F3 script-message-to command_palette show-command-palette "Commands" # Commands
F4 script-message-to command_palette show-command-palette "Options" # Options
F8 script-message-to command_palette show-command-palette "Playlist" # Playlist
F9 script-message-to command_palette show-command-palette "Tracks" # Tracks
Alt+a script-message-to command_palette show-command-palette "Audio Tracks" # Audio Tracks
Alt+s script-message-to command_palette show-command-palette "Subtitle Tracks" # Subtitle Tracks
Alt+b script-message-to command_palette show-command-palette "Secondary Subtitle" # Secondary Subtitle
Alt+v script-message-to command_palette show-command-palette "Video Tracks" # Video Tracks
Alt+c script-message-to command_palette show-command-palette "Chapters" # Chapters
Alt+p script-message-to command_palette show-command-palette "Profiles" # Profiles
Alt+d script-message-to command_palette show-command-palette "Audio Devices" # Audio Devices
Alt+l script-message-to command_palette show-command-palette "Subtitle Line" # Subtitle Line
Alt+t script-message-to command_palette show-command-palette "Blu-ray Titles" # Blu-ray Titles
Alt+q script-message-to command_palette show-command-palette "Stream Quality" # Stream Quality
Alt+r script-message-to command_palette show-command-palette "Aspect Ratio" # Aspect Ratio
Alt+f script-message-to command_palette show-command-palette "Recent Files" # Recent Files
Available options and their defaults:
font_size=40
scale_by_window=no
lines_to_show=12
# might be buggy
#pause_on_open=no
#resume_on_exit=only-if-was-paused
# styles
#line_bottom_margin=1
#menu_x_padding=5
#menu_y_padding=2
# yes requires the MediaInfo CLI app being installed
#use_mediainfo=no
#stream_quality_options=2160,1440,1080,720,480
#aspect_ratios=4:3,16:9,2.35:1,1.36,1.82,0,-1
https://github.com/stax76/awesome-mpv?tab=readme-ov-file#menu
search_menu is discontinued as command_palette.lua and select.lua are recommended instead.
search_menu based on the external tools Rofi (Linux) or terminal based on fzf (cross-platform).
It provides a searchable menu for bindings, commands, properties, playlist entries and audio/subtitle tracks.
See Dependencies section to install dependencies.
Save the search menu folder at <mpv conf folder>/scripts/search_menu/
, it contains main.lua and a Python script.
Windows: input-ipc-server = \\.\pipe\mpvsocket
Linux: input-ipc-server = /tmp/mpvsocket
<mpv conf folder>/scripts-opts/search_menu.conf
:
#mode=gnome-terminal+sh # Requires Linux and Gnome Terminal, default on Linux
#mode=alacritty+sh # Requires Linux and Alacritty
#mode=rofi # Requires Linux and Rofi
#mode=alacritty+ns # Requires Windows, Alacritty and Nushell
#mode=windows-terminal+ps # Requires Windows and Windows Terminal, default on Windows
#mode=windows-terminal+ns # Requires Windows, Windows Terminal and Nushell
On Windows Alacritty and Nushell have the advantage of a faster startup.
On Linux Alacritty has the advantage of not having any UI apart from the terminal.
Rofi has like mpv a steep learning curve.
F1 script-message-to search_menu show-search-menu binding # Search Binding
F2 script-message-to search_menu show-search-menu binding-full # Search Binding Full
F3 script-message-to search_menu show-search-menu command # Search Command
F4 script-message-to search_menu show-search-menu property # Search Property
F8 script-message-to search_menu show-search-menu playlist # Search Playlist
Alt+a script-message-to search_menu show-search-menu audio-track # Search Audio Track
Alt+s script-message-to search_menu show-search-menu sub-track # Search Subtitle Track
Which dependencies are required depend on which mode and feature is used.
Invoke a menu via shortcut key, type a search keyword, use up/down key to select, enter key to confirm, escape key to close.
misc.lua has various features, among them is printing media info on the screen.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4