As it turns out the manual was very wrong about this.
Unified · Split
| @@ -433,23 +433,28 @@ need to escape special characters. To work this around, the path can be · 432 unmodified lines | |||
| 433 | additionally wrapped in the fixed-length syntax, e.g. ``%n%string_of_length_n`` | 433 | additionally wrapped in the fixed-length syntax, e.g. ``%n%string_of_length_n`` |
| 434 | (see above). | 434 | (see above). |
| 435 | 435 | ||
| 436 | Some mpv options interpret paths starting with ``~``. Currently, the prefix | 436 | Some mpv options interpret paths starting with ``~``. |
| 437 | ``~~/`` expands to the mpv configuration directory (usually ``~/.config/mpv/``). | 437 | Currently, the prefix ``~~home/`` expands to the mpv configuration directory |
| 438 | (usually ``~/.config/mpv/``). | ||
| 438 | ``~/`` expands to the user's home directory. (The trailing ``/`` is always | 439 | ``~/`` expands to the user's home directory. (The trailing ``/`` is always |
| 439 | required.) The following paths are currently recognized: | 440 | required.) The following paths are currently recognized: |
| 440 | 441 | ||
| 441 | ================ =============================================================== | 442 | ================ =============================================================== |
| 442 | Name Meaning | 443 | Name Meaning |
| 443 | ================ =============================================================== | 444 | ================ =============================================================== |
| 444 | ``~~/`` mpv config dir (for example ``~/.config/mpv/``) | 445 | ``~~/`` If the subpath exists in any of the mpv's config directories |
| 446 | the path of the existing file/dir is returned. Otherwise this | ||
| 447 | is equivalent to ``~~home/``. | ||
| 448 | Note that if --no-config is used ``~~/foobar`` will resolve to | ||
| 449 | ``foobar`` which can be unexpected. | ||
| 445 | ``~/`` user home directory root (similar to shell, ``$HOME``) | 450 | ``~/`` user home directory root (similar to shell, ``$HOME``) |
| 446 | ``~~home/`` same as ``~~/`` | 451 | ``~~home/`` mpv config dir (for example ``~/.config/mpv/``) |
| 447 | ``~~global/`` the global config path, if available (not on win32) | 452 | ``~~global/`` the global config path, if available (not on win32) |
| 448 | ``~~osxbundle/`` the macOS bundle resource path (macOS only) | 453 | ``~~osxbundle/`` the macOS bundle resource path (macOS only) |
| 449 | ``~~desktop/`` the path to the desktop (win32, macOS) | 454 | ``~~desktop/`` the path to the desktop (win32, macOS) |
| 450 | ``~~exe_dir`` win32 only: the path to the directory containing the exe (for | 455 | ``~~exe_dir/`` win32 only: the path to the directory containing the exe (for |
| 451 | config file purposes; ``$MPV_HOME`` overrides it) | 456 | config file purposes; ``$MPV_HOME`` overrides it) |
| 452 | ``~~old_home`` do not use | 457 | ``~~old_home/`` do not use |
| 453 | ================ =============================================================== | 458 | ================ =============================================================== |
| 454 | 459 | ||
| 455 | 460 | ||