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: about 2 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 (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-03-04T17:14:49.000Z (7 months ago)
• Last Synced: 2024-04-09T21:26:18.245Z (6 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

Awesome Lists containing this project

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

README

        
# mpv-selectformat

* [Installation](#installation)

* [Features](#features)

* [Menu Key Bindings](#menu-key-bindings)

* [Available Options](#available-options)

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

An *mpv* plugin

for selecting the format of internet videos on the fly.

Based on

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

![Folded](sc1.jpg)

![Unfolded](sc2.jpg)

## Installation

1. [Download](https://github.com/koonix/mpv-selectformat/releases/latest/download/selectformat.lua)

`selectformat.lua`

2. Copy `selectformat.lua` to your mpv [scripts directory](https://mpv.io/manual/stable/#script-location).

3. Add a key binding to your mpv

[input.conf](https://mpv.io/manual/stable/#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](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).