Handy-mpv [ Linux player ]

Hello, as mentioned in this thread: https://discuss.eroscripts.com/t/feature-idea/28757

I am sharing with you all the script player I’ve been using. This is a player I made myself after not finding any good player for Linux that fit my needs.

This player requires python and mpv to be installed on your machine. it is also recommended to use it with special actions from your file manager to easily launch it from any video file. seen below.

Here is the readme for more information on how to install and use this script. Enjoy!


Simple script to play funscripts using mpv and the power of python.


Q : Quit application

up arrow: pause script playback but keep video playing.

down arrow: Re-sync script / restart script playback. use this if for some reason your script becomes out of sync.

all other mpv shortcuts should work as inteded.

Installation / requirements

  1. clone this repo
  2. create a virtualenv python -m venv venv
  3. activate venv . venv/bin/activate
  4. install dependencies pip install -r requirements.txt
  5. Setup your handy key in the app.py file.
# ...




# example usage
$ python app.py yourscript {args}


--double: doubles every stroke in the provided script (does not modify the actual file)

This option is mostly created for fapheroes. results may vary for normal scripts but sometimes creates very interesting results.

for fapheroes however, this makes it so every beat is a full stroke. so assuming you have 4 beats such as:


the resulting motion will be:


instead of:


this was created to more closely match the way I would play fapheroes without the handy.

aditional notes

  • on startup, the script will do a time sync with the handy server to insure accurate strokes. The server delay is stored in a file and the sync will no re-happen for an hour after that.

  • on the first sync with the device. it is usually required to run the script twice. if your video never starts. it’s probably for this reason. simply re-run the script.

  • pausing the video will pause the script. however, if you press the resync button. the script will start playing with the video still paused.

  • scrubbing the player automatically scrubs the script to the appropriate timestamp.

  • If you have a looping video, the script will also loop.


Get the script here:


Amazing stuff! Thanks for the share!

I can finally stop using browser for my handy. thanks for this.

1 Like

happy I could help! didn’t think anyone else was in the same boat as me. I’d have shared it sooner.


What would be required to enable local playback via bluetooth and/or local handycontrol instance? I just got my unit and wanting to contribute to improving quality of life on *nix.

1 Like

I’m not familiar with how the bluetooth works for the handy, but for local playback, I think it’s just a matter of changing the server for the handy api calls. You just need to keep the endpoint that converts funscripts to csv, since I don’t think this comes with the local server.

Sorry for the late reply, been busy working on other things. I’ll be pushing an update soon, couple stuff broke for me after updating some local libs. probably should figure out how to package this as an executable.

Thank you for this! Can’t wait to get it set up

Also if it’s possible I’d love to check out the vid in the thumbnail

Hello! thanks for the interest!, the video is “Fap Hero - Ero Festival” I think I got it from one of the big script archives torrents that are floating around on the web. I can give you the script tho, believe liquid made it.

Fap Hero - Ero Festival.funscript (97.7 KB)

1 Like

I dunno if this one matches the script but I found this: Watch Fap Hero - Ero Festival - Dragon, Fap Hero, Fap Hero Hentai Porn - SpankBang

1 Like