CLI: Video Commands

Store, transcribe, search, and manage video memories with the Trix CLI.

Updated Oct 6, 2026

Overview

The videos command group lets you manage video memories — listing, searching transcripts, triggering transcription, viewing metadata, extracting thumbnails, and playing videos directly from the terminal.

Command aliases: video, vid

Uploading Videos

Upload a video file using trix remember --video. Supported formats include MP4, MOV, AVI, MKV, WebM, WMV, FLV, M4V, and 3GP.

# Upload a video
trix remember --video meeting-recording.mp4

# Upload with tags and space
trix remember --video demo.mov --space work --tags demo,presentation

# Upload and auto-transcribe
trix remember --video lecture.mp4 --transcribe

Listing Videos

List video memories with optional filtering. Defaults to 20 results.

trix videos list
trix videos list --space meetings
trix videos list --limit 50 --tags presentation,demo
trix videos list -o json

Example output:

Video Memories

ID                TAGS                    CREATED
mem_abc123...     presentation, demo      2 hours ago
mem_def456...     meeting, standup        1 day ago

Showing 2 of 12 videos. Use --limit to see more.

Video Info

Show detailed information about a video memory including resolution, duration, frame rate, codecs, file size, and chapter markers.

trix videos info mem_abc123

Example output:

  ID:           mem_abc123
  Type:         video
  Resolution:   1920x1080 (1080p)
  Duration:     1:23:45
  Frame Rate:   29.97 fps
  Video Codec:  h264
  Audio Codec:  aac
  Bitrate:      4.50 Mbps
  File Size:    2.10 GB
  Has Audio:    true
  Has Transcript: true

  Created: Jan 15 10:30

Searching Video Transcripts

Search through transcribed text across your video memories. Results include similarity scores, matched text, and timestamps into the video.

trix videos search "quarterly results"
trix videos search "action items" --space meetings
trix videos search "demo" --limit 20

Example output:

Videos matching: "quarterly results"

ID                SIMILARITY  MATCHED TEXT                        TIMESTAMP
mem_abc123...     0.92        ...discussed quarterly results...   12:34
mem_def456...     0.85        ...Q1 revenue exceeded target...    45:12

Transcription

Queue a transcription job for a video, then retrieve the transcript text.

# Trigger transcription
trix videos transcribe mem_abc123
trix videos transcribe mem_abc123 --language en
trix videos transcribe mem_abc123 --wait=false

# Get transcript (timestamps included by default)
trix videos transcript mem_abc123
trix videos transcript mem_abc123 --timestamps=false
trix videos transcript mem_abc123 --output transcript.txt

If a video has not been transcribed yet, transcript shows a status message. Run trix videos transcribe <id> first.

Thumbnails

Get or save a thumbnail image from a video. By default it opens in your system viewer.

trix videos thumbnail mem_abc123
trix videos thumbnail mem_abc123 --url-only
trix videos thumbnail mem_abc123 --output thumb.jpg
trix videos thumbnail mem_abc123 --timestamp 30

Technical Metadata

Show detailed technical metadata including codec info, bitrate, audio details, and any embedded metadata from the video file.

trix videos metadata mem_abc123

Playing Videos

Open a video in your system default player. Uses xdg-open on Linux, open on macOS, and rundll32 on Windows.

trix videos play mem_abc123
trix videos play mem_abc123 --url-only

Command Reference

Command	Description
`videos list`	List video memories with optional filters
`videos info <id>`	Show video details (resolution, duration, codecs)
`videos search <query>`	Search within video transcripts
`videos transcribe <id>`	Trigger transcription for a video
`videos transcript <id>`	Get transcript text with optional timestamps
`videos thumbnail <id>`	Get or save the video thumbnail
`videos metadata <id>`	Show detailed technical metadata
`videos play <id>`	Open video in system player
`remember --video <file>`	Upload a video file as a memory

Flags

Flag	Short	Default	Commands	Description
`--space`	`-s`	default	list, search	Filter by space
`--limit`	`-l`	20 / 10	list, search	Maximum results
`--tags`	`-t`	-	list	Filter by tags (comma-separated)
`--language`	-	auto	transcribe	Language code (en, es, fr, etc.)
`--wait`	-	true	transcribe	Wait for completion
`--timestamps`	-	true	transcript	Include timestamps in output
`--output`	`-o`	-	transcript, thumbnail	Save output to file
`--url-only`	`-u`	false	thumbnail, play	Print URL without opening
`--timestamp`	-	0	thumbnail	Thumbnail at specific second