Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/christoph-heinrich/mpv-quality-menu

A userscript for MPV that allows you to change the streamed video and audio quality (ytdl-format) on the fly.
https://github.com/christoph-heinrich/mpv-quality-menu

mpv mpv-script

Last synced: 3 months ago
JSON representation

A userscript for MPV that allows you to change the streamed video and audio quality (ytdl-format) on the fly.

Host: GitHub
URL: https://github.com/christoph-heinrich/mpv-quality-menu
Owner: christoph-heinrich
License: gpl-2.0
Fork: true (jgreco/mpv-youtube-quality)
Created: 2021-05-19T22:44:08.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2023-10-22T16:51:15.000Z (about 1 year ago)
Last Synced: 2024-06-30T13:37:42.189Z (5 months ago)
Topics: mpv, mpv-script
Language: Lua
Homepage:
Size: 7.6 MB
Stars: 123
Watchers: 5
Forks: 3
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

awesome-mpv - quality-menu - Change the streamed video and audio quality (ytdl-format) on the fly. (Streaming)

README

        # quality-menu

A userscript for MPV that allows you to change the streamed video and audio quality (ytdl-format) on the fly.

Simply open the video or audio menu, select your prefered format and confirm your choice. The keybindings for opening the menus are configured in input.conf, and everthing else is configured in quality-menu.conf.

![screenshot](preview.jpg)

## Features

- Currently playing format is marked and selected when opening the menu

- Remembers selected format for every url in the current session (e.g. going back to previous playlist item automatically selects the prefered format)

- Controllable entirely by mouse or keyboard (opening by mouse requires either the OSC extension, [uosc](https://github.com/tomasklaen/uosc) or an additional entry in [`input.conf`](https://mpv.io/manual/stable/#input-conf))

- All format related information from yt-dlp/youtube-dl can be shown

- Columns that are identical for all formats are automatically hidden

- Formats can be sorted based on resolution, fps, bitrate, etc.

- Simple reload functionality

- Columns and their order are configurable

- **(optional)** Graphical menu via [uosc](https://github.com/tomasklaen/uosc) integration  

    Note: Requires uosc 5.0.0 or newer.

## OSC extension

**(optional)** An extended version of the OSC is available that includes a button to display the quality menu.

![screenshot](quality-menu-preview-osc.jpg)

**PLEASE NOTE:** This conflicts with other scripts that modify the OSC. Merging this OSC modification others is certainly possible. Depending on how the osc is modified, the [osc.patch](osc.patch) might apply cleanly, but you have to make sure the filename in the patch lines up with the filename of your files.

## Installation

1. Save the `quality-menu.lua` into your [scripts directory](https://mpv.io/manual/stable/#script-location)

2. Set key bindings in [`input.conf`](https://mpv.io/manual/stable/#input-conf)

    ```

    F     script-binding quality_menu/video_formats_toggle

    Alt+f script-binding quality_menu/audio_formats_toggle

    ```

    **(optional)** `Ctrl+r script-binding quality_menu/reload`

3. **(optional)** Save the `quality-menu.conf` into your `script-opts` directory (next to the [scripts directory](https://mpv.io/manual/stable/#script-location), create if it doesn't exist)

4. **(optional)** UI integration (pick one)

    - For OSC: Save the `quality-menu-osc.lua` into your [scripts directory](https://mpv.io/manual/stable/#script-location)  and put `osc=no` in your [mpv.conf](https://mpv.io/manual/stable/#location-and-syntax)

    - For [uosc](https://github.com/tomasklaen/uosc) (each is optional)

        1. Add the video and audio menu to the uosc menu by appending `#! ...` to your key bindings in [`input.conf`](https://mpv.io/manual/stable/#input-conf)

        ```

        F     script-binding quality_menu/video_formats_toggle #! Stream Quality > Video

        Alt+f script-binding quality_menu/audio_formats_toggle #! Stream Quality > Audio

        ```

        2. quality-menu already overwrites the builtin uosc command `stream-quality`, so it already works well out of the box.

            For even deeper UI integration you can add buttons to the `contols=` option in your [`uosc.conf`](https://github.com/tomasklaen/uosc/blob/main/script-opts/uosc.conf)

            1. `command:theaters:script-binding quality_menu/video_formats_toggle#@vformats>1?Video`

            2. `command:graphic_eq:script-binding quality_menu/audio_formats_toggle#@aformats>1?Audio`

## Plans For Future Enhancement

- [x] Visual indication of what the current quality level is

- [x] Option to populate the quality list automatically with the exact formats available for a given video

- [x] Optional OSC extension

- [x] [uosc](https://github.com/tomasklaen/uosc) integration

- [ ] *\[your suggestion here\]*

## Credit

- [reload.lua](https://github.com/4e6/mpv-reload/), for the function to reload a video while preserving the playlist.

- [mpv-playlistmanager](https://github.com/jonniek/mpv-playlistmanager), for the menu formatting config.

- ytdl_hook.lua, much of the  code to fetch the format list with youtube-dl came from there.

- somebody on /mpv/ for the idea