Back to Skills

videodb

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, v

184,214stars28,424forksUpdated 5/16/2026

Security Assessment

Medium Risk(50/100)

Detected risks:

Secret Exposure([reference/api-reference.md] api_key=, [reference/capture-reference.md] token =, [reference/capture-reference.md] token=)
Sensitive File Access([SKILL.md] .env)
Security Score50/100

About videodb

The videodb skill is designed to provide comprehensive perception, understanding, and actionable capabilities for video, audio, and live streams. It addresses the challenges of managing multimedia content by enabling ingestion from local files, URLs, RTSP/live feeds, or desktop captures. Once ingested, the skill provides real-time contextual insights and generates playable stream links, helping users efficiently navigate and utilize large volumes of video and audio content. It solves problems related to content indexing, real-time monitoring, and multimedia manipulation, which are typically time-consuming and technically complex tasks.

Videodb offers a range of core features. It allows users to extract frames, build visual, semantic, and temporal indexes, and search for specific moments with timestamps and auto-generated clips. The skill also supports media transformation through transcoding and normalization, including adjustments to codec, frame rate, resolution, and aspect ratio. Timeline editing features include subtitles, text and image overlays, branding, audio enhancements, dubbing, and translation. Users can generate new media assets—images, audio, and video—and set up real-time alerts for events detected in live streams or desktop sessions. Inputs are flexible, supporting local file paths, public URLs, RTSP streams, and interactive desktop capture requests, while outputs include stream URLs, indexed search results, generated media assets, event payloads, and session summaries.

Typical use cases for videodb include desktop monitoring for session recording and alerting, processing and streaming video content from files or live feeds, indexing and searching multimedia assets, and programmatic timeline editing and content generation. It is particularly useful for professionals working in media production, security monitoring, research, and digital content management who require precise, automated handling of video and audio data. The skill is targeted toward users familiar with Python environments and command-line operations, allowing seamless integration into workflows that demand real-time insights, content manipulation, and multimedia asset management.

FAQ

How do I start a desktop capture session with videodb?

You can initiate a desktop session to capture your screen, microphone, and system audio by specifying a start request. The session allows real-time context streaming, memory storage, alerts, and generation of session summaries.

What types of video sources can videodb ingest?

Videodb supports ingestion from local files, public URLs, RTSP/live feeds, and live desktop capture sessions, returning playable stream links for each source.

How can I configure videodb to use my API key?

Set your VIDEO_DB_API_KEY either by exporting it in your terminal with `export VIDEO_DB_API_KEY=your-key` or by saving it in a project `.env` file. The skill reads the key automatically during connection.

Can videodb generate subtitles or overlays?

Yes. It supports generating, translating, and burning-in subtitles, as well as adding text, image, branding overlays, motion captions, audio tracks, voiceovers, and dubbing through timeline operations.

Are there any system requirements for videodb's live stream monitoring?

Videodb requires access to the RTSP or live feed URLs and a Python environment with the necessary SDK installed. For desktop capture features, additional capture dependencies may be needed, especially on Linux systems.

All Files

12 files
reference/editor.md16.2 KB
View
reference/generative.md10.0 KB
View
reference/rtstream-reference.md14.9 KB
View
reference/search.md7.7 KB
View
reference/api-reference.md20.0 KB
View
reference/use-cases.md4.3 KB
View
reference/capture-reference.md11.3 KB
View
scripts/ws_listener.py8.2 KB
View
reference/capture.md4.7 KB
View
SKILL.md13.8 KB
View
reference/streaming.md11.6 KB
View
reference/rtstream.md1.8 KB
View

Install videodb

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill