tiktok-overlay_skill

Overview

This skill adds TikTok-style text overlays to images and videos with styled fonts, backgrounds, strokes, and timed animations. It provides both an image engine and a video engine so you can produce single-shot overlays or time-synced animated captions. The API accepts flexible input/output types and supports many styling options to reproduce the TikTok look quickly.

How this skill works

The image engine draws text on a target image using configurable styles, background shapes, strokes, opacity, and positioning. The video engine composes text clips over video with per-text timing, fade in/out, and the same styling primitives, then renders with moviepy. Both engines accept file paths, PIL Images, numpy arrays, or raw bytes and return either saved files or PIL objects.

When to use it

• Add bold, outlined captions to photos for social posts.
• Create timed captions, callouts, or animated labels on short videos.
• Batch-process images with consistent branded text overlays.
• Prototype TikTok-like caption styles for app UI or demos.
• Generate thumbnails with readable, styled titles.

Best practices

• Use stroke_width 4–6 with bg_style="none" for the classic TikTok outlined look.
• Use bg_style="highlight" and bg_opacity around 0.6 for per-line rounded highlights that improve readability.
• Set max_width_ratio (e.g. 0.85) to ensure automatic word wrapping fits various aspect ratios.
• Provide explicit positions (e.g. "top-left" or (x,y)) to avoid overlaps with important image content.
• For videos, stagger t_start/t_end and set small fade_in/fade_out (0.3–0.6s) for smooth transitions.

Example use cases

• Create an eye-catching IG/TikTok thumbnail with bold outlined text and a highlight background.
• Add timed promotional text, lower-thirds, or scene callouts to short video clips.
• Batch-generate product images with consistent captions and brand colors.
• Produce tutorial clips with step captions that fade in and out at specific timestamps.