Skip to content

Commit 62032a3

Browse files
committed
Added "troubleshooting and tips" section to README
1 parent d599a64 commit 62032a3

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,13 @@ The extension itself shares a lot of code with the one from the awesome [iina](h
1313

1414
- [Installation](#installation)
1515
- [Configuration](#configuration)
16+
- [Flag overrides](#flag-overrides)
17+
- [Example](#example)
1618
- [The `mpv://` protocol](#the-mpv-protocol)
1719
- [Playlist and `enqueue` functionality](#playlist-and-enqueue-functionality)
1820
- [Player support](#player-support)
1921
- [Supported protocols](#supported-protocols)
22+
- [Troubleshooting and tips](#troubleshooting-and-tips)
2023

2124
### Installation
2225
> Compiled binaries and packed extensions can be found in the [releases page](https://github.com/Baldomo/open-in-mpv/releases).
@@ -144,4 +147,12 @@ input-ipc-server=/tmp/mpvsocket
144147
Supported players are defined in `config.yml`, where the struct `Player` ([see `config.go`](config.go)) defines supported functionality and command line flag overrides. To request support for a player you're welcome to open a new issue or a pull request or just add your own in your configuration file.
145148

146149
### Supported protocols
147-
Since opening an arbitrary URL with a shell command can cause remote code execution on the host machine (for example by loading arbitrary `.so` files on a player by using special [schemes](https://en.wikipedia.org/wiki/List_of_URI_schemes)), only protocols/[schemes](https://en.wikipedia.org/wiki/List_of_URI_schemes) explicitly specified in the configuration will be processed by the native binary without errors. Defaults to `["http", "https"]` if empty. There is also no special instructions parsing or catch-all values.
150+
Since opening an arbitrary URL with a shell command can cause remote code execution on the host machine (for example by loading arbitrary `.so` files on a player by using special [schemes](https://en.wikipedia.org/wiki/List_of_URI_schemes)), only protocols/[schemes](https://en.wikipedia.org/wiki/List_of_URI_schemes) explicitly specified in the configuration will be processed by the native binary without errors. Defaults to `["http", "https"]` if empty. There is also no special instructions parsing or catch-all values.
151+
152+
### Troubleshooting and tips
153+
This section will be updated with tips and tricks coming mainly from the issues and community.
154+
155+
##### Setting a working directory for the called player
156+
- **Abstract:** in Windows, if the player and/or `yt-dlp` are installed as root, the player fails silently because `yt-dlp` (which is being ran as the current user) cannot write to its own directory
157+
- **Links:** issue #13
158+
- **Solution:** pass the `--paths temp:%TMP%` argument to `yt-dlp` to make it use a temporary directory instead of writing to the installation directory

0 commit comments

Comments
 (0)