App Icon
FCP SRT Importer 2
User Manual

Main UI

Main UI

- **Subtitles File (SRT / VTT)**: Accepts the required input file for the conver
  • Subtitles File (SRT / VTT): Accepts the required input file for the conversion process. Dragging and dropping a .srt or .vtt file here initiates parsing, enabling the FCPXML production workflow.
  • Drop or Select Subtitles: Serves as the primary target area for importing the subtitle file. File content is parsed and validated upon drop.
  • Reference Video (Optional): Accepts an optional video file to automatically analyze and extract the target resolution and frame rate for the output FCPXML timeline.
  • Drop or Select Video: Serves as the target area for importing a reference video file (.mov, .mp4, .mpeg, .m4v). Parsing video metadata here updates the timeline settings for the final export.
  • Settings: Opens the configuration panel to adjust typography, styling, timing rules, and export preferences.
  • Produce FCPXML: Triggers the compilation of the imported subtitle data, application of style configurations, and generation of the output Final Cut Pro XML file. This action is only available after a valid subtitle file has been successfully imported and parsed.

Settings

Presets

- **Presets**: Selects the configuration management panel, allowing the user to
  • Presets: Selects the configuration management panel, allowing the user to save, load, and manage custom sets of styling and processing rules.
  • Font & Style: Switches the view to configure typography, colors, and text effects for the subtitle output.
  • Subtitles: Switches the view to configure canvas dimensions, frame rate, timing rules, line splitting, and backdrop patches.
  • Export: Switches the view to manage post-compilation behavior, FCPXML version preferences, and workflow automation.
  • Current Preset: Displays the name of the configuration profile that is currently applied to the application's settings.
  • Save: Overwrites the existing active preset file with the current configuration state, preserving all adjusted styling and processing parameters.
  • Save As...: Opens a naming dialog to store the current configuration state as a new, distinct preset profile for future use.
  • Manage: Organizes the preset management actions within a dedicated container.
  • Load Preset...: Opens a list of saved preset profiles to select from. Selecting a profile replaces the current configuration with the stored settings.

Font & Style

- **Presets**: Selects the configuration management panel, allowing the user to
  • Presets: Selects the configuration management panel, allowing the user to save, load, and manage custom sets of styling and processing rules.
  • Font & Style: Switches the view to configure typography, colors, and text effects for the subtitle output.
  • Subtitles: Switches the view to configure canvas dimensions, frame rate, timing rules, line splitting, and backdrop patches.
  • Export: Switches the view to manage post-compilation behavior, FCPXML version preferences, and workflow automation.

1. Font Selection

  • Font Family: Selects the typeface (e.g., Helvetica, Arial) applied to the subtitle text in the generated output.
  • Typeface: Selects the specific weight and style (e.g., Regular, Bold, Light, Italic) of the chosen font family.

2. Size & Position

  • Size: Adjusts the absolute font size in points to control the visual scale of the subtitle text.
  • Baseline: Adjusts the vertical placement of the text relative to the bottom edge of the video frame, expressed as a percentage of the frame height.

3. Border & Stroke

  • Enable Border: Activates or deactivates an outline stroke around the subtitle characters to improve readability against varying backgrounds.
  • Width: Adjusts the thickness of the outline stroke in points.
  • Stroke Color: Selects the color for the text outline stroke from a palette of standard colors, or uses the color picker for a custom hue.

4. Colors

  • Text Color: Selects the primary fill color for the subtitle text from a palette of standard colors, or uses the color picker for a custom hue.
Element 1
Element 1
  • Font Family: Selects the overarching typeface (e.g., Helvetica, Arial) applied to the subtitle text in the generated output.
  • Typeface: Selects the specific weight and stylistic variant (e.g., Regular, Bold, Light, Italic) of the chosen font family.
Element 2
Element 2
  • Size: Adjusts the absolute font height in points to control the visual scale of the subtitle text.
  • Baseline: Adjusts the vertical placement of the text, expressed as a percentage relative to the bottom edge of the video frame.
Element 3
Element 3
  • Enable Border: Activates or deactivates an outline stroke around the subtitle characters to improve readability against varying backgrounds.
  • Width: Adjusts the thickness of the outline stroke, measured in points.
  • Stroke Color: Selects the color for the text outline stroke from a palette of preset colors, or uses the eyedropper tool to pick a custom hue from the screen.
  • Text Color: Selects the primary fill color for the subtitle text from a palette of preset colors, or uses the eyedropper tool to pick a custom hue from the screen.

Subtitles

