videodb

Ingest, index, search, and edit video and audio streams using the VideoDB Python SDK.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill videodb-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: videodb
Source: https://github.com/ibytechaos/claude/tree/main/plugins/everything-claude-code/skills/videodb
Command: npx skills add https://github.com/ibytechaos/claude --skill videodb-ibytechaos

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 speech, 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 server-side workflow for video perception, indexing, editing, and real-time alerting through the VideoDB API. ## 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/audio overlays, dubbing, and reframe aspect ratios—all server-side without ffmpeg. - 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 webinar, index its spoken words, search for every mention of a product feature, compile those moments into a highlight reel with a title card and background music, and get back a playable stream URL. ## Quick Start Ask the assistant to ingest a video file or URL with VideoDB, index its spoken words, and search for a specific topic to get timestamped clips.

Frequently Asked Questions about videodb

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

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

Index the video with video.index_spoken_words(force=True), then call video.search(query) with a natural language query. Results return shots with timestamps that you can compile into a playable stream URL. Wrap the call in try/except since it raises InvalidRequestError when no results are found.

How do I add subtitles to a video with Python?

Index spoken words first with video.index_spoken_words(force=True), then call video.add_subtitle() to burn subtitles into the stream. You can customize appearance with SubtitleStyle parameters like font name, size, and color.

Can VideoDB convert video aspect ratio for TikTok or Instagram?

Yes, video.reframe() converts aspect ratios server-side with presets like vertical (9:16), square (1:1), and landscape (16:9). Limit to short segments with start/end parameters or use callback_url for async processing, since reframe is slow on long videos.

Does VideoDB desktop capture work on Windows or Linux?

No, desktop capture currently supports macOS only. The CaptureClient records screen, microphone, and system audio on macOS, streaming events over WebSocket. For other platforms, use RTSP/RTMP live stream ingestion instead.

Why does video search raise InvalidRequestError?

The search method raises InvalidRequestError with 'No results found' when there are no matches. Catch this exception and treat it as an empty result set. For scene search, also set score_threshold to 0.3 or higher to filter low-relevance noise.

What video editing operations are not supported by VideoDB timelines?

The timeline editor does not support transitions, speed changes, crop/zoom, color grading, picture-in-picture video, volume mixing, or keyframe animation. For those operations, fall back to local tools like ffmpeg as noted in the editor limitations.