modernz.conf

# Language and display
# set language (for available options, see: https://github.com/Samillion/ModernZ/blob/main/docs/TRANSLATIONS.md)
language=default
# set layout: default, compact, mini, seekbar
layout=default
# set icon theme. accepts fluent or material
icon_theme=fluent
# set icon style. accepts mixed, filled, outline
icon_style=mixed
# font for the OSC (default: mpv-osd-symbols or the one set in mpv.conf)
font=mpv-osd-symbols

# show mpv logo when idle
idlescreen=yes
# show OSC window top bar: "auto", "yes", or "no" (borderless/fullscreen)
window_top_bar=auto
# show OSC when windowed
showwindowed=yes
# show OSC when fullscreen
showfullscreen=yes
# show OSC when a select menu is open
showonselect=no
# show OSC when paused
showonpause=yes
# keep OSC visible while paused: no, bottombar, both
keeponpause=no
# disable Santa hat in December
greenandgrumpy=no

# OSC behaviour and scaling
# time (in ms) before OSC hides if no mouse movement
hidetimeout=1500
# keep OSC visible while cursor hovers over bottom or top bar
keep_with_cursor=yes
# fade-out duration (in ms), set to 0 for no fade
fadeduration=200
# whether to enable fade-in effect
fadein=yes
# minimum mouse movement (in pixels) required to show OSC
minmousemove=0
# controls how much of the window ignores mouse movement for showing the osc
# 0.0 always shows on movement, 1.0 only shows when directly hovered
deadzonesize=0.75
# hide behavior when cursor enters deadzone or leaves window: instant or timeout
deadzone_hide=instant
# show OSC when seeking
osc_on_seek=yes
# show OSC/window controls on start of every file (no, bottom, top, both)
osc_on_start=both
# pause video while seeking with mouse move (on button hold)
mouse_seek_pause=yes
# force show seekbar tooltip on mouse drag, even if not hovering seekbar
force_seek_tooltip=no

# scale osc with the video
vidscale=auto
# osc scale factor when windowed
scalewindowed=1.0
# osc scale factor when fullscreen
scalefullscreen=1.0

# Elements display
# show title in the OSC
show_title=yes
# title: "${media-title}" or "${filename}"
title=${media-title}
# font size of the title text
title_font_size=24
# truncate title with ellipsis if it overflows
truncate_title=no
# chapter title font size
chapter_title_font_size=16
# show cached time information
cache_info=no
# show cache speed per second
cache_info_speed=no
# font size of the cache information
cache_info_font_size=12

# show chapter title
show_chapter_title=yes
# show chapter above title
chapter_above_title=no
# format for chapter display on seekbar hover (set to "no" to disable)
chapter_fmt=%s

# show current time instead of remaining time
timecurrent=yes
# show timecodes with milliseconds
timems=no
# use the Unicode minus sign in remaining time
unicodeminus=no
# "dynamic" or "fixed". dynamic shows MM:SS when possible, fixed always shows HH:MM:SS
time_format=dynamic
# font size of the time display
time_font_size=16
# tooltips font size
tooltip_font_size=14
# speed button font size
speed_font_size=16

# Title bar settings
# show window title in borderless/fullscreen mode
show_window_title=no
# window title font size
window_title_font_size=26
# show window controls (close, minimize, maximize) in borderless/fullscreen
window_controls=yes
# show window controls (top bar) and bottom bar independently on hover
windowcontrols_independent=yes

# Subtitle and OSD display settings
# IMPORTANT: It is recommended to add the following
# in your mpv.conf, to circumvent subtitle or OSD
# bad positioning when watch later options are used
# watch-later-options-remove=sub-pos
# watch-later-options-remove=osd-margin-y

# raise subtitles above the OSC when shown
sub_margins=yes
# adjust OSD to not overlap with OSC
osd_margins=no
# update margins dynamically with OSC visibility
dynamic_margins=yes

# Buttons display and functionality
# show the subtitles menu button
subtitles_button=yes
# show the audio tracks menu button
audio_tracks_button=yes
# show the jump backward and forward buttons
jump_buttons=yes
# change the jump amount in seconds
jump_amount=10
# change the jump amount in seconds on right click
jump_more_amount=60
# show different icon when jump_amount is set to 5, 10, or 30
jump_icon_number=yes
# seek mode for jump buttons: "relative" or "exact"
jump_mode=relative
# enable continuous jumping when holding down seek buttons
jump_softrepeat=yes
# show the chapter skip backward and forward buttons
chapter_skip_buttons=no
# show next/previous playlist track buttons
track_nextprev_buttons=yes

# show mute button and volume slider
volume_control=yes
# volume scale type: "linear" or "logarithmic"
volume_control_type=linear
# unmute audio when adjusting volume slider with left click
volumebar_unmute_on_click=no
# show playlist button
playlist_button=yes
# hide playlist button when no playlist exists
hide_empty_playlist_button=no
# gray out the playlist button when no playlist exists
gray_empty_playlist_button=no

# show fullscreen toggle button
fullscreen_button=yes
# show info button
info_button=yes
# show window on top button
ontop_button=yes
# move ontop button to top bar when ontop is active
ontop_in_topbar=no
# show screenshot button
screenshot_button=yes

