Getting started
What SyncScript Pro does
SyncScript Pro matches the dialogue of your screenplay to the spoken words of your Final Cut Pro clips. It transcribes every clip of an exported Event on your Mac, matches the transcripts against the script lines and prepares the result as keywords on the clips. You review and correct the result on a small timeline before you export. Nothing is changed in Final Cut Pro until you export and send the result. SyncScript Pro does not tag your footage fully automatically, and it is not meant to. The matching gives you suggestions, and an assistant editor checks and corrects every result on the timeline before it goes into Final Cut Pro. The app gives the assistant editor a tool to reach the same checked result in roughly half the time. We don't know a faster way to do it, and a result that a person has checked is the only one worth cutting with.
How many lines are found depends on the footage. A scene with improvised or unclear dialogue matches less, and that is expected. You close the gaps by hand, which is still much faster than doing everything manually.
Before you start
You need an Apple Silicon Mac running macOS 15 or later, and Final Cut Pro. The released app is built for Apple Silicon only. Your script must be a PDF with a text layer. Your clips must be in a Final Cut Pro Event as sync clips and/or multicam clips.
The app checks your license over the internet, and the first transcription downloads the speech model (about 1.5 GB). A short loss of connection does not block the app.
First launch
On the first launch the app asks for your email address. Enter it and click Continue. The button stays disabled until the address looks valid. You cannot skip this step. The address is sent with the license check, so support can find and renew your trial.
Step 1: import the Event and transcribe
Export a single Event from Final Cut Pro as FCPXML. On page 1. Transcribe, drop the file on the Import tile. Click Transcribe Clips. The first run downloads the speech model. When all clips are done, the app moves on to page 2. Script by itself after about a second. See Import an Event and transcribe the clips.
Step 2: import the script
If the app has not moved on, click Continue to Script. On page 2. Script, drop your screenplay PDF on the Script Input tile and select the scenes that you shot. See Import and edit the screenplay.
Step 3: match
Click Continue to Match Captions, then Start Matching on page 3. Matching. Look at the results, and fix lines without a caption. See Match the script and check the result.
Step 4: review and export
Click Continue to Keywords. On page 4. Keywords you see one clip at a time and can move, trim, replace and add keywords. When you are done, choose Export to Final Cut Pro… in the File menu and click Send to FCP, or Export FCPXML… to save a file. See Edit keywords on the timeline and Export keywords to Final Cut Pro.
Import and edit the screenplay
Import the screenplay PDF
Open page 2. Script. In the Script Input tile, drop your screenplay PDF on the drop zone, or click Choose... and pick the file. Only PDF files are accepted. No other screenplay format can be imported. The Transfer Script menu described below only reads files that SyncScript Pro itself wrote.
The PDF needs a text layer. The app has no text recognition (OCR): a scanned PDF without text produces no script lines.
Choose the scenes to work with
If the PDF contains more than one scene, the app lists the scenes it found and waits for your selection. Scene chips (All and one per scene, labeled like "Sz 42") appear for scenes that were detected from the clips of the imported Event and are also in the script. The Add scene: picker lists the other scenes found in the PDF. Review Clips opens the Scene Check window, which lists every clip with its scene. Every change of the scene selection parses the PDF again. Your own edits are carried over.
If you already imported a Final Cut Pro Event that carries scene metadata, the matching scenes are selected and parsed automatically.
What the parser recognizes
The parser reads the PDF text and builds one script line for every block of dialogue:
- Scene headings are recognized when a line starts with
INNEN, AUSSEN, INT., EXT., INT/ or I/E, in capital letters.
- Scene numbers are taken from the numbers printed in the margin of the screenplay. A number only counts when a scene heading of the kinds above follows it. Lines before the first numbered scene get no scene number.
- A character cue is a line in capital letters of 2 to 30 characters. Narrator cues such as
ERZÄHLER or NARRATOR are not imported, and a line that contains " und " or " & " is not treated as a cue.
- The separation of dialogue from stage directions is a heuristic tuned for screenplays in German.
Edit the script lines
Script lines appear in the Script Lines panel. Two views are available: Block Editor (the default) and Classic List. The choice is remembered.
In the Block Editor, click into a character name or dialogue to edit it. Drag a line to reorder it within its scene. Press Return in the middle of a line to split it. Your edits are staged: click Apply to commit them or Discard to drop them. Switching to Classic List applies staged edits automatically.
In the Classic List, click a line twice to edit it. Tick two or more lines with the selection buttons for merging, then click Merge to join them into one line.
Add a scene the PDF import missed
The Scene Selection tile appears once the PDF yielded scenes. In it, click Add Scene Manually. Enter the scene number (for example 42 or 62A) and, optionally, paste the scene text: character names in capital letters on their own line, dialogue below. The scene heading and stage directions are skipped. Click Add Scene.
Add one scene at a time. A scene that is already in the script, or that the PDF import found, is refused with a message in the sheet. So is pasted text that contains more than one scene. Deselecting the scene later removes its lines again, and Cmd+Z brings them back.
Move an edited script to another session
Use the Transfer Script menu above the script lines. Copy Script and Paste Script… move the lines between sessions through the system clipboard, so copying something else in between replaces them. Export Script… and Import Script… write and read a .syncscriptlines file. After a paste or an import, a sheet lets you choose which scenes to take.
Import an Event and transcribe the clips
Before you start
SyncScript Pro reads an exported Final Cut Pro Event file. It does not read a live Final Cut Pro library. Sync your clips in Final Cut Pro first, as sync clips and/or multicam clips, and export a single Event as FCPXML.
The source media of the clips must be reachable on disk.
Import the Event
Open page 1. Transcribe. In the Import tile, drop the Event file on the drop zone or click Choose File.... The picker accepts .fcpxml, .fcpxmld bundles and packages. Dropping a Final Cut Pro library (.fcpbundle) does nothing. Export a single Event instead.
Only the first Event in the file is imported. The tile shows the file name and a clip count. The count can differ from the number of clips that are transcribed, because only the first Event is imported. If the app finds no usable clips, it tells you to load an Event with sync clips and/or multicam clips.
Importing a new Event clears the transcription, captions and matches of the current session.
Choose the language
In the Transcribe tile, set Language:. The default is English, and the choice is remembered across launches and per session. The list contains 25 European languages.
The speech model itself is not given the language setting. The language is part of the transcript cache key, so changing it means the clips are transcribed again, and it is used as a hint when matching. Chinese, Japanese and Korean are not available.
Transcribe the clips
Click Transcribe Clips. The engine is Parakeet v3 and is chosen automatically. Each take is transcribed once from its own source audio on your Mac. The captions are shifted to every camera angle and the multicam clip of that take. Clips without an audio track are skipped, and so are conform variants of a clip that contain only picture.
The first run downloads the speech model (about 1.5 GB) and needs an internet connection. The button reads Loading speech model… while it loads.
While the run is active the button shows the progress, and Cancel stops it. Clips that are already transcribed stay in the cache, so a later run resumes quickly.
Before transcribing, the app checks that the source files can be reached. If files are unreachable (for example a disk that is not mounted), the run stops with a message that starts with the number of unreachable files and lists up to five file names. Mount the volume and run Transcribe Clips again.
Transcribe again from the source
After a run, Re-Transcribe from Source transcribes all clips again instead of reusing the cached results. Use it after updating the app. It takes as long as the first run. A confirmation dialog asks first.
When the run is done
A green badge reports "Transcription complete" with the number of captions. When all clips succeeded and you are still on page 1. Transcribe, the app moves on to page 2. Script by itself after about a second. If it does not, click Continue to Script.
If some clips failed, the badge is orange, the failed clips are named in a red message, and the app does not advance on its own.
Match the script and check the result
Start matching
Open page 3. Matching and click Start Matching. Matching does not start by itself. The page first shows whether script lines and captions are loaded.
Each script line is matched against the captions of the clips. Scenes are respected: a line is matched against the clips of its own scene, and a clip without scene metadata can match any selected line. Only lines that are switched on and have no variant suffix are matched.
Read the results
The list on the left shows one row per active script line (lines that are switched off, and lines with a variant suffix, have no row): a colored dot, the line number, the character, the dialogue and a similarity percentage. A line without a match shows two dashes instead of a percentage, and a line with several matches shows a count badge. The status labels are Exact Match, Close Match, Minor Difference, Major Difference, No Match, Non-Dialogue and LLM Filled. LLM Filled appears only with the optional local LLM check described below.
Select a row to see the matching captions, the clip name with timecode and the best similarity score in the Details tile.
Fix a line that found no caption
Select a line that has no match and click Assign Caption Manually, then pick one of the unmatched captions in the sheet Assign Caption to Keyword. A manual assignment counts as an exact match. To drop a wrong match, remove the caption with the red x in the details.
Check which clips landed in which scene
On page 2. Script, click Review Clips in the Scene Selection tile. The floating window Scene Check lists every detected clip with its scene, and flags clips without scene metadata and scenes that are not in the script. From there you can add a missing scene manually.
Use the lines of one scene for the clips of another
Sometimes clips are labeled with a scene number that shares its setup with another scene. In the Block Editor, click the scene tab of the script scene with the right mouse button and choose Also Use for Clips of Scene…. Enter the scene numbers of the clips, separated by commas. A number such as 62 covers all clips of that scene. With a letter such as 62A, only that scene's clips are covered.
A plain number is used by the manual tools of the timeline. Only a lettered scene such as 62A changes which script lines automatic matching uses for those clips.
To undo this, click the tab with the right mouse button and choose Stop Using for Clips of followed by the scene.
Aliases are saved with the session. They are not part of an exported script file.
Match again
When results exist, the header shows a Re-Match Clip button (it reads Re-Match when it is not limited to one clip). It matches again the clip that is open in the timeline editor. Its menu offers Re-Match All Clips. If you edited the timeline in that scope, the app asks first. Manual keyword edits are discarded. Additional titles and crew talk regions are kept.
Optional: local LLM check
In Settings, tab LLM, Enable LLM Matching lets a local Ollama model verify matches and drop captions it rejects. It is off by default and is switched off again at every launch. You must install and start Ollama yourself and pull the model. The app does not do that. It runs only when matching the whole session, not for Re-Match Clip.
Edit keywords on the timeline
The timeline at a glance
Page 4. Keywords shows one clip at a time: the video, a transport bar and four lanes. From top to bottom the lanes are the ruler with the Action Cut range, the lane for additional titles, the main lane with the waveform, keyword blocks and DISCARD blocks, and the captions lane.
Use the chevrons in the transport bar or Option+Left / Option+Right to move to the previous or next clip.
Move and trim keywords
Drag a keyword block to move it. Drag an edge to trim it. Hold Option while dragging to duplicate it. Hold Cmd when you start dragging on empty space or on a keyword block to create a new keyword region instead; hold Cmd and Option to create a DISCARD region.
Magnetic snapping is on by default; toggle it with N. Pressing Cmd after you have started moving or trimming a block turns it off for the rest of that drag. Blocks snap to the playhead, to the edges of keyword, DISCARD and title blocks, to caption edges and to detected speech onsets. The onsets are not drawn on the timeline.
Shift blocks together (magnetic ripple)
Hold Shift, and no other modifier, when you start the drag. When you move a block, it and everything after it in the same lane travel together. When you trim the end of a block, its end and everything after it travel; when you trim the start, the rest of the block and everything after it shift. This works separately for the keyword lane and the title lane.
Set the Action Cut
Drag on an empty part of the ruler to set the range, or drag the green In and red Out markers. Dragging only moves the range. To also cut away what lies outside, press I and O at the playhead, or choose Set In Point and Set Out Point in the context menu: everything left of In and right of Out becomes DISCARD, as long as the point is more than 0.3 seconds from the clip edge. Keyword blocks inside the new DISCARD region are removed or shortened. Clear In/Out in the context menu of an empty spot removes the two points but keeps the DISCARD blocks.
Add additional titles
Drag horizontally on the empty title lane, then pick an existing title or a script keyword, or type a new title and click OK. Without text the label is Additional Title.
To add a title at the playhead, press T and choose from the list. Click a title twice to rename it. The context menu offers Rename, Copy, Replace with Existing Title, Convert to Keyword... and Remove.
Additional titles are exported as ordinary keyword markers, not as Final Cut Pro titles, as long as Include Additional-Title Keywords is on in the export sheet.
Replace a keyword
Click a keyword block with the right mouse button, or place the playhead on it and press R. The dialog Replace with Existing Keyword lists the other keywords of all scenes, grouped by scene; filter by number, character or dialogue, move with the arrow keys and press Return.
Mark a clip group as done
Click the checkmark in the transport bar, or press Cmd+D. In a group marked as done, edits on the timeline are refused with a message; uncheck it to change it again. Selecting and copying still work, and matching again can still overwrite a done group.
Export keywords to Final Cut Pro
What the export contains
The export writes keywords only. It saves your imported Event again, with keyword markers on the browser clips you worked on, and on clips that share a take with them: one marker per dialogue line, plus optional markers for additional titles and the Action Cut. Dialogue inside DISCARD regions is not exported. It does not create Final Cut Pro titles, captions or a timeline, and projects in the Event are left out. Additional titles are written as ordinary keyword markers.
The result is a new Event named like the source Event with " - SyncScript Pro" appended, so it does not merge into your original Event.
Open the export sheet
On page 4. Keywords, choose Export to Final Cut Pro… in the File menu (Cmd+E) or click Export to FCP in the bar below. The command is available once matching results exist and the timeline editor is open.
Choose what to export
- All Clips exports every clip. Selected Clip Groups Only exports only the groups you pick with Choose Groups…; the other clips are not written to the file at all. By default the groups marked as done are selected. This choice is shown when your clips form groups.
- Include Additional-Title Keywords adds one marker per additional title. It is on by default.
- Include Action Cut Keyword adds a marker named Action Cut for each kept range. It is on by default.
- Mark Outside Action Cut as Rejected sets a Rejected rating on every region outside the Action Cut. It is off by default.
- Keyword Handles extend dialogue keywords, and the Action Cut and Rejected ranges, by the given number of frames at the start and end. The preset buttons are 0f, 12f, 24f and 48f and set both values. Keywords for additional titles get no handles.
Save your toggles and handles with Presets. Defaults for new exports are in Settings, tab Export.
Send to Final Cut Pro
Click Send to FCP. The app writes a temporary FCPXML file and opens it with Final Cut Pro. Final Cut Pro then asks which library to import into. Complete that dialog, then check the Keywords field in the Info Inspector.
The app reports success when the handoff happened, not when the import in Final Cut Pro has finished. Final Cut Pro must be installed.
Save the FCPXML as a file
Click Export FCPXML… instead to choose where the file is saved, for example to send it to someone. While a session is open, every export also writes a diagnostics copy into the session folder (or the diagnostics folder you chose), and a copy into the Default export location if you set one in Settings.
How keywords are written
A dialogue keyword reads like 001 CHARACTER dialogue. Commas are replaced by a character that looks similar, because Final Cut Pro keywords cannot contain commas; this is the setting Replace commas with alternative character, which is on by default. The case of character names follows Character name format: (uppercase by default). Both settings are in Settings, tab Parsing.
Sessions and keyboard shortcuts
Save and reopen your work
Your work lives in sessions. Choose Save Session in the File menu (Cmd+S) to save. Once the session contains script lines, the app also saves it automatically every five seconds while it is active, and the most recent session is reopened at launch.
To reopen another session, click it in the session list in the sidebar. There is no separate open command. The sidebar buttons create a new session, save the current one and import a session from a file. In the context menu of a session you can rename, export or delete it.
Move a session to another Mac
Choose Export Current Session… in the File menu. A session is a folder with the extension .syncscript. It does not contain your media; it stores the paths of the source files, so they must be reachable on the other Mac. Import it with the import button in the session sidebar; the import always creates a new session and opens it.
Start a new session
The dialog for a new session offers New (blank) and New (keep Script). The second keeps the loaded screenplay PDF and its scene list, but the script lines are cleared; parse them again on page 2. Script. Both start an empty session on page 1. Transcribe.
Change a keyboard shortcut
Open Settings and choose the Shortcuts tab. Click the key field of an action, press the new combination and the shortcut is set; Esc cancels. The trash button clears a shortcut. If a combination is already used, the app asks before rebinding it. Reset all to defaults restores the factory shortcuts after a confirmation.
Export… saves your shortcuts as a JSON file. Import… merges a file into your shortcuts; actions that the file does not mention go back to their default.
Some gestures are fixed and cannot be rebound: J, K and L for shuttle, the number keys to assign keywords, Cmd+Z and Cmd+Shift+Z for undo and redo.
Reference
Requirements and limits
- macOS 15.0 or later. The released app is built for Apple Silicon only.
- Final Cut Pro is required to use the result. The app reads and writes FCPXML.
- The screenplay must be a PDF with a text layer. The app has no OCR and imports no other screenplay format.
- The Event must be an exported
.fcpxml or .fcpxmld file (or an Event dragged from Final Cut Pro) with sync clips and/or multicam clips. Only the first Event of a file is imported.
- Transcription uses Parakeet v3 with 25 European languages. Chinese, Japanese and Korean are not available.
- The export contains keywords only: no Final Cut Pro titles, no captions, no timeline.
Pages
- 1. Transcribe: import the Event and transcribe the clips.
- 2. Script: import the screenplay PDF, select scenes, edit script lines.
- 3. Matching: match script lines to captions and check the result.
- 4. Keywords: timeline editor and export.
- Check for Updates… in the app menu checks for a new version. The app also checks automatically once a day.
- Buy SyncScript Pro in the app menu opens the product page in the browser. It is shown until a paid or complimentary license is active.
- Reset Everything... in the File menu (Shift+Cmd+R) clears the transcription, the script and keywords, and the matches and titles after a confirmation. It cannot be undone.
- Export to Final Cut Pro… in the File menu (Cmd+E) opens the export sheet. It is available on page 4. Keywords once matching results exist.
- Save Session in the File menu (Cmd+S) saves the current session.
- Export Current Session… in the File menu writes the session as a
.syncscript folder.
- Send Feedback… in the Help menu opens the feedback sheet.
Settings
Open Settings with Cmd+comma. The tabs are Parsing, Display, Export, LLM, License, Shortcuts and About. A General tab (with Auto-advance to next phase) is shown only in Developer Mode, and an Advanced tab only while you hold Option; automatic advancing after transcription is on by default. The setting Auto-label FCPX rejects as Discard sits in the section FCP Import of the Parsing tab.
- Replace commas with alternative character: on by default. Final Cut Pro keywords cannot contain commas; this replaces them with a character that looks similar when you export.
- Character name format: UPPERCASE by default. Options: UPPERCASE, Title Case, As-is. Applied on export.
- Trim whitespace from dialogue: on by default. Applied when the script is parsed.
- Auto-label FCPX rejects as Discard: off by default. Applies to clips that are matched afterwards.
- Default export location: empty by default. When set, every export also writes a copy to this folder.
- Include timestamp in filename: on by default. Applies to that copy.
- Include Additional-Title Keywords: on by default. Start value of the export sheet.
- Include Action Cut Keyword: on by default. Start value of the export sheet.
- Mark Outside Action Cut as Rejected: off by default. Start value of the export sheet.
- Start Handle: and End Handle: 0 frames by default. Start values of the export sheet.
- Enable LLM Matching: off by default, and off again after every launch. See Match the script and check the result.
Keyboard shortcuts (defaults)
All of the following can be rebound in Settings, tab Shortcuts, except the fixed gestures in the last item.
- Playback: Space plays and pauses. Left and Right arrows step one frame; Shift with the arrows steps by 24 frames. Option with the arrows jumps to the previous or next clip. Up and Down jump to the previous or next edit point. Tab and Shift+Tab jump to the next or previous caption.
- Marking: I sets the In point, O sets the Out point. Return opens the keyword popup. Delete removes the selected keyword. Esc deselects. T inserts an existing additional title at the playhead. R opens the picker to replace the keyword at the playhead. C toggles Discard at the playhead.
- Zoom and view: plus and minus zoom, Shift+Z zooms to fit, N toggles magnetic snapping, S toggles skimming.
- Session: Cmd+S saves, Cmd+D marks the current clip group as done, Cmd+B splits the block at the playhead, Cmd+C and Cmd+V copy and paste.
- Fixed gestures: J, K and L shuttle; the number keys assign keywords 1 to 10 (with Shift: 11 to 20), acting on the selected caption; Cmd+Z and Cmd+Shift+Z undo and redo. These cannot be rebound.
Files the app creates
- Sessions:
~/Library/Application Support/SyncScript Pro/Sessions/<id>.syncscript.
- Speech models: in the Application Support folder of your user Library.
- Transcript cache:
~/Library/Application Support/SyncScriptPro/TranscriptCache.
- Export presets:
~/Library/Application Support/SyncScript Pro/export-presets.json.
- Shortcuts:
~/Library/Application Support/SyncScript Pro/keyboard-bindings.json.
- Script files you export:
.syncscriptlines.
Network use
Transcription, matching and editing run on your Mac. The app contacts these hosts:
api.malibureview.app for the license check (when the main window appears, then daily; it sends a device hash, the app version and your email address), for redeeming or deactivating a license key, for update checks and for feedback you send.huggingface.co, to download the speech models on first use.localhost:11434 only if you enable the local LLM.
Feedback and diagnostics are sent only when you click the send button; if sending fails, the report is kept and sent automatically later. Buying a license, the license portal and the legal pages open in your browser.
Troubleshooting
No clips are found after importing the Event
The app reports "No synced clips found in the Event" when it finds no clips it can import in the file. Sync your clips in Final Cut Pro first, as sync clips and/or multicam clips. Dropping a Final Cut Pro library (.fcpbundle) does nothing.
Export a single Event as FCPXML and drop that file instead.
The source files of some clips cannot be reached, usually because a disk is not mounted. The message names the volumes and up to five file names. Mount the volume and click Transcribe Clips again; finished clips are not transcribed again.
The speech model does not load
The first run downloads the speech models (about 1.5 GB for the main model) and needs an internet connection and enough free disk space. A failure is shown in a red message that starts with "Failed to load transcription models" and gives the reason. Connect to the internet, free up disk space and click Transcribe Clips again.
Some clips failed to transcribe
The result badge turns orange and reads "Transcription incomplete" with the number of failed clips. A red message names up to five of the failed clips and the reason, and the app does not move on to page 2. Script. Click Transcribe Clips again to retry.
The script shows no lines after importing the PDF
First check the status text. If it reads "PDF loaded: N scenes found. Select scenes and click Parse.", no scene is selected yet: pick scenes with the chips or the Add scene: picker.
If it reads "Parsed 0 script lines from PDF", the usual cause is a PDF without a text layer, such as a scan. The app has no text recognition. Use a PDF exported from your screenwriting software.
Also check the scene headings: the parser recognizes headings that start with INNEN, AUSSEN, INT., EXT., INT/ or I/E in capital letters. For a scene that was not found, use Add Scene Manually.
A character's lines are missing
Narrator cues (ERZÄHLER, NARRATOR) and words such as ENDE, FADE or CUT are not recognized as characters, and neither are cues that contain " und " or " & ". The text below such a cue is not imported under its own name and may end up in the dialogue of the previous speaker. Check these lines and fix them by hand in the Block Editor or the Classic List.
Keywords would land in the wrong place
An orange warning says the captions come from an older version with a bug in the sound sync. This appears for sessions that were saved with an older build. Click Transcribe Clips again, run matching again and then export.
Export to Final Cut Pro is greyed out
The command is available only on page 4. Keywords, after matching results exist and with the timeline editor open. In the export sheet both buttons are disabled while an export runs, when there is no result, or when Selected Clip Groups Only is chosen and no group is selected.
Send to FCP shows no error but nothing appears
The app reports the handoff, not the import. Final Cut Pro asks which library to import into; complete that dialog. The keywords are on the clips of a new Event named like your source Event with " - SyncScript Pro" appended. If Final Cut Pro is not installed, the export fails with an error.
The export reports "No source event"
The message says to import your Event on the Transcribe page first. It appears when the session holds no imported Event. Import the Event again on page 1. Transcribe, click Transcribe Clips (clips that are already transcribed come from the cache) and run matching again.
The app is blocked after the trial or shows a license message
On first launch the app asks for your email address before anything else; see Getting started.
The blocked screen shows the reason in plain words, for example that the trial period has ended, that the license has expired or has been revoked, that this version is no longer supported, or that the app has been offline too long. From there you can buy a license, check again, redeem a license key with I already have a license, or quit.
If the message says the license could not be verified yet, connect to the internet once and click Check Again. A short loss of connection alone does not block the app.
Send a problem report
Choose Send Feedback… in the Help menu. The sheet asks five short questions: 1. Goal, 2. Location, 3. Action, 4. Expectation and 5. Result. Answer at least one, ideally all five, in a few words each. Below them you can pick a severity: Showstopper, Bug, UI/Cosmetic, Feature Request or Question. Click the selected one again to clear it. Then click Send Feedback. The report includes your macOS account name, the app and macOS version, counts of keywords and captions, the engine, audio and video file names, the selected scenes and the session ID. The email field is prefilled with the address you entered at first launch and is sent unless you clear it. A screenshot is added only if you switch it on. If you are offline, the report is saved and sent later.
The Diagnostics button in the sidebar shows whether the script and match baselines were saved and which export is the latest. Send Diagnostics Ticket sends the two baselines and the latest export with its manifest. These files contain script dialogue, clip names and media references.
Written for version 1.2.86.
Erste Schritte
Was SyncScript Pro macht
SyncScript Pro ordnet die Dialoge deines Drehbuchs den gesprochenen Worten deiner Clips in Final Cut Pro zu. Die App transkribiert auf deinem Mac jeden Clip eines exportierten Events, gleicht die Transkripte mit den Skriptzeilen ab und bereitet das Ergebnis als Keywords an den Clips vor. Das Ergebnis prüfst und korrigierst du vor dem Export auf einer kleinen Timeline. In Final Cut Pro wird nichts verändert, bevor du das Ergebnis exportierst und sendest. SyncScript Pro verschlagwortet dein Material nicht vollautomatisch und soll es auch nicht. Der Abgleich liefert Vorschläge, und ein Assistent prüft und korrigiert jedes Ergebnis auf der Timeline, bevor es nach Final Cut Pro geht. Die App gibt dem Assistenten ein Werkzeug an die Hand, mit dem er dasselbe geprüfte Ergebnis in etwa der halben Zeit erreicht. Einen schnelleren Weg kennen wir nicht, und nur ein von einem Menschen geprüftes Ergebnis taugt für den Schnitt.
Wie viele Zeilen gefunden werden, hängt vom Material ab. Eine Szene mit improvisiertem oder unklarem Dialog passt weniger gut, das ist zu erwarten. Die Lücken schließt du von Hand, das ist trotzdem viel schneller, als alles manuell zu machen.
Bevor du anfängst
Du brauchst einen Mac mit Apple Silicon und macOS 15 oder neuer sowie Final Cut Pro. Die veröffentlichte App wird nur für Apple Silicon gebaut. Dein Skript muss ein PDF mit Textebene sein. Deine Clips müssen in einem Event in Final Cut Pro liegen, als synchronisierte Clips und/oder als Clips vom Typ Multicam.
Die App prüft deine Lizenz über das Internet, und die erste Transkription lädt das Sprachmodell herunter (etwa 1,5 GB). Ein kurzer Verbindungsabbruch blockiert die App nicht.
Erster Start
Beim ersten Start fragt die App nach deiner Mailadresse. Gib sie ein und klicke auf Continue. Die Schaltfläche bleibt deaktiviert, bis die Adresse gültig aussieht. Du kannst diesen Schritt nicht überspringen. Die Adresse wird mit der Lizenzprüfung gesendet, damit der Support deine Testphase finden und verlängern kann.
Schritt 1: Event importieren und transkribieren
Exportiere ein einzelnes Event aus Final Cut Pro als FCPXML. Ziehe die Datei auf Seite 1. Transcribe auf die Kachel Import. Klicke auf Transcribe Clips. Beim ersten Durchlauf wird das Sprachmodell heruntergeladen. Sobald alle Clips fertig sind, wechselt die App nach etwa einer Sekunde von selbst zu Seite 2. Script. Siehe Event importieren und die Clips transkribieren.
Schritt 2: Skript importieren
Wenn die App nicht weitergewechselt ist, klicke auf Continue to Script. Ziehe auf Seite 2. Script dein Drehbuch als PDF auf die Kachel Script Input und wähle die Szenen aus, die du gedreht hast. Siehe Drehbuch importieren und bearbeiten.
Schritt 3: Abgleichen
Klicke auf Continue to Match Captions und danach auf Seite 3. Matching auf Start Matching. Sieh dir die Ergebnisse an und korrigiere Zeilen ohne Caption. Siehe Skript abgleichen und das Ergebnis prüfen.
Schritt 4: Prüfen und exportieren
Klicke auf Continue to Keywords. Auf Seite 4. Keywords siehst du jeweils einen Clip und kannst Keywords verschieben, kürzen, ersetzen und hinzufügen. Wenn du fertig bist, wähle im Menü „File“ den Befehl Export to Final Cut Pro… und klicke auf Send to FCP, oder wähle Export FCPXML…, um eine Datei zu speichern. Siehe Keywords auf der Timeline bearbeiten und Keywords nach Final Cut Pro exportieren.
Drehbuch importieren und bearbeiten
Drehbuch als PDF importieren
Öffne Seite 2. Script. Ziehe in der Kachel Script Input dein Drehbuch als PDF auf die Ablagefläche oder klicke auf Choose... und wähle die Datei aus. Die App akzeptiert nur PDFs. Kein anderes Drehbuchformat lässt sich importieren. Das unten beschriebene Menü Transfer Script liest nur Dateien, die SyncScript Pro selbst geschrieben hat.
Das PDF braucht eine Textebene. Die App hat keine Texterkennung (OCR): Ein gescanntes PDF ohne Text ergibt keine Skriptzeilen.
Szenen zum Arbeiten auswählen
Enthält das PDF mehr als eine Szene, listet die App die gefundenen Szenen auf und wartet auf deine Auswahl. Szenenchips (All und einer pro Szene, beschriftet wie „Sz 42“) erscheinen für Szenen, die aus den Clips des importierten Events erkannt wurden und auch im Skript stehen. Das Auswahlfeld Add scene: listet die übrigen im PDF gefundenen Szenen. Review Clips öffnet das Fenster Scene Check, das jeden Clip mit seiner Szene auflistet. Jede Änderung der Szenenauswahl liest das PDF erneut ein. Deine eigenen Änderungen bleiben dabei erhalten.
Hast du bereits ein Event aus Final Cut Pro importiert, das Szenenmetadaten enthält, werden die passenden Szenen automatisch ausgewählt und eingelesen.
Was der Parser erkennt
Der Parser liest den Text aus dem PDF und erzeugt für jeden Dialogblock eine Skriptzeile:
- Szenenüberschriften werden erkannt, wenn eine Zeile in Großbuchstaben mit
INNEN, AUSSEN, INT., EXT., INT/ oder I/E beginnt.
- Szenennummern stammen aus den Nummern, die am Rand des Drehbuchs stehen. Eine Nummer zählt nur, wenn danach eine Szenenüberschrift der genannten Art folgt. Zeilen vor der ersten nummerierten Szene bekommen keine Szenennummer.
- Eine Figurenzeile (Character Cue) ist eine Zeile in Großbuchstaben mit 2 bis 30 Zeichen. Erzählerzeilen wie
ERZÄHLER oder NARRATOR werden nicht importiert, und eine Zeile, die " und " oder " & " enthält, wird nicht als Figurenzeile behandelt.
- Die Trennung von Dialog und Regieanweisungen ist eine Heuristik, die auf deutschsprachige Drehbücher abgestimmt ist.
Skriptzeilen bearbeiten
Die Skriptzeilen erscheinen im Bereich Script Lines. Es gibt zwei Ansichten: Block Editor (Standard) und Classic List. Deine Wahl wird gespeichert.
Klicke im Block Editor direkt in einen Figurennamen oder Dialog, um ihn zu bearbeiten. Ziehe eine Zeile, um sie innerhalb ihrer Szene umzusortieren. Drücke die Eingabetaste mitten in einer Zeile, um sie zu teilen. Deine Änderungen werden zunächst vorgemerkt: Klicke auf Apply, um sie zu übernehmen, oder auf Discard, um sie zu verwerfen. Beim Wechsel zu Classic List werden vorgemerkte Änderungen automatisch übernommen.
In der Classic List bearbeitest du eine Zeile per Doppelklick. Hake zwei oder mehr Zeilen mit den Auswahlschaltflächen zum Zusammenführen an und klicke dann auf Merge, um sie zu einer Zeile zu verbinden.
Eine Szene ergänzen, die beim Import des PDFs übersehen wurde
Die Kachel Scene Selection erscheint, sobald das PDF Szenen geliefert hat. Klicke darin auf Add Scene Manually. Gib die Szenennummer ein (zum Beispiel 42 oder 62A) und füge optional den Szenentext ein: Figurennamen in Großbuchstaben in einer eigenen Zeile, darunter der Dialog. Die Szenenüberschrift und Regieanweisungen werden übersprungen. Klicke auf Add Scene.
Ergänze jeweils eine Szene. Eine Szene, die schon im Skript steht oder die beim Import des PDFs gefunden wurde, wird mit einer Meldung im Dialogfenster abgelehnt. Das gilt auch für eingefügten Text, der mehr als eine Szene enthält. Wählst du die Szene später ab, werden ihre Zeilen wieder entfernt, und mit Cmd+Z kommen sie zurück.
Ein bearbeitetes Skript in eine andere Session übertragen
Nutze das Menü Transfer Script über den Skriptzeilen. Copy Script und Paste Script… übertragen die Zeilen über die Systemzwischenablage zwischen Sessions. Kopierst du dazwischen etwas anderes, werden sie ersetzt. Export Script… und Import Script… schreiben und lesen eine Datei mit der Endung .syncscriptlines. Nach dem Einfügen oder Importieren kannst du in einem Dialogfenster wählen, welche Szenen übernommen werden.
Event importieren und die Clips transkribieren
Bevor du anfängst
SyncScript Pro liest die Datei eines Events, das du aus Final Cut Pro exportiert hast. Eine laufende Mediathek in Final Cut Pro liest es nicht. Synchronisiere deine Clips zuerst in Final Cut Pro, als synchronisierte Clips und/oder als Clips vom Typ Multicam, und exportiere ein einzelnes Event als FCPXML.
Die Quellmedien der Clips müssen auf der Festplatte erreichbar sein.
Event importieren
Öffne Seite 1. Transcribe. Ziehe in der Kachel Import die Datei des Events auf die Ablagefläche oder klicke auf Choose File.... Die Dateiauswahl akzeptiert .fcpxml, Bundles mit der Endung .fcpxmld und Pakete. Ziehst du eine Mediathek aus Final Cut Pro (.fcpbundle) auf die Fläche, passiert nichts. Exportiere stattdessen ein einzelnes Event.
Es wird nur das erste Event der Datei importiert. Die Kachel zeigt den Dateinamen und eine Clipanzahl. Die Anzahl kann von der Zahl der transkribierten Clips abweichen, weil nur das erste Event importiert wird. Findet die App keine verwendbaren Clips, fordert sie dich auf, ein Event mit synchronisierten Clips und/oder Multicam zu laden.
Wenn du ein neues Event importierst, werden Transkription, Captions und Matches der aktuellen Session gelöscht.
Sprache wählen
Stelle in der Kachel Transcribe den Wert Language: ein. Standard ist Englisch. Die Wahl wird über Programmstarts hinweg und pro Session gespeichert. Die Liste enthält 25 europäische Sprachen.
Das Sprachmodell selbst bekommt die Spracheinstellung nicht. Die Sprache ist Teil des Schlüssels für den Transkriptcache. Eine Änderung führt also dazu, dass die Clips erneut transkribiert werden. Beim Abgleich dient sie als Hinweis. Chinesisch, Japanisch und Koreanisch stehen nicht zur Verfügung.
Clips transkribieren
Klicke auf Transcribe Clips. Die Engine ist Parakeet v3 und wird automatisch gewählt. Jeder Take wird einmal aus seinem eigenen Quellaudio auf deinem Mac transkribiert. Die Captions werden auf jeden Kamerawinkel und auf den Clip vom Typ Multicam dieses Takes übertragen. Clips ohne Audiospur werden übersprungen, ebenso Varianten eines Clips für das Conform, die nur Bild enthalten.
Beim ersten Durchlauf wird das Sprachmodell heruntergeladen (etwa 1,5 GB). Dafür brauchst du eine Internetverbindung. Während des Ladens steht auf der Schaltfläche Loading speech model….
Solange der Durchlauf aktiv ist, zeigt die Schaltfläche den Fortschritt, und Cancel bricht ihn ab. Bereits transkribierte Clips bleiben im Cache. Ein späterer Durchlauf macht also schnell dort weiter.
Fehlende Medien
Vor dem Transkribieren prüft die App, ob die Quelldateien erreichbar sind. Sind Dateien nicht erreichbar (zum Beispiel weil ein Laufwerk nicht eingebunden ist), bricht der Durchlauf mit einer Meldung ab, die mit der Anzahl der nicht erreichbaren Dateien beginnt und bis zu fünf Dateinamen auflistet. Binde das Volume ein und starte Transcribe Clips erneut.
Erneut aus der Quelle transkribieren
Nach einem Durchlauf transkribiert Re-Transcribe from Source alle Clips noch einmal, statt die zwischengespeicherten Ergebnisse wiederzuverwenden. Nutze das nach einem Update der App. Es dauert so lange wie der erste Durchlauf. Vorher fragt ein Bestätigungsdialog nach.
Wenn der Durchlauf fertig ist
Ein grünes Abzeichen meldet „Transcription complete“ mit der Anzahl der Captions. Waren alle Clips erfolgreich und bist du noch auf Seite 1. Transcribe, wechselt die App nach etwa einer Sekunde von selbst zu Seite 2. Script. Tut sie das nicht, klicke auf Continue to Script.
Sind einzelne Clips fehlgeschlagen, ist das Abzeichen orange, die fehlgeschlagenen Clips werden in einer roten Meldung genannt, und die App wechselt nicht von selbst weiter.
Skript abgleichen und das Ergebnis prüfen
Abgleich starten
Öffne Seite 3. Matching und klicke auf Start Matching. Der Abgleich startet nicht von selbst. Die Seite zeigt zuerst, ob Skriptzeilen und Captions geladen sind.
Jede Skriptzeile wird mit den Captions der Clips abgeglichen. Szenen werden berücksichtigt: Eine Zeile wird mit den Clips ihrer eigenen Szene abgeglichen, und ein Clip ohne Szenenmetadaten kann zu jeder ausgewählten Zeile passen. Abgeglichen werden nur Zeilen, die eingeschaltet sind und kein Variantensuffix haben.
Ergebnisse lesen
Die Liste links zeigt eine Zeile pro aktiver Skriptzeile (ausgeschaltete Zeilen und Zeilen mit Variantensuffix haben keine Zeile): einen farbigen Punkt, die Zeilennummer, die Figur, den Dialog und einen Ähnlichkeitswert in Prozent. Eine Zeile ohne Treffer zeigt zwei Striche statt eines Prozentwerts, und eine Zeile mit mehreren Treffern zeigt ein Abzeichen mit der Anzahl. Die Statusbezeichnungen sind Exact Match, Close Match, Minor Difference, Major Difference, No Match, Non-Dialogue und LLM Filled. LLM Filled erscheint nur bei der unten beschriebenen optionalen Prüfung mit einem lokalen LLM.
Wähle eine Zeile aus, um in der Kachel Details die passenden Captions, den Namen des Clips mit Timecode und den besten Ähnlichkeitswert zu sehen.
Eine Zeile korrigieren, für die keine Caption gefunden wurde
Wähle eine Zeile ohne Treffer aus, klicke auf Assign Caption Manually und wähle im Fenster Assign Caption to Keyword eine der nicht zugeordneten Captions aus. Eine manuelle Zuordnung zählt als exakter Treffer. Um einen falschen Treffer zu entfernen, entferne die Caption in den Details mit dem roten x.
Prüfen, welche Clips in welcher Szene gelandet sind
Klicke auf Seite 2. Script in der Kachel Scene Selection auf Review Clips. Das schwebende Fenster Scene Check listet jeden erkannten Clip mit seiner Szene auf und markiert Clips ohne Szenenmetadaten sowie Szenen, die nicht im Skript stehen. Von dort aus kannst du eine fehlende Szene manuell ergänzen.
Die Zeilen einer Szene für die Clips einer anderen verwenden
Manchmal sind Clips mit einer Szenennummer beschriftet, die sich ihr Setup mit einer anderen Szene teilt. Klicke im Block Editor mit der rechten Maustaste auf den Szenentab der Skriptszene und wähle Also Use for Clips of Scene…. Gib die Szenennummern der Clips ein, durch Kommas getrennt. Eine Nummer wie 62 deckt alle Clips dieser Szene ab. Mit einem Buchstaben wie 62A werden nur die Clips genau dieser Szene abgedeckt.
Eine reine Nummer wird von den manuellen Werkzeugen der Timeline verwendet. Nur eine Szene mit Buchstaben wie 62A ändert, welche Skriptzeilen der automatische Abgleich für diese Clips verwendet.
Um das rückgängig zu machen, klicke mit der rechten Maustaste auf den Tab und wähle Stop Using for Clips of gefolgt von der Szene.
Aliase werden mit der Session gespeichert. Sie sind nicht Teil einer exportierten Skriptdatei.
Erneut abgleichen
Sobald Ergebnisse vorliegen, zeigt die Kopfzeile eine Schaltfläche Re-Match Clip (sie heißt Re-Match, wenn sie nicht auf einen Clip beschränkt ist). Sie gleicht den Clip, der im Editor der Timeline geöffnet ist, erneut ab. Ihr Menü bietet Re-Match All Clips. Hast du die Timeline in diesem Bereich bearbeitet, fragt die App zuerst nach. Manuelle Änderungen an Keywords werden verworfen, zusätzliche Titel und Bereiche für Crew Talk bleiben erhalten.
Optional: Prüfung mit einem lokalen LLM
In den Einstellungen, Tab LLM, lässt Enable LLM Matching ein lokales Modell in Ollama die Treffer gegenprüfen und Captions verwerfen, die es ablehnt. Die Funktion ist standardmäßig aus und wird bei jedem Start wieder ausgeschaltet. Ollama musst du selbst installieren und starten und das Modell selbst laden. Die App tut das nicht. Sie läuft nur beim Abgleich der ganzen Session, nicht bei Re-Match Clip.
Keywords auf der Timeline bearbeiten
Die Timeline im Überblick
Seite 4. Keywords zeigt jeweils einen Clip: das Video, eine Transportleiste und vier Spuren. Von oben nach unten sind das: das Lineal mit dem Bereich Action Cut, die Spur für zusätzliche Titel, die Hauptspur mit Wellenform, Keywordblöcken und Blöcken vom Typ DISCARD sowie die Spur mit den Captions.
Mit den Pfeilen in der Transportleiste oder mit Option+Left / Option+Right springst du zum vorherigen oder nächsten Clip.
Keywords verschieben und kürzen
Ziehe einen Keywordblock, um ihn zu verschieben. Ziehe an einer Kante, um ihn zu kürzen oder zu verlängern. Halte beim Ziehen Option gedrückt, um ihn zu duplizieren. Halte Cmd gedrückt, wenn du auf einer leeren Stelle oder auf einem Keywordblock zu ziehen beginnst, um stattdessen einen neuen Keywordbereich anzulegen; mit Cmd und Option legst du einen Bereich vom Typ DISCARD an.
Magnetisches Einrasten ist standardmäßig eingeschaltet; mit N schaltest du es um. Drückst du Cmd, nachdem du begonnen hast, einen Block zu verschieben oder zu kürzen, ist es für den Rest dieses Zugs ausgeschaltet. Blöcke rasten an der Abspielposition ein, an den Kanten von Keywordblöcken, von Blöcken vom Typ DISCARD und von Titelblöcken, an den Kanten der Captions und an erkannten Sprechbeginnen. Die Sprechbeginne werden auf der Timeline nicht angezeigt.
Blöcke gemeinsam verschieben (Magnetic Ripple)
Halte zu Beginn des Ziehens Shift gedrückt, aber keine andere Taste. Verschiebst du einen Block, wandern er und alles danach in derselben Spur gemeinsam. Kürzt du das Ende eines Blocks, wandern sein Ende und alles danach; kürzt du den Anfang, verschieben sich der Rest des Blocks und alles danach. Das gilt getrennt für die Keywordspur und die Titelspur.
Den Action Cut setzen
Ziehe auf einer leeren Stelle des Lineals, um den Bereich festzulegen, oder ziehe die grüne Markierung In und die rote Markierung Out. Beim Ziehen wird nur der Bereich verschoben. Um zusätzlich alles außerhalb wegzuschneiden, drücke I und O an der Abspielposition oder wähle im Kontextmenü Set In Point und Set Out Point: Alles links von In und rechts von Out wird zu DISCARD, sofern der Punkt mehr als 0,3 Sekunden vom Rand des Clips entfernt ist. Keywordblöcke im neuen Bereich DISCARD werden entfernt oder gekürzt. Clear In/Out im Kontextmenü einer leeren Stelle entfernt die beiden Punkte, behält aber die Blöcke vom Typ DISCARD.
Zusätzliche Titel hinzufügen
Ziehe horizontal auf der leeren Titelspur, wähle dann einen vorhandenen Titel oder ein Keyword aus dem Skript oder tippe einen neuen Titel und klicke auf OK. Ohne Text lautet die Bezeichnung Additional Title.
Um einen Titel an der Abspielposition hinzuzufügen, drücke T und wähle aus der Liste. Doppelklicke einen Titel, um ihn umzubenennen. Das Kontextmenü bietet Rename, Copy, Replace with Existing Title, Convert to Keyword... und Remove.
Zusätzliche Titel werden als gewöhnliche Keywordmarker exportiert, nicht als Titel von Final Cut Pro, solange Include Additional-Title Keywords im Exportblatt eingeschaltet ist.
Ein Keyword ersetzen
Klicke mit der rechten Maustaste auf einen Keywordblock oder setze die Abspielposition darauf und drücke R. Der Dialog Replace with Existing Keyword listet die übrigen Keywords aller Szenen, nach Szene gruppiert; filtere nach Nummer, Figur oder Dialog, bewege dich mit den Pfeiltasten und drücke Return.
Eine Gruppe von Clips als erledigt markieren
Klicke in der Transportleiste auf den Haken oder drücke Cmd+D. In einer als erledigt markierten Gruppe werden Änderungen auf der Timeline mit einer Meldung abgelehnt; nimm den Haken wieder heraus, um sie erneut zu ändern. Auswählen und Kopieren funktionieren weiterhin. Ein erneutes Matching kann eine erledigte Gruppe weiterhin überschreiben.
Keywords nach Final Cut Pro exportieren
Was der Export enthält
Der Export schreibt ausschließlich Keywords. Er speichert dein importiertes Event erneut, mit Keywordmarkern auf den Clips im Browser, die du bearbeitet hast, und auf Clips, die mit ihnen einen Take teilen: ein Marker pro Dialogzeile, dazu optionale Marker für zusätzliche Titel und den Action Cut. Dialog in Bereichen vom Typ DISCARD wird nicht exportiert. Es werden keine Titel von Final Cut Pro, keine Captions und keine Timeline erzeugt, und Projekte im Event bleiben außen vor. Zusätzliche Titel werden als gewöhnliche Keywordmarker geschrieben.
Das Ergebnis ist ein neues Event, benannt wie das Quellevent mit angehängtem " - SyncScript Pro". Es verschmilzt deshalb nicht mit deinem ursprünglichen Event.
Das Exportblatt öffnen
Wähle auf Seite 4. Keywords im Menü „File“ den Befehl Export to Final Cut Pro… (Cmd+E) oder klicke in der Leiste darunter auf Export to FCP. Der Befehl ist verfügbar, sobald Ergebnisse des Matchings vorliegen und der Editor der Timeline geöffnet ist.
Auswählen, was exportiert wird
- All Clips exportiert jeden Clip. Selected Clip Groups Only exportiert nur die Gruppen, die du mit Choose Groups… auswählst; die übrigen Clips werden gar nicht in die Datei geschrieben. Standardmäßig sind die als erledigt markierten Gruppen ausgewählt. Diese Auswahl erscheint, wenn deine Clips Gruppen bilden.
- Include Additional-Title Keywords fügt pro zusätzlichem Titel einen Marker hinzu. Standardmäßig ist es eingeschaltet.
- Include Action Cut Keyword fügt für jeden behaltenen Bereich einen Marker namens Action Cut hinzu. Standardmäßig ist es eingeschaltet.
- Mark Outside Action Cut as Rejected setzt für jeden Bereich außerhalb des Action Cut die Bewertung „Rejected“. Standardmäßig ist es ausgeschaltet.
- Keyword Handles verlängern Keywords für Dialog sowie die Bereiche Action Cut und Rejected am Anfang und am Ende um die angegebene Anzahl Frames. Die Schaltflächen für Voreinstellungen sind 0f, 12f, 24f und 48f und setzen beide Werte. Keywords für zusätzliche Titel erhalten keine Handles.
Sichere deine Schalter und Handles mit Presets. Die Standardwerte für neue Exporte findest du in den Einstellungen, Tab Export.
An Final Cut Pro senden
Klicke auf Send to FCP. Die App schreibt eine temporäre Datei im Format FCPXML und öffnet sie mit Final Cut Pro. Final Cut Pro fragt dann, in welche Mediathek importiert werden soll. Schließe diesen Dialog ab und prüfe danach das Feld „Keywords“ im Info-Inspektor.
Die App meldet Erfolg, wenn die Übergabe stattgefunden hat, nicht wenn der Import in Final Cut Pro abgeschlossen ist. Final Cut Pro muss installiert sein.
Das FCPXML als Datei sichern
Klicke stattdessen auf Export FCPXML…, um den Speicherort der Datei selbst zu wählen, zum Beispiel um sie an jemanden zu schicken. Solange eine Session geöffnet ist, schreibt jeder Export außerdem eine Diagnosekopie in den Ordner der Session (oder in den Diagnoseordner, den du gewählt hast) und, falls du in den Einstellungen einen Default export location festgelegt hast, eine Kopie dorthin.
So werden Keywords geschrieben
Ein Keyword für Dialog sieht aus wie 001 CHARACTER dialogue. Kommas werden durch ein ähnlich aussehendes Zeichen ersetzt, weil Keywords in Final Cut Pro keine Kommas enthalten dürfen; das ist die Einstellung Replace commas with alternative character, die standardmäßig eingeschaltet ist. Die Groß- und Kleinschreibung der Figurennamen richtet sich nach Character name format: (standardmäßig Großbuchstaben). Beide Einstellungen findest du in den Einstellungen, Tab Parsing.
Sessions und Tastenkürzel
Arbeit sichern und wieder öffnen
Deine Arbeit liegt in Sessions. Wähle im Menü „File“ den Befehl Save Session (Cmd+S), um zu sichern. Sobald die Session Skriptzeilen enthält, sichert die App sie außerdem automatisch alle fünf Sekunden, solange sie aktiv ist, und die zuletzt verwendete Session wird beim Start wieder geöffnet.
Um eine andere Session zu öffnen, klicke sie in der Liste der Sessions in der Seitenleiste an. Einen eigenen Befehl zum Öffnen gibt es nicht. Die Schaltflächen der Seitenleiste legen eine neue Session an, sichern die aktuelle und importieren eine Session aus einer Datei. Im Kontextmenü einer Session kannst du sie umbenennen, exportieren oder löschen.
Eine Session auf einen anderen Mac übertragen
Wähle im Menü „File“ den Befehl Export Current Session…. Eine Session ist ein Ordner mit der Endung .syncscript. Er enthält keine Medien, sondern speichert die Pfade der Quelldateien; diese müssen auf dem anderen Mac erreichbar sein. Importiere sie mit der Importschaltfläche in der Seitenleiste der Sessions; der Import legt immer eine neue Session an und öffnet sie.
Eine neue Session beginnen
Der Dialog für neue Sessions bietet New (blank) und New (keep Script). Die zweite Variante behält das geladene PDF des Drehbuchs und dessen Szenenliste, die Skriptzeilen werden aber gelöscht; parse sie auf Seite 2. Script erneut. Beide starten eine leere Session auf Seite 1. Transcribe.
Ein Tastenkürzel ändern
Öffne die Einstellungen und wähle den Tab Shortcuts. Klicke auf das Tastenfeld einer Aktion und drücke die neue Kombination, dann ist das Kürzel gesetzt; mit Esc brichst du ab. Die Schaltfläche mit dem Papierkorb löscht ein Kürzel. Wird eine Kombination bereits verwendet, fragt die App nach, bevor sie neu belegt wird. Reset all to defaults stellt nach einer Bestätigung die Werkseinstellungen der Kürzel wieder her.
Export… sichert deine Kürzel als Datei im Format JSON. Import… führt eine Datei mit deinen Kürzeln zusammen; Aktionen, die in der Datei nicht vorkommen, gehen auf ihren Standardwert zurück.
Einige Gesten sind fest vorgegeben und lassen sich nicht umbelegen: J, K und L für Shuttle, die Zifferntasten zum Zuweisen von Keywords sowie Cmd+Z und Cmd+Shift+Z für Widerrufen und Wiederholen.
Referenz
Voraussetzungen und Grenzen
- macOS 15.0 oder neuer. Die veröffentlichte App ist ausschließlich für Apple Silicon gebaut.
- Final Cut Pro ist nötig, um das Ergebnis zu verwenden. Die App liest und schreibt FCPXML.
- Das Drehbuch muss ein PDF mit Textebene sein. Die App hat keine OCR und importiert kein anderes Drehbuchformat.
- Das Event muss eine exportierte Datei mit der Endung
.fcpxml oder .fcpxmld sein (oder ein aus Final Cut Pro gezogenes Event) mit synchronisierten Clips und/oder Clips vom Typ Multicam. Aus einer Datei wird nur das erste Event importiert.
- Die Transkription nutzt Parakeet v3 mit 25 europäischen Sprachen. Chinesisch, Japanisch und Koreanisch sind nicht verfügbar.
- Der Export enthält ausschließlich Keywords: keine Titel von Final Cut Pro, keine Captions, keine Timeline.
Seiten
- 1. Transcribe: das Event importieren und die Clips transkribieren.
- 2. Script: das PDF des Drehbuchs importieren, Szenen auswählen, Skriptzeilen bearbeiten.
- 3. Matching: Skriptzeilen mit Captions abgleichen und das Ergebnis prüfen.
- 4. Keywords: Editor für die Timeline und Export.
Menüs
- Check for Updates… im Menü der App sucht nach einer neuen Version. Die App sucht außerdem einmal täglich automatisch.
- Buy SyncScript Pro im Menü der App öffnet die Produktseite im Browser. Der Eintrag wird angezeigt, bis eine bezahlte oder kostenlose Lizenz aktiv ist.
- Reset Everything... im Menü „File“ (Shift+Cmd+R) löscht nach einer Bestätigung die Transkription, das Skript und die Keywords sowie die Matches und Titel. Das lässt sich nicht widerrufen.
- Export to Final Cut Pro… im Menü „File“ (Cmd+E) öffnet das Exportblatt. Der Befehl ist auf Seite 4. Keywords verfügbar, sobald Ergebnisse des Matchings vorliegen.
- Save Session im Menü „File“ (Cmd+S) sichert die aktuelle Session.
- Export Current Session… im Menü „File“ schreibt die Session als
.syncscript-Ordner.
- Send Feedback… im Menü „Help“ öffnet das Feedbackblatt.
Einstellungen
Öffne die Einstellungen mit Cmd+Komma. Die Tabs sind Parsing, Display, Export, LLM, License, Shortcuts und About. Ein Tab General (mit Auto-advance to next phase) wird nur im Developer Mode angezeigt und ein Tab Advanced nur, solange du Option gedrückt hältst; das automatische Weiterschalten nach der Transkription ist standardmäßig eingeschaltet. Die Einstellung Auto-label FCPX rejects as Discard befindet sich im Abschnitt FCP Import des Tabs Parsing.
- Replace commas with alternative character: standardmäßig ein. Keywords in Final Cut Pro dürfen keine Kommas enthalten; diese Einstellung ersetzt sie beim Export durch ein ähnlich aussehendes Zeichen.
- Character name format: standardmäßig UPPERCASE. Optionen: UPPERCASE, Title Case, As-is. Wird beim Export angewendet.
- Trim whitespace from dialogue: standardmäßig ein. Wird beim Parsen des Skripts angewendet.
- Auto-label FCPX rejects as Discard: standardmäßig aus. Gilt für Clips, die danach gematcht werden.
- Default export location: standardmäßig leer. Ist ein Ordner gesetzt, schreibt jeder Export zusätzlich eine Kopie dorthin.
- Include timestamp in filename: standardmäßig ein. Gilt für diese Kopie.
- Include Additional-Title Keywords: standardmäßig ein. Startwert des Exportblatts.
- Include Action Cut Keyword: standardmäßig ein. Startwert des Exportblatts.
- Mark Outside Action Cut as Rejected: standardmäßig aus. Startwert des Exportblatts.
- Start Handle: und End Handle: standardmäßig 0 Frames. Startwerte des Exportblatts.
- Enable LLM Matching: standardmäßig aus, und nach jedem Start wieder aus. Siehe Skript abgleichen und das Ergebnis prüfen.
Tastenkürzel (Standardbelegung)
Alle folgenden Kürzel lassen sich in den Einstellungen, Tab Shortcuts, umbelegen, mit Ausnahme der festen Gesten im letzten Punkt.
- Wiedergabe: Space startet und pausiert. Die Pfeiltasten links und rechts gehen ein Frame weiter; Shift mit den Pfeiltasten geht 24 Frames weiter. Option mit den Pfeiltasten springt zum vorherigen oder nächsten Clip. Pfeil nach oben und nach unten springen zum vorherigen oder nächsten Schnittpunkt. Tab und Shift+Tab springen zur nächsten oder vorherigen Caption.
- Markieren: I setzt den Punkt In, O setzt den Punkt Out. Return öffnet das Popup für Keywords. Delete entfernt das ausgewählte Keyword. Esc hebt die Auswahl auf. T fügt einen vorhandenen zusätzlichen Titel an der Abspielposition ein. R öffnet die Auswahl zum Ersetzen des Keywords an der Abspielposition. C schaltet Discard an der Abspielposition um.
- Zoom und Ansicht: Plus und Minus zoomen, Shift+Z zoomt auf Fenstergröße, N schaltet das magnetische Einrasten um, S schaltet Skimming um.
- Session: Cmd+S sichert, Cmd+D markiert die aktuelle Gruppe von Clips als erledigt, Cmd+B teilt den Block an der Abspielposition, Cmd+C und Cmd+V kopieren und fügen ein.
- Feste Gesten: J, K und L für Shuttle; die Zifferntasten weisen die Keywords 1 bis 10 zu (mit Shift: 11 bis 20) und wirken auf die ausgewählte Caption; Cmd+Z und Cmd+Shift+Z für Widerrufen und Wiederholen. Diese lassen sich nicht umbelegen.
Dateien, die die App anlegt
- Sessions:
~/Library/Application Support/SyncScript Pro/Sessions/<id>.syncscript.
- Sprachmodelle: im Ordner Application Support der Benutzerbibliothek deines Benutzers.
- Cache der Transkripte:
~/Library/Application Support/SyncScriptPro/TranscriptCache.
- Presets für den Export:
~/Library/Application Support/SyncScript Pro/export-presets.json.
- Tastenkürzel:
~/Library/Application Support/SyncScript Pro/keyboard-bindings.json.
- Skriptdateien, die du exportierst:
.syncscriptlines.
Netzwerknutzung
Transkription, Matching und Bearbeitung laufen auf deinem Mac. Die App kontaktiert diese Hosts:
api.malibureview.app für die Lizenzprüfung (wenn das Hauptfenster erscheint, danach täglich; dabei werden ein Hash deines Geräts, die Version der App und deine Mailadresse gesendet), für das Einlösen oder Deaktivieren eines Lizenzschlüssels, für die Suche nach Updates und für Feedback, das du sendest.huggingface.co, um bei der ersten Verwendung die Sprachmodelle herunterzuladen.localhost:11434 nur, wenn du das lokale LLM aktivierst.
Feedback und Diagnosedaten werden nur gesendet, wenn du auf die Schaltfläche zum Senden klickst; schlägt das Senden fehl, wird der Bericht aufbewahrt und später automatisch gesendet. Der Lizenzkauf, das Lizenzportal und die rechtlichen Seiten öffnen sich in deinem Browser.
Fehlerbehebung
Nach dem Import des Events werden keine Clips gefunden
Die App meldet „No synced clips found in the Event“, wenn sie in der Datei keine Clips findet, die sie importieren kann. Synchronisiere deine Clips zuerst in Final Cut Pro, als synchronisierte Clips und/oder Clips vom Typ Multicam. Eine Mediathek von Final Cut Pro (.fcpbundle) auf die Fläche zu ziehen bewirkt nichts.
Exportiere ein einzelnes Event als FCPXML und ziehe stattdessen diese Datei hinein.
Die Quelldateien einiger Clips sind nicht erreichbar, meist weil ein Volume nicht eingebunden ist. Die Meldung nennt die Volumes und bis zu fünf Dateinamen. Binde das Volume ein und klicke erneut auf Transcribe Clips; bereits fertige Clips werden nicht noch einmal transkribiert.
Das Sprachmodell lässt sich nicht laden
Beim ersten Lauf werden die Sprachmodelle heruntergeladen (rund 1,5 GB für das Hauptmodell); dafür sind eine Internetverbindung und genug freier Speicherplatz nötig. Ein Fehler erscheint in einer roten Meldung, die mit „Failed to load transcription models“ beginnt und den Grund nennt. Stelle die Verbindung her, schaffe Platz und klicke erneut auf Transcribe Clips.
Einige Clips konnten nicht transkribiert werden
Das Abzeichen mit dem Ergebnis wird orange und zeigt „Transcription incomplete“ mit der Anzahl der fehlgeschlagenen Clips. Eine rote Meldung nennt bis zu fünf der fehlgeschlagenen Clips samt Grund, und die App wechselt nicht zu Seite 2. Script. Klicke erneut auf Transcribe Clips, um es noch einmal zu versuchen.
Nach dem Import des PDFs zeigt das Skript keine Zeilen
Prüfe zuerst den Statustext. Lautet er „PDF loaded: N scenes found. Select scenes and click Parse.“, ist noch keine Szene ausgewählt: Wähle Szenen über die Chips oder die Auswahl Add scene:.
Lautet er „Parsed 0 script lines from PDF“, ist die übliche Ursache ein PDF ohne Textebene, etwa ein Scan. Die App hat keine Texterkennung. Verwende ein PDF, das aus deiner Drehbuchsoftware exportiert wurde.
Prüfe außerdem die Szenenüberschriften: Der Parser erkennt Überschriften, die in Großbuchstaben mit INNEN, AUSSEN, INT., EXT., INT/ oder I/E beginnen. Für eine Szene, die nicht gefunden wurde, nutze Add Scene Manually.
Die Zeilen einer Figur fehlen
Hinweise auf den Erzähler (ERZÄHLER, NARRATOR) und Wörter wie ENDE, FADE oder CUT werden nicht als Figuren erkannt, ebenso wenig Hinweise, die " und " oder " & " enthalten. Der Text unter einem solchen Hinweis wird nicht unter eigenem Namen importiert und kann im Dialog des vorherigen Sprechers landen. Prüfe diese Zeilen und korrigiere sie von Hand im Block Editor oder in der Classic List.
Keywords würden an der falschen Stelle landen
Eine orange Warnung besagt, dass die Captions aus einer älteren Version mit einem Fehler bei der Synchronisation des Tons stammen. Sie erscheint bei Sessions, die mit einem älteren Build gesichert wurden. Klicke erneut auf Transcribe Clips, führe das Matching noch einmal aus und exportiere dann.
Export to Final Cut Pro ist ausgegraut
Der Befehl ist nur auf Seite 4. Keywords verfügbar, wenn Ergebnisse des Matchings vorliegen und der Editor der Timeline geöffnet ist. Im Exportblatt sind beide Schaltflächen deaktiviert, solange ein Export läuft, wenn es kein Ergebnis gibt oder wenn Selected Clip Groups Only gewählt und keine Gruppe ausgewählt ist.
Send to FCP zeigt keinen Fehler, aber es erscheint nichts
Die App meldet die Übergabe, nicht den Import. Final Cut Pro fragt, in welche Mediathek importiert werden soll; schließe diesen Dialog ab. Die Keywords liegen auf den Clips eines neuen Events, das wie dein Quellevent heißt, mit angehängtem " - SyncScript Pro". Ist Final Cut Pro nicht installiert, schlägt der Export mit einer Fehlermeldung fehl.
Der Export meldet „No source event“
Die Meldung fordert dazu auf, dein Event zuerst auf der Seite Transcribe zu importieren. Sie erscheint, wenn die Session kein importiertes Event enthält. Importiere das Event erneut auf Seite 1. Transcribe, klicke auf Transcribe Clips (bereits transkribierte Clips stammen aus dem Cache) und führe das Matching noch einmal aus.
Die App ist nach der Testphase gesperrt oder zeigt eine Lizenzmeldung
Beim ersten Start fragt die App vor allem anderen nach deiner Mailadresse; siehe Erste Schritte.
Der Sperrbildschirm nennt den Grund, zum Beispiel dass die Testphase beendet ist, dass die Lizenz abgelaufen ist oder widerrufen wurde, dass diese Version nicht mehr unterstützt wird oder dass die App zu lange offline war. Von dort aus kannst du eine Lizenz kaufen, erneut prüfen, mit I already have a license einen Lizenzschlüssel einlösen oder die App beenden.
Besagt die Meldung, dass die Lizenz noch nicht verifiziert werden konnte, verbinde dich einmal mit dem Internet und klicke auf Check Again. Ein kurzer Verbindungsabbruch allein sperrt die App nicht.
Einen Problembericht senden
Wähle im Menü „Help“ den Befehl Send Feedback…. Das Blatt stellt fünf kurze Fragen: 1. Goal, 2. Location, 3. Action, 4. Expectation und 5. Result. Beantworte mindestens eine, am besten alle fünf, in wenigen Worten. Darunter kannst du eine Dringlichkeit wählen: Showstopper, Bug, UI/Cosmetic, Feature Request oder Question. Klicke auf die gewählte, um sie wieder abzuwählen. Klicke dann auf Send Feedback. Der Bericht enthält den Namen deines Benutzerkontos in macOS, die Version der App und von macOS, die Anzahl der Keywords und Captions, die Engine, die Namen der Audio- und Videodateien, die ausgewählten Szenen und die ID der Session. Das Feld für die Mailadresse ist mit der Adresse vorausgefüllt, die du beim ersten Start eingegeben hast, und sie wird gesendet, solange du das Feld nicht leerst. Ein Screenshot wird nur hinzugefügt, wenn du ihn einschaltest. Bist du offline, wird der Bericht gespeichert und später gesendet.
Die Schaltfläche Diagnostics in der Seitenleiste zeigt, ob die Baselines für Skript und Matches gesichert wurden und welcher Export der letzte ist. Send Diagnostics Ticket sendet die beiden Baselines und den letzten Export mit seinem Manifest. Diese Dateien enthalten Skriptdialog, die Namen der Clips und Medienverweise.
Geschrieben für Version 1.2.86.
SyncScript Pro