Skip to content

koonix/mpv-selectformat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Feb 13, 2025
169dab5 · Feb 13, 2025

History

64 Commits
Sep 25, 2024
Mar 4, 2024
Nov 9, 2023
Jun 26, 2024
Nov 9, 2023
Nov 9, 2023
Feb 13, 2025

Repository files navigation

mpv-selectformat

An mpv plugin for selecting the format of internet videos on the fly.

Based on mpv-youtube-quality.

Folded

Unfolded

Installation

  1. Download selectformat.lua

  2. Copy selectformat.lua to your mpv scripts directory.

  3. Add a key binding to your mpv input.conf file to open the menu. Example: ctrl+f script-binding selectformat/menu

Features

  • Formats are grouped (folded) based on resolution, to reduce clutter.
  • Formats are properly sorted based on codec, protocol, etc.
  • Formats are fetched asynchronously as soon as an internet video starts.
  • The initially-loaded format is pre-selected in the menu.
  • More useful information about the formats is displayed compared to mpv-youtube-quality.

Menu Key Bindings

The following key bindings can be used to navigate the menu:

Key(s) Function
Up or k Move up
Down or j Move down
PageUp or Ctrl+u Move up 5 items
PageDown or Ctrl+d Move down 5 items
Home or g Jump to the first item
End or G Jump to the last item
Right or l Unfold the resolution under the cursor
Left or h Fold the unfolded resolutions
Enter Select the item under the cursor
Esc or q Close the menu

Available Options

Refer to the options section in selectformat.lua for available options and their default values.

These options can be configured using mpv's script-opts option.

Setting a Default Format

You can change the default format that mpv loads by configuring mpv's ytdl-format option in mpv.conf.