mpv-netrc

mpv-netrc is an mpv user script that, when mpv opens an http(s) URL, looks up matching credentials in your ~/.netrc file and rewrites the URL to include them, so you can stream password-protected media without typing or embedding credentials in the command line.

For background on the netrc file format, see https://www.gnu.org/software/inetutils/manual/html_node/The-_002enetrc-file.html.

Installing into mpv
-------------------

LuaRocks installs the script as a Lua module under the rocks tree (typically ~/.luarocks/share/lua/<lua-version>/netrc.lua). mpv does not load scripts from the rocks tree, so after running `luarocks install mpv-netrc` you still need to make netrc.lua
available to mpv. On Linux/macOS:

ln -s "$(luarocks which netrc | head -n1)" ~/.config/mpv/scripts/netrc.lua

Alternatively, copy the file or fetch netrc.lua directly from the project repository and place it in ~/.config/mpv/scripts/ (or the equivalent scripts/ directory inside your mpv config on other platforms).

netrc format
------------

Only single-line entries are supported. Each entry must match:

machine HOSTNAME login USERNAME password PASSWORD

HOSTNAME is matched against the host portion of the URL mpv is loading (no leading scheme, no path). URLs that already embed credentials (anything containing "@" before the path) are skipped. Make sure ~/.netrc is readable only by you (chmod 600 ~/.netrc).

Configuration
-------------

By default the script reads ~/.netrc. To use a different file, either:

* Create ${MPV_CONFIG_DIR}/script-opts/netrc.conf containing:

netrc-path=/full/path/to/netrc

* Or start mpv with:

mpv --script-opts=netrc=/full/path/to/netrc ...

A full, absolute path is recommended; "~" and mpv's "~~" expansion may not be applied.

Debug logging
-------------

The script emits messages on the "netrc" log prefix. Run mpv with `--msg-level=netrc=debug` to see when entries are skipped, matched, or when ~/.netrc cannot be opened.