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

  1. In the sidebar, open Script matching and switch to Unmatched.
  2. Find the script and check its title, action count, and ending time. Scripts without a recorded source file can also be linked manually.
  3. 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.
  4. Select the matching video and compare its duration with the script's ending time. This example uses the 15-second Sofia video.
  5. Click Link video. Back in video details, check the linked script and active tracks, then use Play with script to check timing.
Unmatched means no video is linked. The script remains in Library.
Sofia script in Script matching → Unmatched, with Choose video
Check the video and duration before clicking Link video.
Sofia selected in Link video, with its duration compared against the script ending time
Verify the link in video details. A closed dialog alone does not confirm success.
Sofia video details after linking, showing the expected script and active tracks
Check the result
The video shows the expected script, its versions remain intact, and footage and curve align during playback.

02 Review automatic suggestions

Information shownHow to interpret it
Needs reviewA candidate awaiting review, not a confirmed link.
Exact name / Similar nameFilename evidence for the match. Also check the folder, footage, and duration.
All source folders / candidate scopeCheck the search scope; identical filenames can exist in different folders.
Confirm actions beyond video durationScript nodes extend beyond the candidate video. Check whether it is a shortened edit before confirming.
Original missing / Indexing / statistics failedRestore the source video or wait for indexing. Use Retry statistics after a failure.
  1. Use the candidate's preview to check footage and curves.
  2. When several candidates appear, explicitly choose the intended video.
  3. To confirm only the link, click Confirm match. To also align source filenames, choose Confirm & rename.
  4. 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.

  1. Open the rename preview and compare each axis's Current filename and New filename.
  2. Check Source folder. If scripts and video are in different folders, scripts stay in their original folder.
  3. Confirm axis suffixes are preserved, then click Rename files or Confirm & rename.
  4. After Filenames aligned appears, use Show in Finder to check the actual filenames.
Compare Current filename and New filename, then confirm with Rename files.
Rename preview changing Practice copy.funscript to Sofia sample.funscript
The rename completed, and Sofia sample.funscript exists on disk.
Source renamed to Sofia sample.funscript with its video link preserved

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

  1. For a linked item, use Change video or Unlink video. Change and Unlink in video details also identify which pairing will be removed.
  2. Unlinking keeps both the video and script in Library.
  3. 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.
  4. Reopen video details and confirm the final link.
Check the result
Link changes affect the selected items. Use the operation's Undo to restore a link instead of importing a duplicate script.

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.

  1. 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.
  2. From the folder menu or refresh window, open Sync cleanup history….
  3. Check each reason: Source transferred means the source has been transferred; Source files missing means the source file is missing.
  4. If a destination-script link is available, open it and check its content. A cleaned-up transferred copy may not be the only version.
This example has one recoverable removal. Choose Open cleanup history to keep it.
Folder refresh after a missing source, showing one recoverable removal and a permanent-delete prompt

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

  1. On a recoverable item, click Restore to Library, then check its content, versions, and notes in Scripts.
  2. To retain the restored copy, use Keep in Library.
  3. 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.
  4. Use Delete selected permanently… only for records you no longer need. Review script, version, and note counts first.
Choose Keep in Library after restoring so the next refresh retains the script.
Restore to Library followed by Keep in Library, confirming the script will survive automatic cleanup
Refresh again to verify. This example removes no scripts.
Refreshing after keeping the recovered copy shows 0 removed
Review the deletion scope. Here, Cancel keeps the restored script.
Permanent-delete confirmation for one script, one track version, and no notes, leaving sources and videos intact

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.

Next: Back up and restore Library →