Skip to content

Add comprehensive Captions documentation section #5455

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jun 21, 2025

This PR adds a new comprehensive "Captions" documentation section to help users work with captions in Remotion videos.

What's Added

New Documentation Section

  • Overview page (/docs/captions-guide/) - Introduction to Remotion's caption ecosystem and the Caption type
  • Importing Captions (/docs/captions-guide/importing) - Complete guide for importing existing captions from SRT files, JSON data, and custom formats
  • Generating Captions (/docs/captions-guide/generating) - Comprehensive coverage of all three caption generation packages with comparison and examples
  • Examples (/docs/captions-guide/examples) - Practical implementation examples including animated captions, TikTok-style captions, and word-by-word highlighting

Key Features Covered

Importing Captions:

  • Using fetch() with SRT files and the parseSrt() function
  • Importing from JSON caption arrays
  • Converting custom caption formats to the Caption type
  • Error handling and performance optimization

Generating Captions:

  • @remotion/install-whisper-cpp - Local transcription with Whisper.cpp
  • @remotion/whisper-web - Browser-based transcription using WebAssembly
  • @remotion/openai-whisper - Cloud-based transcription with OpenAI API
  • Custom caption generation following the Caption type structure
  • Comparison table and best practice recommendations

Practical Examples:

  • Basic caption rendering over video
  • Animated captions with fade-in/fade-out effects
  • TikTok-style captions using createTikTokStyleCaptions()
  • Word-by-word highlighting animations
  • Complete video composition with auto-generated captions
  • Performance optimization techniques

Integration

  • Added new "Captions" section to main sidebar (positioned after Audio section)
  • Generated image cards for all documentation pages
  • All internal links and cross-references work correctly
  • Follows existing documentation patterns and formatting

The documentation provides both beginner-friendly introductions and advanced implementation details, making it easy for users to get started with captions while also providing comprehensive reference material.

Fixes #5454.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copy link

vercel bot commented Jun 21, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
bugs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jun 21, 2025 8:22am
remotion ❌ Failed (Inspect) Jun 21, 2025 8:22am

Co-authored-by: JonnyBurger <1629785+JonnyBurger@users.noreply.github.com>
…n frontmatter

Co-authored-by: JonnyBurger <1629785+JonnyBurger@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] Add a new documentation section with how to work with captions Add comprehensive Captions documentation section Jun 21, 2025
@Copilot Copilot AI requested a review from JonnyBurger June 21, 2025 08:21
Copilot finished work on behalf of JonnyBurger June 21, 2025 08:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Error loading sessions

Retrying...

Successfully merging this pull request may close these issues.

Add a new documentation section with how to work with captions
2 participants