Installation on Linux

Welcome to the ff2mpv installation instructions for Linux distributions.

This page assumes that you've already installed the addon from AMO or chrome store. If you haven't yet, do it before continuing.

Dependencies

• mpv
• python3 / ruby
• yt-dlp (Javascript runtime required for youtube support)
• git

Warning

yt-dlp requires a JS runtime for full youtube support. Instructions to setup the EJS is documented here: https://github.com/yt-dlp/yt-dlp/wiki/EJS.

Chromium browsers and Firefox

Install using script (recommended)

1. Clone the repository to any place in your system using git or download as zip and extract the files.
2. Make sure that the install.sh is executable by using the command chmod +x install.sh
3. From your terminal call the install.sh script and provide the name of your browser as first argument. Valid browsers:
   • chromium
   • chrome
   • brave
   • edge
   • firefox

Example of use:

$ ./install.sh chrome

Note: Opera uses same path to NativeMessagingHosts as Chrome, so you can use chrome switch for Opera browser

Install custom browsers

1. Follow the first two steps above
2. Call the script and use custom-chromium (if based on chromium) or custom-firefox (if based on firefox) as the first argument and the path for the NativeMessagingHosts directory as a second argument

Chromium example:

$ ./install.sh custom-chromium $HOME/.config/chromium

Firefox example:

$ ./install.sh custom-firefox $HOME/.mozilla

Install manually

Firefox

STOP: Before following the steps below, consider using the install.sh script provided in the repository. Installing with the script should be as simple as:

$ ./install.sh

Only follow the steps below if you have not used the install script.

1. Save either ff2mpv (the Ruby script) or ff2mpv.py (the Python script) to somewhere on your machine, and make sure that it's executable. Both scripts work the same.

2. Copy ff2mpv.json into ~/.mozilla/native-messaging-hosts/.

3. Open ~/.mozilla/native-messaging-hosts/ff2mpv.json in your preferred editor, and change the path field to the path where you saved either ff2mpv or ff2mpv.py

4. After that, everything should work.

Chromium

1. Save either ff2mpv (the Ruby script) or ff2mpv.py (the Python script) to somewhere on your machine, and make sure that it's executable. Both scripts work the same.

2. Copy ff2mpv-chromium.json into your native messaging hosts directory and rename it to ff2mpv.json. The location of this directory varies by installation and Chrome variant; see Google's documentation or your specific browser's documentation for more information for the location of the NativeMessagingHosts directory.

3. Open the copied version of ff2mpv-chromium.json from the last step in your preferred editor, and change the path field to the path where you saved either ff2mpv or ff2mpv.py.