Skip to content

Startup options to select config

butterw edited this page Jan 14, 2024 · 4 revisions

Startup options to configure mpv

Switch configurations

  • Disable user config >> uses built-in config: --no-config

    • Files explicitly requested with --include or --use-filedir-conf, will still be loaded.
  • Change the config directory, all other configuration directories are ignored: --config-dir=<path>

    • Force the config directory, ! --no-config has precedence.

Mpv conf

  • Specify configuration file to be parsed after the default ones: --include=myconfig.conf
    • can be used to split mpv.conf into multiple files.
    • can be used with --no-config

Key bindings

  • Override Key binding configuration file: --input-conf=filename.conf
  • Disables the built-in key bindings: --no-input-builtin-bindings
  • Disables weak key bindings (built-in key bindings + keys which scripts bind using mp.add_key_binding): --no-input-default-bindings
    • doesn't affect mp.add_forced_key_binding because this overrides input.conf.

Scripts

  • Disable auto-loading scripts from the scripts folder: --no-load-scripts
  • Manually load scripts: --scripts=debug.dll;file2.lua;...

Script-opts

  • ex: script-opts/btime.conf, ! syntax (filename and inside the conf file)
  • Override script parameter values: --script-opts=key1=value1,key2=value2,...
  • script-opts-append=key1=value1,key2=value2
  • input command: cycle-values script-opts key1=value1