Match scripts and manage source files
Link an existing .funscript to its video for synchronized playback. You can then organize source filenames. If a folder refresh removes a script, review the cleanup history and recover the copy you need.
Import the video into Library and use Import → Import script for its .funscript. Sofia demonstrates manual linking; the filename and cleanup sections use another imported copy. Read the sections you need.
01 Link an unlinked script
- In the sidebar, open Script matching and switch to Unmatched.
- Find the script and check its title, action count, and ending time. Scripts without a recorded source file can also be linked manually.
- Click Choose video. Under Link video, search for the video. The default Without scripts filter narrows the candidates; check it if your video is missing.
- Select the matching video and compare its duration with the script's ending time. This example uses the 15-second Sofia video.
- Click Link video. Back in video details, check the linked script and active tracks, then use Play with script to check timing.
02 Review automatic suggestions
| Information shown | How to interpret it |
|---|---|
| Needs review | A candidate awaiting review, not a confirmed link. |
| Exact name / Similar name | Filename evidence for the match. Also check the folder, footage, and duration. |
| All source folders / candidate scope | Check the search scope; identical filenames can exist in different folders. |
| Confirm actions beyond video duration | Script nodes extend beyond the candidate video. Check whether it is a shortened edit before confirming. |
| Original missing / Indexing / statistics failed | Restore the source video or wait for indexing. Use Retry statistics after a failure. |
- Use the candidate's preview to check footage and curves.
- When several candidates appear, explicitly choose the intended video.
- To confirm only the link, click Confirm match. To also align source filenames, choose Confirm & rename.
- If you do not want to link this script, use Keep unlinked. It moves to Dismissed without deleting the script.
Before confirming a batch, review each pairing in the selection panel and preview individual items as needed. If no candidate fits, use Choose video rather than confirming an incorrect match.
03 Match script filenames to the video
On macOS, a linked script's menu offers Align script filenames…. For a pending suggestion, Confirm & rename confirms the link and renames the source files together. Controls may be unavailable if there is no source file or the names already match.
- Open the rename preview and compare each axis's Current filename and New filename.
- Check Source folder. If scripts and video are in different folders, scripts stay in their original folder.
- Confirm axis suffixes are preserved, then click Rename files or Confirm & rename.
- After Filenames aligned appears, use Show in Finder to check the actual filenames.
Renaming source files alone leaves the video filename, script title, content, and link unchanged. Confirm & rename also confirms the video link. This changes files on disk, unlike renaming a Library item.
If renaming is interrupted
Reopen the operation and follow its recorded state to choose Finish renaming or Restore original names. If you also confirmed a link, recovery uses Restore names & undo match. Decide later keeps the current file state. Files changed externally or involved in a conflict are not overwritten directly.
04 Change or restore a link
- For a linked item, use Change video or Unlink video. Change and Unlink in video details also identify which pairing will be removed.
- Unlinking keeps both the video and script in Library.
- If Change removes the old link and you then cancel choosing a replacement, the video temporarily has no script. Use the notification's Undo or choose a script again.
- Reopen video details and confirm the final link.
05 Refresh folders and review cleanup
Open the source folder's menu and click Refresh folder. Refresh checks source files again; it is separate from player refresh and Sync funscript's file-writing operation.
- Wait for scanning, then review added, updated, removed, skipped, and attention items. For conflicts, compare the source and Library versions before choosing Use source version, Use Library version, or Resolve later.
- From the folder menu or refresh window, open Sync cleanup history….
- Check each reason: Source transferred means the source has been transferred; Source files missing means the source file is missing.
- If a destination-script link is available, open it and check its content. A cleaned-up transferred copy may not be the only version.
Cleanup history records folder-refresh cleanup; it is not a general trash folder for manual deletions. With no records, it shows No scripts removed by sync.
06 Restore a copy and choose whether to keep it
- On a recoverable item, click Restore to Library, then check its content, versions, and notes in Scripts.
- To retain the restored copy, use Keep in Library.
- Restoring does not reassign the source-file binding. An unchanged recovered copy may be cleaned up at the next refresh. Edited scripts, scripts with notes or favorites, and explicitly kept scripts remain in Library.
- Use Delete selected permanently… only for records you no longer need. Review script, version, and note counts first.
Delete permanently removes selected Library scripts, versions, and notes. It cannot be undone. Source files, videos, destination scripts, and existing backups remain. This differs from Hide, Unlink, or removing collection membership.