Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

README.md

Pause Indicator Lite

pause_indicator_preview

A simple script that displays an indicator on pause (and mute), with options to adjust icon type, color, height, width, opacity and whether to toggle pause with a keybind or not.

You can choose from multiple themes:

  • Native: Doesn't require a font file
  • Themed: fluent or material themes with icon_theme option
    • Must set themed_icons=yes, which requires modernz-icons.ttf
    • Each theme has different styles, outline or filled. Which can be set with theme_style option

Script: Pause Indicator Lite

Indicator Options

Below is the full list for indicator options and their default values.

To adjust them you can either:

  • Place pause_indicator_lite.conf in script-opts and change the values in it [recommended]
  • Simply change their values in local options within the script itself
Option Value Description
indicator_icon pause indicator icon type. pause, play
indicator_stay yes keep indicator visibile during pause
indicator_timeout 0.6 timeout (seconds) if indicator doesn't stay
indicator_pos middle_center position of indicator
top_left, top_right, top_center. also: middle_*, bottom_*
same as top_* (ie: bottom_right)
keybind_allow no allow keybind to toggle pause
keybind_set ctrl+mbtn_left the used keybind to toggle pause [reference]
keybind_mode onpause mode to activate keybind
onpause: only active when paused, to unpause
always: always active to toggle pause/unpause
keybind_eof_disable yes disable keybind on eof (end of file) [reference]
icon_color #FFFFFF icon fill color
icon_border_color #111111 icon border color
icon_border_width 1.5 icon border width
icon_opacity 30 icon opacity (0-100)
rectangles_width 20 width of rectangles (pause icon)
rectangles_height 60 height of rectangles (pause icon)
rectangles_spacing 12 spacing between the two rectangles (pause icon)
triangle_width 60 width of triangle (play icon)
triangle_height 60 height of triangle (play icon)
flash_play_icon yes flash play icon on unpause (best with pause indicator icon)
flash_icon_timeout 0.3 timeout (seconds) for flash icon
themed_icons no use icon theme specified in icon_theme requires fonts/modernz-icons.ttf
icon_theme fluent set icon theme. accepts fluent or material
theme_style outline set theme style. accepts outline or filled
themed_icon_size 80 themed icon size
mute_indicator no show a mute indicator
mute_indicator_pos top_right position of mute indicator
top_left, top_right, top_center. also: middle_*, bottom_*
same as top_* (ie: bottom_right)
mute_icon_size 35 mute indicator size

How to install

Simply place pause_indicator_lite.lua in the corresponding mpv scripts folder of your operating system:

  • Windows: %APPDATA%\mpv\scripts\ or C:\users\USERNAME\AppData\Roaming\mpv\scripts\
  • Linux: ~/.config/mpv/scripts/ or /home/USERNAME/.config/mpv/scripts/
  • Mac: ~/.config/mpv/scripts/ or /Users/USERNAME/.config/mpv/scripts/
📁 mpv/
├── 📁 fonts/
│   └── 📄 modernz-icons.ttf
├── 📁 script-opts/
│   └── 📄 pause_indicator_lite.conf
└── 📁 scripts/
    └── 📄 pause_indicator_lite.lua

Tip

More information about mpv files locations can be found here

Notes

  • I don't plan to focus many updates on this script, because ASS drawing and positioning pisses me off. 😝
  • Other alternatives can be found in the mpv user scripts wiki.
  • This isn't exclusive to be used on ModernZ OSC. Feel free to use it with whatever you want.