Safari Player

It’s not the most convenient thing in the world to be forced to have a media file downloaded to enjoy FunPlayer.

Especially these days where streaming content is oh-so-common. It would be really nice to stream content from Safari.

With a Safari Extension, FunPlayer is able to bridge the gap to Safari to get across important video events such as play/pause and the video time that FunPlayer needs to do it’s job synchronizing playback to devices.

Below you’ll see how to setup the extension and how to select a video to track.

Setting up the Extension

The Safari extension is bundled with FunPlayer like any other macOS app that has an extension. To configure the extension:

1. From the top menu bar, Safari -> Safari Extensions
2. Make sure the FunPlayer extension is enabled.
3. Configure the hotkeys available. FunPlayer video picker overlay is a hotkey shortcut to trigger the video picker overlay. FunPlayer is a hotkey shortcut to trigger the popup.

Using the Extension

The extension has two main concepts.

1. The popup display which displays the videos being tracked. At the time of writing this, we strongly suggest tracking only one video at a time, otherwise FunPlayer will be processing events from both videos.

2. The video picker overlay is the second concept. It draws a yellow box on the element that your mouse is hovering over. It can be triggered by the popup Select a video button, or via the hotkey. See below’s example where the yellow box is visible when selecting a video.

Picking a video

1. Navigate to a page that has a video displayed and trigger the video picker overlay. This can be done via pressing the extension’s icon and pressing Select a video or via the hotkey.

2. Once the video picker overlay is triggered, position your mouse over the video element, a yellow box should be covering the video element, then click.

3. If you pressed too far away from a video such that the extension has trouble discerning the video you wanted tracked, a dialogue will be presented for you to clarify, click on the row for the video you are after.

4. The yellow box should disappear and a red badge showing the number of videos being tracked should be displayed. Opening the popup will show the video being tracked. Clicking the Clear all button will clear all videos being tracked. Open tab is useful to jump back to the tab in Safari where the video lives if you are across tabs.

5. That’s it, when a video is being tracked, and the app is connected to the extension, you should see the video title displayed in the app.

   Don’t forget to select a funscript file in the FunPlayer app relevant to the video you are playing.

Gotchas

1. This is not perfect, at the time of writing this, expect bugs, in local testing, sometimes the video picker overlay is stubborn and refuses to be triggered via keybinds or at all. If this is the case, open a new tab or refresh Safari, and try again. Also, it seems to be more reliable triggering the video picker overlay via the popup Select a video button.

2. If you connect FunPlayer to Safari then idle Safari for too long, Safari could sleep the extension, FunPlayer will display an error. Simply click the extension popup to wake the extension up again and press Retry Connect in FunPlayer.

3. The Safari extension hooks into the HTML <video> element. Not every website uses that. Some, for example, wrap their video player in an <iframe>. If the <video> element is not rendered in the HTML, the extension will simply be unable to find it until we improve the extension to support other types of HTML elements.