Skip to content

DOCS/man: clarify file-local options - #18299

Merged
kasper93 merged 2 commits into
mpv-player:masterfrom
na-na-hi:file-local-options-doc
Jul 26, 2026
Merged

DOCS/man: clarify file-local options#18299
kasper93 merged 2 commits into
mpv-player:masterfrom
na-na-hi:file-local-options-doc

Conversation

@na-na-hi

Copy link
Copy Markdown
Contributor

Clarify the difference between the file-local options mechanism and when the mechanism is used (such as per-file options).

na-na-hi added 2 commits July 25, 2026 22:37
The file-local-options property sets options that are reset when file
change occurs. This is different from per-file options which are set with
--{ commandline arguments and options parameter of the loadfile command.
Per-file options use file-local option mechanism for setting options when
the file is loaded, but they are persistent and stay with the playlist
entries, unlike file-local-options set at runtime.

This corrects the on_load hook documentation about the effect of setting
file-local-options.
@kasper93
kasper93 merged commit 05d45f4 into mpv-player:master Jul 26, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants