Release 0.34.1

Commits 04018c3061
cd7a7a1de8 introduced behavior that
updated window geometry during wayland events (specifically surface and
output). This is good but they also are too aggressive with
automatically resizing. For example, if a window is manually resized by
the user and then dragged to a different monitor with different geometry
than the initial monitor, mpv will automatically resize itself to the
window's resolution. The initial thought behind this logic was for
autofit to automatically readjust itself on a new monitor, but doing
that breaks other common use cases. An attempt could be made to
distinguish between autofit and a manual resize but that introduces a
lot of complexity for an edge case. It's better to simply not change the
window geometry here. Internal values are recalculated and scaled of
course, but wl->window_size and wl->geometry should not change.

.editorconfig

@@ -8,19 +8,3 @@ charset = utf-8
 insert_final_newline = true
 indent_style = space
 indent_size = 4
-max_line_length = 80
-trim_trailing_whitespace = true
-
-[.git/COMMIT*]
-max_line_length = 72
-
-[{osdep/dirent-win.h,TOOLS/osxbundle/mpv.app/Contents/PkgInfo,TOOLS/osxbundle/mpv.app/Contents/Resources/Assets.car}]
-charset = unset
-insert_final_newline = unset
-indent_style = unset
-indent_size = unset
-max_line_length = unset
-trim_trailing_whitespace = unset
-
-[menu.conf]
-indent_style = tab

.editorconfig-checker.json

@@ -1,7 +0,0 @@
-{
-    "Format": "github-actions",
-    "Disable": {
-        "IndentSize": true,
-        "MaxLineLength": true
-    }
-}

.github/ISSUE_TEMPLATE/1_dont_ignore.md

@@ -0,0 +1,16 @@
+---
+name: 'README: DO NOT IGNORE OR DELETE THE ISSUE TEMPLATE'
+about: 'Chose and fill out one of the following templates!'
+title: ''
+labels: priority:ignored-issue-template
+assignees: ''
+
+---
+
+We ask you to not ignore the issue template. Fill it out as good and correct as
+possible. Issues that don't adhere to our request will be closed for ignoring
+the issue template. This is because analyzing a bug without a log file is harder
+than necessary. Low quality bug reports are noise.
+
+Please go back and chose the proper issue template. Opening issues with this
+template will be closed immediately.

.github/ISSUE_TEMPLATE/2_bug_report_linux.md

@@ -0,0 +1,49 @@
+---
+name: 'Report a Linux Issue'
+about: 'Create a report for a runtime related Linux Issue'
+title: ''
+labels: 'os:linux'
+assignees: ''
+
+---
+
+### Important Information
+
+Provide following Information:
+- mpv version
+- Linux Distribution and Version
+- Source of the mpv binary
+- If known which version of mpv introduced the problem
+- Window Manager and version
+- GPU driver and version
+- Possible screenshot or video of visual glitches
+
+If you're not using git master or the latest release, update.
+Releases are listed here: https://github.com/mpv-player/mpv/releases
+
+### Reproduction steps
+
+Try to reproduce your issue with --no-config first. If it isn't reproducible
+with --no-config try to first find out which option or script causes your issue.
+
+Describe the reproduction steps as precise as possible. It's very likely that
+the bug you experience wasn't reproduced by the developer because the workflow
+differs from your own.
+
+### Expected behavior
+
+### Actual behavior
+
+### Log file
+
+Make a log file made with -v -v or --log-file=output.txt, paste it to
+https://0x0.st/ or attach it to the github issue, and replace this text with a
+link to it.
+
+The issue will be closed for ignoring the issue template.
+
+### Sample files
+
+Sample files needed to reproduce this issue can be uploaded to https://0x0.st/
+or similar sites. (Only needed if the issue cannot be reproduced without it.)
+Do not use garbage like "cloud storage", especially not Google Drive.

.github/ISSUE_TEMPLATE/2_bug_report_linux.yml

@@ -1,160 +0,0 @@
-name: "Report a Linux Issue"
-description: "Create a report for a runtime related Linux Issue"
-labels: ["os:linux"]
-type: Bug
-body:
-- type: textarea
-  id: mpv_information
-  attributes:
-      label: "mpv Information"
-      placeholder: |
-          mpv v0.38.0-96-gf776be6af5 Copyright © 2000-2024 mpv/MPlayer/mplayer2 projects
-           built on May  5 2024 18:37:43
-          libplacebo version: v7.349.0 (v6.338.0-120-g7b294350)
-          FFmpeg version: 6.1.1
-          FFmpeg library versions:
-             libavutil       58.29.100
-             libavcodec      60.31.102
-             libavformat     60.16.100
-             libswscale      7.5.100
-             libavfilter     9.12.100
-             libswresample   4.12.100
-      description: |
-          Provide the output of `mpv --version`.
-      render: bash
-  validations:
-      required: false
-- type: textarea
-  id: other_information
-  attributes:
-      label: "Other Information"
-      description: >
-          Provide following information if applicable.
-           - Linux Version: `cat /etc/os-release | grep "NAME"`
-           - Kernel Version: `uname -a`
-           - GPU Model: `lspci -nn | grep VGA` or `lshw -C display -numeric`
-           - Mesa/GPU Driver Version: `glxinfo -B | grep "OpenGL version string"` or `vulkaninfo | grep driverInfo`
-           - Window Manager and Version
-           - Source of the mpv binary
-           - Latest version of mpv you know without the problem
-           - The time when the problem started to happen (after updating mpv, system, driver, etc.)
-           - Possible screenshot or video of visual glitches
-
-          If you're not using the git master branch or the [latest release](https://github.com/mpv-player/mpv/releases/latest), please update.
-          Older versions are not supported. If your distribution does not provide the latest version, please report the issue to them.
-
-          Packages and builds can be found [here](https://mpv.io/installation/).
-      value: |-
-          - Linux version:
-          - Kernel Version:
-          - GPU Model:
-          - Mesa/GPU Driver Version:
-          - Window Manager and Version:
-          - Source of mpv:
-          - Latest known working version:
-          - Issue started after the following happened:
-      render: text
-  validations:
-      required: true
-- type: textarea
-  id: reproduction_steps
-  attributes:
-      label: "Reproduction Steps"
-      description: >
-          Try to reproduce your issue with `--no-config` first. If it isn't reproducible
-          with `--no-config` try to find out which option or script causes your issue.
-
-
-          If the issue is render performance-related, try to reproduce it with `--no-config
-          --profile=fast`, which is designed to work on lower-end mobile devices.
-
-
-          For decoding performance-related issues, additionally try to enable hardware
-          decoding with `--hwdec=yes` or the `Ctrl+h` shortcut.
-
-
-          Describe the reproduction steps as precise as possible. It's very likely that
-          the bug you experience wasn't reproduced by the developer because the workflow
-          differs from your own.
-  validations:
-      required: true
-- type: textarea
-  id: expected_behavior
-  attributes:
-      label: "Expected Behavior"
-      placeholder: "What were you expecting?"
-  validations:
-      required: true
-- type: textarea
-  id: actual_behavior
-  attributes:
-      label: "Actual Behavior"
-      placeholder: "What happened instead?"
-  validations:
-      required: true
-- type: textarea
-  id: log_file
-  attributes:
-      label: "Log File"
-      placeholder: "Drag and drop log file here (Don't paste content directly)"
-      description: >
-          Make a log file with `--gpu-debug --log-file=output.txt`, which is our preferred way, and
-          attach it to the issue.
-
-
-          If you have trouble producing a log file, you can alternatively use `--gpu-debug --msg-time -v -v`,
-          save the terminal output to a file, and attach it to the issue.
-
-
-          In the case of a crash, please provide a [backtrace](https://wiki.archlinux.org/title/Debugging/Getting_traces).
-
-
-          Without the log file, this issue will be closed for ignoring the issue template.
-
-
-          Disclaimer: The log file may contain identifiable information, such as your username.
-          Review the log file before sharing and redact any sensitive data if necessary.
-  validations:
-      required: true
-- type: textarea
-  id: sample_files
-  attributes:
-      label: "Sample Files"
-      placeholder: "Drag and drop sample files here"
-      description: >
-          Please provide sample files for a minimal reproduction case, if the issue can't be
-          reproduced without it or it is helpful to demonstrate the issue.
-
-
-          Preferably files should be attached directly within the text field below. Due to GitHub's
-          upload restriction, you may need to archive the sample file first and upload it as `.zip`
-          file. If the sample file is too big to attach directly, use a solution that is easy to
-          access with possible long-term retention. Possible services include, but are not limited
-          to, the following:
-
-          - [0x0.st](https://0x0.st/) (no long-term retention)
-           - [Dropbox](https://www.dropbox.com)
-           - [Google Drive](https://www.google.com/drive/)
-           - [iCLoud Drive](https://www.icloud.com/iclouddrive/)
-           - [MediaFire](https://www.mediafire.com/)
-           - [OneDrive](https://onedrive.live.com/)
-- type: checkboxes
-  attributes:
-      label: "I carefully read all instruction and confirm that I did the following:"
-      options:
-          - label: "I tested and confirmed that the issue exists with the [latest release version](https://github.com/mpv-player/mpv/releases/latest) or newer."
-            required: true
-          - label: "I provided all required information including system and mpv version."
-            required: true
-          - label: >-
-              I produced the log file with the exact same set of files, parameters, and conditions
-              used in "Reproduction Steps", with the addition of `--log-file=output.txt`.
-            required: true
-          - label: >-
-              I produced the log file while the behaviors described in "Actual Behavior" were
-              actively observed.
-            required: true
-          - label: "I attached the full, untruncated log file."
-            required: true
-          - label: "I attached the backtrace in the case of a crash."
-            required: true

.github/ISSUE_TEMPLATE/2_bug_report_macos.md

@@ -0,0 +1,51 @@
+---
+name: 'Report a macOS Issue'
+about: 'Create a report for a runtime related macOS Issue'
+title: ''
+labels: 'os:mac'
+assignees: ''
+
+---
+
+### Important Information
+
+Provide following Information:
+- mpv version
+- macOS Version
+- Source of the mpv binary or bundle
+- If known which version of mpv introduced the problem
+- Possible screenshot or video of visual glitches
+
+If you're not using git master or the latest release, update.
+Releases are listed here: https://github.com/mpv-player/mpv/releases
+
+### Reproduction steps
+
+Try to reproduce your issue with --no-config first. If it isn't reproducible
+with --no-config try to first find out which option or script causes your issue.
+
+Describe the reproduction steps as precise as possible. It's very likely that
+the bug you experience wasn't reproduced by the developer because the workflow
+differs from your own.
+
+### Expected behavior
+
+### Actual behavior
+
+### Log file
+
+Make a log file made with -v -v or --log-file=output.txt. If you use the Bundle
+from a version later than 0.32 a default log is created for your last run at
+~/Library/Logs/mpv.log. You can jump to that file via the Help > Show log File…
+menu. Paste the log to https://0x0.st/ or attach it to the github issue, and
+replace this text with a link to it.
+
+In the case of a crash please provide the macOS Crash Report (Backtrace).
+
+The issue will be closed for ignoring the issue template.
+
+### Sample files
+
+Sample files needed to reproduce this issue can be uploaded to https://0x0.st/
+or similar sites. (Only needed if the issue cannot be reproduced without it.)
+Do not use garbage like "cloud storage", especially not Google Drive.

.github/ISSUE_TEMPLATE/2_bug_report_macos.yml

@@ -1,153 +0,0 @@
-name: "Report a macOS Issue"
-description: "Create a report for a runtime related macOS Issue"
-labels: ["os:mac"]
-type: Bug
-body:
-- type: textarea
-  id: mpv_information
-  attributes:
-      label: "mpv Information"
-      placeholder: |
-          mpv v0.38.0-96-gf776be6af5 Copyright © 2000-2024 mpv/MPlayer/mplayer2 projects
-           built on May  5 2024 18:37:43
-          libplacebo version: v7.349.0 (v6.338.0-120-g7b294350)
-          FFmpeg version: 6.1.1
-          FFmpeg library versions:
-             libavutil       58.29.100
-             libavcodec      60.31.102
-             libavformat     60.16.100
-             libswscale      7.5.100
-             libavfilter     9.12.100
-             libswresample   4.12.100
-      description: |
-          Provide the output of `mpv --version`.
-      render: bash
-  validations:
-      required: false
-- type: textarea
-  id: other_info
-  attributes:
-      label: "Other Information"
-      description: >
-          - macOS Version: `system_profiler SPSoftwareDataType | sed -rn 's/^ *System Version: (.*$)/\1/p'`
-           - Source of the mpv binary or bundle
-           - Latest version of mpv you know without the problem
-           - The time when the problem started to happen (after updating mpv, system, driver, etc.)
-           - Possible screenshot or video of visual glitches
-
-          If you're not using git master or the latest release, update.
-          Nightly builds from master can be found [here](https://github.com/mpv-player/mpv/actions/workflows/build.yml?query=branch%3Amaster+event%3Apush),
-          click on the latest workflow run, scroll down to the Artifacts section and download the
-          appropriate build. Packages and builds can be found [here](https://mpv.io/installation/).
-      value: |-
-          - macOS version:
-          - Source of mpv:
-          - Latest known working version:
-          - Issue started after the following happened:
-      render: text
-  validations:
-      required: true
-- type: textarea
-  id: reproduction_steps
-  attributes:
-      label: "Reproduction Steps"
-      description: >
-          Try to reproduce your issue with `--no-config` first. If it isn't reproducible
-          with `--no-config` try to find out which option or script causes your issue.
-
-
-          If the issue is render performance-related, try to reproduce it with `--no-config
-          --profile=fast`, which is designed to work on lower-end mobile devices.
-
-
-          For decoding performance-related issues, additionally try to enable hardware
-          decoding with `--hwdec=yes` or the `Ctrl+h` shortcut.
-
-
-          Describe the reproduction steps as precise as possible. It's very likely that
-          the bug you experience wasn't reproduced by the developer because the workflow
-          differs from your own.
-  validations:
-      required: true
-- type: textarea
-  id: expected_behavior
-  attributes:
-      label: "Expected Behavior"
-      placeholder: "What were you expecting?"
-  validations:
-      required: true
-- type: textarea
-  id: actual_behavior
-  attributes:
-      label: "Actual Behavior"
-      placeholder: "What happened instead?"
-  validations:
-      required: true
-- type: textarea
-  id: log_file
-  attributes:
-      label: "Log File"
-      placeholder: "Drag and drop log file here (Don't paste content directly)"
-      description: >
-          Make a log file with `--gpu-debug  --log-file=output.txt`, which is our preferred way, and
-          attach it to the issue. If you use the Bundle, a default log is created for your last run
-          at `~/Library/Logs/mpv.log`. You can jump to that file via the `Help > Show log File…` menu.
-
-
-          If you have trouble producing a log file, you can alternatively use `--gpu-debug --msg-time -v -v`,
-          save the terminal output to a file, and attach it to the issue.
-
-
-          In the case of a crash, please provide the macOS Crash Report or create a [backtrace](https://developer.apple.com/library/archive/documentation/General/Conceptual/lldb-guide/chapters/C5-Examining-The-Call-Stack.html)
-          yourself.
-
-
-          Without the log file, this issue will be closed for ignoring the issue template.
-
-
-          Disclaimer: The log file may contain identifiable information, such as your username.
-          Review the log file before sharing and redact any sensitive data if necessary.
-  validations:
-      required: true
-- type: textarea
-  id: sample_files
-  attributes:
-      label: "Sample Files"
-      placeholder: "Drag and drop sample files here"
-      description: >
-          Please provide sample files for a minimal reproduction case, if the issue can't be
-          reproduced without it or it is helpful to demonstrate the issue.
-
-
-          Preferably files should be attached directly within the text field below. Due to GitHub's
-          upload restriction, you may need to archive the sample file first and upload it as `.zip`
-          file. If the sample file is too big to attach directly, use a solution that is easy to
-          access with possible long-term retention. Possible services include, but are not limited
-          to, the following:
-
-          - [0x0.st](https://0x0.st/) (no long-term retention)
-           - [Dropbox](https://www.dropbox.com)
-           - [Google Drive](https://www.google.com/drive/)
-           - [iCLoud Drive](https://www.icloud.com/iclouddrive/)
-           - [MediaFire](https://www.mediafire.com/)
-           - [OneDrive](https://onedrive.live.com/)
-- type: checkboxes
-  attributes:
-      label: "I carefully read all instruction and confirm that I did the following:"
-      options:
-          - label: "I tested and confirmed that the issue exists with the [latest release version](https://github.com/mpv-player/mpv/releases/latest) or newer."
-            required: true
-          - label: "I provided all required information including system and mpv version."
-            required: true
-          - label: >-
-              I produced the log file with the exact same set of files, parameters, and conditions
-              used in "Reproduction Steps", with the addition of `--log-file=output.txt`.
-            required: true
-          - label: >-
-              I produced the log file while the behaviors described in "Actual Behavior" were
-              actively observed.
-            required: true
-          - label: "I attached the full, untruncated log file."
-            required: true
-          - label: "I attached the backtrace in the case of a crash."
-            required: true

.github/ISSUE_TEMPLATE/2_bug_report_windows.md

@@ -0,0 +1,47 @@
+---
+name: 'Report a Windows Issue'
+about: 'Create a report for a runtime related Windows Issue'
+title: ''
+labels: 'os:win'
+assignees: ''
+
+---
+
+### Important Information
+
+Provide following Information:
+- mpv version
+- Windows Version
+- Source of the mpv binary
+- If known which version of mpv introduced the problem
+- Possible screenshot or video of visual glitches
+
+If you're not using git master or the latest release, update.
+Releases are listed here: https://github.com/mpv-player/mpv/releases
+
+### Reproduction steps
+
+Try to reproduce your issue with --no-config first. If it isn't reproducible
+with --no-config try to first find out which option or script causes your issue.
+
+Describe the reproduction steps as precise as possible. It's very likely that
+the bug you experience wasn't reproduced by the developer because the workflow
+differs from your own.
+
+### Expected behavior
+
+### Actual behavior
+
+### Log file
+
+Make a log file made with -v -v or --log-file=output.txt, paste it to
+https://0x0.st/ or attach it to the github issue, and replace this text with a
+link to it.
+
+The issue will be closed for ignoring the issue template.
+
+### Sample files
+
+Sample files needed to reproduce this issue can be uploaded to https://0x0.st/
+or similar sites. (Only needed if the issue cannot be reproduced without it.)
+Do not use garbage like "cloud storage", especially not Google Drive.

.github/ISSUE_TEMPLATE/2_bug_report_windows.yml

@@ -1,154 +0,0 @@
-name: "Report a Windows Issue"
-description: "Create a report for a runtime related Windows Issue"
-labels: ["os:win"]
-type: Bug
-body:
-- type: textarea
-  id: mpv_information
-  attributes:
-      label: "mpv Information"
-      placeholder: |
-          mpv v0.38.0-96-gf776be6af5 Copyright © 2000-2024 mpv/MPlayer/mplayer2 projects
-           built on May  5 2024 18:37:43
-          libplacebo version: v7.349.0 (v6.338.0-120-g7b294350)
-          FFmpeg version: 6.1.1
-          FFmpeg library versions:
-             libavutil       58.29.100
-             libavcodec      60.31.102
-             libavformat     60.16.100
-             libswscale      7.5.100
-             libavfilter     9.12.100
-             libswresample   4.12.100
-      description: |
-          Provide the output of `mpv --version`.
-      render: bash
-  validations:
-      required: false
-- type: textarea
-  id: other_information
-  attributes:
-      label: "Other Information"
-      description: >
-          - Windows Version: `cmd /c ver`
-           - GPU model, driver and version
-           - Source of the mpv binary
-           - Latest version of mpv you know without the problem
-           - The time when the problem started to happen (after updating mpv, system, driver, etc.)
-           - Possible screenshot or video of visual glitches
-
-          If you're not using git master or the latest release, update.
-          Nightly builds from master can be found [here](https://github.com/mpv-player/mpv/actions/workflows/build.yml?query=branch%3Amaster+event%3Apush),
-          click on the latest workflow run, scroll down to the Artifacts section and download the
-          appropriate build. Packages and builds can be found [here](https://mpv.io/installation/).
-      value: |-
-          - Windows version:
-          - GPU model, driver and version:
-          - Source of mpv:
-          - Latest known working version:
-          - Issue started after the following happened:
-      render: text
-  validations:
-      required: true
-- type: textarea
-  id: reproduction_steps
-  attributes:
-      label: "Reproduction Steps"
-      description: >
-          Try to reproduce your issue with `--no-config` first. If it isn't reproducible
-          with `--no-config` try to find out which option or script causes your issue.
-
-
-          If the issue is render performance-related, try to reproduce it with `--no-config
-          --profile=fast`, which is designed to work on lower-end mobile devices.
-
-
-          For decoding performance-related issues, additionally try to enable hardware
-          decoding with `--hwdec=yes` or the `Ctrl+h` shortcut.
-
-
-          Describe the reproduction steps as precise as possible. It's very likely that
-          the bug you experience wasn't reproduced by the developer because the workflow
-          differs from your own.
-  validations:
-      required: true
-- type: textarea
-  id: expected_behavior
-  attributes:
-      label: "Expected Behavior"
-      placeholder: "What were you expecting?"
-  validations:
-      required: true
-- type: textarea
-  id: actual_behavior
-  attributes:
-      label: "Actual Behavior"
-      placeholder: "What happened instead?"
-  validations:
-      required: true
-- type: textarea
-  id: log_file
-  attributes:
-      label: "Log File"
-      placeholder: "Drag and drop log file here (Don't paste content directly)"
-      description: >
-          Make a log file with `--gpu-debug --log-file=output.txt`, which is our preferred way, and
-          attach it to the issue.
-
-
-          If you have trouble producing a log file, you can alternatively use `--gpu-debug --msg-time -v -v`,
-          save the terminal output to a file, and attach it to the issue.
-
-
-          In the case of a crash, please provide a backtrace, attach the appropriate `.dmp` file
-          from `%LOCALAPPDATA%\CrashDumps`.
-
-
-          Without the log file, this issue will be closed for ignoring the issue template.
-
-
-          Disclaimer: The log file may contain identifiable information, such as your username.
-          Review the log file before sharing and redact any sensitive data if necessary.
-  validations:
-      required: true
-- type: textarea
-  id: sample_files
-  attributes:
-      label: "Sample Files"
-      placeholder: "Drag and drop sample files here"
-      description: >
-          Please provide sample files for a minimal reproduction case, if the issue can't be
-          reproduced without it or it is helpful to demonstrate the issue.
-
-
-          Preferably files should be attached directly within the text field below. Due to GitHub's
-          upload restriction, you may need to archive the sample file first and upload it as `.zip`
-          file. If the sample file is too big to attach directly, use a solution that is easy to
-          access with possible long-term retention. Possible services include, but are not limited
-          to, the following:
-
-          - [0x0.st](https://0x0.st/) (no long-term retention)
-           - [Dropbox](https://www.dropbox.com)
-           - [Google Drive](https://www.google.com/drive/)
-           - [iCLoud Drive](https://www.icloud.com/iclouddrive/)
-           - [MediaFire](https://www.mediafire.com/)
-           - [OneDrive](https://onedrive.live.com/)
-- type: checkboxes
-  attributes:
-      label: "I carefully read all instruction and confirm that I did the following:"
-      options:
-          - label: "I tested and confirmed that the issue exists with the [latest release version](https://github.com/mpv-player/mpv/releases/latest) or newer."
-            required: true
-          - label: "I provided all required information including system and mpv version."
-            required: true
-          - label: >-
-              I produced the log file with the exact same set of files, parameters, and conditions
-              used in "Reproduction Steps", with the addition of `--log-file=output.txt`.
-            required: true
-          - label: >-
-              I produced the log file while the behaviors described in "Actual Behavior" were
-              actively observed.
-            required: true
-          - label: "I attached the full, untruncated log file."
-            required: true
-          - label: "I attached the backtrace in the case of a crash."
-            required: true

.github/ISSUE_TEMPLATE/3_bug_report.md

@@ -0,0 +1,43 @@
+---
+name: 'Report a different Issue'
+about: 'Create a report for a runtime related Issue'
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+### Important Information
+
+Provide following Information:
+- mpv version
+- Platform and Version
+- Source of the mpv binary
+
+If you're not using git master or the latest release, update.
+Releases are listed here: https://github.com/mpv-player/mpv/releases
+
+### Reproduction steps
+
+Try to reproduce your issue with --no-config first. If it isn't reproducible
+with --no-config try to first find out which option or script causes your issue.
+
+Describe the reproduction steps as precise as possible. It's very likely that
+the bug you experience wasn't reproduced by the developer because the workflow
+differs from your own.
+
+### Expected behavior
+
+### Actual behavior
+
+### Log file
+
+Make a log file made with -v -v or --log-file=output.txt, paste it to
+https://0x0.st/ or attach it to the github issue, and replace this text with a
+link to it.
+
+### Sample files
+
+Sample files needed to reproduce this issue can be uploaded to https://0x0.st/
+or similar sites. (Only needed if the issue cannot be reproduced without it.)
+Do not use garbage like "cloud storage", especially not Google Drive.

.github/ISSUE_TEMPLATE/3_bug_report.yml

@@ -1,151 +0,0 @@
-name: "Report an Issue on other platforms"
-description: "Create a report for a runtime related Issue on other platforms"
-labels: []
-type: Bug
-body:
-- type: textarea
-  id: mpv_information
-  attributes:
-      label: "mpv Information"
-      placeholder: |
-          mpv v0.38.0-96-gf776be6af5 Copyright © 2000-2024 mpv/MPlayer/mplayer2 projects
-           built on May  5 2024 18:37:43
-          libplacebo version: v7.349.0 (v6.338.0-120-g7b294350)
-          FFmpeg version: 6.1.1
-          FFmpeg library versions:
-             libavutil       58.29.100
-             libavcodec      60.31.102
-             libavformat     60.16.100
-             libswscale      7.5.100
-             libavfilter     9.12.100
-             libswresample   4.12.100
-      description: |
-          Provide the output of `mpv --version`.
-      render: bash
-  validations:
-      required: false
-- type: textarea
-  id: important_information
-  attributes:
-      label: "Important Information"
-      description: >
-          - Platform and Version
-           - GPU model, driver and version
-           - Source of the mpv binary
-           - Latest version of mpv you know without the problem
-           - The time when the problem started to happen (after updating mpv, system, driver, etc.)
-           - Possible screenshot or video of visual glitches
-
-          If you're not using git master or the latest release, update.
-          Packages and builds can be found [here](https://mpv.io/installation/).
-      value: |-
-          - Platform version:
-          - GPU model, driver and version:
-          - Source of mpv:
-          - Latest known working version:
-          - Issue started after the following happened:
-      render: text
-  validations:
-      required: true
-- type: textarea
-  id: reproduction_steps
-  attributes:
-      label: "Reproduction Steps"
-      description: >
-          Try to reproduce your issue with `--no-config` first. If it isn't reproducible
-          with `--no-config` try to find out which option or script causes your issue.
-
-
-          If the issue is render performance-related, try to reproduce it with `--no-config
-          --profile=fast`, which is designed to work on lower-end mobile devices.
-
-
-          For decoding performance-related issues, additionally try to enable hardware
-          decoding with `--hwdec=yes` or the `Ctrl+h` shortcut.
-
-
-          Describe the reproduction steps as precise as possible. It's very likely that
-          the bug you experience wasn't reproduced by the developer because the workflow
-          differs from your own.
-  validations:
-      required: true
-- type: textarea
-  id: expected_behavior
-  attributes:
-      label: "Expected Behavior"
-      placeholder: "What were you expecting?"
-  validations:
-      required: true
-- type: textarea
-  id: actual_behavior
-  attributes:
-      label: "Actual Behavior"
-      placeholder: "What happened instead?"
-  validations:
-      required: true
-- type: textarea
-  id: log_file
-  attributes:
-      label: "Log File"
-      placeholder: "Drag and drop log file here (Don't paste content directly)"
-      description: >
-          Make a log file with `--gpu-debug --log-file=output.txt`, which is our preferred way, and
-          attach it to the issue.
-
-
-          If you have trouble producing a log file, you can alternatively use `--gpu-debug --msg-time -v -v`,
-          save the terminal output to a file, and attach it to the issue.
-
-
-          In the case of a crash, please provide a backtrace.
-
-
-          Without the log file, this issue will be closed for ignoring the issue template.
-
-
-          Disclaimer: The log file may contain identifiable information, such as your username.
-          Review the log file before sharing and redact any sensitive data if necessary.
-  validations:
-      required: true
-- type: textarea
-  id: sample_files
-  attributes:
-      label: "Sample Files"
-      placeholder: "Drag and drop sample files here"
-      description: >
-          Please provide sample files for a minimal reproduction case, if the issue can't be
-          reproduced without it or it is helpful to demonstrate the issue.
-
-
-          Preferably files should be attached directly within the text field below. Due to GitHub's
-          upload restriction, you may need to archive the sample file first and upload it as `.zip`
-          file. If the sample file is too big to attach directly, use a solution that is easy to
-          access with possible long-term retention. Possible services include, but are not limited
-          to, the following:
-
-          - [0x0.st](https://0x0.st/) (no long-term retention)
-           - [Dropbox](https://www.dropbox.com)
-           - [Google Drive](https://www.google.com/drive/)
-           - [iCLoud Drive](https://www.icloud.com/iclouddrive/)
-           - [MediaFire](https://www.mediafire.com/)
-           - [OneDrive](https://onedrive.live.com/)
-- type: checkboxes
-  attributes:
-      label: "I carefully read all instruction and confirm that I did the following:"
-      options:
-          - label: "I tested and confirmed that the issue exists with the [latest release version](https://github.com/mpv-player/mpv/releases/latest) or newer."
-            required: true
-          - label: "I provided all required information including system and mpv version."
-            required: true
-          - label: >-
-              I produced the log file with the exact same set of files, parameters, and conditions
-              used in "Reproduction Steps", with the addition of `--log-file=output.txt`.
-            required: true
-          - label: >-
-              I produced the log file while the behaviors described in "Actual Behavior" were
-              actively observed.
-            required: true
-          - label: "I attached the full, untruncated log file."
-            required: true
-          - label: "I attached the backtrace in the case of a crash."
-            required: true

.github/ISSUE_TEMPLATE/4_bug_report_build.md

@@ -0,0 +1,30 @@
+---
+name: 'Report a build Problem'
+about: 'Create a report for a build related Issue'
+title: ''
+labels: 'core:waf'
+assignees: ''
+
+---
+
+### mpv version and platform versions
+
+If you're not using git master or the latest release, update.
+Releases are listed here: https://github.com/mpv-player/mpv/releases
+
+### Reproduction steps
+
+Describe the reproduction steps as precise as possible. It's very likely that
+the bug you experience wasn't reproduced by the developer because the workflow
+differs from your own.
+
+### Expected behavior
+
+### Actual behavior
+
+### Log file
+
+Upload build/config.log or ./waf configure output to https://0x0.st/ or attach
+it to the github issue, and replace this text with a link to it.
+
+The issue will be closed for ignoring the issue template.

.github/ISSUE_TEMPLATE/4_bug_report_build.yml

@@ -1,76 +0,0 @@
-name: "Report a build Problem"
-description: "Create a report for a build related Issue"
-labels: ["core:meson"]
-type: Bug
-body:
-- type: textarea
-  id: important_information
-  attributes:
-      label: "Important Information"
-      description: >
-          - mpv version
-           - Platform and Version
-           - Meson version
-
-          If you're not using git master or the latest release, update.
-          Releases are listed [here](https://github.com/mpv-player/mpv/releases).
-      value: |-
-          - mpv version:
-          - Platform version:
-          - Meson version:
-      render: text
-  validations:
-      required: true
-- type: textarea
-  id: reproduction_steps
-  attributes:
-      label: "Reproduction Steps"
-      description: >
-          Describe the reproduction steps as precise as possible. It's very likely that
-          the bug you experience wasn't reproduced by the developer because the workflow
-          differs from your own.
-  validations:
-      required: true
-- type: textarea
-  id: expected_behavior
-  attributes:
-      label: "Expected Behavior"
-      placeholder: "What were you expecting?"
-  validations:
-      required: true
-- type: textarea
-  id: actual_behavior
-  attributes:
-      label: "Actual Behavior"
-      placeholder: "What happened instead?"
-  validations:
-      required: true
-- type: textarea
-  id: log_file
-  attributes:
-      label: "Log File"
-      placeholder: "Drag and drop log file here (Don't paste content directly)"
-      description: >
-          Attach meson-logs/meson-log.txt or meson setup build output to the issue.
-
-          Without the log file, this issue will be closed for ignoring the issue template.
-  validations:
-      required: true
-- type: checkboxes
-  attributes:
-      label: "I carefully read all instruction and confirm that I did the following:"
-      options:
-          - label: "I tested and confirmed that the issue exists with the [latest release version](https://github.com/mpv-player/mpv/releases/latest) or newer."
-            required: true
-          - label: "I provided all required information including system and mpv version."
-            required: true
-          - label: >-
-              I produced the log file with the exact same set of parameters, and conditions used in
-              "Reproduction Steps".
-            required: true
-          - label: >-
-              I produced the log file while the behaviors described in "Actual Behavior" were
-              actively observed.
-            required: true
-          - label: "I attached the full, untruncated log file."
-            required: true

.github/ISSUE_TEMPLATE/5_feature_request.md

@@ -0,0 +1,22 @@
+---
+name: 'Request a new Feature'
+about: 'Create a request for a new feature'
+title: ''
+labels: 'meta:feature-request'
+assignees: ''
+
+---
+
+Before requesting a new feature make sure it hasn't been requested yet.
+https://github.com/mpv-player/mpv/labels/meta%3Afeature-request
+
+### Expected behavior of the wanted feature
+
+### Alternative behavior of the wanted feature
+
+### Log file
+
+Even if you think it's not necessary at first, it might help us later to find
+possible issues. Make a log file made with -v -v or --log-file=output.txt, paste
+it to https://0x0.st/ or attach it to the github issue, and replace this text
+with a link to it.

.github/ISSUE_TEMPLATE/5_feature_request.yml

@@ -1,60 +0,0 @@
-name: "Request a new Feature"
-description: "Create a request for a new feature"
-labels: ["meta:feature-request"]
-type: Feature
-body:
-- type: textarea
-  id: expected_behavior
-  attributes:
-      label: "Expected behavior of the wanted feature"
-      description: >
-          Before requesting a new feature, make sure it hasn't been
-          [requested yet](https://github.com/mpv-player/mpv/labels/meta%3Afeature-request),
-          and isn't already supported by [mpv](https://mpv.io/manual/master/),
-          [ffmpeg](https://ffmpeg.org/documentation.html), or existing
-          [mpv scripts](https://github.com/mpv-player/mpv/wiki/User-Scripts).
-
-
-          If you are not sure about this, ask on
-          [mpv Discussions](https://github.com/mpv-player/mpv/discussions) and
-          [mpv IRC channel](https://mpv.io/community/) first before opening a feature request.
-  validations:
-      required: true
-- type: textarea
-  id: alternative_behavior
-  attributes:
-      label: "Alternative behavior of the wanted feature"
-- type: textarea
-  id: log_file
-  attributes:
-      label: "Log File"
-      description: >
-          Even if you think it's not necessary at first, it might help us later to find
-          possible issues. Make a log file with `--log-file=output.txt`, which is our preferred way,
-          and attach it to the issue.
-
-
-          If you have trouble producing a log file, you can alternatively use `-v -v`, save the
-          terminal output to a file, and attach it to the issue.
-- type: textarea
-  id: sample_files
-  attributes:
-      label: "Sample Files"
-      placeholder: "Drag and drop sample files here"
-      description: >
-          Please provide sample files in the case you request a format/codec/container dependent
-          feature, and it could help us test and implement it.
-
-
-          Preferably files should be attached directly within the text field below. Due to GitHub's
-          upload restriction, you may need to archive the sample file first and upload it as `.zip`
-          file. If the sample file is too big to attach directly, use a solution that is easy to
-          access with possible long-term retention. Possible services include, but are not limited
-          to, the following:
-
-          - [0x0.st](https://0x0.st/) (no long-term retention)
-           - [Dropbox](https://www.dropbox.com)
-           - [Google Drive](https://www.google.com/drive/)
-           - [iCLoud Drive](https://www.icloud.com/iclouddrive/)
-           - [MediaFire](https://www.mediafire.com/)
-           - [OneDrive](https://onedrive.live.com/)

.github/ISSUE_TEMPLATE/6_question.md

@@ -0,0 +1,25 @@
+---
+name: 'Ask a Question'
+about: 'Ask a question about mpv'
+title: ''
+labels: 'meta:question'
+assignees: ''
+
+---
+
+Don't ask questions about issues, errors or problems you have and instead open
+a proper issue with the right template from the previous selection.
+
+This template is meant for questions about the workings of mpv, to clarify about
+unspecified behaviour of options or command, or anything else that is not well
+described and needs clarification.
+
+Before asking a question make sure it hasn't been asked or answered yet.
+https://github.com/mpv-player/mpv/labels/meta%3Aquestion
+
+### Log file
+
+Even if you think it's not necessary at first, it might help us later to find
+possible issues. Make a log file made with -v -v or --log-file=output.txt, paste
+it to https://0x0.st/ or attach it to the github issue, and replace this text
+with a link to it.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,5 @@
 blank_issues_enabled: false
 contact_links:
-  - name: mpv Discussions
-    url: https://github.com/mpv-player/mpv/discussions
-    about: If you have questions or want to discuss things use our GitHub Discussions
   - name: mpv IRC channel
     url: https://mpv.io/community/
     about: Feel free to ask questions here irc://irc.libera.chat/mpv

.github/PULL_REQUEST_TEMPLATE

@@ -2,4 +2,4 @@ Read this before you submit this pull request:
 https://github.com/mpv-player/mpv/blob/master/DOCS/contribute.md
 
 Reading this link and following the rules will get your pull request reviewed
-and merged faster. Nobody wants lazy pull requests.
+and merged faster. Nobody wants lazy pull requests.

.github/dependabot.yml

@@ -1,8 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-    commit-message:
-      prefix: "ci"

.github/workflows/build.yml

@@ -6,781 +6,150 @@ on:
       - master
       - ci
       - 'release/**'
-    paths-ignore:
-      - 'DOCS/**'
-      - 'TOOLS/lua/**'
-      - '.editorconfig'
-      - '.github/ISSUE_TEMPLATE/**'
-      - '.github/PULL_REQUEST_TEMPLATE'
-      - '.gitignore'
-      - 'Copyright'
-      - 'README.md'
-      - 'RELEASE_NOTES'
   pull_request:
     branches: [master]
-    paths-ignore:
-      - 'DOCS/**'
-      - 'TOOLS/lua/**'
-      - '.editorconfig'
-      - '.github/ISSUE_TEMPLATE/**'
-      - '.github/PULL_REQUEST_TEMPLATE'
-      - '.gitignore'
-      - 'Copyright'
-      - 'README.md'
-      - 'RELEASE_NOTES'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
 
 jobs:
   mingw:
-    runs-on: ubuntu-24.04
-    env:
-      CCACHE_BASEDIR: ${{ github.workspace }}
-      CCACHE_DIR: ${{ github.workspace }}/.ccache
-      CCACHE_MAXSIZE: 500M
-      DOWNLOAD_CACHE: ${{ github.workspace }}/.ccache/downloads
-      TARGET: ${{ matrix.arch }}-w64-mingw32
-      RUST_TARGET: ${{ matrix.arch }}-pc-windows-gnu
+    runs-on: ubuntu-20.04
     strategy:
-      fail-fast: false
       matrix:
-        include:
-          - arch: i686
-            wine: wine32
-          - arch: x86_64
-            wine: wine64
+        target: [i686-w64-mingw32, x86_64-w64-mingw32]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v2
 
-      - name: Get time
-        id: get_time
-        run: echo "timestamp=`date +%s%N`" >> $GITHUB_OUTPUT
-
-      - name: Restore cache
-        uses: actions/cache/restore@v5
+      # Increase -N suffix here to force full rebuild after changes
+      - uses: actions/cache@v2
         with:
-          path: ${{ env.CCACHE_DIR }}
-          key: ${{ env.TARGET }}-${{ steps.get_time.outputs.timestamp }}
-          restore-keys: ${{ env.TARGET }}-
+          path: mingw_prefix/
+          key: "${{ matrix.target }}-1"
 
       - name: Install dependencies
         run: |
-          rustup target add ${{ env.RUST_TARGET }}
-          sudo dpkg --add-architecture i386
           sudo apt-get update
-          sudo apt-get install --no-install-recommends -y ccache g++-mingw-w64 gcc-multilib python3-pip nasm ninja-build pkgconf ${{ matrix.wine }} wine
-          python -m pip install meson
-
-      - name: Install Meson Wraps
-        run: |
-          mkdir subprojects -p
-          meson wrap install mujs
-          meson subprojects download
-
-      - name: Build libraries
-        run: |
-          ./ci/build-mingw64.sh
-
-      - name: Build with meson
-        id: build
-        run: |
-          ./ci/build-mingw64.sh meson pack
-
-      - name: Print meson log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
-        run: |
-          cat ./mingw_build/meson-logs/meson-log.txt
-
-      - name: Functional test
-        run: |
-          cd artifact && wine ./mpv.com -v --no-config
-        env:
-          WINEDEBUG: '+loaddll'
-
-      - name: Run meson tests
-        id: tests
-        run: |
-          meson test -C mingw_build
-
-      - name: Print meson test log
-        if: ${{ failure() && steps.tests.outcome == 'failure' }}
-        run: |
-          cat ./mingw_build/meson-logs/testlog.txt
-
-      - name: Artifact name
-        id: artifact
-        run: |
-          VERSION_FILE=$(find . -path "*/common/version.h" -type f | head -n 1)
-          VER=$(grep VERSION "$VERSION_FILE" | cut -d'"' -f2)
-          PR=${{ github.event.pull_request.number && format('-pr{0}', github.event.pull_request.number) || '' }}
-          echo "name=mpv-$VER$PR-${{ github.run_id }}-$TARGET" >> "$GITHUB_OUTPUT"
-
-      - uses: actions/upload-artifact@v7
-        with:
-          name: ${{ steps.artifact.outputs.name }}
-          path: artifact/*
-
-      - name: Save Cache
-        uses: actions/cache/save@v5
-        if: always()
-        with:
-          path: ${{ env.CCACHE_DIR }}
-          key: ${{ env.TARGET }}-${{ steps.get_time.outputs.timestamp }}
-
-  win32:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - target: x86_64-pc-windows-msvc
-            arch: "x64"
-            os: "windows-2025-vs2026"
-          - target: aarch64-pc-windows-msvc
-            arch: "arm64"
-            os: "windows-11-arm"
-    env:
-      CC: "ccache clang"
-      CXX: "ccache clang++"
-      CC_LD: "lld-link"
-      CXX_LD: "lld-link"
-      RUST_LD: "lld-link"
-      WINDRES: "llvm-rc"
-      CCACHE_BASEDIR: ${{ github.workspace }}
-      CCACHE_DIR: "${{ github.workspace }}\\.ccache"
-      CCACHE_MAXSIZE: 500M
-    steps:
-      - name: Disable autocrlf
-        run: |
-          git config --global core.autocrlf false
-          git config --global core.eol lf
-
-      - uses: actions/checkout@v6
-
-      - name: Get time
-        id: get_time
-        run: |
-          "timestamp=$((Get-Date).Ticks)" >> $env:GITHUB_OUTPUT
-
-      - name: Restore cache
-        uses: actions/cache/restore@v5
-        with:
-          path: ${{ env.CCACHE_DIR }}
-          key: ${{ matrix.target }}-${{ steps.get_time.outputs.timestamp }}
-          restore-keys: ${{ matrix.target }}-
-
-      - name: Install Winget on windows-11-arm
-        if: matrix.os == 'windows-11-arm'
-        shell: pwsh
-        run: |
-          Install-Module -Name Microsoft.WinGet.Client -Repository PSGallery -Force
-          Repair-WinGetPackageManager -Latest -Force
-
-      - name: Install dependencies
-        run: |
-          python -m pip install meson
-          winget install --accept-source-agreements --accept-package-agreements Ccache.Ccache NASM.NASM
-          echo "$env:LOCALAPPDATA\Microsoft\WinGet\Links" >> $env:GITHUB_PATH
-          # For cargo -C
-          rustup default nightly
-
-      - name: Update Meson WrapDB
-        run: |
-          meson wrap update-db
-          # Explicitly download wraps, as nested projects may have older versions of them.
-          meson wrap install expat
-          meson wrap install harfbuzz
-          meson wrap install libpng
-          meson wrap install zlib
-
-      - name: Find Visual Studio
-        run: |
-          $vswhere = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
-          $vsPath = & $vswhere -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath
-          if (-not $vsPath) { throw "Could not find a Visual Studio installation" }
-          "VS=$vsPath"
-          "VS=$vsPath" >> $env:GITHUB_ENV
+          sudo apt-get install -y autoconf automake pkg-config g++-mingw-w64 gcc-multilib nasm yasm
+          ./bootstrap.py
 
       - name: Build
-        id: build
         run: |
-          $env:PATH = ($env:PATH -split ';' | Where-Object { $_ -ne 'C:\Program Files\LLVM\bin' -and `
-                                                             $_ -ne 'C:\Program Files\CMake\bin' -and `
-                                                             $_ -ne 'C:\Strawberry\c\bin' }) -join ';'
-          $env:PATH += ';C:\Program Files\NASM'
-          Import-Module "$env:VS\Common7\Tools\Microsoft.VisualStudio.DevShell.dll"
-          Enter-VsDevShell -VsInstallPath $env:VS -SkipAutomaticLocation -DevCmdArguments "-arch=${{ matrix.arch }} -host_arch=${{ matrix.arch }}"
-          ./ci/build-win32.ps1
+          ./ci/build-mingw64.sh
+        env:
+          TARGET: ${{ matrix.target }}
 
-      - name: Print build log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
+      - name: Print configure log
+        if: ${{ failure() }}
         run: |
-          cat ./build/meson-logs/meson-log.txt
-
-      - name: Run meson tests
-        id: tests
-        run: |
-          $env:PATH = ($env:PATH -split ';' | Where-Object { $_ -ne 'C:\Program Files\LLVM\bin' -and `
-                                                             $_ -ne 'C:\Program Files\CMake\bin' -and `
-                                                             $_ -ne 'C:\Strawberry\c\bin' }) -join ';'
-          $env:PATH += ';C:\Program Files\NASM'
-          Import-Module "$env:VS\Common7\Tools\Microsoft.VisualStudio.DevShell.dll"
-          Enter-VsDevShell -VsInstallPath $env:VS -SkipAutomaticLocation -DevCmdArguments "-arch=${{ matrix.arch }} -host_arch=${{ matrix.arch }}"
-          meson test -C build -t 2
-
-      - name: Print meson test log
-        if: ${{ failure() && steps.tests.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/testlog.txt
-
-      - name: Artifact name
-        id: artifact
-        run: |
-          $VERSION_FILE = gci . -r -Filter "version.h" | ? { $_.FullName -match "[/\\]common[/\\]version\.h$" } | select -First 1 -exp FullName
-          $VER = (sls $VERSION_FILE -Pattern 'VERSION').Line -replace '.*"([^"]+)".*', '$1'
-          $PR = if ("${{ github.event.pull_request.number }}") { "-pr${{ github.event.pull_request.number }}" } else { "" }
-          $name = "mpv-$VER$PR-${{ github.run_id }}-${{ matrix.target }}"
-          "name=$name" >> $env:GITHUB_OUTPUT
-
-      - uses: actions/upload-artifact@v7
-        with:
-          name: ${{ steps.artifact.outputs.name }}
-          path: |
-            build/mpv.???
-            build/mpv-*.bat
-            build/vulkan-*.dll
-            !build/mpv.lib
-            !build/mpv.pdb
-
-      - uses: actions/upload-artifact@v7
-        with:
-          name: ${{ steps.artifact.outputs.name }}-pdb
-          path: |
-            build/mpv.pdb
-
-      - name: Save Cache
-        uses: actions/cache/save@v5
-        if: always()
-        with:
-          path: ${{ env.CCACHE_DIR }}
-          key: ${{ matrix.target }}-${{ steps.get_time.outputs.timestamp }}
+          cat ./build/config.log
 
   macos:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        include:
-          - os: "macos-14"
-            arch: "arm"
-            xcode: "Xcode_15.0"
-          - os: "macos-15"
-            arch: "arm"
-          - os: "macos-15-intel"
-          - os: "macos-26"
-            arch: "arm"
-          - os: "macos-26"
-            arch: "test"
-            swift: "-target arm64-apple-macosx10.15"
-            target: "10.15"
+        cc:
+          - "clang"
+        os:
+          - "macos-10.15"
+          - "macos-11"
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v2
 
-      - name: Remove stray upstream python binary symlinks under /usr/local
+      - name: Override Xcode 13.0 if it's the default toolchain
         run: |
-          find /usr/local/bin -lname '*/Library/Frameworks/Python.framework/*' -delete -print
-          brew unlink python && brew link --overwrite python
-
-      - name: Unlink pkg-config if the CI runner happens to have it already installed
-        run: |
-          find "$(brew config | grep HOMEBREW_PREFIX | cut -f 2- -d ' ')/bin" -lname '*/pkg-config@0*/*' -print -exec brew unlink pkg-config@0.29.2 \; -quit
-
-      - name: Change Xcode version
-        if: ${{ matrix.xcode != '' }}
-        run: |
-          sudo xcode-select -s /Applications/${{ matrix.xcode }}.app
+          XCODE_PATH="$(xcode-select -p)"
+          case "${XCODE_PATH}" in
+            *Xcode_13.0*)
+              sudo xcode-select -s "/Applications/Xcode_13.1.app"
+              echo "Updated Xcode path ${XCODE_PATH} -> $(xcode-select -p)"
+              ;;
+          esac
 
       - name: Install dependencies
         run: |
-          if [[ -n "${{ matrix.homebrew }}" ]]; then
-            export HOMEBREW_NO_AUTO_UPDATE=1
-            cd "$(brew --repo homebrew/core)"
-            git checkout --force ${{ matrix.homebrew }}
-          else
-            brew update
-          fi
-          if brew list ffmpeg &> /dev/null; then brew unlink ffmpeg; fi
-          brew install -q autoconf automake curl pkgconf libtool python freetype fribidi little-cms2 \
-            luajit libass ffmpeg-full meson rust uchardet mujs libplacebo molten-vk vulkan-loader vulkan-headers \
-            libarchive libbluray libcaca libcdio-paranoia libdvdnav rubberband zimg
-          brew link ffmpeg-full
+          brew update
+          brew install autoconf automake pkg-config libtool python freetype fribidi little-cms2 luajit libass ffmpeg
 
-      - name: Build with meson
-        id: build
+      - name: Build
         run: |
           ./ci/build-macos.sh
         env:
+          CC: "${{ matrix.cc }}"
           TRAVIS_OS_NAME: "${{ matrix.os }}"
-          SWIFT_FLAGS: "${{ matrix.swift }}"
-          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.target }}"
 
-      - name: Create App Bundle
-        if: ${{ matrix.arch != 'test' }}
+      - name: Print configure log
+        if: ${{ failure() }}
         run: |
-          meson compile -C build macos-bundle
-          tar -czvf mpv.tar.gz -C build mpv.app
-
-      - name: Print meson log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/meson-log.txt
-
-      - name: Run meson tests
-        id: tests
-        run: |
-          meson test -C build
-
-      - name: Print meson test log
-        if: ${{ failure() && steps.tests.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/testlog.txt
-
-      - name: Artifact name
-        id: artifact
-        run: |
-          VERSION_FILE=$(find . -path "*/common/version.h" -type f | head -n 1)
-          VER=$(grep VERSION "$VERSION_FILE" | cut -d'"' -f2)
-          TARGET=${{ matrix.os }}${{ matrix.arch != '' && format('-{0}', matrix.arch) || '' }}
-          PR=${{ github.event.pull_request.number && format('-pr{0}', github.event.pull_request.number) || '' }}
-          echo "name=mpv-$VER$PR-${{ github.run_id }}-$TARGET" >> "$GITHUB_OUTPUT"
-
-      - uses: actions/upload-artifact@v7
-        if: ${{ matrix.arch != 'test' }}
-        with:
-          name: ${{ steps.artifact.outputs.name }}
-          path: mpv.tar.gz
+          cat ./build/config.log
 
   linux:
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-20.04"
     container:
-      image: "registry.opensuse.org/home/mia/images/images/mpv-ci:stable-deps"
+      image: "registry.cirno.systems/kiwi/containers/mpv-ci:stable-deps"
+      # Disable seccomp until a container manager in GitHub recognizes
+      # clone3() syscall,
+      # <https://github.com/actions/virtual-environments/issues/3812>.
+      options: --security-opt seccomp=unconfined
       env:
-        CC: "${{ matrix.config.cc }}"
-        CXX: "${{ matrix.config.cxx }}"
-        CC_LD: "${{ matrix.config.ld }}"
-        CXX_LD: "${{ matrix.config.ld }}"
+        CC: "${{ matrix.cc }}"
     strategy:
       matrix:
-        config:
-          - cc: "gcc"
-            cxx: "g++"
-            args: "-Db_ndebug=true"
-          - cc: "clang"
-            cxx: "clang++"
-            ld: "lld"
-            args: "-Db_lto=true -Db_lto_mode=thin"
+        cc:
+          - "gcc"
+          - "clang"
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v2
 
-      - name: Build with meson
-        id: build
-        run: |
-          ./ci/build-tumbleweed.sh ${{ matrix.config.args }}
-
-      - name: Print meson log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/meson-log.txt
-
-      - name: Run meson tests
-        id: tests
-        run: |
-          meson test -C build
-
-      - name: Print meson test log
-        if: ${{ failure() && steps.tests.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/testlog.txt
-
-  linux-fuzz:
-    runs-on: ubuntu-latest
-    container:
-      image: "registry.opensuse.org/home/mia/images/images/mpv-ci:stable-deps"
-      env:
-        CC: "clang"
-        CXX: "clang++"
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Build with meson
-        id: build
-        run: |
-          meson setup build \
-            --werror        \
-            -Dfuzzers=true -Dlibmpv=true -Dcplayer=false
-          meson compile -C build fuzzers
-
-      - name: Print meson log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/meson-log.txt
-
-  linux-ffmpeg-6-1:
-    runs-on: ubuntu-latest
-    container:
-      # We want to test ffmpeg 6.1.2, which Alpine 3.21 includes.
-      # Also test compatibility with Wayland Protocols 1.38 and Wayland libs 1.23.
-      # Musl support is an added bonus.
-      image: alpine:3.21
-    steps:
-      - uses: actions/checkout@v6
       - name: Install dependencies
         run: |
-          apk update
-          apk add \
-              binutils \
-              curl-dev \
-              ffmpeg-dev \
-              gcc \
-              git \
-              g++ \
-              libass-dev \
-              lua5.2-dev \
-              pulseaudio-dev \
-              libplacebo-dev \
-              libx11-dev \
-              libxfixes-dev \
-              libxkbcommon-dev \
-              libxrandr-dev \
-              libxpresent-dev \
-              libxscrnsaver-dev \
-              meson \
-              musl-dev \
-              rust \
-              samurai \
-              wayland-dev \
-              wayland-protocols
+          ./bootstrap.py
 
-      - name: Build with meson
-        id: build
+      - name: Build
         run: |
-          ./ci/build-linux-old.sh
+          ./ci/build-tumbleweed.sh
 
-      - name: Print meson log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
+      - name: Print configure log
+        if: ${{ failure() }}
         run: |
-          cat ./build/meson-logs/meson-log.txt
-
-      - name: Run meson tests
-        id: tests
-        run: |
-          meson test -C build
-
-      - name: Print meson test log
-        if: ${{ failure() && steps.tests.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/testlog.txt
-
-  openbsd:
-    runs-on: ubuntu-latest # until https://github.com/actions/runner/issues/385
-    timeout-minutes: 15 # avoid any weirdness with the VM
-    steps:
-    - uses: actions/checkout@v6
-    - name: Test in OpenBSD VM
-      uses: cross-platform-actions/action@v1.1.0
-      with:
-        operating_system: openbsd
-        version: '7.8'
-        run: |
-            sudo pkg_add -U \
-                cmake \
-                curl \
-                ffmpeg \
-                git \
-                libarchive \
-                libbluray \
-                libcaca \
-                libcdio-paranoia \
-                libdvdnav \
-                libiconv \
-                libplacebo \
-                libv4l \
-                libxkbcommon \
-                luajit \
-                meson \
-                openal \
-                pkgconf \
-                pulseaudio \
-                python3 \
-                rubberband \
-                rust \
-                sdl2 \
-                shaderc \
-                spirv-cross \
-                spirv-headers \
-                uchardet \
-                vulkan-loader \
-                vulkan-headers \
-                zimg
-            ./ci/build-openbsd.sh
-            if ! meson test -C build; then
-                cat ./build/meson-logs/testlog.txt
-                exit 1
-            fi
+          cat ./build/config.log
 
   freebsd:
-    runs-on: ubuntu-latest # until https://github.com/actions/runner/issues/385
-    timeout-minutes: 15 # avoid any weirdness with the VM
+    runs-on: macos-10.15 # until https://github.com/actions/runner/issues/385
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@v2
     - name: Test in FreeBSD VM
-      uses: cross-platform-actions/action@v1.1.0
+      uses: vmactions/freebsd-vm@v0.1.5 # aka FreeBSD 13.0
       with:
-        operating_system: freebsd
-        version: '15.0'
-        run: |
-            sudo pkg update
-            sudo pkg install -y \
-                alsa-lib \
-                cmake \
-                curl \
+        usesh: true
+        prepare: |
+            # Requested in ci/build-freebsd.sh
+            pkg install -y \
                 evdev-proto \
                 ffmpeg \
-                git \
-                iconv \
+                libplacebo \
+                libxkbcommon \
+                luajit \
+                openal-soft \
+                pkgconf \
+                python3 \
+                sdl2 \
+                vulkan-headers \
+                wayland-protocols \
+                #
+            # Optionally auto-enabled
+            pkg install -y \
+                alsa-lib \
                 jackit \
+                libXv \
                 libarchive \
                 libbluray \
                 libcaca \
                 libcdio-paranoia \
                 libdvdnav \
-                libdisplay-info \
-                libplacebo \
-                libXinerama \
-                libxkbcommon \
-                libXpresent \
-                libXv \
-                luajit \
-                meson \
                 mujs \
-                openal-soft \
-                pipewire \
-                pkgconf \
                 pulseaudio \
-                python3 \
                 rubberband \
-                rust \
                 sekrit-twc-zimg \
-                sdl2 \
-                sndio \
                 uchardet \
                 v4l_compat \
-                vulkan-headers \
-                wayland-protocols
-            ./ci/build-freebsd.sh
-            if ! meson test -C build; then
-                cat ./build/meson-logs/testlog.txt
-                exit 1
-            fi
-
-  msys2:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - sys: "clang64"
-            os: "windows-2025-vs2026"
-            auto-var-init: "uninitialized"
-          - sys: "clang64"
-            os: "windows-2025-vs2026"
-            asan: true
-          - sys: "clang64"
-            os: "windows-2025-vs2026"
-            auto-var-init: "zero"
-          - sys: "clang64"
-            os: "windows-2025-vs2026"
-            auto-var-init: "pattern"
-          - sys: "mingw64"
-            os: "windows-2025-vs2026"
-          - sys: "ucrt64"
-            os: "windows-2025-vs2026"
-          - sys: "clangarm64"
-            os: "windows-11-arm"
-    defaults:
-      run:
-        shell: msys2 {0}
-    steps:
-      - name: Disable autocrlf
-        shell: pwsh
+                #
         run: |
-          git config --global core.autocrlf false
-          git config --global core.eol lf
-      - uses: actions/checkout@v6
-      - uses: msys2/setup-msys2@v2
-        with:
-          msystem: ${{ matrix.sys }}
-          update: true
-          install: git
-          pacboy: >-
-            amf-headers:p
-            angleproject:p
-            ca-certificates:p
-            cc:p
-            cppwinrt:p
-            curl:p
-            ffmpeg:p
-            lcms2:p
-            libarchive:p
-            libass:p
-            libcdio-paranoia:p
-            libdvdnav:p
-            libjpeg-turbo:p
-            libplacebo:p
-            lua51:p
-            meson:p
-            ninja:p
-            pkgconf:p
-            python:p
-            rst2pdf:p
-            rubberband:p
-            rust:p
-            shaderc:p
-            spirv-cross:p
-            uchardet:p
-            vapoursynth:p
-            vulkan-devel:p
-
-      - name: Build with meson
-        id: build
-        run: |
-          ./ci/build-msys2.sh meson
-        env:
-          SYS: ${{ matrix.sys }}
-          ASAN: ${{ matrix.asan }}
-          AUTO_VAR_INIT: ${{ matrix.auto-var-init }}
-
-      - name: Print meson log
-        if: ${{ failure() && steps.build.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/meson-log.txt
-
-      - name: Run meson tests
-        id: tests
-        run: |
-          meson test -C build
-        env:
-          GGML_NO_BACKTRACE: 1
-
-      - name: Print meson test log
-        if: ${{ failure() && steps.tests.outcome == 'failure' }}
-        run: |
-          cat ./build/meson-logs/testlog.txt
-
-  publish:
-    name: Publish git release
-    needs: [mingw, win32, macos]
-    if: github.event_name == 'push' && github.ref == 'refs/heads/master' &&
-        github.repository == 'mpv-player/mpv'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      actions: read
-    concurrency:
-      group: publish-git
-      cancel-in-progress: false
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - name: Publish to git release
-        env:
-          GH_REPO: ${{ github.repository }}
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          set -eu
-          tag=git-release
-          base_url="https://github.com/$GH_REPO/releases/download/$tag"
-
-          artifacts=$(gh api "repos/{owner}/{repo}/actions/runs/${{ github.run_id }}/artifacts")
-
-          # Attach every build artifact unchanged; the notes link to them with
-          # labels derived from the verbose names.
-          mkdir -p release
-          jq -r '.artifacts[] | "\(.id)\t\(.name)"' <<< "$artifacts" |
-          while IFS=$'\t' read -r id name; do
-            gh api "repos/{owner}/{repo}/actions/artifacts/$id/zip" > "release/$name.zip"
-          done
-
-          section() {
-            jq -r --arg url "$base_url" --arg re "$1" '
-              def pretty:
-                (if   test("i686")    then "i686"
-                 elif test("aarch64") then "arm64"
-                 elif test("-arm$")   then "arm64"
-                 elif test("intel")   then "x86_64"
-                 else "x86_64" end) as $arch
-                | [ (if test("mingw") then "GCC" elif test("msvc") then "Clang" else empty end),
-                    (if test("macos") then "macOS " + capture("macos-(?<v>[0-9]+)").v else empty end),
-                    (if test("-pdb") then "debug symbols" else empty end) ] as $q
-                | $arch + (if ($q | length) > 0 then " (" + ($q | join(", ")) + ")" else "" end);
-              # primary builds first (x86_64, arm64, i686; Clang before GCC), debug symbols last
-              def rank:
-                [ (if test("-pdb") then 1 else 0 end),
-                  (if test("x86_64|intel") then 0 elif test("i686") then 2 else 1 end),
-                  (if test("mingw") then 1 else 0 end),
-                  (if test("macos") then (capture("macos-(?<v>[0-9]+)").v | tonumber) else 0 end) ];
-              [ .artifacts[] | select(.name | test($re)) ] | sort_by(.name | rank)
-              | map("* [\(.name | pretty)](\($url)/\(.name).zip)") | join("\n")
-            ' <<< "$artifacts"
-          }
-
-          # Match the version string baked into the build (see common/meson.build).
-          version=$(git describe --abbrev=9 --tags --dirty)
-          notes=$(cat <<EOF
-          Automated development build of the latest \`master\` branch.
-
-          - Version: \`$version\`
-          - Commit: ${{ github.sha }}
-          - Built: $(date -u '+%Y-%m-%d %H:%M:%S UTC')
-
-          ### Windows
-
-          $(section 'w64|msvc')
-
-          ### macOS
-
-          $(section 'macos')
-
-          > [!WARNING]
-          > These are untested development builds of the very latest \`master\`.
-          > They are **not** official releases. For stable builds see the
-          > [latest release](https://github.com/$GH_REPO/releases/latest).
-          EOF
-          )
-
-          # Create the release once (which also creates the tag), then only edit
-          # it in place so watchers aren't notified on every master push. Stale
-          # assets are dropped first since their names embed the run id.
-          if gh release view "$tag" >/dev/null 2>&1; then
-            gh release view "$tag" --json assets --jq '.assets[].name' |
-            while read -r asset; do
-              gh release delete-asset "$tag" "$asset" --yes
-            done
-            gh release edit "$tag" \
-              --prerelease \
-              --latest=false \
-              --title "mpv development build" \
-              --notes "$notes"
-            gh release upload "$tag" release/*
-          else
-            gh release create "$tag" \
-              --target "$GITHUB_SHA" \
-              --prerelease \
-              --latest=false \
-              --title "mpv development build" \
-              --notes "$notes" \
-              release/*
-          fi
+          ./ci/build-freebsd.sh

.github/workflows/cleanup_caches.yml

@@ -1,48 +0,0 @@
-name: Cleanup caches
-
-on:
-  workflow_run:
-    workflows: [build]
-    types: [completed]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-permissions:
-  actions: write
-
-jobs:
-  cache:
-    runs-on: ubuntu-latest
-    steps:
-      - run: |
-          gh cache list -L 100 --json id,key,ref -S last_accessed_at -O desc --jq '
-            map(select(.key | startswith("x86_64-w64-mingw32-") or
-                              startswith("i686-w64-mingw32-") or
-                              startswith("aarch64-pc-windows-msvc-") or
-                              startswith("x86_64-pc-windows-msvc-"))) |
-            group_by(.ref) |
-            map({
-              ref: .[0].ref,
-              caches: map({
-                        key: .key,
-                        prefix: (.key | capture("^(?<prefix>[\\w_-]+-)\\d+$").prefix)
-                      }) | group_by(.prefix) | map({keys: map(.key)})
-            }) |
-            .[]
-          ' |
-          while read -r group; do
-            pr=$(echo "$group" | jq -r '.ref | capture("refs/pull/(?<num>[0-9]+)/merge").num')
-            if [[ -n "$pr" ]] && [ "$(gh pr view $pr --json state --jq '.state')" != "OPEN" ]; then
-              keys=$(echo "$group" | jq -c '.caches | map(.keys) | .[]')
-            else
-              keys=$(echo "$group" | jq -c '.caches | map(.keys[1:]) | .[]')
-            fi
-            for key in $(echo "$keys" | jq -r '.[]'); do
-              gh cache delete "$key"
-            done
-          done
-    env:
-      GH_REPO: ${{ github.repository }}
-      GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/comment.yml

@@ -1,55 +0,0 @@
-name: comment
-
-on:
-  workflow_run:
-    workflows: [build]
-    types: [completed]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-permissions:
-  actions: read
-  contents: read
-  pull-requests: write
-
-jobs:
-  pr_comment:
-    if: github.event.workflow_run.event == 'pull_request' &&
-        github.event.workflow_run.conclusion == 'success'
-    runs-on: ubuntu-latest
-    steps:
-      - env:
-          GH_REPO: ${{ github.repository }}
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          pr=$(gh pr list --state open --json headRefOid,number \
-            --jq '.[] | select(.headRefOid == "${{ github.event.workflow_run.head_sha }}") | .number')
-          if [ -z "$pr" ]; then
-            echo "No matching open pull request found"
-            exit 0
-          fi
-
-          artifacts=$(gh api repos/{owner}/{repo}/actions/runs/${{ github.event.workflow_run.id }}/artifacts --jq '.artifacts')
-          if [ "$(echo "$artifacts" | jq 'length')" -eq 0 ]; then
-            echo "No artifacts found"
-            exit 0
-          fi
-
-          body=$(echo "$artifacts" | jq -r '
-            def link: "https://nightly.link/${{ github.repository }}/actions/artifacts/\(.id).zip";
-            def entry: "* [\(.name)](\(link))";
-            "Download the artifacts for this pull request:\n<details><summary>Windows</summary>\n\n" +
-            (sort_by(.name) | map(select(.name | test("w64|msvc")) | entry) | join("\n")) +
-            "\n</details>\n<details><summary>macOS</summary>\n\n" +
-            (sort_by(.name) | map(select(.name | test("macos")) | entry) | join("\n")) +
-            "\n</details>"
-          ')
-
-          comment_id=$(gh issue view $pr --json comments \
-            --jq '.comments[] | select(.author.login == "github-actions") | .id')
-          if [ -n "$comment_id" ]; then
-            edit=--edit-last
-          fi
-          gh pr comment $pr --body "$body" $edit

.github/workflows/docs.yml

@@ -1,30 +0,0 @@
-name: docs
-
-on:
-  push:
-    branches:
-      - master
-      - ci
-      - 'release/**'
-    paths:
-      - 'DOCS/**'
-  pull_request:
-    branches: [master]
-    paths:
-      - 'DOCS/**'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-jobs:
-  check-docs:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - name: Docs
-        run: |
-          sudo apt-get install --no-install-recommends -y python3-docutils rst2pdf
-          ./TOOLS/docutils-wrapper.py rst2man --strip-elements-with-class=contents --halt=2 ./DOCS/man/mpv.rst mpv.1
-          ./TOOLS/docutils-wrapper.py rst2html --halt=2 ./DOCS/man/mpv.rst mpv.html
-          ./TOOLS/docutils-wrapper.py rst2pdf -c -b 1 --repeat-table-rows ./DOCS/man/mpv.rst -o mpv.pdf

.github/workflows/fuzz.yml

@@ -1,61 +0,0 @@
-name: Pull Request Fuzzing
-
-on:
-  pull_request:
-    branches: [master]
-    paths-ignore:
-        - 'DOCS/**'
-        - 'TOOLS/lua/**'
-        - '.editorconfig'
-        - '.github/ISSUE_TEMPLATE/**'
-        - '.github/PULL_REQUEST_TEMPLATE'
-        - '.gitignore'
-        - 'Copyright'
-        - 'README.md'
-        - 'RELEASE_NOTES'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-permissions: {}
-
-jobs:
-  Fuzzing:
-    runs-on: ubuntu-latest
-    permissions:
-      security-events: write
-    strategy:
-      fail-fast: false
-      matrix:
-        sanitizer: [address, undefined, memory]
-    steps:
-    - name: Build Fuzzers (${{ matrix.sanitizer }})
-      id: build
-      uses: google/oss-fuzz/infra/cifuzz/actions/build_fuzzers@master
-      with:
-        oss-fuzz-project-name: 'mpv'
-        language: c
-        sanitizer: ${{ matrix.sanitizer }}
-    - name: Run Fuzzers (${{ matrix.sanitizer }})
-      uses: google/oss-fuzz/infra/cifuzz/actions/run_fuzzers@master
-      with:
-        oss-fuzz-project-name: 'mpv'
-        language: c
-        fuzz-seconds: 1200
-        sanitizer: ${{ matrix.sanitizer }}
-        report-ooms: true
-        report-timeouts: true
-        output-sarif: true
-    - name: Upload Crash
-      uses: actions/upload-artifact@v7
-      if: failure() && steps.build.outcome == 'success'
-      with:
-        name: ${{ matrix.sanitizer }}-artifacts
-        path: ./out/artifacts
-    - name: Upload Sarif
-      if: always() && steps.build.outcome == 'success'
-      uses: github/codeql-action/upload-sarif@v4
-      with:
-        sarif_file: cifuzz-sarif/results.sarif
-        checkout_path: cifuzz-sarif

.github/workflows/lint.yml

@@ -1,75 +0,0 @@
-name: lint
-
-on:
-  push:
-    branches:
-      - master
-      - ci
-      - 'release/**'
-  pull_request:
-    branches: [master]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-jobs:
-  commit-msg:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 50
-
-      - name: Lint
-        run: |
-          ./ci/lint-commit-msg.py
-
-  swift:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: norio-nomura/action-swiftlint@3.2.1
-
-  lua:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: lunarmodules/luacheck@v1
-
-  ruff:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - name: Check
-        id: check
-        uses: astral-sh/ruff-action@v3
-        with:
-          src: ". TOOLS/umpv"
-      - name: Suggested changes
-        if: ${{ failure() && steps.check.outcome == 'failure' }}
-        run: ruff check . TOOLS/umpv --diff
-
-  mypy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: python/mypy@master
-        with:
-          install_project_dependencies: no
-          options: '--check-untyped-defs'
-          paths: ". TOOLS/umpv"
-
-  editorconfig:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: editorconfig-checker/action-editorconfig-checker@main
-      - run: editorconfig-checker -config .editorconfig-checker.json
-
-  pre-commit:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: pre-commit/action@v3.0.1

.gitignore

@@ -1,3 +1,38 @@
-/subprojects/*
-!/subprojects/packagefiles
-!/subprojects/*.wrap
+*.o
+*.a
+*.d
+*.exe
+*.pyc
+.depend
+
+/config.h
+/config.mak
+/config.log
+/mpv
+/mpv.app
+/version.h
+/input/input_conf.h
+/tags
+/TAGS
+/video/out/x11_icon.inc
+/demux/ebml_defs.c
+/demux/ebml_types.h
+/sub/osd_font.h
+/player/lua/*.inc
+/player/builtin_conf.inc
+/DOCS/man/mpv.1
+/DOCS/man/mpv.aux
+/DOCS/man/mpv.log
+/DOCS/man/mpv.out
+/DOCS/man/mpv.pdf
+/DOCS/man/mpv.toc
+
+/waf
+/waf-*
+/waf3-*
+/build
+/.waf*
+/.lock-waf_*
+
+/old_build
+/Makefile

.luacheckrc

@@ -1,110 +0,0 @@
-local mp_globals = {
-    mp = {
-        fields = {
-            command = {},
-            commandv = {},
-            command_native = {},
-            command_native_async = {},
-            add_hook = {},
-            abort_async_command = {},
-            del_property = {},
-            get_property = {},
-            get_property_osd = {},
-            get_property_bool = {},
-            get_property_number = {},
-            get_property_native = {},
-            set_property = {},
-            set_property_bool = {},
-            set_property_number = {},
-            set_property_native = {},
-            get_time = {},
-            add_key_binding = {},
-            add_forced_key_binding = {},
-            remove_key_binding = {},
-            register_event = {},
-            unregister_event = {},
-            observe_property = {},
-            unobserve_property = {},
-            add_timeout = {},
-            add_periodic_timer = {},
-            get_opt = {},
-            get_script_name = {},
-            get_script_directory = {},
-            osd_message = {},
-            get_wakeup_pipe = {},
-            get_next_timeout = {},
-            dispatch_events = {},
-            register_idle = {},
-            unregister_idle = {},
-            enable_messages = {},
-            register_script_message = {},
-            unregister_script_message = {},
-            create_osd_overlay = {},
-            get_osd_size = {},
-            msg = {
-                fields = {
-                    fatal = {},
-                    error = {},
-                    warn = {},
-                    info = {},
-                    verbose = {},
-                    debug = {},
-                    trace = {},
-                }
-            },
-            -- Not documented
-            -- TODO: Document or remove them
-            disable_key_bindings = {},
-            enable_key_bindings = {},
-            find_config_file = {},
-            flush_keybindings = {},
-            format_time = {},
-            get_mouse_pos = {},
-            set_key_bindings = {},
-            set_mouse_area = {},
-            set_osd_ass = {},
-        }
-    },
-    exit = {},
-    unpack = {},
-}
-
-local mp_internal = {
-    mp = {
-        fields = {
-            -- Internal
-            -- TODO: Move to mp_internal module
-            ARRAY = { fields = { info = {}, type = {} }},
-            MAP = { fields = { info = {}, type = {} }},
-            UNKNOWN_TYPE = { fields = { info = {}, type = {} }},
-            _legacy_overlay = { fields = { res_x = {}, res_y = {}, data = {}, update = {} }},
-            cancel_timer = {},
-            get_osd_margins = {},
-            input_define_section = {},
-            input_disable_section = {},
-            input_enable_section = {},
-            input_set_section_mouse_area = {},
-            keep_running = {},
-            log = {},
-            raw_abort_async_command = {},
-            raw_command_native_async = {},
-            raw_hook_add = {},
-            raw_hook_continue = {},
-            raw_observe_property = {},
-            raw_unobserve_property = {},
-            raw_wait_event = {},
-            request_event = {},
-            script_name = {},
-            use_suspend = {},
-            wait_event = {},
-        }
-    }
-}
-
-std = "min+mp"
-stds = { mp = { read_globals = mp_globals } }
--- mp_internal seems to be merged with mp for other files too...
-files["player/lua/defaults.lua"] = { globals = mp_internal }
-files["player/lua/auto_profiles.lua"] = { globals = { "p", "get" } }
-files["player/lua/select.lua"] = { globals = { "p", "get" } }
-max_line_length = 100

.pre-commit-config.yaml

@@ -1,23 +0,0 @@
-repos:
-- repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v5.0.0
-  hooks:
-    - id: check-case-conflict
-    - id: check-executables-have-shebangs
-    - id: check-illegal-windows-names
-    - id: check-json
-    - id: check-shebang-scripts-are-executable
-    - id: check-xml
-      exclude: ^TOOLS/mpv-osd-symbols.sfdir/font.props$
-    - id: check-yaml
-    - id: end-of-file-fixer
-      exclude: ^TOOLS/osxbundle/mpv.app/Contents/PkgInfo$
-    - id: fix-byte-order-marker
-    - id: mixed-line-ending
-    - id: trailing-whitespace
-- repo: https://github.com/codespell-project/codespell
-  rev: v2.3.0
-  hooks:
-    - id: codespell
-      args: ["--ignore-words-list", "ALS,als,datas,DNE,enew,HDA,numer,ontop,optionA,Paeth,pathc,inout,requestor"]
-      exclude: ^(etc/menu.conf|misc/language.c)$

.swiftlint.yml

@@ -1,10 +0,0 @@
-disabled_rules:
-    - identifier_name
-    - line_length
-    - large_tuple
-    - void_function_in_ternary
-    - function_body_length
-    - cyclomatic_complexity
-    - file_length
-    - type_body_length
-strict: true

Copyright

@@ -2,20 +2,9 @@ mpv is a fork of mplayer2, which is a fork of MPlayer.
 
 mpv as a whole is licensed under the GNU General Public License GPL version 2
 or later (called GPLv2+ in this document, see LICENSE.GPL for full license
-text) by default. The mpv program is licensed the GNU Lesser General Public
-License LGPL version 2 or later (LGPLv2.1+ in this document, see LICENSE.LGPL
-for full license text) if built without using any GPL only files.
-The -Dgpl=false configure switch is provided as a convenience for excluding
-the GPL only files listed below from the build process.
-
-However, do note that the build system is provided "as is" and using the
--Dgpl=false configure switch does not in itself create a LGPLv2.1+ license
-grant.
-
-Additionally, some non-program parts, such as the documentation and some config
-files listed below, are still built and licensed under their respective licenses
-even when -Dgpl=false is used. Please consult GPLv2+ and LGPLv2.1+ license texts
-for further details on how to distribute these files.
+text) by default, or the GNU Lesser General Public License LGPL version 2 or
+later (LGPLv2.1+ in this document, see LICENSE.LGPL for full license text) if
+built with the --enable-lgpl configure switch.
 
 Most source files are LGPLv2.1+ or GPLv2+, but some files are available under
 more liberal licenses, such as BSD, MIT, ISC, and possibly others. Look at the
@@ -37,20 +26,26 @@ See DOCS/contribute.md for binding rules wrt. licensing for contributions.
 For information about authors and contributors, consult the git log, which
 contains the complete SVN and CVS history as well.
 
-mpv can be built as LGPLv2.1+ without using any GPL only files. To add a
-LGPL mode to mpv, MPlayer code had to be relicensed from GPLv2+ to LGPLv2.1+ by
-asking the MPlayer authors for permission. Since permission could not be
-obtained from everyone, LGPL mode disables the following features, some of them
-quite central:
+"v2.1+" in this context means "version 2.1 or later".
+
+Some libraries are GPLv2+ or GPLv3+ only. Building mpv with Samba support makes
+it GPLv3+.
+
+mpv can be built as LGPLv2.1+ with the --enable-lgpl configure option. To add
+a LGPL mode to mpv, MPlayer code had to be relicensed from GPLv2+ to LGPLv2.1+
+by asking the MPlayer authors for permission. Since permission could not be
+obtained from everyone, LGPL mode disables the following features, some of
+them quite central:
 - Linux X11 video output
 - BSD audio output via OSS
 - NVIDIA/Linux hardware decoding (vdpau, although nvdec usually works)
-- minor features: jack, DVD, CDDA, DVB, CACA, legacy direct3d VO
+- Linux TV input
+- minor features: jack, DVD, CDDA, SMB, CACA, legacy direct3d VO
 Some of these will be fixed in the future. The intended use for LGPL mode is
 with libmpv, and currently it's not recommended to build mpv CLI in LGPL mode
 at all.
 
-The following files are still GPL only (-Dgpl=false disables them):
+The following files are still GPL only (--enable-lgpl disables them):
 
     audio/out/ao_jack.c             will stay GPL
     audio/out/ao_oss.c              will stay GPL
@@ -69,8 +64,9 @@ The following files are still GPL only (-Dgpl=false disables them):
     video/vdpau.h                   unknown
     video/vdpau_mixer.*             actual code must be rewritten
     DOCS/man/                       GPLv2+
+    bootstrap.py                    unknown license, probably GPLv2+ or LGPLv2+
     etc/mplayer-input.conf          unknown license, probably GPLv2+
-    etc/mpv.desktop                 unknown license, probably GPLv2+
+    mpv.desktop                     unknown license, probably GPLv2+
     etc/restore-old-bindings.conf   unknown license, probably GPLv2+
 
 None of the cases listed above affect the final binary if it's built as

DOCS/client-api-changes.rst

@@ -32,32 +32,9 @@ API changes
 
 ::
 
- --- mpv 0.40.0 ---
- 2.5    - Deprecate MPV_RENDER_PARAM_AMBIENT_LIGHT. no replacement.
- --- mpv 0.39.0 ---
- 2.4    - mpv_render_param with the MPV_RENDER_PARAM_ICC_PROFILE argument no
-          longer has incorrect assumptions about memory allocation and can be
-          correctly used.
- --- mpv 0.38.0 ---
- 2.3    - partially revert the changes from API version 1.27, remove libmpv as
-          the default VO and move it to the bottom of the auto-probing order.
-          This restores the prior behavior on all platforms other than macOS,
-          but still auto selects libmpv/cocoa-cb on macOS if it was built with
-          support for cocoa-cb.
- --- mpv 0.37.0 ---
- 2.2    - add mpv_time_ns()
- --- mpv 0.36.0 ---
- 2.1    - add mpv_del_property()
- --- mpv 0.35.0 ---
- 2.0    - remove headers/functions of the obsolete opengl_cb API
-        - remove mpv_opengl_init_params.extra_exts field
-        - remove deprecated mpv_detach_destroy. Use mpv_destroy instead.
-        - remove obsolete mpv_suspend and mpv_resume
-        - remove deprecated SCRIPT_INPUT_DISPATCH, PAUSE and UNPAUSE, TRACKS_CHANGED
-          TRACK_SWITCHED, METADATA_UPDATE, CHAPTER_CHANGE events
  --- mpv 0.33.0 ---
  1.109  - add MPV_RENDER_API_TYPE_SW and related (software rendering API)
-        - deactivate the opengl_cb API (always fails to initialize now)
+        - inactivate the opengl_cb API (always fails to initialize now)
           The opengl_cb API was deprecated over 2 years ago. Use the render API
           instead.
  1.108  - Deprecate MPV_EVENT_IDLE
@@ -77,6 +54,7 @@ API changes
           It is a good idea to write better wrappers for your use, though.
  --- mpv 0.31.0 ---
  1.107  - Deprecate MPV_EVENT_TICK
+
  --- mpv 0.30.0 ---
  1.106  - Add cancel_fn to mpv_stream_cb_info
  1.105  - Fix deadlock problems with MPV_RENDER_PARAM_ADVANCED_CONTROL and if
@@ -94,6 +72,7 @@ API changes
         - add mpv_abort_async_command()
  1.102  - rename struct mpv_opengl_drm_osd_size to mpv_opengl_drm_draw_surface_size
         - rename MPV_RENDER_PARAM_DRM_OSD_SIZE to MPV_RENDER_PARAM_DRM_DRAW_SURFACE_SIZE
+
  --- mpv 0.29.0 ---
  1.101  - add MPV_RENDER_PARAM_ADVANCED_CONTROL and related API
         - add MPV_RENDER_PARAM_NEXT_FRAME_INFO and related symbols
@@ -285,6 +264,7 @@ API changes
         - extend the "--start" option; a leading "+", which was previously
           insignificant is now significant
         - add "cache-free" and "cache-used" properties
-        - macOS: the "coreaudio" AO spdif code is split into a separate AO
+        - OSX: the "coreaudio" AO spdif code is split into a separate AO
  --- mpv 0.4.0 ---
  1.0    - the API is declared stable
+

DOCS/compatibility.rst

@@ -29,16 +29,7 @@ All of these are important for interfacing both with end users and API users
 (which include Lua scripts, libmpv, and the JSON IPC). As such, they constitute
 a large part of the user interface and APIs.
 
-Certain options and commands may have documented default values. These default
-values are considered a part of the API since scripts may already rely on these
-documented behaviors. Changing these defaults are considered incompatible
-changes and must be documented. Undocumented default values do not subject to
-this requirement, and it is recommended to discourage such usage in the related
-documentations if there is a need to frequently change such defaults.
-
-All incompatible changes to this must be declared in interface-changes.rst,
-which include the types of changes, the impact of these changes, and suggested
-actions to address such impact so that the incompatibility is alleviated.
+All incompatible changes to this must be declared in interface-changes.rst.
 (This may also list compatible additions, but it's not a requirement.)
 
 Degrees of importance and compatibility preservation
@@ -58,17 +49,8 @@ functionality still works, and a replacement is available (if technically
 reasonable). For example, a feature deprecated in mpv 0.30.0 may be removed in
 mpv 0.32.0. Minor releases do not count towards this.
 
-Under extraordinary circumstances, such as missed incompatible changes that are
-already included in a release, critical security fixes, or a severe shortage of
-developer time to address the known incompatible changes, important/often used
-parts may be broken immediately, but the change must be extensively documented:
-all of the related documentations (including manpage, interface-changes.rst,
-etc., retrospectively modified if applicable) must clearly state the following:
-the fact that the change is a breaking change; the version when the breaking
-change happened; and the reason, impact, and suggested remedy actions.
-
 Less useful parts can be broken immediately, but must come with some sort of
-removal warning.
+removal warning-
 
 Parts for debugging and testing may be removed any time, potentially even
 without any sort of documentation.
@@ -126,7 +108,7 @@ CLI
 Things such as default key bindings do not necessarily require compatibility.
 However, the release notes should be extremely clear on changes to "important"
 key bindings. Bindings which restore the old behavior should be added to
-restore-old-bindings.conf and restore-osc-bindings.conf.
+restore-old-bindings.conf.
 
 Some option parsing is CLI-only and not available from libmpv or scripting. No
 compatibility guarantees come with them. However, the rules which mpv uses to
@@ -153,7 +135,7 @@ command-interface.
 libmpv C API
 ------------
 
-The libmpv client API (such as ``<mpv/client.h>``) mostly gives access to
+The libmpv client API (such as ``<libmpv/client.h>``) mostly gives access to
 the command interface. The API itself (if looked at as a component separate
 from the command interface) is intended to be extremely stable.
 

DOCS/compile-windows.md

@@ -1,284 +1,213 @@
-# Compiling for Windows
+Compiling for Windows
+=====================
 
-Compiling for Windows is supported using GNU-like compilers (GCC/Clang). Clang
-is compatible with both the ``w64-windows-gnu`` [MinGW-w64](https://www.mingw-w64.org/)
-and ``pc-windows-msvc`` [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk)
-targets. It supports the production of both 32-bit and 64-bit binaries and is
-suitable for building on Windows as well as cross-compiling from Linux and Cygwin.
+Compiling for Windows is supported with MinGW-w64. This can be used to produce
+both 32-bit and 64-bit executables, and it works for building on Windows and
+cross-compiling from Linux and Cygwin. MinGW-w64 is available from:
+http://mingw-w64.sourceforge.net.
 
-Although it is possible to build a complete MinGW-w64 toolchain yourself, there
-are build environments and scripts available to simplify the process, such as
-MSYS2 on Windows or a packaged toolchain provided by your favorite Linux
-distribution. Note that MinGW-w64 environments included in Linux distributions
-can vary in versions. As a general guideline, mpv only supports the MinGW-w64
-toolchain version included in the latest Ubuntu LTS release.
+While building a complete MinGW-w64 toolchain yourself is possible, there are a
+few build environments and scripts to help ease the process, such as MSYS2 and
+MXE. Note that MinGW environments included in Linux distributions are often
+broken, outdated and useless, and usually don't use MinGW-w64.
 
-mpv employs Meson for building, and the process is the same as any standard Meson
-compilation.
+**Warning**: the original MinGW (http://www.mingw.org) is unsupported.
 
-For the most up-to-date reference on build scripts, you can refer to
-[build.yml](https://github.com/mpv-player/mpv/blob/master/.github/workflows/build.yml),
-which builds and tests all supported configurations: ``MinGW-w64``, ``Windows SDK``,
-and ``MSYS2`` builds.
+Cross-compilation
+=================
 
-## Cross-compilation
+When cross-compiling, you have to run mpv's configure with these arguments:
 
-When cross-compiling, it is recommended to use a Meson ``--cross-file`` to set up the
-cross-compiling environment. For a basic example, please refer to
-[Cross-compilation](https://mesonbuild.com/Cross-compilation.html).
-
-Alternatively, consider using [mpv-winbuild-cmake](https://github.com/shinchiro/mpv-winbuild-cmake),
-which bootstraps a MinGW-w64 toolchain and builds mpv along with its dependencies.
-
-### Example with Meson
-
-1. Create ``cross-file.txt`` with definitions for your toolchain and target platform.
-   Refer to [x86_64-w64-mingw32.txt](https://mesonbuild.com/Cross-compilation.html)
-   as a directly usable example.
-   - **Important**: Beware of pkg-config usage. By default, it uses build machine
-     files for dependency detection, even when ``--cross-file`` is used. It must
-     be configured correctly. Refer to ``pkg_config_libdir`` and ``sys_root``
-     in the [documentation](https://mesonbuild.com/Cross-compilation.html#defining-the-environment)
-     for proper setup. **In this example pkg-config is not used/required.**
-2. Initialize subprojects. This step is optional; other methods are also
-   available to provide the necessary dependencies.
-
-   ``` bash
-   # Update the subprojects database from Meson's WrapDB.
-   meson wrap update-db
-
-   # Explicitly download wraps as nested projects may have older versions of them.
-   meson wrap install expat
-   meson wrap install harfbuzz
-   meson wrap install libpng
-   meson wrap install zlib
-
-   # Add wraps for mpv's required dependencies
-   mkdir -p subprojects
-
-   cat <<EOF > subprojects/libplacebo.wrap
-   [wrap-git]
-   url = https://github.com/haasn/libplacebo
-   revision = master
-   depth = 1
-   clone-recursive = true
-   EOF
-
-   cat <<EOF > subprojects/libass.wrap
-   [wrap-git]
-   revision = master
-   url = https://github.com/libass/libass
-   depth = 1
-   EOF
-
-   # For FFmpeg, use Meson's build system port; alternatively, you can compile
-   # the upstream version yourself. See https://trac.ffmpeg.org/wiki/CompilationGuide
-   cat <<EOF > subprojects/ffmpeg.wrap
-   [wrap-git]
-   url = https://gitlab.freedesktop.org/gstreamer/meson-ports/ffmpeg.git
-   revision = meson-8.1
-   depth = 1
-   [provide]
-   libavcodec = libavcodec_dep
-   libavdevice = libavdevice_dep
-   libavfilter = libavfilter_dep
-   libavformat = libavformat_dep
-   libavutil = libavutil_dep
-   libswresample = libswresample_dep
-   libswscale = libswscale_dep
-   EOF
-   ```
-
-3. Build
-
-   ``` bash
-   meson setup -Ddefault_library=static -Dprefer_static=true \
-               -Dc_link_args='-static' -Dcpp_link_args='-static' \
-               --cross-file cross-file.txt build
-
-   ninja -C build mpv.exe mpv.com
-   ```
-
-   This will produce fully portabiel, statically linked, ``mpv.exe`` and ``mpv.com``
-   binaries.
-
-#### Building libmpv
-
-- To also build ``libmpv``, execute the following commands:
-
-   ``` bash
-   # For a static library
-   meson configure build -Dlibmpv=true -Ddefault_library=static
-   ninja -C build libmpv.a
-
-   # For a shared library
-   meson configure build -Dlibmpv=true -Ddefault_library=shared
-   ninja -C build libmpv-2.dll
-   ```
-
-- Depending on the use case, you might want to use ``-Dgpl=false`` and review
-  similar options for subprojects.
-- If any of Meson's subprojects are not linked statically, you might need to
-  specify options like the following example for ffmpeg:
-  ``-Dffmpeg:default_library=static``.
-
-#### Enabling more mpv features
-
-The process above produces a basic mpv build. You can enable additional features.
-Check the Meson
-[WrapDB packages](https://mesonbuild.com/Wrapdb-projects.html) for available
-dependencies or by providing them through other means.
-
-Enhancing mpv with more features is as simple as adding more arguments to the
-Meson setup command, for example:
-
-``` bash
--Dlua=enabled -Djavascript=enabled -Dlcms2=enabled -Dlibplacebo:lcms=enabled
+```bash
+DEST_OS=win32 TARGET=i686-w64-mingw32 ./waf configure
 ```
 
-they will be automatically downloaded and built by Meson.
+[MXE](https://mxe.cc) makes it very easy to bootstrap a complete MingGW-w64
+environment from a Linux machine. See a working example below.
 
-## Native Compilation with Clang (Windows SDK Build)
+Alternatively, you can try [mingw-w64-cmake](https://github.com/lachs0r/mingw-w64-cmake),
+which bootstraps a MinGW-w64 environment and builds mpv and dependencies.
 
-1. Install [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022)
-   or the full [Visual Studio](https://visualstudio.microsoft.com/downloads/#visual-studio-community-2022):
-   - From the installer, select the necessary components:
-      - Clang compiler for Windows
-      - C++ CMake tools for Windows
-      - Windows SDK
-   - Activate the developer shell. The target and host architecture must match
-      (e.g. `amd64` for x86_64, `arm64` for ARM64):
-      ```
-      & "<Visual Studio Path>\Common7\Tools\Launch-VsDevShell.ps1" -Arch amd64 -HostArch amd64 -SkipAutomaticLocation | Out-Null
-      ```
-2. Install the remaining build tools that are not part of the Visual Studio installer:
-   - [Meson](https://mesonbuild.com/Getting-meson.html), the build system.
-   - [NASM](https://www.nasm.us/), required to assemble the hand-written assembly
-     in FFmpeg, dav1d and aom. Make sure it is in `PATH`.
-   - [Rust](https://www.rust-lang.org/tools/install) (via `rustup`), required to
-     build mpv's Rust components and the `subrandr` subproject. A **nightly**
-     toolchain is needed, as the build relies on Cargo's unstable `-C` option:
+Example with MXE
+----------------
 
-     ```powershell
-     rustup default nightly
-     ```
+```bash
+# Before starting, make sure you install MXE prerequisites. MXE will download
+# and build all target dependencies, but no host dependencies. For example,
+# you need a working compiler, or MXE can't build the crosscompiler.
+#
+# Refer to
+#
+#    https://mxe.cc/#requirements
+#
+# Scroll down for disto/OS-specific instructions to install them.
 
-3. The following build script utilizes the Meson subprojects system to build mpv and its dependencies.
-   To make sure all dependency versions are up-to-date, update the subprojects database from Meson's WrapDB.
-   Also explicitly download several wraps as some nested projects may pull older versions of them.
-   ```
-   meson wrap update-db
+# Download MXE. Note that compiling the required packages requires about 1.4 GB
+# or more!
 
-   meson wrap install expat
-   meson wrap install harfbuzz
-   meson wrap install libpng
-   meson wrap install zlib
-   ```
-4. Set environment variables so Meson uses the Clang/LLVM toolchain, or pass an
-equivalent `--native-file` to Meson.
-   ```powershell
-   $env:CC = 'clang'
-   $env:CXX = 'clang++'
-   $env:CC_LD = 'lld-link'
-   $env:CXX_LD = 'lld-link'
-   $env:RUST_LD = 'lld-link'
-   $env:WINDRES = 'llvm-rc'
-   ```
-   Note that some dependencies (e.g. LuaJIT) may require `sed` to configure. Fortunately, it is already bundled in
-   [Git for Windows](https://www.git-scm.com/download/win):
-   ```powershell
-   $env:PATH += ';<Git Path>\usr\bin'
-   ```
-5. Execute [ci\build-win32.ps1](https://github.com/mpv-player/mpv/blob/master/ci/build-win32.ps1). Refer to the script for more details.
+cd /opt
+git clone https://github.com/mxe/mxe mxe
+cd mxe
 
-This process will produce a fully static ``mpv.exe`` and ``mpv.com``, as well as
-a static ``libmpv.a``.
+# Set build options.
 
-## Native Compilation with MSYS2
+# The JOBS environment variable controls threads to use when building. DO NOT
+# use the regular `make -j4` option with MXE as it will slow down the build.
+# Alternatively, you can set this in the make command by appending "JOBS=4"
+# to the end of command:
+echo "JOBS := 4" >> settings.mk
 
-For Windows developers seeking a quick setup, MSYS2 is an effective tool for
-compiling mpv natively on a Windows machine. The MSYS2 repositories provide
-binary packages for most of mpv's dependencies, simplifying the process to
-primarily involve building mpv itself.
+# The MXE_TARGET environment variable builds MinGW-w64 for 32 bit targets.
+# Alternatively, you can specify this in the make command by appending
+# "MXE_TARGETS=i686-w64-mingw32" to the end of command:
+echo "MXE_TARGETS := i686-w64-mingw32.static" >> settings.mk
 
-### Installing MSYS2
+# If you want to build 64 bit version, use this:
+# echo "MXE_TARGETS := x86_64-w64-mingw32.static" >> settings.mk
 
-1. Follow the installation steps from [MSYS2](https://www.msys2.org/).
-2. Initiate one of the [Environments](https://www.msys2.org/docs/environments/),
-   with the CLANG64 (``clang64.exe``) being the recommended option.
-   **Note:** This environment is distinct from the MSYS2 shell that opens
-   automatically after the final installation dialog. You must close that
-   initial shell and open a new one for the appropriate environment.
+# Build required packages. The following provide a minimum required to build
+# a reasonable mpv binary (though not an absolute minimum).
 
-### Updating MSYS2
+make gcc ffmpeg libass jpeg lua luajit
 
-For guidance on updating MSYS2, please refer to the official documentation:
-[Updating MSYS2](https://www.msys2.org/docs/updating/).
+# Add MXE binaries to $PATH
+export PATH=/opt/mxe/usr/bin/:$PATH
 
-### Installing mpv Dependencies
+# Build mpv. The target will be used to automatically select the name of the
+# build tools involved (e.g. it will use i686-w64-mingw32.static-gcc).
 
-``` bash
-# Install pacboy and git
-pacman -S pactoys git
+cd ..
+git clone https://github.com/mpv-player/mpv.git
+cd mpv
+python ./bootstrap.py
+DEST_OS=win32 TARGET=i686-w64-mingw32.static ./waf configure
+# Or, if 64 bit version,
+# DEST_OS=win32 TARGET=x86_64-w64-mingw32.static ./waf configure
+./waf build
+```
 
+Native compilation with MSYS2
+=============================
+
+For Windows developers looking to get started quickly, MSYS2 can be used to
+compile mpv natively on a Windows machine. The MSYS2 repositories have binary
+packages for most of mpv's dependencies, so the process should only involve
+building mpv itself.
+
+To build 64-bit mpv on Windows:
+
+Installing MSYS2
+----------------
+
+1. Download an installer from https://msys2.github.io/
+
+   Both the i686 and the x86_64 version of MSYS2 can build 32-bit and 64-bit
+   mpv binaries when running on a 64-bit version of Windows, but the x86_64
+   version is preferred since the larger address space makes it less prone to
+   fork() errors.
+
+2. Start a MinGW-w64 shell (``mingw64.exe``). **Note:** This is different from
+   the MSYS2 shell that is started from the final installation dialog. You must
+   close that shell and open a new one.
+
+   For a 32-bit build, use ``mingw32.exe``.
+
+Updating MSYS2
+--------------
+
+To prevent errors during post-install, the MSYS2 core runtime must be updated
+separately.
+
+```bash
+# Check for core updates. If instructed, close the shell window and reopen it
+# before continuing.
+pacman -Syu
+
+# Update everything else
+pacman -Su
+```
+
+Installing mpv dependencies
+---------------------------
+
+```bash
 # Install MSYS2 build dependencies and a MinGW-w64 compiler
-pacboy -S python pkgconf cc meson
+pacman -S git python $MINGW_PACKAGE_PREFIX-{pkg-config,gcc}
 
-# Install key dependencies. libass and lcms2 are also included as dependencies
-# of ffmpeg.
-pacboy -S ffmpeg libjpeg-turbo libplacebo luajit vulkan-headers
+# Install the most important MinGW-w64 dependencies. libass and lcms2 are also
+# pulled in as dependencies of ffmpeg.
+pacman -S $MINGW_PACKAGE_PREFIX-{ffmpeg,libjpeg-turbo,lua51}
 ```
 
-### Building mpv
+Building mpv
+------------
 
-To compile and install mpv, execute the following commands.
-The binaries will be installed in the directory ``/$MSYSTEM_PREFIX/bin``.
+Clone the latest mpv from git and install waf. **Note:** ``/usr/bin/python3``
+is invoked directly here, since an MSYS2 version of Python is required.
 
 ```bash
-# Set up the build directory with the desired configuration
-meson setup build -Dlibmpv=true --prefix=$MSYSTEM_PREFIX
-
-# Compile
-meson compile -C build
-
-# Optionally, install the compiled binaries
-meson install -C build
+git clone https://github.com/mpv-player/mpv.git && cd mpv
+/usr/bin/python3 bootstrap.py
 ```
 
-## Running mpv
-
-Depending on your build configuration, ``mpv.exe`` may rely on external
-libraries. To create a portable package, you will need to include these
-dependencies as well. The quickest way to determine which libraries are needed
-is to run ``mpv.exe`` and note any error messages that list the required ``.dll``
-files. You can find these libraries in the sysroot used for compilation, such as
-``/clang64/bin/`` in MSYS2.
-
-## Linking libmpv with MSVC Programs
-
-Building mpv/libmpv directly with the MSVC compiler (cl.exe) is not supported
-due to differences in compiler flags. Our build system is designed specifically
-for GNU-like compiler drivers. However, you can still build programs in
-Visual Studio and link them with libmpv.
-
-When ``libmpv`` is built with the recommended Clang/``lld-link`` toolchain,
-``lld-link`` emits an import library (``mpv.lib``) next to the DLL in the build
-directory. Add that ``mpv.lib`` to your MSVC project.
-
-To generate an import library from a DLL yourself, first create a ``.def`` file
-listing its exports. There are several ways to do this. One is ``gendef``, which
-writes a ``.def``, based on DLL.
+Finally, compile and install mpv. Binaries will be installed to
+``/mingw64/bin`` or ``/mingw32/bin``.
 
 ```bash
-gendef libmpv-2.dll
+/usr/bin/python3 waf configure CC=gcc.exe --check-c-compiler=gcc --prefix=$MSYSTEM_PREFIX
+/usr/bin/python3 waf install
 ```
 
-Then build the import library from it. ``/name`` must match the DLL filename, and
-``/machine`` must match the DLL's architecture (e.g. ``x64`` or ``arm64``):
+Or, compile and install both libmpv and mpv:
 
 ```bash
-lib /def:libmpv-2.def /name:libmpv-2.dll /out:mpv.lib /machine:x64
+/usr/bin/python3 waf configure CC=gcc.exe --check-c-compiler=gcc --enable-libmpv-shared --prefix=$MSYSTEM_PREFIX
+/usr/bin/python3 waf install
 ```
 
-**Note:** Static linking is only feasible with matching compilers. For instance,
-if you build with Clang in Visual Studio, static linking is possible.
+Linking libmpv with MSVC programs
+---------------------------------
+
+mpv/libmpv cannot be built with Visual Studio (Microsoft is too incompetent to
+support C99/C11 properly and/or hates open source and Linux too much to
+seriously do it). But you can build C++ programs in Visual Studio and link them
+with a libmpv built with MinGW.
+
+To do this, you need a Visual Studio which supports ``stdint.h`` (recent ones do),
+and you need to create a import library for the mpv DLL:
+
+```bash
+lib /def:mpv.def /name:mpv-1.dll /out:mpv.lib /MACHINE:X64
+```
+
+The string in the ``/name:`` parameter must match the filename of the DLL (this
+is simply the filename the MSVC linker will use). The ``mpv.def`` can be
+retrieved from the mpv build directory, or can be produced by MingGW's
+gendef.exe helper from the mpv DLL.
+
+Static linking is not possible.
+
+Running mpv
+-----------
+
+If you want to run mpv from the MinGW-w64 shell, you will find the experience
+much more pleasant if you use the ``winpty`` utility
+
+```bash
+pacman -S winpty
+winpty mpv.com ToS-4k-1920.mov
+```
+
+If you want to move / copy ``mpv.exe`` and ``mpv.com`` to somewhere other than
+``/mingw64/bin/`` for use outside the MinGW-w64 shell, they will still depend on
+DLLs in that folder. The simplest solution is to add ``C:\msys64\mingw64\bin``
+to the windows system ``%PATH%``. Beware though that this can cause problems or
+confusion in Cygwin if that is also installed on the machine.
+
+Use of the ANGLE OpenGL backend requires a copy of the D3D compiler DLL that
+matches the version of the D3D SDK that ANGLE was built with
+(``d3dcompiler_43.dll`` in case of MinGW-built ANGLE) in the path or in the
+same folder as mpv. It must be of the same architecture (x86_64 / i686) as the
+mpv you compiled. You can find copies here:
+
+https://mpv.srsfckn.biz/d3dcompiler.7z

DOCS/contribute.md

@@ -5,13 +5,13 @@ General
 -------
 
 The main contact for mpv development is IRC, specifically #mpv
-and #mpv-devel on Libera.chat. GitHub is used for code review and
+and #mpv-devel on Libera.chat. Github is used for code review and
 long term discussions.
 
 Sending patches
 ---------------
 
-- Make a GitHub pull request, or send a link to a plaintext patch created with
+- Make a github pull request, or send a link to a plaintext patch created with
   ``git format-patch``.
 - Plain diffs posted as pastebins are not acceptable! (Especially if the http
   link returns HTML.) They only cause extra work for everyone, because they lack
@@ -42,7 +42,7 @@ Copyright of contributions
   this. If the license of the code is not LGPLv2.1+, you must mention this.
 - These license statements are legally binding.
 - Don't use fake names (something that looks like an actual name, and may be
-  someone else's name, but is not your legal name). Using a pseudonym is
+  someone else's name, but is not your legal name). Using a pseudonyms is
   allowed if it can be used to identify or contact you, even if whatever
   account you used to submit the patch dies.
 - Do not add your name to the license header. This convention is not used by
@@ -111,13 +111,13 @@ Always squash fixup commits when making changes to pull requests
 - If you make fixup commits to your pull request, you should generally squash
   them with "git rebase -i". We prefer to have pull requests in a merge
   ready state.
-- We don't squash-merge (nor do we use GitHub's feature that does this) because
+- We don't squash-merge (nor do we use github's feature that does this) because
   pull requests with multiple commits are perfectly legitimate, and the only
   thing that makes sense in non-trivial cases.
 - With complex pull requests, it *may* make sense to keep them separate, but
   they should be clearly marked as such. Reviewing commits is generally easier
   with fixups squashed.
-- Reviewers are encouraged to look at individual commits instead of GitHub's
+- Reviewers are encouraged to look at individual commits instead of github's
   "changes from all commits" view (which just encourages bad git and review
   practices).
 
@@ -131,31 +131,16 @@ Touching user-visible parts may require updating the mpv docs
 - Changes to command line options (addition/modification/removal) must be
   documented in options.rst.
 - Changes to input properties or input commands must be documented in input.rst.
+- All incompatible changes to the user interface (options, properties, commands)
+  must be documented with a small note in interface-changes.rst. (Additions may
+  be documented there as well, but this isn't required.)
 - Changes to the libmpv API must be reflected in the libmpv's headers doxygen,
   and in client-api-changes.rst.
 
-Interface change policy
------------------------
-
-- All incompatible changes to the user interface (options, properties, commands)
-  must be documented by making a new text file with a txt extension containing a
-  small note in the DOCS/interface-changes directory.
-- The name of the file should be brief and related to the commit that makes the
-  change. The content of the file should begin with the type of the change
-  (add, remove, deprecate, change, rename, etc.). If the file contains multiple
-  changes, the change which causes the most serious compatibility issues should
-  be placed first.
-- Grouping multiple related changes in the same file is also OK. Just be sure to
-  put each separate change on a different line.
-- Documenting additions in DOCS/interface-changes is optional but encouraged.
-- interface-changes.rst is never directly updated except when making new major
-  releases.
-- See DOCS/interface-changes/example.txt for an example.
-
 Code formatting
 ---------------
 
-mpv uses C11 with K&R formatting, with some exceptions.
+mpv uses C99 with K&R formatting, with some exceptions.
 
 - Use the K&R indent style.
 - Use 4 spaces of indentation, never use tabs (except in Makefiles).
@@ -168,9 +153,9 @@ mpv uses C11 with K&R formatting, with some exceptions.
         some_function(a, b, c);
     }
     ```
-- Break lines on 80 columns. There is a hard limit of 100 columns. You may ignore
+- Break lines on 80 columns. There is a hard limit of 85 columns. You may ignore
   this limit if there's a strong case that not breaking the line will increase
-  readability. Going over 100 columns might provoke endless discussions about
+  readability. Going over 85 columns might provoke endless discussions about
   whether such a limit is needed or not, so avoid it.
 - If the body of an if/for/while statement has more than 1 physical lines, then
   always add braces, even if they're technically redundant.
@@ -239,40 +224,21 @@ New code must follow the following conventions:
 General coding
 --------------
 
-- Use C11. Also freely make use of C11 features if it's appropriate, but do not
-  use VLA and complex number types.
+- Use C99. Also freely make use of C99 features if it's appropriate, such as
+  stdbool.h. (Except VLA and complex number types.)
 - Don't use non-standard language (such as GNU C-only features). In some cases
   they may be warranted, if they are optional (such as attributes enabling
   printf-like format string checks). "#pragma once" is allowed as an exception.
-  But in general, standard C11 must be used.
+  But in general, standard C99 must be used.
 - The same applies to libc functions. We have to be Windows-compatible too. Use
-  functions guaranteed by C11 or POSIX only, unless your use is guarded by a
-  configure check. Be mindful of MinGW-specifics since C11 support is not always
-  guaranteed.
+  functions guaranteed by C99 or POSIX only, unless your use is guarded by a
+  configure check. There is some restricted use of C11 (ask on IRC for details).
 - Prefer fusing declaration and initialization, rather than putting declarations
   on the top of a block. Obvious data flow is more important than avoiding
   mixing declarations and statements, which is just a C90 artifact.
 - If you add features that require intrusive changes, discuss them on the dev
   channel first. There might be a better way to add a feature and it can avoid
   wasted work.
-- Newly added code for any Apple Platform (macOS, iOS, etc), that uses Cocoa or
-  any other object-oriented Framework or API, should be written in Swift instead
-  of Objective-C. This also includes complete rewrites/refactors of existing
-  code. Plain C API usages may stay as C, but can be written in Swift. Existing
-  Objective-C code can stay as is, though Swift rewrites are welcome.
-
-AI-assisted Contributions
--------------------------
-
-If you have used an AI/LLM for your contribution, you must disclose this in the
-PR description. Such contributions are not forbidden, but the submitter takes
-full responsibility for the code changes. This includes having full
-understanding of the code (knowing what was changed and why) and the ability to
-participate in the code review process with human-written responses. This also
-includes confirming that the code can be submitted under the same license as the
-relevant files (usually LGPLv2 or GPLv2).
-
-Clearly vibe-coded patches will not be considered.
 
 Code of Conduct
 ---------------

DOCS/edl-mpv.rst

@@ -214,9 +214,6 @@ It provides following parameters change track metadata:
 ``byterate``
     Number of bytes per second this stream uses. (Purely informational.)
 
-``program_id``
-    Assign this track to a program (integer, default: -1 meaning unset).
-
 ``index``
     The numeric index of the track this should map to (default: -1). This is
     the 0-based index of the virtual stream as seen by the player, enumerating
@@ -369,7 +366,8 @@ tracks. In this case, it's not obvious, which virtual tracks the EDL show should
 expose when being played.
 
 Currently, mpv will apply an arbitrary heuristic which tracks the EDL file
-should expose.
+should expose. (Before mpv 0.30.0, it always used the first source file in the
+segment list.)
 
 You can set the ``layout`` option to ``this`` to make a specific entry define
 the track layout.

DOCS/encoding.rst

@@ -3,26 +3,26 @@ General usage
 
 ::
 
-  mpv infile --o=outfile [--of=outfileformat] [--ofopts=formatoptions] [--orawts] \
+  mpv infile -o outfile [-of outfileformat] [-ofopts formatoptions] [-orawts] \
     [(any other mpv options)] \
-    --ovc=outvideocodec [--ovcopts=outvideocodecoptions] \
-    --oac=outaudiocodec [--oacopts=outaudiocodecoptions]
+    -ovc outvideocodec [-ovcopts outvideocodecoptions] \
+    -oac outaudiocodec [-oacopts outaudiocodecoptions]
 
 Help for these options is provided if giving help as parameter, as in::
 
-  mpv --ovc=help
+  mpv -ovc help
 
 The suboptions of these generally are identical to ffmpeg's (as option parsing
-is simply delegated to ffmpeg). The option --ocopyts enables copying timestamps
+is simply delegated to ffmpeg). The option -ocopyts enables copying timestamps
 from the source as-is, instead of fixing them to match audio playback time
-(note: this doesn't work with all output container formats); --orawts even turns
+(note: this doesn't work with all output container formats); -orawts even turns
 off discontinuity fixing.
 
-Note that if neither --ofps nor --oautofps is specified, VFR encoding is assumed
-and the time base is 24000fps. --oautofps sets --ofps to a guessed fps number
+Note that if neither -ofps nor -oautofps is specified, VFR encoding is assumed
+and the time base is 24000fps. -oautofps sets -ofps to a guessed fps number
 from the input video. Note that not all codecs and not all formats support VFR
 encoding, and some which do have bugs when a target bitrate is specified - use
---ofps or --oautofps to force CFR encoding in these cases.
+-ofps or -oautofps to force CFR encoding in these cases.
 
 Of course, the options can be stored in a profile, like this .config/mpv/mpv.conf
 section::
@@ -42,11 +42,13 @@ section::
   oacopts-add = b=96k
 
 It's also possible to define default encoding options by putting them into
-the section named ``[encoding]``.
+the section named ``[encoding]``. (This behavior changed after mpv 0.3.x. In
+mpv 0.3.x, config options in the default section / no section were applied
+to encoding. This is not the case anymore.)
 
 One can then encode using this profile using the command::
 
-  mpv infile --o=outfile.mp4 --profile=myencprofile
+  mpv infile -o outfile.mp4 -profile myencprofile
 
 Some example profiles are provided in a file
 etc/encoding-profiles.conf; as for this, see below.
@@ -60,10 +62,10 @@ for.
 
 Typical MPEG-4 Part 2 ("ASP", "DivX") encoding, AVI container::
 
-  mpv infile --o=outfile.avi \
+  mpv infile -o outfile.avi \
     --vf=fps=25 \
-    --ovc=mpeg4 --ovcopts=qscale=4 \
-    --oac=libmp3lame --oacopts=b=128k
+    -ovc mpeg4 -ovcopts qscale=4 \
+    -oac libmp3lame -oacopts ab=128k
 
 Note: AVI does not support variable frame rate, so the fps filter must be used.
 The frame rate should ideally match the input (25 for PAL, 24000/1001 or
@@ -71,22 +73,22 @@ The frame rate should ideally match the input (25 for PAL, 24000/1001 or
 
 Typical MPEG-4 Part 10 ("AVC", "H.264") encoding, Matroska (MKV) container::
 
-  mpv infile --o=outfile.mkv \
-    --ovc=libx264 --ovcopts=preset=medium,crf=23,profile=baseline \
-    --oac=libopus --oacopts=qscale=3
+  mpv infile -o outfile.mkv \
+    -ovc libx264 -ovcopts preset=medium,crf=23,profile=baseline \
+    -oac libvorbis -oacopts qscale=3
 
 Typical MPEG-4 Part 10 ("AVC", "H.264") encoding, MPEG-4 (MP4) container::
 
-  mpv infile --o=outfile.mp4 \
-    --ovc=libx264 --ovcopts=preset=medium,crf=23,profile=baseline \
-    --oac=aac --oacopts=b=128k
+  mpv infile -o outfile.mp4 \
+    -ovc libx264 -ovcopts preset=medium,crf=23,profile=baseline \
+    -oac aac -oacopts ab=128k
 
 Typical VP8 encoding, WebM (restricted Matroska) container::
 
   mpv infile -o outfile.mkv \
-    --of=webm \
-    --ovc=libvpx --ovcopts=qmin=6,b=1000000k \
-    --oac=libopus --oacopts=qscale=3
+    -of webm \
+    -ovc libvpx -ovcopts qmin=6,b=1000000k \
+    -oac libvorbis -oacopts qscale=3
 
 
 Device targets
@@ -95,9 +97,12 @@ Device targets
 As the options for various devices can get complex, profiles can be used.
 
 An example profile file for encoding is provided in
-etc/encoding-profiles.conf in the source tree. mpv will read any file
-named ``encoding-profiles.conf`` in either the local or system
-configuration directories.
+etc/encoding-profiles.conf in the source tree. This file is installed and loaded
+by default. If you want to modify it, you can replace and it with your own copy
+by doing::
+
+  mkdir -p ~/.mpv
+  cp /etc/mpv/encoding-profiles.conf ~/.mpv/encoding-profiles.conf
 
 Keep in mind that the default profile is the playback one. If you want to add
 options that apply only in encoding mode, put them into a ``[encoding]``
@@ -106,18 +111,18 @@ section.
 Refer to the top of that file for more comments - in a nutshell, the following
 options are added by it::
 
-  --profile=enc-to-dvdpal      # DVD-Video PAL, use dvdauthor -v pal+4:3 -a ac3+en
-  --profile=enc-to-dvdntsc     # DVD-Video NTSC, use dvdauthor -v ntsc+4:3 -a ac3+en
-  --profile=enc-to-bb-9000     # MP4 for Blackberry Bold 9000
-  --profile=enc-to-nok-6300    # 3GP for Nokia 6300
-  --profile=enc-to-psp         # MP4 for PlayStation Portable
-  --profile=enc-to-iphone      # MP4 for iPhone
-  --profile=enc-to-iphone-4    # MP4 for iPhone 4 (double res)
-  --profile=enc-to-iphone-5    # MP4 for iPhone 5 (even larger res)
+  -profile enc-to-dvdpal      DVD-Video PAL, use dvdauthor -v pal+4:3 -a ac3+en
+  -profile enc-to-dvdntsc     DVD-Video NTSC, use dvdauthor -v ntsc+4:3 -a ac3+en
+  -profile enc-to-bb-9000     MP4 for Blackberry Bold 9000
+  -profile enc-to-nok-6300    3GP for Nokia 6300
+  -profile enc-to-psp         MP4 for PlayStation Portable
+  -profile enc-to-iphone      MP4 for iPhone
+  -profile enc-to-iphone-4    MP4 for iPhone 4 (double res)
+  -profile enc-to-iphone-5    MP4 for iPhone 5 (even larger res)
 
 You can encode using these with a command line like::
 
-  mpv infile --o=outfile.mp4 --profile=enc-to-bb-9000
+  mpv infile -o outfile.mp4 -profile enc-to-bb-9000
 
 Of course, you are free to override options set by these profiles by specifying
 them after the -profile option.
@@ -128,19 +133,19 @@ What works
 
 * Encoding at variable frame rate (default)
 * Encoding at constant frame rate using --vf=fps=RATE
-* 2-pass encoding (specify flags=+pass1 in the first pass's --ovcopts, specify
+* 2-pass encoding (specify flags=+pass1 in the first pass's -ovcopts, specify
   flags=+pass2 in the second pass)
 * Hardcoding subtitles using vobsub, ass or srt subtitle rendering (just
   configure mpv for the subtitles as usual)
-* Hardcoding any other mpv OSD (e.g. time codes, using --osdlevel=3 and
-  --vf=expand=::::1)
+* Hardcoding any other mpv OSD (e.g. time codes, using -osdlevel 3 and -vf
+  expand=::::1)
 * Encoding directly from a DVD, network stream, webcam, or any other source
   mpv supports
 * Using x264 presets/tunings/profiles (by using profile=, tune=, preset= in the
-  --ovcopts)
+  -ovcopts)
 * Deinterlacing/Inverse Telecine with any of mpv's filters for that
-* Audio file converting: mpv --o=outfile.m4a infile.flac --no-video
-  --oac=aac --oacopts=b=320k
+* Audio file converting: mpv -o outfile.mp3 infile.flac -no-video -oac
+  libmp3lame -oacopts ab=320k
 
 What does not work yet
 ======================

DOCS/interface-changes.rst

@@ -17,547 +17,15 @@ a large part of the user interface and APIs.
 
 Also see compatibility.rst.
 
-Prior to 0.40.0, only changes had to be listed here and not necessarily new
-additions. After 0.40.0, all changes and additions to options/commands/etc are
-listed here.
-
-**Never** write to this file directly except when making releases. New changes
-are added in the interface-changes directory instead. See contribute.md for more
-details.
+This document lists changes to them. New changes are added to the top. Usually,
+only incompatible or important changes are mentioned. New options/commands/etc.
+are not always listed.
 
 Interface changes
 =================
 
 ::
 
- --- mpv 0.42.0 ---
- --- mpv 0.41.0 ---
-    - the value of `--tls-ca-file` is now expanded as a path
-    - the value of `--tls-cert-file` is now expanded as a path
-    - the value of `--tls-key-file` is now expanded as a path
-    - the `--sub-sdh-enclosures` option is now a string list option
-    - rename `console-selected_color` script-opt to `console-focused_color`
-    - rename `console-selected_back_color` script-opt to `console-
-      focused_back_color`
-    - mediacodec_embed is no longer the default `vo` on Android. Set the option
-      explicitly if you want to use it and are aware of the limitations.
-    - change `--target-colorspace-hint` to `auto` by default. Auto mode will
-      also enable hint for SDR formats if target metadata is reported by current
-      output context.
-    - change `--prefetch-playlist` default to `no`
-    - add `--clipboard-xwayland` option
-    - add `video-params/prim-*` properties
-    - add `stats-plot_cache` script-opt
-    - disable `stats-plot_{perfdata,vsync_ratio,vsync_jitter}` by default
-    - add `scaled` and `osd` flags to screenshot commands
-    - add `forced` flag to track add commands
-    - add `default` flag to track add commands
-    - add `console-monospace_font` script-opt
-    - remove `console-font` script-opt
-    - add `console-gap` script-opt
-    - add `console-exact_match` script-opt
-    - make `console-case_sensitive` only affect exact searches and change the to
-      default to no on platforms other than Windows
-    - add `commands-remember_input` script-opt
-    - add `--wid=0` support for win32
-    - add `--vo-kitty-auto-multiplexer-passthrough=<yes|no>`
-    - add `--vf=format=transfer` alias
-    - add `--vf=format=min-luma`
-    - add `--vf=format=max-luma`
-    - add `--vf=format=max-cll`
-    - add `--vf=format=max-fall`
-    - add `--treat-srgb-as-power22`
-    - add `--sdr-adjust-gamma`
-    - add `--target-colorspace-hint-strict` option
-    - add `--target-colorspace-hint-mode` option
-    - add `--sub-hdr-peak` option
-    - add `--sub-fix-timing-threshold`
-    - add `--sub-fix-timing-keep`
-    - add `--register` and `--unregister`
-    - add `--osd-prune-delay`
-    - add `--osd-glyph-limit`
-    - add `--osd-bitmap-max-size`
-    - add `--sub-glyph-limit`
-    - add `--sub-bitmap-max-size`
-    - add `--osd-shaper`
-    - add `--input-tablet-emulate-mouse` option
-    - add `--image-subs-hdr-peak` option
-    - add `--hwdec-threads`
-    - add `--hdr-reference-white`
-    - add `--d3d11-output-mode` enable use specific output mode for creating the
-      D3D11 swapchain
-    - add `--d3d11-composition-size=<WxH>` support for d3d11 composition mode
-    - add `--border-background=blur`
-    - add `--background-blur-radius`
-    - add `--bluray-angle`
-    - add `--background-tile-size` option
-    - add `--background-tile-color-0` and `--background-tile-color-1` options
-    - add --audio-set-media-role, disabled by default. This effectively changes
-      the behavior for ao_pipewire
-    - `encoding-profiles.conf` is no longer installed by default into the system
-      configuration directory and is instead installed in the data directory
- --- mpv 0.40.0 ---
-    - undeprecate list option suffixes that work with multiple items
-    - add `-del` to string list and keyvalue list options
-    - add `-clr` to keyvalue list options
-    - undeprecate `--gamma-factor`
-    - the `path` and `track-list/N/external-filename` properties now always
-      return a full, absolute path
-    - rename `--vd-lavc-software-fallback` to `--hwdec-software-fallback`
-    - rename `--sub-ass-line-spacing` to `--sub-line-spacing`
-    - rename `--sub-ass-shaper` to `--sub-shaper`
-    - rename `--sub-ass-hinting` to `--sub-hinting`
-    - rename `--load-osd-console` to `--load-console`
-    - remove `stats-term_width_limit` script-opt
-    - add `stats-term_clip` script-opt
-    - remove `stats-term_height_limit` script-opt
-    - remove `player` argument form `--media-controls`, it's handled internally
-      now.
-    - make `script-binding` command scalable; add `nonscalable` command prefix
-      to restore the old behavior
-    - deprecate `osc-message` script message in favor of `show-text` command
-    - deprecate `osc-chapterlist` script message in favor of `show-text
-      ${chapter-list}`
-    - deprecate `osc-playlist` script message in favor of `show-text
-      ${playlist}`
-    - deprecate `osc-tracklist` script message in favor of `show-text ${track-
-      list}`
-    - add `visibility_modes` script-opt to osc
-    - deprecate `--wayland-disable-vsync`
-    - add `--wayland-internal-vsync` as a replacement for `--wayland-disable-
-      vsync`
-    - deprecate `--cdda-span-a` and `--cdda-span-b`
-    - commands.lua is split out of console.lua. commands.lua runs and completes
-      commands and adds mpv's log entries to the console's log, while
-      console.lua handles the UI for other scripts
-    - add `--load-commands` option
-    - `script-binding console/enable` becomes `script-binding commands/open`,
-      though the console one is kept as an alias
-    - `script-message-to console type` becomes `script-message-to commands
-      type`, though the console one is kept as an alias. This also now
-      automatically closes the console after running the command.
-    - change the underlying type of the `aspect`, `par`, and `sar` sub-
-      properties to double from float
-    - add `--video-aspect-method=ignore`
-    - change `--video-aspect-override=no` to respect `--video-aspect-method`
-      option
-    - deprecate setting `--video-aspect-override` to `0` and `-1`
-    - change several OSC mouse bindings to select.lua functions
-    - add script-opts to configure what OSC buttons do when clicked
-    - remove `osc-playlist_osd` script-opt and behave as if it was off by
-      default; `playlist_osd=yes` can be replicated with `osc-
-      playlist_prev_mbtn_left_command=playlist-prev; show-text ${playlist} 3000`
-      and `osc-playlist_next_mbtn_left_command=playlist-next; show-text
-      ${playlist} 3000`
-    - remove `osc-chapters_osd` script-opt and behave as if it was off by
-      default; `chapter_osd=yes` can be replicated with `osc-
-      chapter_prev_mbtn_left_command=no-osd add chapter -1; show-text ${chapter-
-      list} 3000` and `osc-chapter_next_mbtn_left_command=no-osd add chapter 1;
-      show-text ${chapter-list} 3000`
-    - add script-opts to define custom buttons
-    - change `--prefetch-playlist`'s default to `yes`
-    - change `--osd-back-color` and `--sub-back-color` defaults to #AF000000
-    - change `--geometry` so that it no longer unconditionally moves the window
-      on platforms where that is possible. Use `--force-window-position` or add
-      `+50%+50%` to your geometry command to get the old behavior back.
-    - all options that take filepaths as values are now properly expanded (i.e.
-      ~/ -> /home/$USER)
-    - all commands that take filepaths as arguments are now properly expanded
-      (i.e. ~/ -> /home/$USER)
-    - add `ytdl_hook-include` script-opt
-    - add `video-frame-info/gop-timecode`, `video-frame-info/smpte-timecode` and
-      `video-frame-info/estimated-smpte-timecode`
-    - add `term-clip-cc`
-    - add `sub-ass-prune-delay` option to control libass automatic pruning of
-      past
-    - events
-    - add `slimbottombar` and `slimtopbar` OSC layouts optimized for viewing
-      images
-    - add `osc-fadein` script-opt
-    - add `mpv://` protocol
-    - add `metadata` sub-property for `track-list`
-    - add `keep_open` flag to `mp.input.get()` and `mp.input.select()`
-    - `mp.input.get()` now closes automatically on submit, pass `keep_open =
-      true` to restore the old behavior
-    - add `autoselect_completion` flag to `mp.input.get()`
-    - add `history_path` key to `mp.input.get()`
-    - add `hearing-impaired`, `visual-impaired` and `attached-picture` flags to
-      track add command
-    - add `format` argument to `screenshot-raw` command
-    - add `display-page-n-toggle` script bindings to stats.lua, where n is a
-      page number
-    - add `demuxer-mkv-crop-compat` option
-    - add `current-watch-later-dir` property
-    - add `console-scale_with_window` script-opt
-    - add `console-margin-x` and `console-margin-y` script-opts
-    - add `console-background_alpha` `console-menu_outline_size` `console-
-      menu_outline_color` `console-corner_radius` `console-selected_color` and
-      `console-selected_back_color` script-opts
-    - add `--video-recenter` option
-    - add `nvidia-true-hdr` mode to vf_d3d11vpp
-    - add `--sub-scale-signs` to allow `--sub-scale` to also scale events
-      detected to be signs by libass
-    - add `--script-opt` alias for `--script-opts-append`
-    - add `--save-watch-history` and `--watch-history-path` options
-    - add `--osd-selected-color` and `--osd-selected-outline-color` options
-    - add `--osd-bar-marker-scale` and `--osd-bar-marker-min-size` options
-    - add `--osd-bar-marker-style` option
-    - add `--input-ime` to enable or disable the IME on supported VOs (Windows,
-      Wayland)
-    - add `--clipboard-monitor` option
-    - add `clipboard` property
-    - add `current-clipboard-backend` property
-    - add `--clipboard-backends` option
-    - add `--archive-exts`
-    - add `archive` to `--directory-filter-types`' default
-    - add `--playlist-exts`
-    - add `playlist` to `--directory-filter-types`' default
-    - add --audio-exclusive option support for ao=audiounit and make non-
-      exclusive the new default
-    - `sub-blur` is now applied by `sub-ass-override=force` with new enough
-      libass
-    - `stats-font_size`, `stats-border_size`, `stats-shadow_x_offset`, `stats-
-      shadow_y_offset` and `stats-plot_bg_border_width` script-opt values result
-      in 2.5 times smaller sizes in order to have the same sizes as the values
-      of equivalent OSD options like `--osd-font-size`. If you customized these
-      sizes, multiply them by 2.5 to get the previous sizes.
-    - ``glsl-shader-opts`` now has predefined parameters that can be used. See
-      the documentation for available values.
-    - `--hwdec=auto` now behaves like `--hwdec=auto-safe`; use `--hwdec=auto-
-      unsafe` to get the old behavior back
-    - Change auto profiles hook priority from 50 to 5
-    - add optional `frames` and `flags` arguments to `frame-step` command
-      controlling the direction and amount of frames mpv steps through
-    - add optional `mute` flag to `frame-step` command which mutes the player
-      during the duration of the frame step
- --- mpv 0.39.0 ---
-    - turn `--cover-art-whitelist` into a list option
-    - reserve `user-data/osc` and `user-data/mpv` sub-paths for internal use
-    - remove deprecated `packet-video-bitrate` `packet-audio-bitrate` and
-      `packet-sub-bitrate` properties
-    - remove deprecated `--cache-dir` option alias
-    - remove deprecated `--cache-unlink-files` option alias
-    - remove deprecated `--demuxer-cue-codepage` option alias
-    - remove deprecated `--fps` option alias
-    - remove deprecated `--cdrom-device` option alias
-    - remove deprecated `--sub-forced-only` option alias
-    - remove deprecated `--vo-sixel-exit-clear` option alias
-    - remove deprecated `--cdda-toc-bias` option
-    - remove deprecated `--drm-atomic` option
-    - remove `sub-ass-vsfilter-aspect-compat`: use `sub-ass-use-video-data=none`
-      for disabling aspect compat
-    - remove `sub-ass-vsfilter-blur-compat`: use `sub-ass-use-video-data=aspect-
-      ratio` for disabling blur compat
-    - add `sub-ass-use-video-data`
-    - add `sub-ass-video-aspect-override`
-    - change default V keybind to cycle `sub-ass-use-video-data` instead of the
-      now removed `sub-ass-vsfilter-aspect-compat`
-    - remove `console-scale` script-opt
-    - remap numpad `+ - * /` keys to `KP_ADD/KP_SUBTRACT/KP_MULTIPLY/KP_DIVIDE`;
-      keybinds which require these numpad keys to function need to use the new
-      names instead
-    - numerical values of `--loop-file` no longer decrease on each iteration
-    - add `remaining-file-loops` property as a replacement to get the remaining
-      loop count
-    - numerical values of `--ab-loop-count` no longer decrease on each iteration
-    - add `remaining-ab-loops` property as a replacement to get the remaining
-      loop count
-    - move 'scale' above 'force' for `sub-ass-override` in documentation as well
-      as code. This more accurately reflects destructiveness of these options.
-    - change `sub-ass-override` default from 'yes' to 'scale'. This should
-      result in no effective changes because 'yes' used to unintentionally do
-      what 'scale' should've done.
-    - change 'u' binding to cycle between 'force' and 'scale', instead of
-      'force' and 'yes'
-    - deprecate `sub-text-ass` property; add `sub-text/ass` sub-property
-    - change type of `sub-start` and `sub-end` properties to time
-    - change `vidscale` script option type to string for osc.lua
-    - change `vidscale` script option type to string for stats.lua
-    - change `vidscale` default from `yes` to `auto` for osc.lua and stats.lua
-    - change `mp.add_key_binding` so that by default, the callback is not
-      invoked if the event is canceled; clients should now use the `complex`
-      option to detect this situation
-    - add `canceled` entry to `mp.add_key_binding` callback argument
-    - add the `normalize-path` command
-    - add `user-data/mpv/ytdl/path` and `user-data/mpv/ytdl/json-subprocess-
-      result` properties
-    - add `track-list/N/dolby-vision-profile` and `track-list/N/dolby-vision-
-      level`
-    - add `track-list/N/decoder`
-    - add `sub-text/ass-full` sub-property
-    - add `osc-show` script message
-    - add `nonrepeatable` input command prefix
-    - add `mp.input.select()`
-    - add `--wasapi-exclusive-buffer` option
-    - add `--vf=d3d11vpp=scaling-mode`
-    - add `--vf=d3d11vpp=scale`
-    - add `--sub-border-style` and `--osd-border-style` options
-    - the border style does not depend on `--(sub/osd)-border-color` and
-      `--(sub/osd)-shadow-color`; now it depends solely on `--(sub/osd)-border-
-      style`
-    - make `--(sub/osd)-border-color` an alias of `--(sub/osd)-outline-color`
-    - make `--(sub/osd)-border-size` an alias of `--(sub/osd)-outline-size`
-    - make `--(sub/osd)-shadow-color` an alias of `--(sub/osd)-back-color`; they
-      cannot both be set now
-    - make `--osd-bar-border-size` an alias of `--osd-bar-outline-size`
-    - add `--show-in-taskbar` option
-    - add `--pitch` option
-    - add `--osd-playlist-entry` option
-    - remove `osc-playlist_media_title` script-opt
-    - add `--native-touch` option
-    - add `--input-touch-emulate-mouse` option
-    - add `touch-pos` property
-    - add `--media-controls` option
-    - add `--input-dragging-deadzone` option
-    - add `--input-builtin-dragging` option
-    - add `--egl-config-id` option
-    - add `--egl-output-format` option
-    - add `--directory-filter-types`
-    - By default, opening a directory will create a playlist with only the media
-      types "video, audio, image". To restore the previous behavior, use
-      `--directory-filter-types-clr`.
-    - add `--autocreate-playlist`
-    - add `--video-exts`
-    - add `--audio-exts`
-    - add `--image-exts`
-    - add `option-info/<name>/expects-file` sub-property
-    - Bump dependency of VapourSynth to utilize its API version 4. New minimum
-      VapourSynth version for runtime is R56. Some functions and plugins are
-      changed or removed. For details, refer to VapourSynth documentation
-      <http://www.vapoursynth.com/2021/09/r55-audio-support-and-improved-performance/> and
-      <https://github.com/vapoursynth/vapoursynth/blob/R68/APIV4%20changes.txt>
- --- mpv 0.38.0 ---
-    - add `term-size` property
-    - add the `escape-ass` command
-    - add `>` for fixed precision floating-point property expansion
-    - add `--input-comands` option
-    - change `--pulse-latency-hacks` default to `yes`
-    - add `context-menu` command
-    - add `menu-data` property
-    - add `--vo-tct-buffering` option
-    - add `begin-vo-dragging` command
-    - add `--deinterlace-field-parity` option
-    - add `--volume-gain`, `--volume-gain-min`, and `--volume-gain-max` options
-    - add `current-gpu-context` property
-    - add `--secondary-sub-ass-override` option
-    - add `--input-preprocess-wheel` option
-    - remove `shared-script-properties` (`user-data` is a replacement)
-    - add `--secondary-sub-delay`, decouple secondary subtitles from
-      `--sub-delay`
-    - add the `--osd-bar-border-size` option
-    - `--screenshot-avif-pixfmt` no longer defaults to yuv420p
-    - `--screenshot-avif-opts` defaults to lossless screenshot
-    - rename key `MP_KEY_BACK` to `MP_KEY_GO_BACK`
-    - add `--sub-filter-sdh-enclosures` option
-    - added the `mp.input` scripting API to query the user for textual input
-    - add `forced` choice to `subs-with-matching-audio`
-    - remove `--term-remaining-playtime` option
-    - change fallback deinterlace to bwdif
-    - add the command `load-config-file`
-    - add the command `load-input-conf`
-    - remove `--vo=rpi`, `--gpu-context=rpi`, and `--hwdec=mmal`
-    - add `auto` choice to `--deinterlace`
-    - change `--teletext-page` default from 100 to 0 ("subtitle" in lavc)
-    - change `--hidpi-window-scale` default to `no`
-    - add `insert-next`, `insert-next-play`, `insert-at`, and `insert-at-play`
-      actions to `loadfile` and `loadlist` commands
-    - add `index` argument to `loadlist` command
-    - add `index` argument to `loadfile` command. This breaks all existing
-      uses of this command which make use of the argument to include the list of
-      options to be set while the file is playing. To address this problem, the
-      third argument now needs to be set to -1 if the fourth argument needs to be used.
-    - move the `options` argument of the `loadfile` command from the third
-      parameter to the fourth (after `index`)
-    - add `--drag-and-drop=insert-next` option
-    - rename `--background` to `--background-color`
-    - remove `--alpha` and reintroduce `--background` option for better control
-      over blending alpha components into specific background types
-    - add `--border-background` option
-    - add `video-target-params` property
-    - add `hdr10plus` sub-parameter to `format` video filter
-    - remove `--focus-on-open` and add replacement `--focus-on`
-    - remove debanding from the high-quality profile
- --- mpv 0.37.0 ---
-    - `--save-position-on-quit` and its associated commands now store state files
-      in %LOCALAPPDATA% instead of %APPDATA% directory by default on Windows.
-    - change `--subs-with-matching-audio` default from `no` to `yes`
-    - change `--subs-fallback` default from `no` to `default`
-    - add the `--hdr-peak-percentile` option
-    - include `--hdr-peak-percentile` in the `gpu-hq` profile
-    - change `--audiotrack-pcm-float` default from `no` to `yes`
-    - add video-params/aspect-name
-    - change type of `--sub-pos` to float
-    - The remaining time printed in the terminal is now adjusted for speed by default.
-      You can disable this with `--no-term-remaining-playtime`.
-    - add `playlist-path` and `playlist/N/playlist-path` properties
-    - add `--x11-wid-title` option
-    - add `--libplacebo-opts` option
-    - add `--audio-file-exts`, `--cover-art-auto-exts`, and `--sub-auto-exts`
-    - change `slang` default back to NULL
-    - remove special handling of the `auto` value from `--alang/slang/vlang` options
-    - add `--subs-match-os-language` as a replacement for `--slang=auto`
-    - add `always` option to `--subs-fallback-forced`
-    - remove `auto` choice from `--sub-forced-only`
-    - remove `auto-forced-only` property
-    - rename `--sub-forced-only` to `--sub-forced-events-only`
-    - remove `sub-forced-only-cur` property (`--sub-forced-events-only` is a replacement)
-    - remove deprecated `video-aspect` property
-    - add `--video-crop`
-    - add `video-params/crop-[w,h,x,y]`
-    - remove `--tone-mapping-mode`
-    - change `--subs-fallback-forced` so that it works alongside `--slang`
-    - add `--icc-3dlut-size=auto` and make it the default
-    - add `--scale=ewa_lanczos4sharpest`
-    - remove `--scale-wblur`, `--cscale-wblur`, `--dscale-wblur`, `--tscale-wblur`
-    - remove `bcspline` filter (`bicubic` is now the same as `bcspline`)
-    - rename `--cache-dir` and `--cache-unlink-files` to `--demuxer-cache-dir` and
-      `--demuxer-cache-unlink-files`
-    - enable `--correct-downscaling`, `--linear-downscaling`, `--sigmoid-upscaling`
-    - `--cscale` defaults to `--scale` if not defined
-    - change `--tscale` default to `oversample`
-    - change `--dither-depth` to `auto`
-    - deprecate `--profile=gpu-hq`, add `--profile=<fast|high-quality>`
-    - change `--dscale` default to `hermite`
-    - update defaults to `--hdr-peak-decay-rate=20`, `--hdr-scene-threshold-low=1.0`,
-      `--hdr-scene-threshold-high=3.0`
-    - update defaults to `--deband-threshold=48`, `--deband-grain=32`
-    - add `--directory-mode=auto` and make it the default
-    - remove deprecated `--profile=opengl-hq`
-    - remove several legacy fallbacks for old deprecated options (now they will just
-      error out like normal)
-    - remove deprecated `drop-frame-count` and `vo-drop-frame-count` property aliases
-    - remove the ability to write to the `display-fps` property (use `override-display-fps`
-      instead)
-    - writing the current value to playlist-pos will no longer restart playback (use
-      `playlist-play-index` instead)
-    - remove deprecated `--oaoffset`, `--oafirst`, `--ovoffset`, `--ovfirst`,
-      `--demuxer-force-retry-on-eof`, `--fit-border` options
-    - remove deprecated `--record-file` option
-    - remove deprecated `--vf-defaults` and `--af-defaults` options
-    - `--drm-connector` no longer allows selecting the card number (use `--drm-device`
-      instead)
-    - add `--title-bar` option
-    - add `--window-corners` option
-    - rename `--cdrom-device` to `--cdda-device`
-    - remove `--scale-cutoff`, `--cscale-cutoff`, `--dscale-cutoff`, `--tscale-cutoff`
-    - remove `--scaler-lut-size`
-    - deprecate shared-script-properties (user-data is a replacement)
-    - add `--backdrop-type` option
-    - add `--window-affinity` option
-    - `--config-dir` no longer forces cache and state files to also reside in there
-    - deprecate `--demuxer-cue-codepage` in favor of `--metadata-codepage`
-    - change the default of `metadata-codepage` to `auto`
-    - add `playlist-next-playlist` and `playlist-prev-playlist` commands
-    - change `video-codec` to show description or name, not both
-    - deprecate `--cdda-toc-bias` option, offsets are always checked now
-    - disable `--allow-delayed-peak-detect` by default
-    - rename `--fps` to `--container-fps-override`
-    - rename `--override-display-fps` to `--display-fps-override`
-    - rename `--sub-ass-force-style` to `--sub-ass-style-overrides`
-    - alias `--screenshot-directory` to `--screenshot-dir`
-    - alias `--watch-later-directory` to `--watch-later-dir`
-    - rename `--play-dir` to `--play-direction`
-    - `--js-memory-report` is now used for enabling memory reporting for javascript
-      scripts
-    - drop support for `-del` syntax for list options
-    - `--demuxer-hysteresis-secs` now respects `--cache-secs` and/or
-      `--demuxer-readahead-secs` as well
-    - add hdr metadata to `video-params` property
-    - add `--target-gamut`
-    - change the way display names are retrieved on macOS, usage of options and properties
-      `--fs-screen-name`, `--screen-name` and `display-names` needs to be adjusted
-    - remove OpenGL cocoa backend that was deprecated in 0.29
-    - remove `border`, `fullscreen`, `ontop`, `osd-level` and `pause`
-      from default `--watch-later-options`
-    - add `video-*` and `secondary-sub-visibility` to default `--watch-later-options`
- --- mpv 0.36.0 ---
-    - add `--target-contrast`
-    - Target luminance value is now also applied when ICC profile is used.
-      `--icc-use-luma` has been added to use ICC profile luminance value.
-      If target luminance and ICC luminance is not used, old behavior apply,
-      defaulting to 203 nits. (Only applies for `--vo=gpu-next`)
-    - `playlist/N/title` gets set upon opening the file if it wasn't already set
-      and a title is available.
-    - add the `--vo=kitty` video output driver, as well as the options
-      `--vo-kitty-cols`, `--vo-kitty-rows`, `--vo-kitty-width`,
-      `--vo-kitty-height`, `--vo-kitty-left`, `--vo-kitty-top`,
-      `--vo-kitty-config-clear`, `--vo-kitty-alt-screen` and
-      `--vo-kitty-use-shm`
-    - add `--force-render`
-    - add `--vo-sixel-config-clear`, `--vo-sixel-alt-screen` and
-      `--vo-sixel-buffered`
-    - add `--wayland-content-type`
-    - deprecate `--vo-sixel-exit-clear` and alias it to
-      `--vo-sixel-alt-screen`
-    - deprecate `--drm-atomic`
-    - add `--demuxer-hysteresis-secs`
-    - add `--video-sync=display-tempo`
-    - the `start` option is no longer unconditionally written by
-      watch-later. It is still written by default but you may
-      need to explicitly add `start` depending on how you have
-      `--watch-later-options` configured.
-    - add `--vd-lavc-dr=auto` and make it the default
-    - add support for the fractional scale protocol in wayland
-    - in wayland, hidpi window scaling now scales the window by the compositor's
-      dpi scale factor by default (can be disabled with --no-hidpi-window-scale
-      if fractional scaling support exists).
-    - change --screenshot-tag-colorspace default value from `no` to `yes`
-    - undeprecate vf_sub
-    - add `--tone-mapping=st2094-40` and `--tone-mapping=st2094-10`
-    - change `--screenshot-jxl-effort` default from `3` to `4`.
-    - add `--tone-mapping-visualize`
-    - change type of `--brightness`, `--saturation`, `--contrast`, `--hue` and
-      `--gamma` to float.
-    - add `platform` property
-    - add `--auto-window-resize`
-    - `--save-position-on-quit` and its associated commands now store state files in
-      the XDG_STATE_HOME directory by default. This only has an effect on linux/bsd
-      systems.
-    - mpv now implicitly saves cache files in XDG_CACHE_HOME by default. This only has
-      an effect if the user enables options that would lead to cache being stored and
-      only makes a difference on linux/bsd systems.
-    - `--cache-on-disk` no longer requires explicitly setting the `--cache-dir` option
-    - add `--icc-cache` and `--gpu-shader-cache` options to control whether or not to
-      save cache files for these features; explicitly setting `--icc-cache-dir` and
-      `--gpu-shader-cache` is no longer required
-    - remove the `--tone-mapping-crosstalk` option
-    - add `--gamut-mapping-mode=perceptual|relative|saturation|absolute|linear`
-    - add `--corner-rounding` option
-    - change `--subs-with-matching-audio` default from `yes` to `no`
-    - change `--slang` default from blank to `auto`
-    - add `--input-cursor-passthrough` option to allow pointer events to completely
-      passthrough the mpv window
-    - icc and gpu-shader cache are now saved by default (use --no-icc-shader-cache and
-      --no-gpu-shader-cache to disable)
-    - add `--directory-mode=recursive|lazy|ignore`
-    - `--hwdec=yes` is now mapped to `auto-safe` rather than `auto` (also used
-      by ctrl+h keybind)
-    - add `--hdr-contrast-recovery` and `--hdr-contrast-smoothness`
-    - include `--hdr-contrast-recovery` in the `gpu-hq` profile
- --- mpv 0.35.0 ---
-    - add the `--vo=gpu-next` video output driver, as well as the options
-      `--allow-delayed-peak-detect`, `--builtin-scalers`,
-      `--interpolation-preserve` `--lut`, `--lut-type`, `--image-lut`,
-      `--image-lut-type` and `--target-lut` along with it.
-    - add `--target-colorspace-hint`
-    - add `--tone-mapping-crosstalk`
-    - add `--tone-mapping` options `auto`, `spline` and `bt.2446a`
-    - add `--inverse-tone-mapping`
-    - add `--gamut-mapping-mode`, replacing `--gamut-clipping` and `--gamut-warning`
-    - add `--tone-mapping-mode`, replacing `--tone-mapping-desaturate` and
-      `--tone-mapping-desaturate-exponent`.
-    - add `dolbyvision` sub-parameter to `format` video filter
-    - `--sub-visibility` no longer has any effect on secondary subtitles
-    - add `film-grain` sub-parameter to `format` video filter
-    - add experimental `--vo=dmabuf-wayland` video output driver
-    - add `--x11-present` for controlling whether to use xorg's present extension
-    - add `engine` option to the `rubberband` audio filter to support the new
-      engine introduced in rubberband 3.0.0. Defaults to `finer` (new engine).
-    - add `--wayland-configure-bounds` option
-    - deprecate `--gamma-factor`
-    - deprecate `--gamma-auto`
-    - remove `--vulkan-disable-events`
-    - add `--glsl-shader-opts`
  --- mpv 0.34.0 ---
     - deprecate selecting by card number with `--drm-connector`, add
       `--drm-device` which can be used instead
@@ -590,7 +58,7 @@ Interface changes
     - names starting with "." in ~/.mpv/scripts/ (or equivalent) are now ignored
     - js modules: ~~/scripts/modules.js/ is no longer used, global paths can be
       set with custom init (see docs), dir-scripts first look at <dir>/modules/
-    - the macOS bundle now logs to "~/Library/Logs/mpv.log" by default
+    - the OSX bundle now logs to "~/Library/Logs/mpv.log" by default
     - deprecate the --cache-secs option (once removed, the cache cannot be
       limited by time anymore)
     - remove deprecated legacy hook API ("hook-add", "hook-ack"). Use either the
@@ -660,7 +128,7 @@ Interface changes
     - deprecate --input-file (there are no plans to remove this short-term,
       but it will probably eventually go away <- that was a lie)
     - deprecate --video-sync=display-adrop (might be removed if it's in the way;
-      undeprecated or re-added if it's not too much of a problem)
+      undeprecated or readded if it's not too much of a problem)
     - deprecate all input section commands (these will be changed/removed, as
       soon as mpv internals do not require them anymore)
     - remove deprecated --playlist-pos alias (use --playlist-start)
@@ -852,7 +320,7 @@ Interface changes
       (such as "sub-file"), deprecated in mpv 0.26.0
     - deprecate the old command based hook API, and introduce a proper C API
       (the high level Lua API for this does not change)
-    - rename the lua-settings/ config directory to script-opts/
+    - rename the the lua-settings/ config directory to script-opts/
     - the way the player waits for scripts getting loaded changes slightly. Now
       scripts are loaded in parallel, and block the player from continuing
       playback only in the player initialization phase. It could change again in

DOCS/interface-changes/all_formats.txt

@@ -1 +0,0 @@
-change `ytdl_hook-all_formats` default to `yes`

DOCS/interface-changes/autocreate-playlist.txt

@@ -1 +0,0 @@
-make `--autocreate-playlist` only activate for regular files

DOCS/interface-changes/cmd-set-metadata.txt

@@ -1 +0,0 @@
-make the `metadata/by-key` property writable

DOCS/interface-changes/command-list.txt

@@ -1 +0,0 @@
-'command-list' now also returns a default value and available choices where applicable for each command argument.

DOCS/interface-changes/command-name.txt

@@ -1 +0,0 @@
-make `mpv_command_node` accept `_name` for command name

DOCS/interface-changes/demuxer-hysteresis-bytes.txt

@@ -1 +0,0 @@
-add `--demuxer-hysteresis-bytes`

DOCS/interface-changes/dnd.txt

@@ -1,2 +0,0 @@
-add `--input-builtin-drag-and-drop` option
-add `dropped-file` property

DOCS/interface-changes/end-file-error.txt

@@ -1 +0,0 @@
-remove the deprecated `error` field from `end-file`

DOCS/interface-changes/env-property.txt

@@ -1 +0,0 @@
-add `env` property that can be used to retrieve environment variables

DOCS/interface-changes/example.txt

@@ -1 +0,0 @@
-deprecate `--foo`, instead use `--bar=foo` as a replacement

DOCS/interface-changes/expand-properties.txt

@@ -1 +0,0 @@
-the `expand-properties` command modifier also applies to string lists now

DOCS/interface-changes/geometry-position.txt

@@ -1 +0,0 @@
-`--geometry` x/y position is now applied only on initial window creation, unless `--force-window-position=yes` is set.

DOCS/interface-changes/http-backend.txt

@@ -1 +0,0 @@
-add libcurl-based stream backend (http, https, ftp, ftps), with new options `--curl-enabled`, `--curl-http-version`, `--curl-max-redirects`, `--curl-max-retries`, `--curl-connect-timeout`, `--curl-buffer-size` and `--curl-max-request-size`

DOCS/interface-changes/libplacebo-version.txt

@@ -1 +0,0 @@
-add `libplacebo-version` property

DOCS/interface-changes/loadfile-refactor.txt

@@ -1 +0,0 @@
-the `loadfile` and `loadlist` commands can now take multiple flags (i.e. `append+play`)

DOCS/interface-changes/log-error.txt

@@ -1 +0,0 @@
-deprecate `mp.input.log_error()`

DOCS/interface-changes/lua-settings.rst

@@ -1 +0,0 @@
-stop searching the deprecated `lua-settings` directory for script config files

DOCS/interface-changes/menu-open.rst

@@ -1 +0,0 @@
-add `user-data/mpv/context-menu/open` sub-property

DOCS/interface-changes/mp-input-async-completions.txt

@@ -1,4 +0,0 @@
-`mp.input.get()` `complete` callbacks are now passed a second argument,
-a function which can be passed the completion values, which allows generating
-completions asynchronously. The old method of returning completions from
-the callback is now deprecated.

DOCS/interface-changes/mp-input-console-opts.txt

@@ -1 +0,0 @@
-add `console_opt_overrides` argument to `mp.input.get()` and `mp.input.select()`

DOCS/interface-changes/mp-utils-terminal-display-width.txt

@@ -1,2 +0,0 @@
-add `mp.utils.terminal_display_width()` function that measures the width of
-a string in terminal cells

DOCS/interface-changes/on-loaded.txt

@@ -1 +0,0 @@
-add `on_loaded` hook

DOCS/interface-changes/osc-audioonly.txt

@@ -1 +0,0 @@
-add `audioonlyscreen` script option to osc

DOCS/interface-changes/osc-boxwidth.txt

@@ -1,2 +0,0 @@
-add `boxwidth` script option to osc
-add `slimboxwidth` script option to osc

DOCS/interface-changes/osc-down.txt

@@ -1,2 +0,0 @@
-add `skip_{backward,forward}_mbtn_*_down_command` script-opt for osc
-add `{close,minimize,maximize}_mbtn_*_command` script-opt for osc

DOCS/interface-changes/osc-icon-style.txt

@@ -1 +0,0 @@
-add `osc-icon_style` option

DOCS/interface-changes/osc-margins.txt

@@ -1,3 +0,0 @@
-add `osc-dynamic_margins` option
-add `osc-sub-margin` option
-add `osc-osd-margin` option

DOCS/interface-changes/osc-wc.txt

@@ -1 +0,0 @@
-add `osc-windowcontrols_independent` script-opt

DOCS/interface-changes/osc-windowcontrols-title.txt

@@ -1 +0,0 @@
-remove `windowcontrols_title` script-opt from osc, use `title` mpv option instead

DOCS/interface-changes/player-operation-mode.rst

@@ -1 +0,0 @@
-make `player-operation-mode` readable as a property

DOCS/interface-changes/preserve-options.txt

@@ -1 +0,0 @@
-add `preserve-options` flag to `playlist-play-index`

DOCS/interface-changes/program-editions.txt

@@ -1,6 +0,0 @@
-``track-list`` is now filtered by the currently selected edition
-add ``edition-list/N/metadata`` sub-property
-add ``program_id`` support to EDL ``!track_meta`` header
-add ``--flatten-editions`` option to disable program-based edition grouping
-add ``track-list/N/program-ids`` sub-property
-deprecate ``track-list/N/program-id`` in favor of ``track-list/N/program-ids``

DOCS/interface-changes/screenshot-template-time.txt

@@ -1 +0,0 @@
-change `%tX` format specifier of `--screenshot-template` option to only accept C11 strftime specifiers or `%s` specifier

DOCS/interface-changes/scrgb.txt

@@ -1 +0,0 @@
-add `--target-trc=scrgb`

DOCS/interface-changes/show-dependent-tracks.txt

@@ -1,2 +0,0 @@
-``track-list`` now hides dependent tracks (e.g. tile sub-streams, IAMF audio element layers, LCEVC enhancement streams) by default
-add ``--show-dependent-tracks`` option to expose them

DOCS/interface-changes/speed-aware-image-display-duration.txt

@@ -1 +0,0 @@
-effective `--image-display-duration` takes `--speed` into consideration now

DOCS/interface-changes/stats-page-5.txt

@@ -1,2 +0,0 @@
-add `track_info_selected_only` script option for stats
-add `track-list/N/demux-duration` property

DOCS/interface-changes/sub-lines.txt

@@ -1 +0,0 @@
-add `sub-lines` and `secondary-sub-lines` properties

DOCS/interface-changes/target-gamut-custom-primaries.txt

@@ -1 +0,0 @@
-`--target-gamut` now accepts custom CIE xy primaries as comma-separated values (Rx,Ry,Gx,Gy,Bx,By,Wx,Wy) in addition to named primary sets

DOCS/interface-changes/time-start.txt

@@ -1 +0,0 @@
-remove the deprecated `time-start` property

DOCS/interface-changes/tls-verify-default.txt

@@ -1 +0,0 @@
-change `--tls-verify` default to `yes`

DOCS/interface-changes/update-clipboard.txt

@@ -1,2 +0,0 @@
-add `update-clipboard` command
-change `clipboard` property to require `update-clipboard` command when clipboard monitoring is disabled

DOCS/interface-changes/vf-amd-frc.txt

@@ -1 +0,0 @@
-add `--vf=amf_frc`

DOCS/interface-changes/vf-d3d11vpp-fix-ivctc-typo.txt

@@ -1 +0,0 @@
-rename `d3d11vpp=mode=ivctc` to `d3d11vpp=mode=ivtc`

DOCS/interface-changes/vf_format.txt

@@ -1 +0,0 @@
-deprecate `--vf=format=sig-peak`

DOCS/interface-changes/vo-deprecation.txt

@@ -1 +0,0 @@
-deprecate `--vo=vaapi`

DOCS/interface-changes/vo-gpu-params-support.txt

@@ -1 +0,0 @@
-add support for (a subset of) tunable parameter for `vo=gpu`

DOCS/interface-changes/wayland-session.txt

@@ -1,2 +0,0 @@
-add `--wayland-session=<string>`
-restore the mpv window on wayland using xdg-session-management-v1

DOCS/man/af.rst

@@ -8,8 +8,6 @@ syntax is:
     Setup a chain of audio filters. See ``--vf`` (`VIDEO FILTERS`_) for the
     full syntax.
 
-    This is an object settings list option. See `List Options`_ for details.
-
 .. note::
 
     To get a full list of available audio filters, see ``--af=help``.
@@ -21,8 +19,8 @@ syntax is:
     The ``--vf`` description describes how libavfilter can be used and how to
     workaround deprecated mpv filters.
 
-See ``--vf`` group of options for info on how ``--af-add``, ``--af-pre``,
-``--af-clr``, and possibly others work.
+See ``--vf`` group of options for info on how ``--af-defaults``, ``--af-add``,
+``--af-pre``, ``--af-del``, ``--af-clr``, and possibly others work.
 
 Available filters are:
 
@@ -102,7 +100,7 @@ Available filters are:
 
 ``scaletempo[=option1:option2:...]``
     Scales audio tempo without altering pitch, optionally synced to playback
-    speed.
+    speed (default).
 
     This works by playing 'stride' ms of audio at normal speed then consuming
     'stride*scale' ms of input audio. It pieces the strides together by
@@ -118,8 +116,8 @@ Available filters are:
         cause noticeable skips at high scale amounts and an echo at low scale
         amounts. Very low values will alter pitch. Increasing improves
         performance. (default: 60)
-    ``overlap=<factor>``
-        Factor of stride to overlap. Decreasing improves performance.
+    ``overlap=<percent>``
+        Percentage of stride to overlap. Decreasing improves performance.
         (default: .20)
     ``search=<amount>``
         Length in milliseconds to search for best overlap position. Decreasing
@@ -163,17 +161,14 @@ Available filters are:
             Would play media at 1.2x normal speed, with audio at normal pitch.
             Changing playback speed would change pitch, leaving audio tempo at
             1.2x.
-
+    
 ``scaletempo2[=option1:option2:...]``
     Scales audio tempo without altering pitch.
-    The algorithm is ported from chromium and uses the
+    The algorithm is ported from chromium and uses the 
     Waveform Similarity Overlap-and-add (WSOLA) method.
-    It seems to achieves higher audio quality than scaletempo, and rubberband R2
-    engine, or ``engine=faster``. This filter is inserted automatically if
-    ``audio-pitch-correction`` option is used (on by default) when the playback
-    speed is changed.
+    It seems to achieve a higher audio quality than scaletempo and rubberband.
 
-    By default, the ``search-interval`` and ``window-size`` parameters
+    By default, the ``search-interval`` and ``window-size`` parameters 
     have the same values as in chromium.
 
     ``min-speed=<speed>``
@@ -181,33 +176,22 @@ Available filters are:
 
     ``max-speed=<speed>``
         Mute audio if the playback speed is above ``<speed>``
-        and ``<speed> != 0``. (default: 8.0)
+        and ``<speed> != 0``. (default: 4.0)
 
     ``search-interval=<amount>``
-        Length in milliseconds to search for best overlap position. (default: 40)
-
+        Length in milliseconds to search for best overlap position. (default: 30)
+    
     ``window-size=<amount>``
-        Length in milliseconds of the overlap-and-add window. (default: 12)
+        Length in milliseconds of the overlap-and-add window. (default: 20)
 
 ``rubberband``
     High quality pitch correction with librubberband. This can be used in place
-    of ``scaletempo`` and ``scaletempo2``, and will be used to adjust audio pitch
-    when playing at speed different from normal. It can also be used to adjust
-    audio pitch without changing playback speed.
+    of ``scaletempo``, and will be used to adjust audio pitch when playing
+    at speed different from normal. It can also be used to adjust audio pitch
+    without changing playback speed.
 
-    ``pitch-scale=<amount>``
+    ``<pitch-scale>``
         Sets the pitch scaling factor. Frequencies are multiplied by this value.
-        (default: 1.0)
-
-    ``engine=<faster|finer>``
-        Select the core Rubberband engine to be used. There are two available:
-
-        :Faster: This is the Rubberband R2 engine. It uses significantly less
-                 CPU than the Finer (R3) engine.
-        :Finer: This is the Rubberband R3 engine. This engine is only available
-                with librubberband version 3 or newer. This produces significantly
-                higher quality output, at the cost of higher CPU usage. (Default
-                if available)
 
     This filter has a number of additional sub-options. You can list them with
     ``mpv --af=rubberband=help``. This will also show the default values
@@ -215,8 +199,6 @@ Available filters are:
     merely passed to librubberband. Look at the librubberband documentation
     to learn what each option does:
     https://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
-    Do note that certain options are only applicable to one of R2 (faster) and
-    R3 (finer) engines.
     (The mapping of the mpv rubberband filter sub-option names and values to
     those of librubberband follows a simple pattern: ``"Option" + Name + Value``.)
 
@@ -228,7 +210,10 @@ Available filters are:
         using the standard ``speed`` property, not ``af-command``.
 
     ``multiply-pitch <factor>``
-        Multiply the current value of ``<pitch-scale>`` dynamically.
+        Multiply the current value of ``<pitch-scale>`` dynamically.  For
+        example: 0.5 to go down by an octave, 1.5 to go up by a perfect fifth.
+        If you want to go up or down by semi-tones, use 1.059463094352953 and
+        0.9438743126816935
 
 ``lavfi=graph``
     Filter audio using FFmpeg's libavfilter.

DOCS/man/ao.rst

@@ -10,67 +10,18 @@ syntax is:
 If the list has a trailing ',', mpv will fall back on drivers not contained
 in the list.
 
-This is an object settings list option. See `List Options`_ for details.
-
 .. note::
 
-    See ``--ao=help`` for a list of compiled-in audio output drivers sorted by
-    autoprobe order.
-
-    Note that the default audio output driver is subject to change, and must
-    not be relied upon. If a certain AO needs to be used, it must be
-    explicitly specified.
+    See ``--ao=help`` for a list of compiled-in audio output drivers. The
+    driver ``--ao=alsa`` is preferred. ``--ao=pulse`` is preferred on systems
+    where PulseAudio is used. On BSD systems, ``--ao=oss`` is preferred.
 
 Available audio output drivers are:
 
-``alsa``
-    ALSA audio output driver.
+``alsa`` (Linux only)
+    ALSA audio output driver
 
-    The following global options are supported by this audio output:
-
-    ``--alsa-resample=yes``
-        Enable ALSA resampling plugin. (This is disabled by default, because
-        some drivers report incorrect audio delay in some cases.)
-
-    ``--alsa-mixer-device=<device>``
-        Set the mixer device used with ``ao-volume`` (default: ``default``).
-
-    ``--alsa-mixer-name=<name>``
-        Set the name of the mixer element (default: ``Master``). This is for
-        example ``PCM`` or ``Master``.
-
-    ``--alsa-mixer-index=<number>``
-        Set the index of the mixer channel (default: 0). Consider the output of
-        "``amixer scontrols``", then the index is the number that follows the
-        name of the element.
-
-    ``--alsa-non-interleaved``
-        Allow output of non-interleaved formats (if the audio decoder uses
-        this format). Currently disabled by default, because some popular
-        ALSA plugins are utterly broken with non-interleaved formats.
-
-    ``--alsa-ignore-chmap``
-        Don't read or set the channel map of the ALSA device - only request the
-        required number of channels, and then pass the audio as-is to it. This
-        option most likely should not be used. It can be useful for debugging,
-        or for static setups with a specially engineered ALSA configuration (in
-        this case you should always force the same layout with ``--audio-channels``,
-        or it will work only for files which use the layout implicit to your
-        ALSA device).
-
-    ``--alsa-buffer-time=<microseconds>``
-        Set the requested buffer time in microseconds. A value of 0 skips requesting
-        anything from the ALSA API. This and the ``--alsa-periods`` option uses the
-        ALSA ``near`` functions to set the requested parameters. If doing so results
-        in an empty configuration set, setting these parameters is skipped.
-
-        Both options control the buffer size. A low buffer size can lead to higher
-        CPU usage and audio dropouts, while a high buffer size can lead to higher
-        latency in volume changes and other filtering.
-
-    ``--alsa-periods=<number>``
-        Number of periods requested from the ALSA API. See ``--alsa-buffer-time``
-        for further remarks.
+    See `ALSA audio output options`_ for options specific to this AO.
 
     .. warning::
 
@@ -79,8 +30,7 @@ Available audio output drivers are:
         explicitly reject multichannel output, as there is no way to detect
         whether a certain channel layout is actually supported.
 
-        You can also try `using the upmix plugin
-        <https://github.com/mpv-player/mpv/wiki/ALSA-Surround-Sound-and-Upmixing>`_.
+        You can also try `using the upmix plugin <http://git.io/vfuAy>`_.
         This setup enables multichannel audio on the ``default`` device
         with automatic upmixing with shared access, so playing stereo
         and multichannel audio at the same time will work as expected.
@@ -144,26 +94,13 @@ Available audio output drivers are:
         passthrough (even if the device reports it as supported). Use with
         extreme care.
 
+
 ``coreaudio_exclusive`` (macOS only)
     Native macOS audio output driver using direct device access and
     exclusive mode (bypasses the sound server).
 
-``avfoundation`` (macOS only)
-    Native macOS audio output driver using ``AVSampleBufferAudioRenderer``
-    in AVFoundation, which supports `spatial audio
-    <https://support.apple.com/en-us/HT211775>`_.
-
-    .. warning::
-
-        Turning on spatial audio may hang the playback
-        if mpv is not started out of the bundle,
-        though playback with spatial audio off always works.
-
-``audiounit`` (iOS only)
-    Native iOS audio output driver using ``AudioUnits`` and AudioToolbox.
-
 ``openal``
-    OpenAL audio output driver.
+    OpenAL audio output driver. This is broken and does not work.
 
     ``--openal-num-buffers=<2-128>``
         Specify the number of audio buffers to use. Lower values are better for
@@ -175,7 +112,9 @@ Available audio output drivers are:
 
     ``--openal-direct-channels=<yes|no>``
         Enable OpenAL Soft's direct channel extension when available to avoid
-        tinting the sound with ambisonics or HRTF. Default: yes.
+        tinting the sound with ambisonics or HRTF.
+        Channels are dropped when when they are not available as downmixing
+        will be disabled. Default: no.
 
 ``pulse``
     PulseAudio audio output driver
@@ -190,44 +129,26 @@ Available audio output drivers are:
         Set the audio buffer size in milliseconds. A higher value buffers
         more data, and has a lower probability of buffer underruns. A smaller
         value makes the audio stream react faster, e.g. to playback speed
-        changes. "native" lets the sound server determine buffers.
+        changes.
 
     ``--pulse-latency-hacks=<yes|no>``
-        Enable hacks to workaround PulseAudio timing bugs (default: yes). If
+        Enable hacks to workaround PulseAudio timing bugs (default: no). If
         enabled, mpv will do elaborate latency calculations on its own. If
         disabled, it will use PulseAudio automatically updated timing
         information. Disabling this might help with e.g. networked audio or
         some plugins, while enabling it might help in some unknown situations
-        (it is currently enabled due to known bugs with PulseAudio 16.0).
+        (it used to be required to get good behavior on old PulseAudio versions).
+
+        If you have stuttering video when using pulse, try to enable this
+        option. (Or try to update PulseAudio.)
 
     ``--pulse-allow-suspended=<yes|no>``
         Allow mpv to use PulseAudio even if the sink is suspended (default: no).
         Can be useful if PulseAudio is running as a bridge to jack and mpv has its sink-input set to the one jack is using.
 
-``pipewire``
-    PipeWire audio output driver
-
-    The following global options are supported by this audio output:
-
-    ``--pipewire-buffer=<1-2000|native>``
-        Set the audio buffer size in milliseconds. A higher value buffers
-        more data, and has a lower probability of buffer underruns. A smaller
-        value makes the audio stream react faster, e.g. to playback speed
-        changes. "native" lets the sound server determine buffers.
-
-    ``--pipewire-remote=<remote>``
-        Specify the PipeWire remote daemon name to connect to via local UNIX
-        sockets.
-        An empty <remote> string uses the default remote named ``pipewire-0``.
-
-    ``--pipewire-volume-mode=<channel|global>``
-        Specify if the ``ao-volume`` property should apply to the channel
-        volumes or the global volume.
-        By default the channel volumes are used.
-
 ``sdl``
-    SDL 2.0+ audio output driver. Should work on any platform supported by SDL
-    2.0, but may require the ``SDL_AUDIODRIVER`` environment variable to be set
+    SDL 1.2+ audio output driver. Should work on any platform supported by SDL
+    1.2, but may require the ``SDL_AUDIODRIVER`` environment variable to be set
     appropriately for your system.
 
     .. note:: This driver is for compatibility with extremely foreign
@@ -298,26 +219,5 @@ Available audio output drivers are:
         ``no-waveheader`` option - with ``waveheader`` it's broken, because
         it will write a WAVE header every time the file is opened.
 
-``sndio``
-    Audio output to the OpenBSD sndio sound system
-
-    (Note: only supports mono, stereo, 4.0, 5.1 and 7.1 channel
-    layouts.)
-
 ``wasapi``
     Audio output to the Windows Audio Session API.
-
-    The following global options are supported by this audio output:
-
-    ``--wasapi-exclusive-buffer=<default|min|1-2000000>``
-        Set buffer duration in exclusive mode (i.e., with
-        ``--audio-exclusive=yes``). ``default`` and ``min`` use the default and
-        minimum device period reported by WASAPI, respectively. You can also
-        directly specify the buffer duration in microseconds, in which case a
-        duration shorter than the minimum device period will be rounded up to
-        the minimum period.
-
-        The default buffer duration should provide robust playback in most
-        cases, but reportedly on some devices there are glitches following
-        stream resets under the default setting. In such cases, specifying a
-        shorter duration might help.

DOCS/man/changes.rst

@@ -10,7 +10,8 @@ There is no real changelog, but you can look at the following things:
 * The git log, which is the "real" changelog
 * The file https://github.com/mpv-player/mpv/blob/master/DOCS/interface-changes.rst
   documents changes to the command and user interface, such as options and
-  properties.
+  properties. (It usually documents breaking changes only, additions and
+  enhancements are often not listed.)
 * C API changes are listed in
   https://github.com/mpv-player/mpv/blob/master/DOCS/client-api-changes.rst
 * The file ``mplayer-changes.rst`` in the ``DOCS`` sub directory on the git

DOCS/man/commands.rst

@@ -1,58 +0,0 @@
-COMMANDS
-========
-
-This script allows running and completing input commands in the console
-interactively, and also adds mpv's log to the console's log.
-
-Keybindings
------------
-
-\`
-    Open the console to enter commands.
-
-Commands
---------
-
-``script-binding commands/open``
-
-    Open the console to enter commands.
-
-``script-message-to commands type <text> [<cursor_pos>]``
-    Show the console and pre-fill it with the provided text, optionally
-    specifying the initial cursor position as a positive integer starting from
-    1. The console is automatically closed after running the command.
-
-    .. admonition:: Examples for input.conf
-
-        ``% script-message-to commands type "seek  absolute-percent" 6``
-            Enter a percent position to seek to.
-
-        ``Ctrl+o script-message-to commands type "loadfile ''" 11``
-            Enter a file or URL to play, with autocompletion of paths in the
-            filesystem.
-
-Configuration
--------------
-
-This script can be customized through a config file ``script-opts/commands.conf``
-placed in mpv's user directory and through the ``--script-opts`` command-line
-option. The configuration syntax is described in `mp.options functions`_.
-
-Configurable Options
-~~~~~~~~~~~~~~~~~~~~
-
-``persist_history``
-    Default: no
-
-    Whether to save the command history to a file and load it.
-
-``history_path``
-    Default: ``~~state/command_history.txt``
-
-    The file path for ``persist_history`` (see `FILES`_).
-
-``remember_input``
-    Default: yes
-
-    Whether to remember the input line and cursor position when closing the
-    console, and prefill it the next time it is opened.

DOCS/man/console.rst

@@ -1,75 +1,73 @@
 CONSOLE
 =======
 
-This script provides the ability to process the user's textual input to other
-scripts through the ``mp.input`` API. It can be displayed on both the video
-window and the terminal. It can be disabled entirely using the
-``--load-console=no`` option.
+The console is a REPL for mpv input commands. It is displayed on the video
+window. It also shows log messages. It can be disabled entirely using the
+``--load-osd-console=no`` option.
 
-Console can either process free-form text or select from a predefined list of
-items.
+Keybindings
+-----------
 
-Free-form text mode keybindings
--------------------------------
+\`
+    Show the console.
 
-ESC and Ctrl+[
+ESC
     Hide the console.
 
-ENTER, Ctrl+j and Ctrl+m
-    Select the first completion if one wasn't already manually selected, and run
-    the typed command.
+ENTER, Ctrl+J and Ctrl+M
+    Run the typed command.
 
 Shift+ENTER
     Type a literal newline character.
 
-LEFT and Ctrl+b
+LEFT and Ctrl+B
     Move the cursor to the previous character.
 
-RIGHT and Ctrl+f
+RIGHT and Ctrl+F
     Move the cursor to the next character.
 
-Ctrl+LEFT and Alt+b
+Ctrl+LEFT and Alt+B
     Move the cursor to the beginning of the current word, or if between words,
     to the beginning of the previous word.
 
-Ctrl+RIGHT and Alt+f
+Ctrl+RIGHT and Alt+F
     Move the cursor to the end of the current word, or if between words, to the
     end of the next word.
 
-HOME and Ctrl+a
+HOME and Ctrl+A
     Move the cursor to the start of the current line.
 
-END and Ctrl+e
+END and Ctrl+E
     Move the cursor to the end of the current line.
 
-BACKSPACE and Ctrl+h
+BACKSPACE and Ctrl+H
     Delete the previous character.
 
-Ctrl+d
+Ctrl+D
     Hide the console if the current line is empty, otherwise delete the next
     character.
 
-Ctrl+BACKSPACE and Ctrl+w
+Ctrl+BACKSPACE and Ctrl+W
     Delete text from the cursor to the beginning of the current word, or if
     between words, to the beginning of the previous word.
 
-Ctrl+DEL and Alt+d
+Ctrl+DEL and Alt+D
     Delete text from the cursor to the end of the current word, or if between
     words, to the end of the next word.
 
-Ctrl+u
+Ctrl+U
     Delete text from the cursor to the beginning of the current line.
 
-Ctrl+k
+Ctrl+K
     Delete text from the cursor to the end of the current line.
 
-Ctrl+c
+Ctrl+C
     Clear the current line.
 
-UP and Ctrl+p
+UP and Ctrl+P
     Move back in the command history.
 
-DOWN and Ctrl+n
+DOWN and Ctrl+N
     Move forward in the command history.
 
 PGUP
@@ -78,48 +76,37 @@ PGUP
 PGDN
     Stop navigating the command history.
 
-Ctrl+r
-    Search the command history. See `SELECT`_ for the key bindings in this mode.
-
-Shift+UP
-    Scroll the log one line up.
-
-Shift+DOWN
-    Scroll the log one line down.
-
 INSERT
     Toggle insert mode.
 
-Ctrl+v
+Ctrl+V
     Paste text (uses the clipboard on X11 and Wayland).
 
 Shift+INSERT
     Paste text (uses the primary selection on X11 and Wayland).
 
-Ctrl+y
-    Copy the current line to the clipboard.
+TAB and Ctrl+I
+    Complete the command or property name at the cursor.
 
-TAB and Ctrl+i
-    Cycle through completions.
-
-Shift+TAB
-    Cycle through the completions backwards.
-
-Ctrl+l
+Ctrl+L
     Clear all log messages from the console.
 
-MBTN_MID
-    Paste text (uses the primary selection on X11 and Wayland).
+Commands
+--------
 
-WHEEL_UP
-    Move back in the command history.
+``script-message-to console type <text> [<cursor_pos>]``
+    Show the console and pre-fill it with the provided text, optionally
+    specifying the initial cursor position as a positive integer starting from
+    1.
 
-WHEEL_DOWN
-    Move forward in the command history.
+    .. admonition:: Example for input.conf
+
+        ``% script-message-to console type "seek  absolute-percent" 6``
 
 Known issues
 ------------
 
+- Pasting text is slow on Windows
 - Non-ASCII keyboard input has restrictions
 - The cursor keys move between Unicode code-points, not grapheme clusters
 
@@ -128,112 +115,31 @@ Configuration
 
 This script can be customized through a config file ``script-opts/console.conf``
 placed in mpv's user directory and through the ``--script-opts`` command-line
-option. The configuration syntax is described in `mp.options functions`_.
+option. The configuration syntax is described in `ON SCREEN CONTROLLER`_.
 
-Note that ``mp.input`` clients can selectively override these options.
+Key bindings can be changed in a standard way, see for example stats.lua
+documentation.
 
 Configurable Options
 ~~~~~~~~~~~~~~~~~~~~
 
-``monospace_font``
-    Default: platform dependent
+``scale``
+    Default: 1
 
-    The monospace font used when there are completions to align in a grid.
+    All drawing is scaled by this value, including the text borders and the
+    cursor.
 
-    When there are no completions, ``--osd-font`` is used.
+    If the VO backend in use has HiDPI scale reporting implemented, the option
+    value is scaled with the reported HiDPI scale.
+
+``font``
+    Default: unset (picks a hardcoded font depending on detected platform)
+
+    Set the font used for the REPL and the console. This probably doesn't
+    have to be a monospaced font.
 
 ``font_size``
-    Default: 24
+    Default: 16
 
-    The font size. This will be multiplied by ``display-hidpi-scale`` when the
-    console is not scaled with the window.
-
-``border_size``
-    Default: 1.65
-
-    The font border size.
-
-``background_alpha``
-    Default: 80
-
-    The transparency of the menu's background. Ranges from 0 (opaque) to 255
-    (fully transparent).
-
-``gap``
-    Default: 0.2
-
-    The gap between menu items, specified as a percentage the font size.
-
-``padding``
-    Default: 10
-
-    The padding of the menu.
-
-``menu_outline_size``
-    Default: 0
-
-    The size of the menu's border.
-
-``menu_outline_color``
-    Default: #FFFFFF
-
-    The color of the menu's border.
-
-``corner_radius``
-    Default: 8
-
-    The radius of the menu's corners.
-
-``margin_x``
-    Default: same as ``--osd-margin-x``
-
-    The margin from the left of the window.
-
-``margin_y``
-    Default: same as ``--osd-margin-y``
-
-    The margin from the bottom of the window.
-
-``scale_with_window``
-    Default: ``auto``
-
-    Whether to scale the console with the window height. Can be ``yes``, ``no``,
-    or ``auto``, which follows the value of ``--osd-scale-by-window``.
-
-``focused_color``
-    Default: ``#222222``
-
-    The color of the focused item.
-
-``focused_back_color``
-    Default: ``#FFFFFF``
-
-    The background color of the focused item.
-
-``match_color``
-    Default: ``#0088FF``
-
-    The color of characters that match the searched string.
-
-``exact_match``
-    Default: no
-
-    Whether to match menu search queries exactly instead of fuzzily. Without
-    this option, prefixing queries with ``'`` enables exact matching.
-
-``case_sensitive``
-    Default: no
-
-    Whether exact searches are case sensitive. Only works with ASCII characters.
-
-``history_dedup``
-    Default: true
-
-    Remove duplicate entries in history as to only keep the latest one.
-
-``font_hw_ratio``
-    Default: auto
-
-    The ratio of font height to font width.
-    Adjusts grid width of completions.
-    Values in the range 1.8..2.5 make sense for common monospace fonts.
+    Set the font size used for the REPL and the console. This will be
+    multiplied by "scale."

DOCS/man/context_menu.rst

@@ -1,142 +0,0 @@
-CONTEXT MENU
-============
-
-The context menu is a menu that pops up on the video window. By default, it is
-bound to right click.
-
-menu.conf
----------
-
-You can define your own menu in ``~~/menu.conf`` (see `FILES`_), or an
-alternative path specified with ``--script-opt=select-menu_conf_path``. It is
-recommended to use the default ``menu.conf`` from
-https://github.com/mpv-player/mpv/blob/master/etc/menu.conf as an example to get
-started.
-
-Each line of ``menu.conf`` is a menu item with fields separated by 1 or more
-tabs. The first field is the text shown in the menu. The second field is usually
-the command that is run when that item is selected. Fields from the third
-onwards can specify ``checked=``, ``disabled=`` and ``hidden=`` states in the
-same way as `Conditional auto profiles`_.
-
-When there is no command, the item will open a submenu. Fields below indented
-with leading whitespace are added to this submenu. Nested submenu items are
-defined by adding more leading whitespace than the parent menu entry.
-
-Empty lines are interpreted as separators.
-
-The second field can also be one of the following tokens to make that entry a
-submenu with the relative items: ``$playlist``, ``$tracks``, ``$video-tracks``,
-``$audio-tracks``, ``$sub-tracks``, ``$secondary-sub-tracks``, ``$chapters``,
-``$editions``, ``$audio-devices``, ``$profiles``. These menus are automatically
-disabled when empty.
-
-To use the native context menu, you need to fill the ``menu-data`` property with
-menu definition data, and call the ``context-menu`` command. In builtin scripts,
-this is done by ``select.lua``, which parses ``menu.conf`` to populate
-``menu-data``. It then calls the ``context-menu`` command on platforms where
-integration with the native context menu is implemented, while on platforms
-where it is not, it opens ``context_menu.lua``.
-
-On platforms without integration with the native context menu,
-``context_menu.lua`` can be disabled entirely using the
-``--load-context-menu=no`` option. On platforms where the integration is
-implemented, it is already disabled by default, and ``--load-context-menu=yes``
-will make ``select.lua`` use it.
-
-Script messages
----------------
-
-``open``
-    Show the context menu.
-
-``select``
-    Select the focused item when there is one.
-
-Configuration
--------------
-
-This script can be customized through a config file
-``script-opts/context_menu.conf`` placed in mpv's user directory and through
-the ``--script-opts`` command-line option. The configuration syntax is
-described in `mp.options functions`_.
-
-Configurable Options
-~~~~~~~~~~~~~~~~~~~~
-
-``font_size``
-    Default: 14
-
-    The font size.
-
-``gap``
-    Default: 0.2
-
-    The gap between menu items, specified as a percentage the font size.
-
-``padding_x``
-    Default: 8
-
-    The horizontal padding of the menu.
-
-``padding_y``
-    Default: 4
-
-    The vertical padding of the menu.
-
-``menu_outline_size``
-    Default: 0
-
-    The size of the menu's border.
-
-``menu_outline_color``
-    Default: ``#FFFFFF``
-
-    The color of the menu's border.
-
-``background_alpha``
-    Default: ``0``
-
-    The transparency of the menu's background. Ranges from 0 (opaque) to 255
-    (fully transparent).
-
-``corner_radius``
-    Default: 5
-
-    The radius of the menu's corners.
-
-``scale_with_window``
-    Default: auto
-
-    Whether to scale sizes with the window height. Can be ``yes``, ``no``, or
-    ``auto``, which follows the value of ``--osd-scale-by-window``.
-
-    When sizes aren't scaled with the window, they are scaled by
-    ``display-hidpi-scale``.
-
-``focused_color``
-    Default: ``#222222``
-
-    The color of the focused item.
-
-``focused_back_color``
-    Default: ``#FFFFFF``
-
-    The background color of the focused item.
-
-``disabled_color``
-    Default: ``#555555``
-
-    The color of disabled items and separators.
-
-``seconds_to_open_submenus``
-    Default: 0.2
-
-    The number of seconds to open submenus after the cursor enters items
-    associated with one.
-
-``seconds_to_close_submenus``
-    Default: 0.2
-
-    The number of seconds to close submenus after the cursor enters a parent
-    menu.

DOCS/man/encode.rst

@@ -8,7 +8,7 @@ You can encode files from one format/codec to another using this facility.
 
 ``--of=<format>``
     Specifies the output format (overrides autodetection by the file name
-    extension of the file specified by ``--o``). See ``--of=help`` for a full
+    extension of the file specified by ``-o``). See ``--of=help`` for a full
     list of supported formats.
 
 ``--ofopts=<options>``
@@ -28,6 +28,10 @@ You can encode files from one format/codec to another using this facility.
     Specifies the output audio codec. See ``--oac=help`` for a full list of
     supported codecs.
 
+``--oaoffset=<value>``
+    Shifts audio data by the given time (in seconds) by adding/removing
+    samples at the start. Deprecated.
+
 ``--oacopts=<options>``
     Specifies the output audio codec options for libavcodec.
     See ``--oacopts=help`` for a full list of supported options.
@@ -46,10 +50,18 @@ You can encode files from one format/codec to another using this facility.
     ``--oacopts=""``
         Completely empties the options list.
 
+``--oafirst``
+    Force the audio stream to become the first stream in the output.
+    By default, the order is unspecified. Deprecated.
+
 ``--ovc=<codec>``
     Specifies the output video codec. See ``--ovc=help`` for a full list of
     supported codecs.
 
+``--ovoffset=<value>``
+    Shifts video data by the given time (in seconds) by shifting the pts
+    values. Deprecated.
+
 ``--ovcopts=<options>``
     Specifies the output video codec options for libavcodec.
     See --ovcopts=help for a full list of supported options.
@@ -71,14 +83,19 @@ You can encode files from one format/codec to another using this facility.
     ``--ovcopts=""``
         Completely empties the options list.
 
+``--ovfirst``
+    Force the video stream to become the first stream in the output.
+    By default, the order is unspecified. Deprecated.
+
 ``--orawts``
     Copies input pts to the output video (not supported by some output
     container formats, e.g. AVI). In this mode, discontinuities are not fixed
     and all pts are passed through as-is. Never seek backwards or use multiple
     input files in this mode!
 
-``--ocopy-metadata=<yes|no>``
-    Copy metadata from input files to output files when encoding (default: yes).
+``--no-ocopy-metadata``
+    Turns off copying of metadata from input files to output files when
+    encoding (which is enabled by default).
 
 ``--oset-metadata=<metadata-tag[,metadata-tag,...]>``
     Specifies metadata to include in the output file.
@@ -102,5 +119,5 @@ You can encode files from one format/codec to another using this facility.
     .. admonition:: Example
 
         "``--oremove-metadata=comment,genre``"
-            excludes copying of the comment and genre tags to the output
+            excludes copying of the the comment and genre tags to the output
             file.

DOCS/man/ipc.rst

@@ -3,10 +3,8 @@ JSON IPC
 
 mpv can be controlled by external programs using the JSON-based IPC protocol.
 It can be enabled by specifying the path to a unix socket or a named pipe using
-the option ``--input-ipc-server``, or the file descriptor number of a unix socket
-or a named pipe using ``--input-ipc-client``.
-Clients can connect to this socket and send commands to the player or receive
-events from it.
+the option ``--input-ipc-server``. Clients can connect to this socket and send
+commands to the player or receive events from it.
 
 .. warning::
 
@@ -195,8 +193,8 @@ And this is the completion:
     {"request_id":123,"error":"success","data":null}
 
 By design, you will not get a confirmation that the command was started. If a
-command is long running, sending the message will not lead to any reply until
-much later when the command finishes.
+command is long running, sending the message will lead to any reply until much
+later when the command finishes.
 
 Some commands execute synchronously, but these will behave like asynchronous
 commands that finished execution immediately.

DOCS/man/javascript.rst

@@ -27,17 +27,16 @@ otherwise, the documented Lua options, script directories, loading, etc apply to
 JavaScript files too.
 
 Script initialization and lifecycle is the same as with Lua, and most of the Lua
-functions in the modules ``mp``, ``mp.utils``, ``mp.msg``, ``mp.options`` and
-``mp.input`` are available to JavaScript with identical APIs - including running
-commands, getting/setting properties, registering events/key-bindings/hooks,
-etc.
+functions at the modules ``mp``, ``mp.utils``, ``mp.msg`` and ``mp.options`` are
+available to JavaScript with identical APIs - including running commands,
+getting/setting properties, registering events/key-bindings/hooks, etc.
 
 Differences from Lua
 --------------------
 
-No need to load modules. ``mp``, ``mp.utils``,  ``mp.msg``, ``mp.options`` and
-``mp.input`` are preloaded, and you can use e.g. ``var cwd =
-mp.utils.getcwd();`` without prior setup.
+No need to load modules. ``mp``, ``mp.utils``,  ``mp.msg`` and ``mp.options``
+are preloaded, and you can use e.g. ``var cwd = mp.utils.getcwd();`` without
+prior setup.
 
 Errors are slightly different. Where the Lua APIs return ``nil`` for error,
 the JavaScript ones return ``undefined``. Where Lua returns ``something, error``
@@ -74,6 +73,12 @@ Unsupported Lua APIs and their JS alternatives
 
 ``utils.to_string(v)``  see ``dump`` below.
 
+``mp.suspend()`` JS: none (deprecated).
+
+``mp.resume()`` JS: none (deprecated).
+
+``mp.resume_all()`` JS: none (deprecated).
+
 ``mp.get_next_timeout()`` see event loop below.
 
 ``mp.dispatch_events([allow_wait])`` see event loop below.
@@ -92,12 +97,10 @@ Where the Lua APIs use ``nil`` to indicate error, JS APIs use ``undefined``.
 ``mp.command_native(table [,def])`` (LE)
 
 ``id = mp.command_native_async(table [,fn])`` (LE) Notes: ``id`` is true-thy on
-success, ``error`` is empty string on success.
+success, ``fn`` is called always a-sync, ``error`` is empty string on success.
 
 ``mp.abort_async_command(id)``
 
-``mp.del_property(name)`` (LE)
-
 ``mp.get_property(name [,def])`` (LE)
 
 ``mp.get_property_osd(name [,def])`` (LE)
@@ -196,18 +199,6 @@ meta-paths like ``~~/foo`` (other JS file functions do expand meta paths).
 ``mp.options.read_options(obj [, identifier [, on_update]])`` (types:
 string/boolean/number)
 
-``mp.input.get(obj)``
-
-``mp.input.select(obj)``
-
-``mp.input.terminate()``
-
-``mp.input.log(message, style)``
-
-``mp.input.set_log(log)``
-
-``exit()`` (global)
-
 Additional utilities
 --------------------
 
@@ -230,9 +221,9 @@ Additional utilities
     ``undefined`` if the variable is not defined.
 
 ``mp.utils.get_user_path(path)``
-    Trivial wrapper of the ``expand-path`` mpv command, returns a string.
-    ``read_file``, ``write_file``, ``append_file`` and ``require`` already
-    expand the path internally and accept mpv meta-paths like ``~~desktop/foo``.
+    Expands (mpv) meta paths like ``~/x``, ``~~/y``, ``~~desktop/z`` etc.
+    ``read_file``, ``write_file``, ``append_file`` and ``require`` already use
+    this internally.
 
 ``mp.utils.read_file(fname [,max])``
     Returns the content of file ``fname`` as string. If ``max`` is provided and
@@ -256,6 +247,10 @@ text content only.
 ``mp.get_script_file()``
     Returns the file name of the current script.
 
+``exit()`` (global)
+    Make the script exit at the end of the current event loop iteration.
+    Note: please remove added key bindings before calling ``exit()``.
+
 ``mp.utils.compile_js(fname, content_str)``
     Compiles the JS code ``content_str`` as file name ``fname`` (without loading
     anything from the filesystem), and returns it as a function. Very similar
@@ -350,6 +345,8 @@ paths - like ``<script-dir>/modules`` for scripts which load from a directory).
 
 The custom-init file is ignored if mpv is invoked with ``--no-config``.
 
+Before mpv 0.34, the file name was ``.init.js`` (with dot) at the same dir.
+
 The event loop
 --------------
 

DOCS/man/libmpv.rst

@@ -2,14 +2,14 @@ EMBEDDING INTO OTHER PROGRAMS (LIBMPV)
 ======================================
 
 mpv can be embedded into other programs as video/audio playback backend. The
-recommended way to do so is using libmpv. See ``include/mpv/client.h`` in the mpv
+recommended way to do so is using libmpv. See ``libmpv/client.h`` in the mpv
 source code repository. This provides a C API. Bindings for other languages
 might be available (see wiki).
 
 Since libmpv merely allows access to underlying mechanisms that can control
 mpv, further documentation is spread over a few places:
 
-- https://github.com/mpv-player/mpv/blob/master/include/mpv/client.h
+- https://github.com/mpv-player/mpv/blob/master/libmpv/client.h
 - https://mpv.io/manual/master/#options
 - https://mpv.io/manual/master/#list-of-input-commands
 - https://mpv.io/manual/master/#properties
@@ -21,15 +21,15 @@ C PLUGINS
 You can write C plugins for mpv. These use the libmpv API, although they do not
 use the libmpv library itself.
 
-They are enabled by default if compiler supports linking with the ``-rdynamic``
-flag on Linux/BSD platforms. On Windows they are always enabled.
+They are available on Linux/BSD platforms only and enabled by default if the
+compiler supports linking with the ``-rdynamic`` flag.
 
 C plugins location
 ------------------
 
 C plugins are put into the mpv scripts directory in its config directory
-(see the `FILES`_ section for details). They must have a ``.so`` or ``.dll``
-file extension. They can also be explicitly loaded with the ``--script`` option.
+(see the `FILES`_ section for details). They must have a ``.so`` file extension.
+They can also be explicitly loaded with the ``--script`` option.
 
 API
 ---
@@ -38,7 +38,7 @@ A C plugin must export the following function::
 
     int mpv_open_cplugin(mpv_handle *handle)
 
-The plugin function will be called on loading time. This function must not
+The plugin function will be called on loading time. This function does not
 return as long as your plugin is loaded (it runs in its own thread). The
 ``handle`` will be deallocated as soon as the plugin function returns.
 
@@ -52,8 +52,7 @@ behavior.
 Within the plugin function, you can call libmpv API functions. The ``handle``
 is created by ``mpv_create_client()`` (or actually an internal equivalent),
 and belongs to you. You can call ``mpv_wait_event()`` to wait for things
-happening, and so on. However do not call ``mpv_destroy()`` or
-``mpv_terminate_destroy()`` on this handle.
+happening, and so on.
 
 Note that the player might block until your plugin calls ``mpv_wait_event()``
 for the first time. This gives you a chance to install initial hooks etc.
@@ -65,13 +64,9 @@ Linkage to libmpv
 -----------------
 
 The current implementation requires that your plugins are **not** linked against
-libmpv. What your plugins use are not symbols from a libmpv binary, but
+libmpv. What your plugins uses are not symbols from a libmpv binary, but
 symbols from the mpv host binary.
 
-On Windows to make symbols from the host binary available, you have to define
-MPV_CPLUGIN_DYNAMIC_SYM when compiling cplugin. This will load symbols
-dynamically, before calling ``mpv_open_cplugin()``.
-
 Examples
 --------
 

DOCS/man/lua.rst

@@ -7,6 +7,7 @@ mpv provides the built-in module ``mp``, which contains functions to send
 commands to the mpv core and to retrieve information about playback state, user
 settings, file information, and so on.
 
+These scripts can be used to control mpv in a similar way to slave mode.
 Technically, the Lua code uses the client API internally.
 
 Example
@@ -61,14 +62,15 @@ that uses the ``.foo`` file extension.
 mpv also appends the top level directory of the script to the start of Lua's
 package path so you can import scripts from there too. Be aware that this will
 shadow Lua libraries that use the same package path. (Single file scripts do not
-include mpv specific directories in the Lua package path.)
+include mpv specific directory the Lua package path. This was silently changed
+in mpv 0.32.0.)
 
 Using a script directory is the recommended way to package a script that
 consists of multiple source files, or requires other files (you can use
 ``mp.get_script_directory()`` to get the location and e.g. load data files).
 
 Making a script a git repository, basically a repository which contains a
-``main.lua`` file in the root directory, makes scripts easily updateable
+``main.lua``` file in the root directory, makes scripts easily updateable
 (without the dangers of auto-updates). Another suggestion is to use git
 submodules to share common files or libraries.
 
@@ -84,8 +86,7 @@ own event handlers which you have registered with ``mp.register_event``, or
 timers added with ``mp.add_timeout`` or similar. Note that since the
 script starts execution concurrently with player initialization, some properties
 may not be populated with meaningful values until the relevant subsystems have
-initialized. Rather than retrieving these properties at the top of scripts, you
-should use ``mp.observe_property`` or read them within event handlers.
+initialized.
 
 When the player quits, all scripts will be asked to terminate. This happens via
 a ``shutdown`` event, which by default will make the event loop return. If your
@@ -99,14 +100,17 @@ The event loop will wait for events and dispatch events registered with
 ``mp.register_event``. It will also handle timers added with ``mp.add_timeout``
 and similar (by waiting with a timeout).
 
-The player will wait until the script is fully loaded before continuing normal
-operation. The player considers a script as fully loaded as soon as it starts
-waiting for mpv events (or it exits). In practice this means the player will
-more or less hang until the script returns from the main chunk (and
-``mp_event_loop`` is called), or the script calls ``mp_event_loop`` or
+Since mpv 0.6.0, the player will wait until the script is fully loaded before
+continuing normal operation. The player considers a script as fully loaded as
+soon as it starts waiting for mpv events (or it exits). In practice this means
+the player will more or less hang until the script returns from the main chunk
+(and ``mp_event_loop`` is called), or the script calls ``mp_event_loop`` or
 ``mp.dispatch_events`` directly. This is done to make it possible for a script
-to fully setup event handlers etc. before playback actually starts. Scripts run
-though initialization in parallel.
+to fully setup event handlers etc. before playback actually starts. In older
+mpv versions, this happened asynchronously. With mpv 0.29.0, this changes
+slightly, and it merely waits for scripts to be loaded in this manner before
+starting playback as part of the player initialization phase. Scripts run though
+initialization in parallel. This might change again.
 
 mp functions
 ------------
@@ -155,14 +159,11 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     ``mp.commandv()`` (but can be a native type instead of a string).
 
     If the table contains string keys, it's interpreted as command with named
-    arguments. This requires at least an entry with the key ``_name`` to be
-    present, which must be a string, and contains the command name.
-    For compatibility, if the key ``_name`` does not exist, then the entry with
-    the key ``name`` will be used instead. The special entry ``_flags`` is
-    optional, and if present, must be an array of `Input Command Prefixes`_ to
-    apply. All other entries are interpreted as arguments. Note that some
-    commands have arguments named ``name``, and can only be used if the command
-    name is specified with key ``_name`` instead of ``name``.
+    arguments. This requires at least an entry with the key ``name`` to be
+    present, which must be a string, and contains the command name. The special
+    entry ``_flags`` is optional, and if present, must be an array of
+    `Input Command Prefixes`_ to apply. All other entries are interpreted as
+    arguments.
 
     Returns a result table on success (usually empty), or ``def, error`` on
     error. ``def`` is the second parameter provided to the function, and is
@@ -173,7 +174,7 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     as possible), and upon completion, fn is called. fn has three arguments:
     ``fn(success, result, error)``:
 
-        ``success``
+         ``success``
             Always a Boolean and is true if the command was successful,
             otherwise false.
 
@@ -190,20 +191,12 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     If starting the command failed for some reason, ``nil, error`` is returned,
     and ``fn`` is called indicating failure, using the same error value.
 
-    ``fn`` is always called asynchronously, even if the command failed to start.
-
 ``mp.abort_async_command(t)``
     Abort a ``mp.command_native_async`` call. The argument is the return value
     of that command (which starts asynchronous execution of the command).
     Whether this works and how long it takes depends on the command and the
     situation. The abort call itself is asynchronous. Does not return anything.
 
-``mp.del_property(name)``
-    Delete the given property. See ``mp.get_property`` and `Properties`_ for more
-    information about properties. Most properties cannot be deleted.
-
-    Returns true on success, or ``nil, error`` on error.
-
 ``mp.get_property(name [,def])``
     Return the value of the given property as string. These are the same
     properties as used in input.conf. See `Properties`_ for a list of
@@ -291,18 +284,6 @@ The ``mp`` module is preloaded, although it can be loaded manually with
 
     After calling this function, key presses will cause the function ``fn`` to
     be called (unless the user remapped the key with another binding).
-    However, if the key binding is canceled , the function will not be called,
-    unless ``complex`` flag is set to ``true``, where the function will be
-    called with the ``canceled`` entry set to ``true``.
-
-    For example, a canceled key binding can happen in the following situations:
-
-    - If key A is pressed while key B is being held down, key B is logically
-      released ("canceled" by key A), which stops the current autorepeat
-      action key B has.
-    - If key A is pressed while a mouse button is being held down, the mouse
-      button is logically released, but the mouse button's action will not be
-      called, unless ``complex`` flag is set to ``true``.
 
     The ``name`` argument should be a short symbolic string. It allows the user
     to remap the key binding via input.conf using the ``script-message``
@@ -314,36 +295,24 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     or pass the ``fn`` argument in place of the name. The latter is not
     recommended and is handled for compatibility only.)
 
-    The ``flags`` argument is used for optional parameters. This is a table,
-    which can have the following entries:
+    The last argument is used for optional flags. This is a table, which can
+    have the following entries:
 
         ``repeatable``
             If set to ``true``, enables key repeat for this specific binding.
-            This option only makes sense when ``complex`` is not set to ``true``.
-
-        ``scalable``
-            If set to ``true``, enables key scaling for this specific binding.
-            This option only makes sense when ``complex`` is set to ``true``.
-            Note that this has no effect if the key binding is invoked by
-            ``script-binding`` command, where the scalability of the command
-            takes precedence.
 
         ``complex``
-            If set to ``true``, then ``fn`` is called on key down, repeat and up
-            events, with the first argument being a table. This table has the
-            following entries (and may contain undocumented ones):
+            If set to ``true``, then ``fn`` is called on both key up and down
+            events (as well as key repeat, if enabled), with the first
+            argument being a table. This table has the following entries (and
+            may contain undocumented ones):
 
                 ``event``
                     Set to one of the strings ``down``, ``repeat``, ``up`` or
-                    ``press`` (the latter if key up/down/repeat can't be
-                    tracked), which indicates the key's logical state.
+                    ``press`` (the latter if key up/down can't be tracked).
 
                 ``is_mouse``
-                    Boolean: Whether the event was caused by a mouse button.
-
-                ``canceled``
-                    Boolean: Whether the event was canceled.
-                    Not all types of cancellations set this flag.
+                    Boolean Whether the event was caused by a mouse button.
 
                 ``key_name``
                     The name of they key that triggered this, or ``nil`` if
@@ -355,15 +324,6 @@ The ``mp`` module is preloaded, although it can be loaded manually with
                     description of ``script-binding`` command for details (this
                     field is equivalent to the 5th argument).
 
-                ``scale``
-                    The scale of the key, such as the ones produced by ``WHEEL_*``
-                    keys. The scale is 1 if the key is nonscalable.
-
-                ``arg``
-                    User-provided string in the ``arg`` argument in the
-                    ``script-binding`` command if the key binding is invoked
-                    by that command.
-
     Internally, key bindings are dispatched via the ``script-message-to`` or
     ``script-binding`` input commands and ``mp.register_script_message``.
 
@@ -418,7 +378,7 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     and the function fn is a Lua function value.
 
     Some events have associated data. This is put into a Lua table and passed
-    as argument to fn. The Lua table by default contains a ``event`` field,
+    as argument to fn. The Lua table by default contains a ``name`` field,
     which is a string containing the event name. If the event has an error
     associated, the ``error`` field is set to a string describing the error,
     on success it's not set.
@@ -444,7 +404,7 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     the property will be passed as second argument to ``fn``, using
     ``mp.get_property_<type>`` to retrieve it. This means if ``type`` is for
     example ``string``, ``fn`` is roughly called as in
-    ``fn(name, mp.get_property(name))``.
+    ``fn(name, mp.get_property_string(name))``.
 
     If possible, change events are coalesced. If a property is changed a bunch
     of times in a row, only the last change triggers the change function. (The
@@ -458,9 +418,9 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     This depends on the property, and it's a valid feature request to ask for
     better update handling of a specific property.
 
-    If the ``type`` is ``none`` or ``nil``, the change function ``fn`` will be
-    called sporadically even if the property doesn't actually change. You should
-    therefore avoid using these types.
+    If the ``type`` is ``none`` or ``nil``, sporadic property change events are
+    possible. This means the change function ``fn`` can be called even if the
+    property doesn't actually change.
 
     You always get an initial change notification. This is meant to initialize
     the user's state to the current value of the property.
@@ -470,26 +430,21 @@ The ``mp`` module is preloaded, although it can be loaded manually with
     that are equal to the ``fn`` parameter. This uses normal Lua ``==``
     comparison, so be careful when dealing with closures.
 
-``mp.add_timeout(seconds, fn [, disabled])``
+``mp.add_timeout(seconds, fn)``
     Call the given function fn when the given number of seconds has elapsed.
     Note that the number of seconds can be fractional. For now, the timer's
     resolution may be as low as 50 ms, although this will be improved in the
     future.
 
-    If the ``disabled`` argument is set to ``true`` or a truthy value, the
-    timer will wait to be manually started with a call to its ``resume()``
-    method.
-
     This is a one-shot timer: it will be removed when it's fired.
 
     Returns a timer object. See ``mp.add_periodic_timer`` for details.
 
-``mp.add_periodic_timer(seconds, fn [, disabled])``
+``mp.add_periodic_timer(seconds, fn)``
     Call the given function periodically. This is like ``mp.add_timeout``, but
     the timer is re-added after the function fn is run.
 
     Returns a timer object. The timer object provides the following methods:
-
         ``stop()``
             Disable the timer. Does nothing if the timer is already disabled.
             This will remember the current elapsed time when stopping, so that
@@ -534,7 +489,7 @@ The ``mp`` module is preloaded, although it can be loaded manually with
         seconds = 0
         timer = mp.add_periodic_timer(1, function()
             print("called every second")
-            -- stop it after 10 seconds
+            # stop it after 10 seconds
             seconds = seconds + 1
             if seconds >= 10 then
                 timer:kill()
@@ -572,6 +527,18 @@ Advanced mp functions
 These also live in the ``mp`` module, but are documented separately as they
 are useful only in special situations.
 
+``mp.suspend()``
+    This function has been deprecated in mpv 0.21.0 and does nothing starting
+    with mpv 0.23.0 (no replacement).
+
+``mp.resume()``
+    This function has been deprecated in mpv 0.21.0 and does nothing starting
+    with mpv 0.23.0 (no replacement).
+
+``mp.resume_all()``
+    This function has been deprecated in mpv 0.21.0 and does nothing starting
+    with mpv 0.23.0 (no replacement).
+
 ``mp.get_wakeup_pipe()``
     Calls ``mpv_get_wakeup_pipe()`` and returns the read end of the wakeup
     pipe. This is deprecated, but still works. (See ``client.h`` for details.)
@@ -662,20 +629,6 @@ are useful only in special situations.
 
     May return invalid/nonsense values if OSD is not initialized yet.
 
-``exit()`` (global)
-    Make the script exit at the end of the current event loop iteration. This
-    does not terminate mpv itself or other scripts.
-
-    This can be polyfilled to support mpv versions older than 0.40 with:
-
-    ::
-
-        if not _G.exit then
-            function exit()
-                mp.keep_running = false
-            end
-        end
-
 mp.msg functions
 ----------------
 
@@ -731,13 +684,13 @@ with values found in the config-file and the command-line (in that order).
 
 Example implementation::
 
+    require 'mp.options'
     local options = {
         optionA = "defaultvalueA",
         optionB = -0.5,
         optionC = true,
     }
-
-    require "mp.options".read_options(options, "myscript")
+    read_options(options, "myscript")
     print(options.optionA)
 
 
@@ -849,7 +802,7 @@ strictly part of the guaranteed API.
     - rename ``cancellable`` field to ``playback_only``
     - rename ``max_size`` to ``capture_size``
     - set ``capture_stdout`` field to ``true`` if unset
-    - set ``_name`` field to ``subprocess``
+    - set ``name`` field to ``subprocess``
     - call ``mp.command_native(copied_t)``
     - if the command failed, create a dummy result table
     - copy ``error_string`` to ``error`` field if the string is non-empty
@@ -909,177 +862,6 @@ strictly part of the guaranteed API.
     Turn the given value into a string. Formats tables and their contents. This
     doesn't do anything special; it is only needed because Lua is terrible.
 
-mp.input functions
---------------------
-
-This module lets scripts get textual input from the user using the console.
-
-``input.get(table)``
-    Show the console to let the user enter text.
-
-    The following entries of ``table`` are read:
-
-    ``prompt``
-        The string to be displayed before the input field.
-
-    ``submit``
-        A callback invoked when the user presses Enter. The first argument is
-        the text in the console.
-
-    ``keep_open``
-        Whether to keep the console open on submit, allowing further input.
-        Defaults to ``false``.
-
-        If calling ``input.get()`` or ``input.select()`` again from inside the
-        ``submit`` callback, setting this option to ``true`` allows a seamless
-        transition without the console closing and reopening.
-
-    ``opened``
-        A callback invoked when the console is shown. This can be used to
-        override keybinds set by the console with ``mp.add_forced_key_binding()``.
-
-    ``edited``
-        A callback invoked when the text changes. The first argument is the text
-        in the console.
-
-    ``complete``
-        A callback invoked when the user edits the text or moves the cursor. The
-        first argument is the text before the cursor, and the second argument is
-        a response function which can be called to present completion values to
-        the user.
-
-        The first argument to the response function is a table of the string
-        candidate completion values, and the second argument is the 1-based cursor
-        position from which the completion starts. console will show the
-        completions that fuzzily match the text between this position and the
-        cursor, which the user can select with ``TAB``. The completions will only
-        be shown to the user if the text before the cursor has not since changed.
-        The response function should be called with an empty table if there are no
-        completion values to display.
-
-        The third and optional argument to the response function is a string that
-        will be appended to the input line without displaying it in the completions.
-
-    ``autoselect_completion``
-        Whether to automatically select the first completion on submit if one
-        wasn't already manually selected. Defaults to ``false``.
-
-    ``closed``
-        A callback invoked when the console is hidden, either because
-        ``input.terminate()`` was invoked from the other callbacks, or because
-        the user closed it with a key binding. The first argument is the text in
-        the console, and the second argument is the cursor position.
-
-    ``default_text``
-        A string to pre-fill the input field with.
-
-    ``cursor_position``
-        The initial cursor position, starting from 1.
-
-    ``history_path``
-        If specified, the path to save and load the history of the entered
-        lines.
-
-    ``id``
-        An identifier that determines which input history and log buffer to use
-        among the ones stored for ``input.get()`` calls. Defaults to the calling
-        script name with ``prompt`` appended.
-
-    ``console_opt_overrides``
-        A table containing configuration overrides for the console script.
-        Can be used to change the visual style of the text input, among other things.
-        See `CONSOLE`_ for the full list of options.
-
-``input.terminate()``
-    Closes any currently active input request. This will not close
-    requests made by other scripts.
-
-``input.log(message, style, terminal_style)``
-    Add a line to the log buffer of the latest ``input.get()`` request.
-    ``style`` can contain additional ASS tags to apply to ``message``,
-    and ``terminal_style`` can contain escape sequences that are used
-    when the console is displayed in the terminal.
-
-``input.set_log(log)``
-    Replace the entire log buffer of the latest ``input.get()`` request.
-
-    ``log`` is a table of strings, or tables with ``text``, ``style`` and
-    ``terminal_style`` keys.
-
-    Example:
-
-    ::
-
-        input.set_log({
-            "regular text",
-            {
-                text = "error text",
-                style = "{\\c&H7a77f2&}",
-                terminal_style = "\027[31m",
-            }
-        })
-
-``input.select(table)``
-    Specify a list of items that are presented to the user for selection.
-
-    The following entries of ``table`` are read:
-
-    ``prompt``
-        The string to be displayed before the input field.
-
-    ``items``
-        The table of the entries to choose from.
-
-    ``default_item``
-        The 1-based integer index of the preselected item.
-
-    ``submit``
-        The callback invoked when the user presses Enter. The first argument is
-        the 1-based index of the selected item.
-
-    ``keep_open``
-        Whether to keep the console open on submit, allowing further input.
-        Defaults to ``false``.
-
-        If calling ``input.get()`` or ``input.select()`` again from inside the
-        ``submit`` callback, setting this option to ``true`` allows a seamless
-        transition without the console closing and reopening.
-
-    ``opened``
-        A callback invoked when the console is shown. This can be used to
-        override keybinds set by the console with ``mp.add_forced_key_binding()``.
-
-    ``closed``
-        A callback invoked when the console is hidden, either because
-        ``input.terminate()`` was invoked from the other callbacks, or because
-        the user closed it with a key binding. The first argument is the text in
-        the console, and the second argument is the cursor position.
-
-    ``default_text``
-        A string to pre-fill the input field with.
-
-    ``cursor_position``
-        The initial cursor position, starting from 1.
-
-    ``console_opt_overrides``
-        A table containing configuration overrides for the console script.
-        Can be used to change the visual style of the select window, among other things.
-        See `CONSOLE`_ for the full list of options.
-
-    Example:
-
-        ::
-
-            input.select({
-                items = {
-                    "First playlist entry",
-                    "Second playlist entry",
-                },
-                submit = function (id)
-                    mp.commandv("playlist-play-index", id - 1)
-                end,
-            })
-
 Events
 ------
 

DOCS/man/osc.rst

@@ -20,44 +20,35 @@ The Interface
 
 ::
 
-    +------+---------+---------+-----------------------------------------------+
-    | menu | pl prev | pl next | title                                   cache |
-    +------+------+------+---------+-----------+------+-------+-----+-----+----+
+    +---------+----------+------------------------------------------+----------+
+    | pl prev | pl next  |  title                                   |    cache |
+    +------+--+---+------+---------+-----------+------+-------+-----+-----+----+
     | play | skip | skip | time    |  seekbar  | time | audio | sub | vol | fs |
     |      | back | frwd | elapsed |           | left |       |     |     |    |
     +------+------+------+---------+-----------+------+-------+-----+-----+----+
 
 
-menu
-    =============   ================================================
-    left-click      open the menu
-    =============   ================================================
-
 pl prev
     =============   ================================================
     left-click      play previous file in playlist
-    shift+L-click   show the playlist
-    middle-click    show the playlist
-    right-click     open the playlist menu
+    right-click     show playlist
+    shift+L-click   show playlist
     =============   ================================================
 
 pl next
     =============   ================================================
     left-click      play next file in playlist
-    shift+L-click   show the playlist
-    middle-click    show the playlist
-    right-click     open the playlist menu
+    right-click     show playlist
+    shift+L-click   show playlist
     =============   ================================================
 
 title
-    | Displays the current playlist position and media-title, filename or custom
-      title, or the target chapter name while hovering the seekbar.
+    | Displays current media-title, filename, custom title, or target chapter
+      name while hovering the seekbar.
 
     =============   ================================================
-    left-click      show file and track info
-    shift+L-click   show the path
-    middle-click    show the path
-    right-click     open the history menu
+    left-click      show playlist position and length and full title
+    right-click     show filename
     =============   ================================================
 
 cache
@@ -66,25 +57,20 @@ cache
 play
     =============   ================================================
     left-click      toggle play/pause
-    shift+L-click   toggle infinite looping of the playlist
-    middle-click    toggle infinite looping of the playlist
-    right-click     toggle infinite looping of the current file
     =============   ================================================
 
 skip back
     =============   ================================================
     left-click      go to beginning of chapter / previous chapter
+    right-click     show chapters
     shift+L-click   show chapters
-    middle-click    show chapters
-    right-click     open the chapter menu
     =============   ================================================
 
 skip frwd
     =============   ================================================
     left-click      go to next chapter
+    right-click     show chapters
     shift+L-click   show chapters
-    middle-click    show chapters
-    right-click     open the chapter menu
     =============   ================================================
 
 time elapsed
@@ -99,8 +85,6 @@ seekbar
 
     =============   ================================================
     left-click      seek to position
-    right-click     seek to the nearest chapter
-    mouse wheel     seek forward/backward
     =============   ================================================
 
 time left
@@ -115,30 +99,21 @@ audio and sub
 
     =============   ================================================
     left-click      cycle audio/sub tracks forward
-    shift+L-click   cycle audio/sub tracks backwards
-    middle-click    cycle audio/sub tracks backwards
-    right-click     open the audio/sub track menu
-    mouse wheel     cycle audio/sub tracks forward/backwards
+    right-click     cycle audio/sub tracks backwards
+    shift+L-click   show available audio/sub tracks
     =============   ================================================
 
 vol
     =============   ================================================
     left-click      toggle mute
-    right-click     open the audio device menu
     mouse wheel     volume up/down
     =============   ================================================
 
 fs
     =============   ================================================
     left-click      toggle fullscreen
-    right-click     toggle whether the window is maximized
     =============   ================================================
 
-Since mpv 0.40.0, it is possible to configure the commands to run with mouse
-actions on some interface elements, and the default behaviors of several
-elements were changed. If you miss some older behaviors, look at
-``etc/restore-osc-bindings.conf`` in the mpv git repository.
-
 Key Bindings
 ~~~~~~~~~~~~
 
@@ -153,9 +128,22 @@ del             Cycles visibility between never / auto (mouse-move) / always
 Configuration
 -------------
 
-This script can be customized through a config file ``script-opts/osc.conf``
-placed in mpv's user directory and through the ``--script-opts`` command-line
-option. The configuration syntax is described in `mp.options functions`_.
+The OSC offers limited configuration through a config file
+``script-opts/osc.conf`` placed in mpv's user dir and through the
+``--script-opts`` command-line option. Options provided through the command-line
+will override those from the config file.
+
+Config Syntax
+~~~~~~~~~~~~~
+
+The config file must exactly follow the following syntax::
+
+    # this is a comment
+    optionA=value1
+    optionB=value2
+
+``#`` can only be used at the beginning of a line and there may be no
+spaces around the ``=`` or anywhere else.
 
 Command-line Syntax
 ~~~~~~~~~~~~~~~~~~~
@@ -175,7 +163,7 @@ Configurable Options
     Default: bottombar
 
     The layout for the OSC. Currently available are: box, slimbox,
-    bottombar, topbar, slimbottombar, slimtopbar and floating.
+    bottombar and topbar. Default pre-0.21.0 was 'box'.
 
 ``seekbarstyle``
     Default: bar
@@ -186,7 +174,7 @@ Configurable Options
 ``seekbarhandlesize``
     Default: 0.6
 
-    Size ratio of the seek handle if ``seekbarstyle`` is set to ``diamond``
+    Size ratio of the seek handle if ``seekbarstyle`` is set to ``dimaond``
     or ``knob``. This is relative to the full height of the seekbar.
 
 ``seekbarkeyframes``
@@ -217,19 +205,12 @@ Configurable Options
     seekbar or separately if ``seekbarstyle`` is set to ``bar``.
 
 ``seekrangealpha``
-    Default: 20
+    Default: 200
 
     Alpha of the seekable ranges, 0 (opaque) to 255 (fully transparent).
 
-``scrollcontrols``
-    Default: yes
-
-    By default, going up or down with the mouse wheel can trigger certain
-    actions (such as seeking) if the mouse is hovering an OSC element.
-    Set to ``no`` to disable any special mouse wheel behavior.
-
 ``deadzonesize``
-    Default: 0.75
+    Default: 0.5
 
     Size of the deadzone. The deadzone is an area that makes the mouse act
     like leaving the window. Movement there won't make the OSC show up and
@@ -237,13 +218,13 @@ Configurable Options
     at the window border opposite to the OSC and the size controls how much
     of the window it will span. Values between 0.0 and 1.0, where 0 means the
     OSC will always popup with mouse movement in the window, and 1 means the
-    OSC will only show up when the mouse hovers it. Default pre-0.42.0 was 0.5.
+    OSC will only show up when the mouse hovers it. Default pre-0.21.0 was 0.
 
 ``minmousemove``
     Default: 0
 
     Minimum amount of pixels the mouse has to move between ticks to make
-    the OSC show up.
+    the OSC show up. Default pre-0.21.0 was 3.
 
 ``showwindowed``
     Default: yes
@@ -255,16 +236,6 @@ Configurable Options
 
     Enable the OSC when fullscreen
 
-``idlescreen``
-    Default: yes
-
-    Show the mpv logo and message when idle
-
-``audioonlyscreen``
-    Default: no
-
-    Show the mpv logo when no video track is present or selected.
-
 ``scalewindowed``
     Default: 1.0
 
@@ -275,29 +246,31 @@ Configurable Options
 
     Scale factor of the OSC when fullscreen
 
-``vidscale``
-    Default: auto
+``scaleforcedwindow``
+    Default: 2.0
 
-    Scale the OSC with the video.
-    ``no`` tries to keep the OSC size constant as much as the window size allows.
-    ``auto`` scales the OSC with the OSD, which is scaled with the window or kept at a
-    constant size, depending on the ``--osd-scale-by-window`` option.
+    Scale factor of the OSC when rendered on a forced (dummy) window
+
+``vidscale``
+    Default: yes
+
+    Scale the OSC with the video
+    ``no`` tries to keep the OSC size constant as much as the window size allows
 
 ``valign``
     Default: 0.8
 
-    Vertical alignment in box and slimbox layouts, -1 (top) to 1 (bottom).
+    Vertical alignment, -1 (top) to 1 (bottom)
 
 ``halign``
     Default: 0.0
 
-    Horizontal alignment in box and slimbox layouts, -1 (left) to 1 (right).
+    Horizontal alignment, -1 (left) to 1 (right)
 
 ``barmargin``
     Default: 0
 
-    Margin from bottom (bottombar, slimbottombar) or top (topbar, slimtopbar),
-    in pixels.
+    Margin from bottom (bottombar) or top (topbar), in pixels
 
 ``boxalpha``
     Default: 80
@@ -313,19 +286,14 @@ Configurable Options
 ``fadeduration``
     Default: 200
 
-    Duration of fade effects in ms, 0 = no fade.
-
-``fadein``
-    Default: no
-
-    Enable fade-in.
+    Duration of fade out in ms, 0 = no fade
 
 ``title``
-    Default: ${!playlist-count==1:[${playlist-pos-1}/${playlist-count}] }${media-title}
+    Default: ${media-title}
 
     String that supports property expansion that will be displayed as
     OSC title.
-    ASS tags are escaped and newlines are converted to spaces.
+    ASS tags are escaped, and newlines and trailing slashes are stripped.
 
 ``tooltipborder``
     Default: 1
@@ -337,47 +305,16 @@ Configurable Options
 
     Show total time instead of time remaining
 
-``remaining_playtime``
-    Default: yes
-
-    Whether the time-remaining display takes speed into account.
-    ``yes`` - how much playback time remains at the current speed.
-    ``no`` - how much video-time remains.
-
 ``timems``
     Default: no
 
     Display timecodes with milliseconds
 
-``tcspace``
-    Default: 100 (allowed: 50-200)
-
-    Adjust space reserved for timecodes (current time and time remaining) in
-    the ``bottombar`` and ``topbar`` layouts. The timecode width depends on the
-    font, and with some fonts the spacing near the timecodes becomes too small.
-    Use values above 100 to increase that spacing, or below 100 to decrease it.
-
 ``visibility``
     Default: auto (auto hide/show on mouse move)
 
     Also supports ``never`` and ``always``
 
-``visibility_modes``
-    Default: never_auto_always
-
-    The list of visibility modes to cycle through when calling the
-    osc-visibility cycle script message. Modes are separated by ``_``.
-
-``boxwidth``
-    Default: 550
-
-    Width of the ``box`` layout.
-
-``slimboxwidth``
-    Default: 660
-
-    Width of the ``slimbox`` layout.
-
 ``boxmaxchars``
     Default: 80
 
@@ -393,50 +330,27 @@ Configurable Options
     within the areas not covered by the osc (``yes``). If this option is set,
     the osc may overwrite the ``--video-margin-ratio-*`` options, even if the
     user has set them. (It will not overwrite them if all of them are set to
-    default values.) By default, ``visibility`` must be set to ``always``.
-    Use ``dynamic_margins`` to allow margins to update with OSC visibility
-    instead.
+    default values.) Additionally, ``visibility`` must be set to ``always``.
+    Otherwise, this option does nothing.
 
-    Currently, this is supported for the ``bottombar``, ``slimbottombar``,
-    ``topbar`` and ``slimtopbar`` layouts only. The other layouts do not change
-    if this option is set. Separately, if window controls are present (see
-    below), they will be affected regardless of which osc layout is in use.
+    Currently, this is supported for the ``bottombar`` and ``topbar`` layout
+    only. The other layouts do not change if this option is set. Separately,
+    if window controls are present (see below), they will be affected
+    regardless of which osc layout is in use.
 
-    Subtitles may still overlap with the OSC when ``--sub-use-margins`` is set
-    to ``yes`` (the default), as they are allowed to extend into the margin
-    area. Setting ``--sub-use-margins=no`` confines subtitles to the video
-    area.
+    The border is static and appears even if the OSC is configured to appear
+    only on mouse interaction. If the OSC is invisible, the border is simply
+    filled with the background color (black by default).
+
+    This currently still makes the OSC overlap with subtitles (if the
+    ``--sub-use-margins`` option is set to ``yes``, the default). This may be
+    fixed later.
 
     This does not work correctly with video outputs like ``--vo=xv``, which
     render OSD into the unscaled video.
 
-``dynamic_margins``
-    Default: no
-
-    When set to ``yes``, margins follow the actual OSC visibility: they are
-    applied when the OSC appears and removed when it hides. Without this
-    option, margins are only applied when ``visibility`` is set to ``always``.
-
-``sub_margins``
-    Default: no
-
-    Whether to adjust the subtitle margin so that subtitles do not overlap
-    with the OSC. Requires ``dynamic_margins`` or ``visibility=always`` to
-    take effect. Uses ``--sub-margin-y-offset`` to apply the adjustment.
-
-    With ``boxvideo`` enabled and ``--sub-use-margins=no``, subtitles are
-    already confined to the video area and this option has no additional
-    effect.
-
-``osd_margins``
-    Default: yes
-
-    Whether to adjust the OSD margin so that OSD text does not overlap
-    with the OSC. Requires ``dynamic_margins`` or ``visibility=always`` to
-    take effect. Uses ``--osd-margin-y-offset`` to apply the adjustment.
-
 ``windowcontrols``
-    Default: auto (Show window controls if there is no window border/title-bar)
+    Default: auto (Show window controls if there is no window border)
 
     Whether to show window management controls over the video, and if so,
     which side of the window to place them. This may be desirable when the
@@ -448,12 +362,6 @@ Configurable Options
     and ``quit``. Not all platforms implement ``minimize`` and ``maximize``,
     but ``quit`` will always work.
 
-``windowcontrols_independent``
-    Default: yes
-
-    Whether to show window controls independently of the OSC, or show them
-    together.
-
 ``windowcontrols_alignment``
     Default: right
 
@@ -463,37 +371,6 @@ Configurable Options
     Supports ``left`` and ``right`` which will place the controls on those
     respective sides.
 
-``windowcontrols_title``
-    Default: ${media-title}
-
-    String that supports property expansion that will be displayed as the
-    windowcontrols title.
-    ASS tags are escaped, and newlines and trailing slashes are stripped.
-
-``floatingtitle``
-    Default: yes
-
-    Whether to show the title row in the ``floating`` layout. When enabled,
-    window controls are rendered as compact buttons without a full-width
-    background bar.
-
-``floatingwidth``
-    Default: 700
-
-    Width of the ``floating`` layout.
-
-``floatingalpha``
-    Default: 105
-
-    Alpha of the ``floating`` layout background, 0 (opaque) to 255 (fully
-    transparent).
-
-``tracknumberswidth``
-    Default: 35
-
-    Width of the track number labels next to the audio/subtitle track selector
-    icons. Set to ``0`` to hide track numbers and show only the icons.
-
 ``greenandgrumpy``
     Default: no
 
@@ -505,255 +382,19 @@ Configurable Options
     Update chapter markers positions on duration changes, e.g. live streams.
     The updates are unoptimized - consider disabling it on very low-end systems.
 
-``chapter_fmt``
-    Default: ``Chapter: %s``
-
-    Template for the chapter-name display when hovering the seekbar.
-    Use ``no`` to disable chapter display on hover. Otherwise it's a lua
-    ``string.format`` template and ``%s`` is replaced with the actual name.
-
-``unicodeminus``
-    Default: no
-
-    Use a Unicode minus sign instead of an ASCII hyphen when displaying
-    the remaining playback time.
-
-``icon_style``
-    Default: layout
-
-    Selects the icon set used for OSC buttons. Both sets are bundled in the
-    mpv-osd-symbols font.
-
-    ``layout``
-        Select the icon set based on the current layout.
-    ``classic``
-        The original mpv icon set.
-    ``fluent``
-        Icons based on Microsoft's Fluent UI System Icons.
-
-``background_color``
-    Default: #000000
-
-    Sets the background color of the OSC.
-
-``timecode_color``
-    Default: #FFFFFF
-
-    Sets the color of the timecode and seekbar, of the OSC.
-
-``title_color``
-    Default: #FFFFFF
-
-    Sets the color of the video title. Formatted as #RRGGBB.
-
-``time_pos_color``
-    Default: #FFFFFF
-
-    Sets the color of the timecode at hover position in the seekbar.
-
-``time_pos_outline_color``
-    Default: #FFFFFF
-
-    Sets the color of the timecode's outline at hover position in the seekbar.
-    Also affects the timecode in the slimbox layout.
-
-``buttons_color``
-    Default: #FFFFFF
-
-    Sets the colors of the big buttons.
-
-``top_buttons_color``
-    Default: #FFFFFF
-
-    Sets the colors of the top buttons.
-
-``small_buttonsL_color``
-    Default: #FFFFFF
-
-    Sets the colors of the small buttons on the left in the box layout.
-
-``small_buttonsR_color``
-    Default: #FFFFFF
-
-    Sets the colors of the small buttons on the right in the box layout.
-
-``held_element_color``
-    Default: #999999
-
-    Sets the colors of the elements that are being pressed or held down.
-
-``tick_delay``
-    Default: 1/60
-
-    Sets the minimum interval between OSC redraws in seconds. This can be
-    decreased on fast systems to make OSC rendering smoother.
-
-    Ignored if ``tick_delay_follow_display_fps`` is set to yes and the VO
-    supports the ``display-fps`` property.
-
-``tick_delay_follow_display_fps``
-    Default: no
-
-    Use display fps to calculate the interval between OSC redraws.
-
-``max_thumb_size``
-    Default: 200
-
-    Maximum display size of the preview thumbnail. Only meaningful when a
-    Thumbnailer is active. See the `OSC Preview API`_ section.
-
-The following options configure what commands are run when the buttons are
-clicked. ``mbtn_mid`` commands are also triggered with ``shift+mbtn_left``.
-An option that ends with ``_down_command`` means that the command is
-continuously called while the mouse button is held down.
-
-``menu_mbtn_left_command=script-binding select/menu; script-message-to osc osc-hide``
-
-``menu_mbtn_mid_command=``
-
-``menu_mbtn_right_command=``
-
-``playlist_prev_mbtn_left_command=playlist-prev; show-text ${playlist} 3000``
-
-``playlist_prev_mbtn_mid_command=show-text ${playlist} 3000``
-
-``playlist_prev_mbtn_right_command=script-binding select/select-playlist; script-message-to osc osc-hide``
-
-``playlist_next_mbtn_left_command=playlist-next; show-text ${playlist} 3000``
-
-``playlist_next_mbtn_mid_command=show-text ${playlist} 3000``
-
-``playlist_next_mbtn_right_command=script-binding select/select-playlist; script-message-to osc osc-hide``
-
-``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; script-message-to osc osc-hide``
-
-``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_prev_mbtn_left_command=osd-msg add chapter -1``
-
-``chapter_prev_mbtn_mid_command=show-text ${chapter-list} 3000``
-
-``chapter_prev_mbtn_right_command=script-binding select/select-chapter; script-message-to osc osc-hide``
-
-``chapter_next_mbtn_left_command=osd-msg add chapter 1``
-
-``chapter_next_mbtn_mid_command=show-text ${chapter-list} 3000``
-
-``chapter_next_mbtn_right_command=script-binding select/select-chapter; script-message-to osc osc-hide``
-
-``audio_track_mbtn_left_command=cycle audio``
-
-``audio_track_mbtn_mid_command=cycle audio down``
-
-``audio_track_mbtn_right_command=script-binding select/select-aid; script-message-to osc osc-hide``
-
-``audio_track_wheel_down_command=cycle audio``
-
-``audio_track_wheel_up_command=cycle audio down``
-
-``sub_track_mbtn_left_command=cycle sub``
-
-``sub_track_mbtn_mid_command=cycle sub down``
-
-``sub_track_mbtn_right_command=script-binding select/select-sid; script-message-to osc osc-hide``
-
-``sub_track_wheel_down_command=cycle sub``
-
-``sub_track_wheel_up_command=cycle sub down``
-
-``volume_mbtn_left_command=no-osd cycle mute``
-
-``volume_mbtn_mid_command=``
-
-``volume_mbtn_right_command=script-binding select/select-audio-device; script-message-to osc osc-hide``
-
-``volume_wheel_down_command=add volume -5``
-
-``volume_wheel_up_command=add volume 5``
-
-``fullscreen_mbtn_left_command="cycle fullscreen"``
-
-``fullscreen_mbtn_mid_command=``
-
-``fullscreen_mbtn_right_command="cycle window-maximized"``
-
-``skip_backward_mbtn_left_down_command=seek -5``
-
-``skip_backward_mbtn_mid_down_command=frame-back-step``
-
-``skip_backward_mbtn_right_down_command=seek -30``
-
-``skip_forward_mbtn_left_down_command=seek 10``
-
-``skip_forward_mbtn_mid_down_command=frame-step``
-
-``skip_forward_mbtn_right_down_command=seek 60``
-
-``close_mbtn_left_command=quit``
-
-``close_mbtn_mid_command=``
-
-``close_mbtn_right_command=``
-
-``minimize_mbtn_left_command=cycle window-minimized``
-
-``minimize_mbtn_mid_command=``
-
-``minimize_mbtn_right_command=``
-
-``maximize_mbtn_left_command=cycle ${?fullscreen==yes:fullscreen}${!fullscreen==yes:window-maximized}``
-
-``maximize_mbtn_mid_command=``
-
-``maximize_mbtn_right_command=``
-
-Custom Buttons
-~~~~~~~~~~~~~~
-
-Additional script-opts are available to define custom buttons in ``bottombar``
-and ``topbar`` layouts.
-
-.. admonition:: Example to add loop, shuffle and speed buttons
-
-    ::
-
-        custom_button_1_content=🔁
-        custom_button_1_mbtn_left_command=cycle-values loop-file inf no
-        custom_button_1_mbtn_right_command=cycle-values loop-playlist inf no
-
-        custom_button_2_content=🔀
-        custom_button_2_mbtn_left_command=playlist-shuffle
-
-        custom_button_3_content=⏱
-        custom_button_3_mbtn_left_command=add speed 1
-        custom_button_3_mbtn_right_command=set speed 1
-        custom_button_3_wheel_up_command=add speed 0.25
-        custom_button_3_wheel_down_command=add speed -0.25
-
 Script Commands
 ~~~~~~~~~~~~~~~
 
 The OSC script listens to certain script commands. These commands can bound
 in ``input.conf``, or sent by other scripts.
 
+``osc-message``
+    Show a message on screen using the OSC. First argument is the message,
+    second the duration in seconds.
+
 ``osc-visibility``
     Controls visibility mode ``never`` / ``auto`` (on mouse move) / ``always``
-    and also ``cycle`` to cycle between the modes. If a second argument is
-    passed (any value), then the output on the OSD will be silenced.
-
-``osc-show``
-    Triggers the OSC to show up, just as if user moved mouse.
-
-``osc-hide``
-    Hide the OSC when ``visibility`` is ``auto``.
+    and also ``cycle`` to cycle between the modes
 
 Example
 
@@ -763,40 +404,7 @@ to set auto mode (the default) with ``b``::
     a script-message osc-visibility never
     b script-message osc-visibility auto
 
-``osc-idlescreen``
-    Controls the visibility of the mpv logo on idle. Valid arguments are ``yes``,
-    ``no``, and ``cycle`` to toggle between yes and no. If a second argument is
-    passed (any value), then the output on the OSD will be silenced.
+``osc-playlist``, ``osc-chapterlist``, ``osc-tracklist``
+    Shows a limited view of the respective type of list using the OSC. First
+    argument is duration in seconds.
 
-OSC Preview API
-~~~~~~~~~~~~~~~
-
-The OSC supports displaying preview thumbnails when hovering over the seekbar if
-a compatible thumbnailer script is installed. It communicates with a thumbnailer
-script via the following ``user-data`` properties:
-
-``user-data/osc/draw-preview``
-    Set by the OSC to request a thumbnail within the currently playing file.
-    The ``draw-preview`` property is a table with the following fields:
-
-    ``x``, ``y``
-        Top-left coordinates (positive integers) to draw the thumbnail at.
-
-    ``w``, ``h``
-        Width and height (positive non-zero integers) of the area to draw the
-        thumbnail in. Note that this only specifies the drawing width and
-        height, the actual backing thumbnail size may differ.
-
-    ``hover-sec``
-        Requested thumbnail timestamp in seconds.
-
-    ``ass``
-        Optional ASS string to render alongside the thumbnail, using OSD
-        coordinates. This can be used for decorations such as a thumbnail
-        border.
-
-    The OSC sets this property to ``nil`` to signal the thumbnailer to clear
-    the displayed thumbnail.
-
-Avoid installing/enabling multiple thumbnailer script since this api expects
-only one to be active at a time.