mpv-stats

Display statistics for the currently played file in mpv.

Requirements

The latest version of this script requires mpv version 0.26.0 or above (or at least newer than this commit).
For older mpv versions please go to Releases.
The oldest supported version of mpv is 0.9.3.

There are no further/external dependencies.

Usage

Place stats.lua in your ~/.config/mpv/scripts/ or ~/.mpv/scripts/ folder to autoload the script.

The script is binding itself to i and I (however, not overriding your own bindings) and can therefore be invoked by pressing these keys. i will show the stats once while I will toggle them.

You can set different bindings either by customizing this script or by using the script_binding input command (in input.conf), e.g.:

e script-binding stats/display_stats
E script-binding stats/display_stats_toggle

By default Source Sans Pro is used as font. You can download it here.

F.A.Q.

How to get graphs?

Graphs are enabled by default. Please note that they are only shown when stats are toggled and that only the opengl VO is exposing frame timing data.

Turn graphs off with plot_perfdata=no, plot_vsync_ratio=no and plot_vsync_jitter=no (see Customization).

Can I get a sum of all three timing values?

Yes, use print_perfdata_total=yes to add an additional line showing the values summed up (see Customization).

Why are my frame timing values colored?

Red: your hardware needs more time to render/present/upload a frame than available.
Yellow: your hardware needs more than 85% of the available time. This is merely a warning.

When using display-resample and/or interpolation mpv has to show (render/present/upload) one frame every 1/display-fps seconds. In case of a 60Hz display this means there's 1/60 = 0.016666 sec (16666 μs) time per frame available.
Given display-resample is not used the video's FPS will be used for these calculations. Note that there are further parameters and coherences (depending on user configuration) influencing fluent playback and this is just a very general indicator.

Turn it off by setting timing_warning=no (see Customization).
Use timing_warning_th=0.85 to set a factor determining when to warn (yellow).

The graph's position is jumping

Please use a font with monospaced digits. The default font does meet this requirement. Either download it (see Usage) or set your own with font_mono (see Customization).
Note that font does not need to be a monospaced font.

Why does the layout change when showing graphs?

Long story short: there can't be text behind the graph drawings. (Why)

Customization

You can configure various settings by creating a file called stats.conf in a folder named lua-settings within your mpv config folder (where your mpv.conf is in). Please refer to the o table within the script for possible option names and consult mpv manual regarding configuration syntax.

To change e.g. the text display duration your stats.conf may look like:

duration=5

A more sophisticated example:

key_oneshot=e
key_toggle=E
font_size=8
plot_perfdata=no
print_perfdata_total=yes
font=Arial
font_mono=Monospaced
font_color=262626
border_size=0.5

Note: colors are given as hexadecimal values and use ASS tag order: BBGGRR (blue green red).