Naming Convention for Videos & Scripts

FunFlixDroid automatically associates your scripts to videos based on filenames. To ensure your files are matched correctly, follow these simple rules.

---

🔁 Basic Matching Rule

To associate a script to a video:

📹 MyAwesomeVideo.mp4
📄 MyAwesomeVideo.funscript

✅ The filenames must match exactly, excluding the file extension.

FunFlixDroid will automatically detect and link them together.

---

🎯 Multiple Scripts per Video

You can associate multiple scripts with a single video by using a suffix:

📹 MyAwesomeVideo.mp4
📄 MyAwesomeVideo.sleeve.funscript – for stroker-type toys
📄 MyAwesomeVideo.vibrator.funscript – for vibrators
📄 MyAwesomeVideo.custom.funscript – any custom label

The suffix helps you distinguish between scripts, and FunFlixDroid displays them clearly in the interface.

---

⚠️ Important Tips

• While special characters are technically allowed in filenames, it’s safer to use underscores _ or dashes - for better compatibility.
• It’s recommended to keep your video and its associated script(s) in the same folder
• If you rename or add files, you can refresh a folder by simply leaving it and opening it again — there’s no manual refresh button needed.

---

🧩 Manual Association

If a script wasn’t matched automatically (e.g. filename too different), you can manually assign it from the Home screen.

While the video is playing (or loaded in the playlist), tap the “Add Script” button to manually select and link the appropriate Funscript file.

This allows full control when filenames don’t match or when experimenting with alternate scripts.