ClipMagic icon

ClipMagic

Interact with ClipMagic API for video and audio processing

Actions7

Overview

This node integrates with the ClipMagic API to burn subtitles (captions) directly into a video file. It takes an input video URL and a subtitle file URL (.srt or .ass format), then processes the video to embed the subtitles permanently, producing a new video file with burned-in captions.

Common scenarios for this node include:

  • Creating videos with hardcoded subtitles for platforms that do not support separate subtitle tracks.
  • Preparing videos for social media where subtitles improve accessibility and engagement.
  • Embedding translated subtitles into videos for multilingual audiences.

Example use case: You have a video hosted online and a corresponding subtitle file. Using this node, you can generate a new video file with the subtitles visually embedded, ready for upload to any platform without requiring subtitle support.

Properties

Name Meaning
Video URL URL of the input video file to which subtitles will be burned in.
Subtitle URL URL of the subtitle file (.srt or .ass) containing the captions to burn into the video.
Font Size Font size of the subtitle text in pixels (default 24).
Font Color Primary color of the subtitle text (default white #FFFFFF).
Font Name Font name to use for subtitles; can be a system font or a URL to a font file.
Outline Width Width of the text outline around subtitles; 0 means no outline (default 0).
Boxed Subtitles Boolean indicating whether subtitles should have a background box behind the text (default false).
Resolution Output video resolution; options are 480p, 720p, 1080p, 1440p, and 4K (default 720p).
Orientation Orientation of the output video; options are Landscape, Portrait, or Square (default Landscape).
Output Filename Desired filename for the output video file without extension (optional).
Options > Timeout (ms) How long to wait before aborting the HTTP request in milliseconds; 0 means no timeout (default 600000 ms).

Output

The node outputs a single item per execution containing:

  • json:

    • success: boolean indicating if the operation succeeded.
    • operation: the string "burnCaptions".
    • filename: the name of the generated output video file.
    • contentType: MIME type of the output file (e.g., video/mp4).
    • Additional response data if the API returns JSON instead of binary.

  • binary:

    • data: the binary content of the processed video file with burned-in subtitles.

This allows downstream nodes to access the processed video either as a binary file or via metadata.

Dependencies

  • Requires an active connection to the ClipMagic API using an API key credential configured in n8n.
  • The node makes HTTP requests to the ClipMagic service endpoint.
  • The user must provide accessible URLs for both the input video and subtitle files.
  • No additional environment variables are required beyond the API credential.

Troubleshooting

  • Timeouts: If processing large videos or slow networks cause timeouts, increase the "Timeout (ms)" option or set it to 0 for no limit.
  • Invalid URLs: Ensure the video and subtitle URLs are publicly accessible and correctly formatted. Private or inaccessible URLs will cause errors.
  • Unsupported subtitle formats: Only .srt and .ass subtitle files are supported. Other formats may cause failures.
  • Font issues: Specifying a custom font URL requires the font file to be accessible. Otherwise, the default system font is used.
  • API errors: Errors from the ClipMagic API will be returned in the node output. Check the error message for details and verify your API key and parameters.

Links and References

Discussion