- **Presets**: Selects the configuration management panel, allowing the user to
  • Presets: Selects the configuration management panel, allowing the user to save, load, and manage custom sets of styling and processing rules.
  • Font & Style: Switches the view to configure typography, colors, and text effects for the subtitle output.
  • Subtitles: Switches the view to configure canvas dimensions, frame rate, timing rules, line splitting, and backdrop patches.
  • Export: Switches the view to manage post-compilation behavior, FCPXML version preferences, and workflow automation.

1. Canvas & Timing

  • Frame Rate (FPS): Selects the target timeline frame rate for the output project, ensuring proper synchronization of subtitle durations.
  • Frame Width: Sets the horizontal canvas dimension in pixels for the generated FCPXML output.
  • Frame Height: Sets the vertical canvas dimension in pixels for the generated FCPXML output.
  • Avoid Overlap (offset by 1 frame): When active, automatically reduces a subtitle's end time by one frame if it would otherwise collide with the start of the next subtitle, preventing rendering conflicts.
  • Extend Duration: Appends a fixed time offset, in seconds, to the end of every subtitle block to extend its display duration.

2. Formatting & Splitting

  • Auto Split Long Lines: Automatically divides subtitle lines that exceed a set character count into multiple rows to improve readability.
  • Max Length: Defines the character limit that triggers the line-splitting logic when automatic splitting is active.

3. Backdrop Patch

  • Add Black Backdrop Patch: Generates a solid black background block behind the subtitles to ensure legibility, particularly over bright or complex video content.

4. Ignore Formatting Markup

  • Italics (<i> / </i>): When active, strips HTML-style italic markup tags from the source subtitle text during parsing.
  • Bold (<b> / </b>): When active, strips HTML-style bold markup tags from the source subtitle text during parsing.
  • Underlines (<u> / </u>): When active, strips HTML-style underline markup tags from the source subtitle text during parsing.
  • Fonts (<font> / </font>): When active, strips HTML-style font container tags and their color properties from the source subtitle text during parsing.

Close: Dismisses the preferences window after the active configuration has been saved to the application's persistent storage.

Element 1
Element 1
  • Frame Rate (FPS): Selects the target timeline frame rate for the output project, ensuring proper synchronization of subtitle durations.
  • Frame Width: Sets the horizontal canvas dimension in pixels for the generated FCPXML output.
  • Frame Height: Sets the vertical canvas dimension in pixels for the generated FCPXML output.
  • Avoid Overlap (offset by 1 frame): When active, automatically reduces a subtitle's end time by one frame if it would otherwise collide with the start of the next subtitle, preventing rendering conflicts.
  • Extend Duration: Appends a fixed time offset, in seconds, to the end of every subtitle block to extend its display duration.
Element 2
Element 2
  • Auto Split Long Lines: Automatically divides subtitle lines that exceed a set character count into multiple rows to improve readability.
  • Max Length: Defines the character limit that triggers the line-splitting logic when automatic splitting is active.
Element 3
Element 3
  • Add Black Backdrop Patch: Generates a solid black background block behind the subtitles to ensure legibility, particularly over bright or complex video content.
Element 4
Element 4
  • Italics (<i> / </i>): When active, strips HTML-style italic markup tags from the source subtitle text during parsing.
  • Bold (<b> / </b>): When active, strips HTML-style bold markup tags from the source subtitle text during parsing.
  • Underlines (<u> / </u>): When active, strips HTML-style underline markup tags from the source subtitle text during parsing.
  • Fonts (<font> / </font>): When active, strips HTML-style font container tags and their color properties from the source subtitle text during parsing.

Export

- **Presets**: Selects the configuration management panel, allowing the user to
  • Presets: Selects the configuration management panel, allowing the user to save, load, and manage custom sets of styling and processing rules.
  • Font & Style: Switches the view to configure typography, colors, and text effects for the subtitle output.
  • Subtitles: Switches the view to configure canvas dimensions, frame rate, timing rules, line splitting, and backdrop patches.
  • Export: Switches the view to manage post-compilation behavior, FCPXML version preferences, and workflow automation.

Final Cut Pro Workflow

  • Open FCPXML immediately in Final Cut Pro: When active, automatically launches Apple Final Cut Pro and opens the generated FCPXML file immediately after compilation is complete.
  • Don't suggest Show in Finder after export: When active, suppresses the standard completion dialog prompt that offers to reveal the output file in the Finder.

FCP XML Version Preference

  • Prefer FCP 10.6+ FCPXML: Determines whether the application generates XML targeting newer Final Cut Pro 10.6+ structures by default, rather than legacy FCPXML versions.
  • Remember my FCPXML choice: When active, saves the user's selection from the version prompt sheet, bypassing the prompt in future export operations.

Close: Dismisses the preferences window after the active configuration has been saved to the application's persistent storage.