-
Notifications
You must be signed in to change notification settings - Fork 52
Common problems
This page documents common problems when using ff2mpv and how to diagnose and correct them.
TODO: Document the following common problems:
- Failing to install the native client
-
youtube-dl
not being installed at all
Some Linux users have reported problems with ff2mpv's ability to spawn mpv
and/or youtube-dl
when Firefox is launched via a "desktop" launcher (e.g. an icon corresponding to a .desktop
file). It's not clear what causes this, but it is not a bug in ff2mpv itself: it happens at the system level.
To confirm that you're having this problem, try running Firefox from a terminal emulator (i.e., just run firefox
). If ff2mpv functions correctly when Firefox is run like this, it's probably a launcher issue.
The "fix" for most launcher issues appears to be opening Firefox's .desktop
file and removing %U
from the Exec=
line. It's not clear why this fixes things.
Alternatively, consider using a simplified launcher like dmenu
or rofi
. These don't appear to have problems.
On Linux and macOS, mpv
and youtube-dl
need to be on the PATH
in order for ff2mpv to function correctly.
To confirm that mpv
is on the PATH
, you can run:
$ which mpv
/path/to/some/folder/mpv
If which
doesn't print a path, then mpv
is not on the PATH
. You'll need to take steps specific to your OS, distribution, environment, and/or package manager to resolve it.
NOTE: Do not open issues asking ff2mpv to support a particular website or URL. ff2mpv has no control over the URLs supported by your mpv
and youtube-dl
installations.
ff2mpv sends URLs to mpv
, which in turn sends them to youtube-dl
for extraction. That means that either mpv
or youtube-dl
can fail for a particular website, causing ff2mpv to not work.
If a website ceases to work with ff2mpv, there's a good chance that your version of youtube-dl
no longer works with the current version of the site. youtube-dl
is frequently updated; you can find directions for updating your installed copy here.
If updating youtube-dl
doesn't work, the problem might be mpv
itself. You should use your package manager to update it.