Installation on macOS

Welcome to the ff2mpv installation instructions for macOS.

Firefox

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

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 has the executable bit set. Both scripts work the same.

2. Copy ff2mpv.json into ~/Library/Application Support/Mozilla/NativeMessagingHosts/.

3. Open ~/Library/Application Support/Mozilla/NativeMessagingHosts/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...

...unless you're using a copy of MPV installed in an applications folder, e.g., /Applications. In that case, you need to modify your script of choice a bit:

For ff2mpv, change

pid = spawn "mpv", "--no-terminal", "--", url, in: :close, out: :close, err: :close

to

pid = spawn "/Applications/mpv.app/Contents/MacOS/mpv", "--no-terminal", "--", url, in: :close, out: :close, err: :close

For ff2mpv.py. change

args = ['mpv', '--no-terminal', '--', url]

to

args = ['/Applications/mpv.app/Contents/MacOS/mpv', '--no-terminal', '--', url]

Adjust as appropriate if you've used a different Applications folder.

Chrome

This isn't documented yet. Please contribute documentation!

In the mean time, the Installation on Linux steps might be of some help, as might be Google's Native Messaging documentation.