command_palette

November 26, 2025 · View on GitHub

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.

powershell-completion - Command line completion for mpv and mpv.net.
command_palette - Note that this script is now obsolete because mpv supports all this now directly using the built-in script select.lua.

Searchable menu for bindings, playlist, chapters, profiles, all tracks, audio tracks, video tracks, subtitle tracks, secondary subtitle tracks, subtitle lines, commands, properties, options, audio devices, Blu-ray titles, stream quality, aspect ratio, recent files. Note that this script is now obsolete because mpv supports all this now using the built-in script select.lua.
search_menu - Note that this script is now obsolete because mpv supports all this now directly using the built-in script select.lua.

Searchable menu for bindings, commands, properties, playlist entries and audio/subtitle tracks.
auto_mode.lua - Use mpv as video player, music player and image viewer.
delete_current_file.lua - Moves the currently playing file instantly to the recycle bin.
file_rating.lua - Writes a star rating to the filename of the currently playing file.
history.lua - Writes date, time, playtime and filename to a log file.
osm.lua - Shows a customizable on screen menu.
misc.lua
- Show detailed media info on screen (Screenshot).
- Cycle audio and subtitle tracks, include only languages you know.
- Paste/Load/Append files/URLs from clipboard.
- Jump to a random position in the playlist.
- Navigate in playlist to next/previous/first/last file.
- Restart mpv restoring the properties path, time-pos, pause and volume.
- Execute Lua code from input.conf.
- When seeking display position and duration like so: 70:00 / 80:00.
average_volume.lua - Records and restores the relative volume for music.

command_palette

Note that this script is now obsolete because mpv supports all this now directly using the built-in script select.lua.

command_palette_main

command_palette_bindings

command_palette is a searchable menu for:

Command palette
Bindings
Playlist
Chapters
Profiles
All tracks
Audio tracks
Video tracks
Subtitle tracks
Secondary subtitle tracks
Subtitle lines
Commands
Properties
Options
Audio devices
Blu-ray titles
Stream quality
Aspect ratio
Recent files (depends on recent-menu)

Note

mpv v0.40 has a built-in script named select.lua that is similar to command_palette.lua.

Installation

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:

Save the script at: <mpv conf folder>/scripts/command_palette.lua
Create a empty text file for options at: <mpv conf folder>/script-opts/command_palette.conf
Download extended-menu and save it at: <mpv conf folder>/script-modules/extended-menu.lua
The Recent Files feature requires recent-menu being installed or mpv.net being used.
For better track media info like showing bitrates, the MediaInfo CLI app must be installed.
Debian/Ubuntu: sudo apt install mediainfo
Windows: https://mediaarea.net/en/MediaInfo/Download/Windows
This feature must be enabled in command_palette.conf as use_mediainfo=yes

Usage

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

Credits

https://github.com/stax76/awesome-mpv?tab=readme-ov-file#menu

search_menu

Note that this script is now obsolete because mpv supports all this now directly using the built-in script select.lua.

About

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.

Terminal search menu

Rofi search menu

#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.

input.conf:

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