Skip to content
William Woodruff edited this page Dec 26, 2020 · 8 revisions

This page documents common problems when using ff2mpv and how to diagnose and correct them.

Nothing is playing!

TODO: Document the following common problems:

  1. Failing to install the native client
  2. youtube-dl not being installed at all

Launcher problems

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.

PATH 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.

"URLs from $website aren't working!"

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.

Clone this wiki locally