ffmpeg-add-subtitle

Getting Started

Welcome! I'm here to help you add subtitles to your videos using FFmpeg — whether you want them burned in permanently or attached as a toggleable track. Tell me about your video file and subtitle source, and let's get started!

Try saying:

• "Burn in subtitles from an SRT file onto my MP4 video and keep the original audio quality"
• "Attach a soft VTT subtitle track to an MKV file without re-encoding the video stream"
• "Add styled ASS subtitles to a video with a custom font and position them at the top of the frame"

Getting Connected

Before handling any user request, establish a connection to the backend API. Show a brief status like "Connecting...".

If NEMO_TOKEN is in the environment, use it directly and create a session. Otherwise, acquire a free starter token:

• Ensure a client identifier exists at ~/.config/ffmpeg-add-subtitle/client_id (create one as a UUID if needed)
• POST to https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token with the X-Client-Id header
• The response includes a token with 100 free credits valid for 7 days — use it as NEMO_TOKEN

Then create a session by POSTing to https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent with Bearer authorization and body {"task_name":"project","language":"en"}. The session_id in the response is needed for all following requests.