https://github.com/koonix/mpv-selectformat

mpv plugin for selecting the format of internet videos.
https://github.com/koonix/mpv-selectformat

mpv mpv-plugin mpv-scripts youtube youtube-dl yt-dlp

Last synced: 4 months ago
JSON representation

mpv plugin for selecting the format of internet videos.

• Host: GitHub
• URL: https://github.com/koonix/mpv-selectformat
• Owner: koonix
• License: mit
• Created: 2022-05-03T21:46:52.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-03-04T17:14:49.000Z (4 months ago)
• Last Synced: 2024-03-04T19:04:54.331Z (4 months ago)
• Topics: mpv, mpv-plugin, mpv-scripts, youtube, youtube-dl, yt-dlp
• Language: Lua
• Homepage:
• Size: 622 KB
• Stars: 10
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-mpv - selectformat - Select the format (quality) of internet videos. (Streaming)

README

        
# mpv-selectformat

* [Installation](#installation)

* [Features](#features)

* [Key Bindings](#key-bindings)

* [Available Options](#available-options)

* [Setting a Default Format](#setting-a-default-format)

selectformat is an mpv plugin

for selecting the format of internet videos on the fly.

Based on the unmaintained

[mpv-youtube-quality](https://github.com/jgreco/mpv-youtube-quality).

![Folded](sc1.jpg)

![Unfolded](sc2.jpg)

## Installation

1. Download and copy `selectformat.lua` to your mpv's

[scripts directory](https://mpv.io/manual/stable/#script-location)

2. Add a binding to your mpv's

[input.conf](https://mpv.io/manual/stable/#input-conf) file

for opening the menu

(selectformat doesn't add such binding itself).

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 info about the formats are displayed compared to mpv-youtube-quality

## Key Bindings

These are the key bindings for navigating 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

Take a look at the `options` section in `selectformat.lua`

for available options and their default values.

These options can be configured using mpv's

[script-opts](https://mpv.io/manual/stable/#options-script-opts)

option.

## Setting a Default Format

You can change the default format that mpv loads

by configuring mpv's

[`ytdl-format`](https://mpv.io/manual/stable/#options-ytdl-format)

option in [mpv.conf](https://mpv.io/manual/stable/#configuration-files).