IINA Player

IINA is a modern, open-source player for Mac, based on a media player called MPV.

Some refer to IINA as a crossroad between Quicktime-like sleekness and VLC-like power.

Wherever you stand on that debate is your decision. FunPlayer supports both VLC and IINA. We don’t support the standalone MPV player application itself tho at the time of writing this.

IINA’s powerful plugin system

Unlike VLC which has a HTTP API that FunPlayer needs to poll on a set interval loop, IINA takes it one step further with the ability to use Websockets. This is more efficient.

To support IINA with FunPlayer, we created a straightforward IINA plugin that listens to important events (like play/pause and video loaded) and the Websocket between IINA and FunPlayer relays that information.

Configure IINA

1. Open IINA.
2. Go to IINA -> Settings (or press ⌘,).
3. Go to Plugins from the sidebar.
4. Click Install from Github and paste http://127.0.0.1:8080.
5. Make sure the plugin is ticked.
6. That should be it. There shouldn’t be a need to restart IINA, but for good measure feel free to.

Alternatively, if you are a power user, feel free to use Install Package... and locally install the package.

You are welcome to download the repository, npm i, and npm run build. That’ll compile and output the .iinaplgz file that can be installed via the Install Package... button.

By default the plugin will listen on ws://127.0.0.1:9084. At the time of writing this, the port 9084 is hardcoded into the plugin.

Add IINA to FunPlayer

1. In the Media Players section, click Add Player.
2. Choose IINA.
3. Set a name you like.
4. Enter the base URL including scheme and port (in most cases this should work: ws://127.0.0.1:9084).
5. Save and click Connect.

FunPlayer will make an attempt to talk with IINA via Websocket. If it succeeds, you should see Connected.

Playback Expectations

• Open a video in IINA. FunPlayer should show the loaded video in IINA as loaded.
• When you press play/pause in IINA, FunPlayer will coordinate connected devices with the funscript you selected.
• Seeking and pausing in IINA should reflect in FunPlayer.

Known quirks

• The plugin isn’t setup to replay past events to FunPlayer so if you open a video in IINA then connect to FunPlayer, FunPlayer will be blissfully unaware that a video is loaded. This should be ironed out sometime in the future.