Timeline View
The Timeline shows all recorded clips across all cameras, organized by date. It's your visual memory — every moment captured, described by AI, and searchable.
Browsing Clips
Clips are displayed as thumbnail cards grouped by date. Scroll down to load more — the timeline uses infinite scroll (no manual "load more" button).
Each clip card shows:
- Thumbnail — extracted frame from the clip, giving you a visual preview at a glance
- Timestamp — exactly when the clip was recorded
- Camera name — which camera recorded it, helping you orient events spatially
- Duration — clip length (e.g., "0:15" for a fifteen-second clip)
- AI description — if video analysis has run, a short text summary appears beneath the thumbnail: "Person walking up driveway carrying a large box"
Click a clip to open it in the Clip Playback view for full video with frame-by-frame AI analysis.
Understanding AI Descriptions
AI descriptions are generated by the active Vision Model (VLM). They transform raw video into searchable text, which means:
- You can find clips by what happened, not just when they happened
- The agent can answer questions like "when did the mail arrive?" by searching these descriptions
- Event handlers evaluate descriptions to trigger alerts — the LLM compares each description against your rules using semantic understanding
If a clip doesn't have an AI description, it means either video analysis was disabled when the clip was recorded, or the VLM hasn't analyzed it yet. You can analyze any clip retroactively from the Clip Playback view.
Camera Filter
Filter clips by camera using the camera filter bar at the top of the Timeline.
Two modes:
- Include — show only clips from selected cameras (e.g., "show me only living room clips")
- Exclude — show clips from all cameras except selected ones (e.g., "hide the hallway camera, show everything else")
Click a camera name to toggle it in the filter. The clip list updates immediately. This is especially useful when you're investigating a specific incident and want to focus on the relevant cameras.
Filter Use Cases
| Scenario | Filter Mode | Selection |
|---|---|---|
| "What happened at the front door?" | Include | Front Door camera only |
| "Show me everything except indoor cameras" | Exclude | Living Room, Kitchen |
| "Review all outdoor cameras from today" | Include | All outdoor cameras |
| "I'm debugging a camera, hide it" | Exclude | The camera you're testing |
Favorites
Click the heart icon on a clip to mark it as a favorite. Favorites are useful for:
- Marking clips you want to review later
- Saving notable events (deliveries, visitors, incidents)
- Building a curated collection of clips for reference
Use the Favorites toggle in the filter bar to show only favorited clips. Favorites persist across sessions — they're stored with the clip metadata and survive app restarts.
Pull-to-Refresh
Pull down on the timeline list to refresh and load the most recent clips. This manually triggers a reload of the clip database and fetches any newly recorded clips.
Auto-Retry
If a clip's thumbnail fails to load (e.g., the file is temporarily locked or a disk read error occurs), Aegis automatically retries with exponential backoff. You don't need to manually refresh — the thumbnail will appear within a few seconds.
Live Updates
New clips appear in real-time without refreshing. When a camera records a new clip:
- The clip is automatically pushed to the timeline
- It appears at the top of the list with its thumbnail and metadata
- AI analysis results are appended to the clip card as they become available
This means you can keep the Timeline open as a live feed of activity across your property — new events populate automatically.
Date Navigation
Clips are grouped by date with clear date headers (e.g., "Today", "Yesterday", "March 20, 2026"). When scrolling through a long timeline:
- Date headers stay visible as section separators
- The infinite scroll loads older clips as you scroll deeper
- There's no hard limit on how far back you can scroll — it depends on your retention settings
Searching the Timeline
While the Timeline itself doesn't have a text search box, you can search your clip history through the Aegis Home chat interface. Ask the agent:
- "What happened on the driveway yesterday?"
- "Show me clips with people at the front door from this week"
- "Were there any deliveries today?"
The agent searches clip descriptions and metadata to find matching results, then presents them to you in the conversation.