videodb

Ingest, index, search, and edit video and live streams via the VideoDB API.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/freedom909/real-estate-saas --skill videodb-freedom909
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: videodb
Source: https://github.com/freedom909/real-estate-saas/tree/main/.trae/skills/videodb
Command: npx skills add https://github.com/freedom909/real-estate-saas --skill videodb-freedom909

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires videodb, python-dotenv, and includes scripts (resource) and references (resource) components.

What problem does it solve? Working with video programmatically—transcribing, searching for specific moments, editing timelines, transcoding formats, and monitoring live streams—normally requires juggling ffmpeg, local encoders, and custom pipelines. This Skill provides a unified VideoDB-based workflow to see, understand, and act on video, audio, live RTSP feeds, and desktop capture sessions entirely server-side. ## Core Features & Use Cases - Video Ingest & Search: Upload files, URLs, or YouTube links; build spoken-word and scene indexes; search for exact moments with timestamps and auto-compile clips. - Timeline Editing & Transcoding: Trim and combine clips, add subtitles, text/image overlays, background music, dubbing, and convert resolution or aspect ratio (vertical, square, landscape) without local encoding tools. - Live Streams & Desktop Capture: Connect RTSP/RTMP feeds or record macOS desktop sessions with real-time transcription, visual indexing, and event-based alerts. - Use Case: Ingest a recorded product demo, index its spoken words, search for "pricing discussion", compile the matching shots into a highlight clip, burn in subtitles, and reframe it to vertical format for social media. ## Quick Start Ask the AI to ingest a video file or URL with VideoDB and return a playable stream link with a searchable transcript.

Frequently Asked Questions about videodb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for specific moments inside a video with Python?▼

Use the VideoDB SDK to index spoken words with video.index_spoken_words(), then call video.search() with a natural language query. Results return shots with exact timestamps, and results.compile() creates a playable clip of all matches.

How to add subtitles to a video without ffmpeg?▼

VideoDB handles subtitles server-side. Index the video's spoken words, then call video.add_subtitle() to get a stream URL with burned-in subtitles. You can customize styling with SubtitleStyle or use CaptionAsset via the Editor API for animations.

Does VideoDB support live RTSP stream monitoring?▼

Yes, coll.connect_rtstream() ingests RTSP or RTMP feeds. You can run real-time visual and audio indexing pipelines, create events, and attach alerts delivered via WebSocket or webhook when matching content is detected.

Why does video.search() raise InvalidRequestError?▼

VideoDB raises InvalidRequestError with the message "No results found" when a search has no matches. Wrap search calls in try/except and treat that specific message as an empty result set rather than a failure.

What are the limitations of the VideoDB timeline editor?▼

The timeline editor supports only non-destructive linear composition: no transitions, speed changes, crop/zoom, color grading, volume mixing, or picture-in-picture video. Audio fades are capped at 5 seconds, and overlays use absolute timestamps.

Can I convert a landscape video to vertical for TikTok or Instagram?▼

Yes, video.reframe(target="vertical") converts aspect ratios server-side with optional smart object tracking. For long videos, limit the segment with start/end parameters or pass a callback_url for async processing to avoid timeouts.