mpv Profiles

mpv Profiles

• built-in profiles: https://github.com/mpv-player/mpv/blob/master/etc/builtin.conf
• list profiles: --profile=help,
  • property: profile-list
• show the contents of a profile: --show-profile=myProfile
• apply profile on startup: --profile=myProfile
• [default] empty profile, runs by default, cannot be applied at runtime.

[Profiles] can be defined in mpv.conf

mpv.conf:

[myProfile]
profile-desc="Description of myProfile"
profile-restore=copy OR copy-equal
...

• a Profile can extend other profiles.

Legacy Auto profile

• Some profiles are loaded automatically using a legacy mechanism. [extension.mkv]

Runtime profiles (! destructive by default)

• Profiles can be set at runtime:
  • apply-profile myProfile
  • apply-profile myProfile restore

! Limitations

• It's important to know that restoring does not "undo" setting an option, but simply copies the old option value. Ex: vf-add, appends an entry to vf. This mechanism will simply copy the entire vf list, and does not execute the inverse of vf-add (that would be vf-remove) on restoring.