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 | 433 | additionally wrapped in the fixed-length syntax, e.g. ``%n%string_of_length_n`` |
| 434 | 434 | (see above). |
| 435 | 435 | |
| 436 | −Some mpv options interpret paths starting with ``~``. Currently, the prefix | |
| 437 | −``~~/`` expands to the mpv configuration directory (usually ``~/.config/mpv/``). | |
| 436 | +Some mpv options interpret paths starting with ``~``. | |
| 437 | +Currently, the prefix ``~~home/`` expands to the mpv configuration directory | |
| 438 | +(usually ``~/.config/mpv/``). | |
| 438 | 439 | ``~/`` expands to the user's home directory. (The trailing ``/`` is always |
| 439 | 440 | required.) The following paths are currently recognized: |
| 440 | 441 | |
| 441 | 442 | ================ =============================================================== |
| 442 | 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 | 450 | ``~/`` user home directory root (similar to shell, ``$HOME``) |
| 446 | −``~~home/`` same as ``~~/`` | |
| 451 | +``~~home/`` mpv config dir (for example ``~/.config/mpv/``) | |
| 447 | 452 | ``~~global/`` the global config path, if available (not on win32) |
| 448 | 453 | ``~~osxbundle/`` the macOS bundle resource path (macOS only) |
| 449 | 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 | 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 | |