# show download button on web videos (requires yt-dlp and ffmpeg)
download_button=yes
# default download directory for videos (https://mpv.io/manual/master/#paths)
download_path=~~desktop/mpv

# show file loop button
loop_button=yes
# show shuffle button
shuffle_button=no
# show speed control button
speed_button=yes

# force buttons to always be active. can add: playlist_prev,playlist_next
buttons_always_active=none

# icon size for the play/pause button
playpause_size=28
# icon size for the middle buttons
midbuttons_size=24
# icon size for the side buttons
sidebuttons_size=24

# show zoom controls in image viewer mode
zoom_control=yes
# maximum zoom in value
zoom_in_max=4
# minimum zoom out value
zoom_out_min=-1

# Colors and style
# accent color of the OSC and title bar
osc_color=#000000
# color of the title in borderless/fullscreen mode
window_title_color=#FFFFFF
# color of the window controls (close, minimize, maximize) in borderless/fullscreen mode
window_controls_color=#FFFFFF
# color of close window control on hover
windowcontrols_close_hover=#F45C5B
# color of maximize window controls on hover
windowcontrols_max_hover=#F8BC3A
# color of minimize window controls on hover
windowcontrols_min_hover=#43CB44
# color of the title
title_color=#FFFFFF
# color of the cache information
cache_info_color=#FFFFFF
# color of the cache ranges on the seekbar
seekbar_cache_color=#B1B1B1
# color of the seekbar progress
seekbarfg_color=#FF8232
# color of the remaining seekbar
seekbarbg_color=#999999
# color of the seekbar handle
seek_handle_color=#C96508
# inner border color drawn inside the seekbar handle (set to disable to disable)
seek_handle_border_color=#FF8232
# match volume bar color with seekbar color (ignores side_buttons_color)
volumebar_match_seek_color=no
# color of the timestamps (below seekbar)
time_color=#FFFFFF
# color of the chapter title
chapter_title_color=#FFFFFF
# color of the side buttons (audio, subtitles, playlist, etc.)
side_buttons_color=#FFFFFF
# color of the middle buttons (skip, jump, chapter, etc.)
middle_buttons_color=#FFFFFF
# color of the play/pause button
playpause_color=#FFFFFF
# color of the element when held down (pressed)
held_element_color=#999999
# color of a hovered button when hover_effect includes "color"
hover_effect_color=#FF8232
# color of the background for thumbnail box
thumbnail_box_color=#111111
# color of the border outline for thumbnail box
thumbnail_box_outline=#404040
# color of chapter nibbles on the seekbar
nibble_color=#FF8232
# color of the current chapter nibble on the seekbar
nibble_current_color=#FFFFFF
# color of the A/B loop range on the seekbar
ab_loop_color=#2596be

# strength of the OSC background fade (0 to disable)
osc_fade_strength=100
# blur strength for the OSC alpha fade. caution: high values can take a lot of CPU time to render
fade_blur_strength=100
# use with "fade_blur_strength=0" to create a transparency box
fade_transparency_strength=0
# strength of the window title bar fade (0 to disable)
window_fade_strength=100
# blur strength for the window title bar. caution: high values can take a lot of CPU time to render
window_fade_blur_strength=100
# use with "window_fade_blur_strength=0" to create a transparency box
window_fade_transparency_strength=0
# thumbnail box padding around the image
thumbnail_box_padding=4.5
# round corner radius for thumbnail box border (0 to disable)
thumbnail_box_radius=4
# thumbnail box border outline size (thickness)
thumbnail_box_outline_size=1

# Button interaction settings
# active button hover effects: glow, size, color, box; can use multiple separated by commas
hover_effect=size,glow,color,box
# relative size of a hovered button if "size" effect is active
button_hover_size=115
# relative size of a button when held/pressed. below 100 shrinks button when held down
button_held_size=100
# alpha of the hover background box when a button is held down
button_held_box_alpha=18
# glow intensity when "glow" hover effect is active
button_glow_amount=5
# relative size of a hovered slider handle (100 = no size change)
slider_hover_size=100
# enable tooltips for most buttons. seek and volume tooltips are always enabled
tooltip_hints=yes

# Progress bar settings
# size ratio of the seekbar handle (range: 0 ~ 1)
seek_handle_size=0.8
# border thickness as a fraction of the handle radius
seek_handle_border_size=0.42
# border thickness when handle is hovered (set equal to seek_handle_border_size to disable)
seek_handle_border_hover_size=0.31
# seekbar height preset: small, medium, large, xlarge
seekbar_height=medium
# show seek range overlay
seekrange=yes
# transparency of the seek range
seekrangealpha=150
# update chapter markers on the seekbar when duration changes
livemarkers=yes
# use keyframes when dragging the seekbar
seekbarkeyframes=yes
# rounded corners seekbar slider
slider_rounded_corners=yes

# chapter nibble style: "gap", "triangle", "bar" or "single-bar"
nibbles_style=gap
# top chapter nibbles above seekbar
nibbles_top=yes
# bottom chapter nibbles below seekbar
nibbles_bottom=yes

