{"id":13835050,"url":"https://github.com/stax76/mpv-scripts","last_synced_at":"2025-10-23T23:16:00.508Z","repository":{"id":40677486,"uuid":"474184335","full_name":"stax76/mpv-scripts","owner":"stax76","description":"Script collection for the mpv media player.","archived":false,"fork":false,"pushed_at":"2025-05-03T23:50:43.000Z","size":2133,"stargazers_count":190,"open_issues_count":8,"forks_count":12,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-07-10T12:00:20.195Z","etag":null,"topics":["lua","media-info","mpv-script","rofi-scripts"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stax76.png","metadata":{"files":{"readme":"README.md","changelog":"history.lua","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-03-25T22:47:44.000Z","updated_at":"2025-07-08T22:39:51.000Z","dependencies_parsed_at":"2024-01-04T10:29:14.332Z","dependency_job_id":"84c1192e-b445-47da-80e1-5a6a0d08f033","html_url":"https://github.com/stax76/mpv-scripts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stax76/mpv-scripts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stax76%2Fmpv-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stax76%2Fmpv-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stax76%2Fmpv-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stax76%2Fmpv-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stax76","download_url":"https://codeload.github.com/stax76/mpv-scripts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stax76%2Fmpv-scripts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280706898,"owners_count":26377011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-23T02:00:06.710Z","response_time":142,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["lua","media-info","mpv-script","rofi-scripts"],"created_at":"2024-08-04T14:00:55.640Z","updated_at":"2025-10-23T23:16:00.503Z","avatar_url":"https://github.com/stax76.png","language":"Lua","readme":"\nCollection of mpv user scripts.\n\ncommand_palette and search_menu are documented here, all other scripts are\ndocumented directly in the script via code comment at the beginning of the script.\n\n- [powershell-completion](powershell/mpv-powershell-completion.ps1) - Command line completion for mpv and mpv.net.\n- [command_palette](#command_palette) - Searchable menu for bindings,\n  playlist, chapters, profiles, all tracks, audio tracks, video tracks,\n  subtitle tracks, secondary subtitle tracks, subtitle lines, commands,\n  properties, options, audio devices, Blu-ray titles, stream quality,\n  aspect ratio, recent files.\n- [search_menu](#search_menu) - Searchable menu for bindings, commands, properties, playlist\n  entries and audio/subtitle tracks.\n- [auto_mode.lua](auto_mode.lua) - Use mpv as video player, music player and image viewer.\n- [delete_current_file.lua](delete_current_file.lua) - Moves the currently playing file instantly to the recycle bin.\n- [file_rating.lua](file_rating.lua) - Writes a star rating to the filename of the currently playing file.\n- [history.lua](history.lua) - Writes date, time, playtime and filename to a log file.\n- [osm.lua](osm.lua) - Shows a customizable on screen menu.\n- [misc.lua](misc.lua)\n  - Show detailed media info on screen ([Screenshot](#screenshot-misclua)).\n  - Cycle audio and subtitle tracks, include only languages you know.\n  - Paste/Load/Append files/URLs from clipboard.\n  - Jump to a random position in the playlist.\n  - Navigate in playlist to next/previous/first/last file.\n  - Restart mpv restoring the properties path, time-pos, pause and volume.\n  - Execute Lua code from input.conf.\n  - When seeking display position and duration like so: 70:00 / 80:00.\n- [average_volume.lua](average_volume.lua) - Records and restores the relative volume for music.\n\n# command_palette\n\n![command_palette_main](screenshots/command_palette_main.webp)\n\n![command_palette_bindings](screenshots/command_palette_bindings.png)\n\ncommand_palette is a searchable menu for:\n\n- Command palette\n- Bindings\n- Playlist\n- Chapters\n- Profiles\n- All tracks\n- Audio tracks\n- Video tracks\n- Subtitle tracks\n- Secondary subtitle tracks\n- Subtitle lines\n- Commands\n- Properties\n- Options\n- Audio devices\n- Blu-ray titles\n- Stream quality\n- Aspect ratio\n- Recent files (depends on [recent-menu](https://github.com/natural-harmonia-gropius/recent-menu))\n\n### Note\n\nmpv v0.40 has a built-in script named [select.lua](https://mpv.io/manual/master/#select) that is similar to command_palette.lua.\n\n### Installation\n\nRun the following command line:\n\n```\npowershell -executionpolicy bypass -nologo -noexit -noprofile -command \"irm https://raw.githubusercontent.com/stax76/mpv-scripts/refs/heads/main/powershell/command_palette_installer.ps1 | iex\"\n```\n\nOr follow these steps:\n\n1. Save the script at: `\u003cmpv conf folder\u003e/scripts/command_palette.lua`\n2. Create a empty text file for options at: `\u003cmpv conf folder\u003e/script-opts/command_palette.conf`\n3. Download [extended-menu](https://github.com/Seme4eg/mpv-scripts/blob/master/script-modules/extended-menu.lua)\n   and save it at: `\u003cmpv conf folder\u003e/script-modules/extended-menu.lua`\n4. The Recent Files feature requires [recent-menu](https://github.com/natural-harmonia-gropius/recent-menu)\n   being installed or mpv.net being used.\n5. For better track media info like showing bitrates, the MediaInfo CLI app must be installed.  \n   Debian/Ubuntu: `sudo apt install mediainfo`  \n   Windows: https://mediaarea.net/en/MediaInfo/Download/Windows  \n   This feature must be enabled in `command_palette.conf` as `use_mediainfo=yes`\n\n### Usage\n\nAdd bindings to input.conf:\n\n```\nCtrl+p      script-message-to command_palette show-command-palette \"Command Palette\" # Command Palette\nF1          script-message-to command_palette show-command-palette \"Bindings\" # Bindings\nF2          script-message-to command_palette show-command-palette \"Properties\" # Properties\nF3          script-message-to command_palette show-command-palette \"Commands\" # Commands\nF4          script-message-to command_palette show-command-palette \"Options\" # Options\nF8          script-message-to command_palette show-command-palette \"Playlist\" # Playlist\nF9          script-message-to command_palette show-command-palette \"Tracks\" # Tracks\nAlt+a       script-message-to command_palette show-command-palette \"Audio Tracks\" # Audio Tracks\nAlt+s       script-message-to command_palette show-command-palette \"Subtitle Tracks\" # Subtitle Tracks\nAlt+b       script-message-to command_palette show-command-palette \"Secondary Subtitle\" # Secondary Subtitle\nAlt+v       script-message-to command_palette show-command-palette \"Video Tracks\" # Video Tracks\nAlt+c       script-message-to command_palette show-command-palette \"Chapters\" # Chapters\nAlt+p       script-message-to command_palette show-command-palette \"Profiles\" # Profiles\nAlt+d       script-message-to command_palette show-command-palette \"Audio Devices\" # Audio Devices\nAlt+l       script-message-to command_palette show-command-palette \"Subtitle Line\" # Subtitle Line\nAlt+t       script-message-to command_palette show-command-palette \"Blu-ray Titles\" # Blu-ray Titles\nAlt+q       script-message-to command_palette show-command-palette \"Stream Quality\" # Stream Quality\nAlt+r       script-message-to command_palette show-command-palette \"Aspect Ratio\" # Aspect Ratio\nAlt+f       script-message-to command_palette show-command-palette \"Recent Files\" # Recent Files\n```\n\nAvailable options and their defaults:\n\n```\nfont_size=40\nscale_by_window=no\nlines_to_show=12\n\n# might be buggy\n#pause_on_open=no\n\n#resume_on_exit=only-if-was-paused\n\n# styles\n#line_bottom_margin=1\n#menu_x_padding=5\n#menu_y_padding=2\n\n# yes requires the MediaInfo CLI app being installed\n#use_mediainfo=no\n\n#stream_quality_options=2160,1440,1080,720,480\n#aspect_ratios=4:3,16:9,2.35:1,1.36,1.82,0,-1\n```\n\n### Credits\n\n- https://github.com/mpv-player/mpv/blob/master/player/lua/select.lua\n- https://github.com/Seme4eg/mpv-scripts\n- https://github.com/CogentRedTester/mpv-search-page\n- https://github.com/tomasklaen/uosc\n\n### More menu scripts\n\nhttps://github.com/stax76/awesome-mpv?tab=readme-ov-file#menu\n\n# search_menu\n\n### About\n\nsearch_menu is discontinued as command_palette.lua and select.lua are recommended instead.\n\nsearch_menu based on the external tools [Rofi](https://github.com/davatorium/rofi) (Linux) or terminal based on [fzf](https://github.com/junegunn/fzf) (cross-platform).\n\nIt provides a searchable menu for bindings, commands, properties, playlist entries and audio/subtitle tracks.\n\n![Terminal search menu](screenshots/search_menu-binding.png)\n\n![Rofi search menu](screenshots/rofi.png)\n\n### Installation\n\nSee Dependencies section to install dependencies.\n\nSave the search menu folder at `\u003cmpv conf folder\u003e/scripts/search_menu/`,\nit contains main.lua and a Python script.\n\n### Configuration\n\n#### mpv.conf\n\nWindows: `input-ipc-server = \\\\.\\pipe\\mpvsocket`\n\nLinux: `input-ipc-server = /tmp/mpvsocket`\n\n#### Conf file at `\u003cmpv conf folder\u003e/scripts-opts/search_menu.conf`:\n\n```\n#mode=gnome-terminal+sh    # Requires Linux and Gnome Terminal, default on Linux\n#mode=alacritty+sh         # Requires Linux and Alacritty\n#mode=rofi                 # Requires Linux and Rofi\n#mode=alacritty+ns         # Requires Windows, Alacritty and Nushell\n#mode=windows-terminal+ps  # Requires Windows and Windows Terminal, default on Windows\n#mode=windows-terminal+ns  # Requires Windows, Windows Terminal and Nushell\n```\n\nOn Windows Alacritty and Nushell have the advantage of a faster startup.\n\nOn Linux Alacritty has the advantage of not having any UI apart from the terminal.\n\nRofi has like mpv a steep learning curve.\n\n#### input.conf:\n\n```\nF1 script-message-to search_menu show-search-menu binding        # Search Binding\nF2 script-message-to search_menu show-search-menu binding-full   # Search Binding Full\nF3 script-message-to search_menu show-search-menu command        # Search Command\nF4 script-message-to search_menu show-search-menu property       # Search Property\nF8 script-message-to search_menu show-search-menu playlist       # Search Playlist\nAlt+a script-message-to search_menu show-search-menu audio-track # Search Audio Track\nAlt+s script-message-to search_menu show-search-menu sub-track   # Search Subtitle Track\n```\n\n### Dependencies\n\nWhich dependencies are required depend\non which mode and feature is used.\n\n- [Python](https://www.python.org) - Always required.\n- [Rofi](https://github.com/davatorium/rofi) - Required launcher app for rofi mode, depends on Linux and X11.\n- [fzf](https://github.com/junegunn/fzf) - Required CLI tool for modes other than rofi (terminal modes).\n- [MediaInfo](https://mediaarea.net/en/MediaInfo) - Required CLI tool to search audio or subtitle tacks.\n- [Alacritty](https://alacritty.org) - Modern, simple and fast terminal emulator.\n- [Nushell](https://www.nushell.sh) - Modern shell that starts 200 ms faster than PowerShell.\n\n### Usage\n\nInvoke a menu via shortcut key, type a search keyword, use up/down key to select,\nenter key to confirm, escape key to close.\n\n# Screenshot misc.lua\n\nmisc.lua has various features, among them is printing media info on the screen.\n\n![media-info](screenshots/media-info.jpg)\n","funding_links":[],"categories":["Playback"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstax76%2Fmpv-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstax76%2Fmpv-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstax76%2Fmpv-scripts/lists"}