Skip to content
Semantic search & clipping – jump to moments in seconds and watch instantly.LLM summaries – generate follow-up emails or full minutes with one prompt.Screen-share parsing – scrape on-screen data for deeper analytics.Workflow hooks – auto fill CRM fields, trigger Zapier actions, connect n8n nodes or raise Jira tickets.Build advanced workflows : CRM auto update – create & enrich deals, push next steps.Candidate interview scoring – extract skills, sentiment, red flags.Webinar chaptering & highlights – publish shareable clips in minutes.
Brand-able Participant - Configure a custom bot name and avatar for a seamless, white-label presence in every call.Live Status & Completion Events - Fetch recording state at any time, and receive a final “recording-complete” callback with file URLs and metadata.Speaker-Timeline Metadata - Per-speaker start/stop timestamps are returned for Google Meet only. Microsoft Teams and Zoom support ship next. Use this timeline to align transcripts, analytics, or highlights from individual speakers.
initializing - Bot is being set upprocessing - Bot is actively recording the meetingdone - Recording completed successfullyfailed - Recording failed
Meeting Scheduling: Schedule recordings in advance with the join_at parameter or calendar connects.Real-Time Stream Access: Access audio and video streams live during meetings.Live Action Integration: Connect real-time meeting streams directly into .Audio Responses: Have your bot respond back to participants using conversational intelligence.Human-like Screen Sharing: Automate dynamic, interactive screen-sharing use cases.
VideoDB Documentation
- Pages
Meeting Recording SDK
What you’ll build
A headless “bot-participant” that joins your Zoom, Meet, or Teams call, records high-quality audio + video, and upload straight into your VideoDB collection.
Why it matters
Once the recording lands in VideoDB, you immediately unlock:
(Feel free to fork—each notebook uses the same SDK primitives you’ll wire into production.)
Platforms : Google Meet, Teams, Zoom.
Recorder and Post Meeting Analysis
Key Features:
Getting Started
Install the SDK
!pip install --upgrade videodb
import os
os.environ["VIDEO_DB_API_KEY"] = <Your API Key>
Record a Meeting
import videodb
conn = videodb.connect(api_key=os.getenv("VIDEO_DB_API_KEY"))
meeting = conn.record_meeting(
meeting_url="https://meet.google.com/abc-defg-hij",
bot_name="Your Bot Name", # Name displayed in the meeting
bot_image_url = "https://link-to-image.jpg" # Image displayed in the meeting
meeting_title="Your Meeting Title", # Identifies the meeting internally
callback_url="https://yourapp.com/webhook",
callback_data={"internal_id": "123"}, # Your custom metadata
time_zone="America/Los_Angeles"
)
print(f"Meeting recording initiated with ID: {meeting.id}")
You can also use collection object to record and upload meeting on that collection.
my_coll = conn.get_collection("your-collection-id")
meeting = my_coll.record_meeting(
meeting_url="https://zoom.us/j/123456789",
bot_name="Team Recorder Bot",
meeting_title="Weekly Standup",
callback_url="https://yourapp.com/webhook"
)
Tracking Recording Status
meeting.refresh()
print("Current status:", meeting.status)
Wait for completion (recommended method):
# Wait for up to 1 hour, polling every 60 seconds
if meeting.wait_for_status("done", timeout=3600, interval=60):
print("Recording successful.")
else:
print("Recording encountered an issue.")
Recording status:
Callback Notifications
VideoDB sends a webhook (HTTP POST) to your specified callback_url when recording completes. You can use these to automate post-processing tasks.
Success:
{
"success": true,
"message": "Meeting recording completed.",
"data": {
"video_id": "vid_123",
"speaker_timeline": [{"speaker_name": "Alice", "start_time_seconds": 9.94}],
"stream_url": "...",
"player_url": "..."
}
}
Failure:
{
"success": false,
"message": "Failed to record meeting."
}
Accessing the Recorded Video
Retrieve your video directly from connection ) or collection object after completion:
meeting = coll.get_meeting("xx-xx-xx")
print(meeting.id)
print(meeting.video_id)
# Get video object
video = collection.get(meeing.video_id)
Meeting Object
id
str
ID of the meeting to get it from conn and collection objects
bot_name
str
Name of the bot that appears in the meeting.
bot_image_url
str
Image of the bot that appears in the meeting.
meeting_url
str
URL of the meeting being recorded
meeting_title
str
Title of the meeting
collection_id
str
ID of the collection where the recording will be stored
status
str
Current status of the recording (see Status Values below)
time_zone
str
Time zone of the meeting
is_active
bool
Property that returns True if meeting is currently being recorded
is_completed
bool
Property that returns True if meeting recording is done
speaker_timeline
dict
Speaker timeline.
video_id
str
Video ID of the meeting.
There are no rows in this table
Stay tuned for upcoming features 🙌🏼
You're all set to start automating your meeting recordings with VideoDB! If you encounter any issues or have questions, reach out via our support channels on .
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.