STATS ===== This builtin script displays information and statistics for the currently played file. It is enabled by default if mpv was compiled with Lua support. It can be disabled entirely using the ``--load-stats-overlay=no`` option. Usage ----- The following key bindings are active by default unless something else is already bound to them: ==== ============================================== i Show stats for a fixed duration I Toggle stats (shown until toggled again) ==== ============================================== While the stats are visible on screen the following key bindings are active, regardless of existing bindings. They allow you to switch between *pages* of stats: ==== ================== 1 Show usual stats 2 Show frame timings (scroll) 3 Input cache stats 4 Internal stuff (scroll) ==== ================== On pages which support scroll, these key bindings are also active: ==== ================== UP Scroll one line up DOWN Scroll one line down ==== ================== Font ~~~~ For optimal visual experience, a font with support for many font weights and monospaced digits is recommended. By default, the open source font `Source Sans Pro `_ is used. Configuration ------------- This script can be customized through a config file ``script-opts/stats.conf`` placed in mpv's user directory and through the ``--script-opts`` command-line option. The configuration syntax is described in `ON SCREEN CONTROLLER`_. Configurable Options ~~~~~~~~~~~~~~~~~~~~ ``key_oneshot`` Default: i ``key_toggle`` Default: I Key bindings to display stats. ``key_page_1`` Default: 1 ``key_page_2`` Default: 2 ``key_page_3`` Default: 3 ``key_page_4`` Default: 4 Key bindings for page switching while stats are displayed. ``key_scroll_up`` Default: UP ``key_scroll_down`` Default: DOWN ``scroll_lines`` Default: 1 Scroll key bindings and number of lines to scroll on pages which support it. ``duration`` Default: 4 How long the stats are shown in seconds (oneshot). ``redraw_delay`` Default: 1 How long it takes to refresh the displayed stats in seconds (toggling). ``persistent_overlay`` Default: no When `no`, other scripts printing text to the screen can overwrite the displayed stats. When `yes`, displayed stats are persistently shown for the respective duration. This can result in overlapping text when multiple scripts decide to print text at the same time. ``plot_perfdata`` Default: yes Show graphs for performance data (page 2). ``plot_vsync_ratio`` Default: yes ``plot_vsync_jitter`` Default: yes Show graphs for vsync and jitter values (page 1). Only when toggled. ``flush_graph_data`` Default: yes Clear data buffers used for drawing graphs when toggling. ``font`` Default: Source Sans Pro Font name. Should support as many font weights as possible for optimal visual experience. ``font_mono`` Default: Source Sans Pro Font name for parts where monospaced characters are necessary to align text. Currently, monospaced digits are sufficient. ``font_size`` Default: 8 Font size used to render text. ``font_color`` Default: FFFFFF Font color. ``border_size`` Default: 0.8 Size of border drawn around the font. ``border_color`` Default: 262626 Color of drawn border. ``alpha`` Default: 11 Transparency for drawn text. ``plot_bg_border_color`` Default: 0000FF Border color used for drawing graphs. ``plot_bg_color`` Default: 262626 Background color used for drawing graphs. ``plot_color`` Default: FFFFFF Color used for drawing graphs. Note: colors are given as hexadecimal values and use ASS tag order: BBGGRR (blue green red). Different key bindings ~~~~~~~~~~~~~~~~~~~~~~ A different key binding can be defined with the aforementioned options ``key_oneshot`` and ``key_toggle`` but also with commands in ``input.conf``, for example:: e script-binding stats/display-stats E script-binding stats/display-stats-toggle Using ``input.conf``, it is also possible to directly display a certain page:: i script-binding stats/display-page-1 e script-binding stats/display-page-2 Internal stuff page ~~~~~~~~~~~~~~~~~~~ Most entries shown on this page have rather vague meaning. Likely none of this is useful for you. Don't attempt to use it. Forget its existence. Selecting this for the first time will start collecting some internal performance data. That means performance will be slightly lower than normal for the rest of the time the player is running (even if the stats page is closed). Note that the stats page itself uses a lot of CPU and even GPU resources, and may have a heavy impact on performance. The displayed information is accumulated over the redraw delay (shown as ``poll-time`` field). This adds entries for each Lua script. If there are too many scripts running, parts of the list will simply be out of the screen, but it can be scrolled. If the underlying platform does not support pthread per thread times, the displayed times will be 0 or something random (I suspect that at time of this writing, only Linux provides the correct via pthread APIs for per thread times). Most entries are added lazily and only during data collection, which is why entries may pop up randomly after some time. It's also why the memory usage entries for scripts that have been inactive since the start of data collection are missing. Memory usage is approximate and does not reflect internal fragmentation. JS scripts memory reporting is disabled by default because collecting the data at the JS side has an overhead. It can be enabled by exporting the env var ``MPV_LEAK_REPORT=1`` before starting mpv, and will increase JS memory usage. If entries have ``/time`` and ``/cpu`` variants, the former gives the real time (monotonic clock), while the latter the thread CPU time (only if the corresponding pthread API works and is supported).