# automatically set keyframes for the seekbar based on video length
automatickeyframemode=yes
# videos longer than this (in seconds) will have keyframes on the seekbar
automatickeyframelimit=600

# always show a small progress line at the bottom of the screen
persistent_progress=no
# height of the persistent progress bar
persistent_progress_height=17
# show cached buffer status in the persistent progress line
persistent_buffer=no

# Miscellaneous settings
# only used at init to set visibility_mode(...)
visibility=auto
# visibility modes to cycle through, modes are separated by _
visibility_modes=never_auto_always
# minimum interval between OSC redraws (in seconds)
tick_delay=0.0167
# use display FPS as the minimum redraw interval
tick_delay_follow_display_fps=no

# Elements Position
# Useful when adjusting font size or type

# title vertical offset relative to seekbar
title_offset=20
# title vertical offset if a chapter title is below it
title_with_chapter_offset=5
# chapter title vertical offset relative to seekbar
chapter_title_offset=18
# chapter offset when shown above title
chapter_above_title_offset=3
# time codes vertical offset relative to seekbar
time_codes_offset=0
# tooltip height position offset
tooltip_height_offset=5
# portrait window width trigger to move some elements
portrait_window_trigger=950
# hide volume bar trigger window width
hide_volume_bar_trigger=1150
# osc height
osc_height=60

## Mouse commands
## details: https://github.com/Samillion/ModernZ#mouse-commands-user-options

# title mouse actions
title_mbtn_left_command=script-binding stats/display-page-5
title_mbtn_mid_command=show-text ${path}
title_mbtn_right_command=script-binding select/select-watch-history

# chapter title mouse actions
chapter_title_mbtn_left_command=script-binding select/select-chapter
chapter_title_mbtn_right_command=show-text ${chapter-list} 3000

# seekbar wheel actions
seekbar_wheel_up_command=seek 10
seekbar_wheel_down_command=seek -10

# playlist button mouse actions
playlist_mbtn_left_command=script-binding select/select-playlist
playlist_mbtn_right_command=script-binding select/menu

# volume mouse actions
vol_ctrl_mbtn_left_command=no-osd cycle mute
vol_ctrl_mbtn_right_command=script-binding select/select-audio-device
vol_ctrl_wheel_down_command=osd-msg add volume -5
vol_ctrl_wheel_up_command=osd-msg add volume 5
volumebar_wheel_down_command=osd-msg add volume -5
volumebar_wheel_up_command=osd-msg add volume 5

# audio button mouse actions
audio_track_mbtn_left_command=script-binding select/select-aid
audio_track_mbtn_mid_command=cycle audio down
audio_track_mbtn_right_command=cycle audio
audio_track_wheel_down_command=cycle audio
audio_track_wheel_up_command=cycle audio down

# subtitle button mouse actions
sub_track_mbtn_left_command=script-binding select/select-sid
sub_track_mbtn_mid_command=cycle sub down
sub_track_mbtn_right_command=cycle sub
sub_track_wheel_down_command=cycle sub
sub_track_wheel_up_command=cycle sub down

# play/pause button mouse actions
play_pause_mbtn_left_command=cycle pause
play_pause_mbtn_mid_command=cycle-values loop-playlist inf no
play_pause_mbtn_right_command=cycle-values loop-file inf no

# chapter skip buttons mouse actions
chapter_prev_mbtn_left_command=add chapter -1
chapter_prev_mbtn_mid_command=show-text ${chapter-list} 3000
chapter_prev_mbtn_right_command=script-binding select/select-chapter

chapter_next_mbtn_left_command=add chapter 1
chapter_next_mbtn_mid_command=show-text ${chapter-list} 3000
chapter_next_mbtn_right_command=script-binding select/select-chapter

# playlist skip buttons mouse actions
playlist_prev_mbtn_left_command=playlist-prev
playlist_prev_mbtn_mid_command=show-text ${playlist} 3000
playlist_prev_mbtn_right_command=script-binding select/select-playlist

playlist_next_mbtn_left_command=playlist-next
playlist_next_mbtn_mid_command=show-text ${playlist} 3000
playlist_next_mbtn_right_command=script-binding select/select-playlist

# fullscreen button mouse actions
fullscreen_mbtn_left_command=cycle fullscreen
fullscreen_mbtn_right_command=cycle window-maximized

# info button mouse actions
info_mbtn_left_command=script-binding stats/display-page-1-toggle

# ontop (pin) button mouse actions
ontop_mbtn_left_command=osd-msg cycle ontop

# screenshot button mouse actions
screenshot_mbtn_left_command=osd-msg screenshot video

# loop file button mouse actions
file_loop_mbtn_left_command=osd-msg cycle-values loop-file inf no
file_loop_mbtn_right_command=osd-msg cycle-values loop-playlist inf no

# speed button mouse actions
speed_mbtn_left_command=osd-msg add speed 1
speed_mbtn_right_command=osd-msg set speed 1
speed_wheel_down_command=osd-msg add speed -0.25
speed_wheel_up_command=osd-msg add speed 0.25