Complete reference for all supported frontmatter properties to control media behavior in note metadata

You can control media behavior by adding properties to the YAML frontmatter of your media notes. These properties affect how media files are displayed and played when viewing or embedded in the note.

For example:

---
title: My Video Note
loop: true
muted: true
volume: 80
---

Basic Properties

Property	Description	Values	Example
`title`	Custom title for the media	Text string	`title: "My Custom Title"`

Playback Control Properties

Property	Description	Values	Example
`loop`	Loop the media	`true` or `false`	`loop: true`
`muted`	Start in muted state	`true` or `false`	`muted: true`
`auto_play`	Start playing automatically	`true` or `false`	`auto_play: true`
`autoplay`	Alias for `auto_play`	`true` or `false`	`autoplay: true`

Audio/Video Properties

Property	Description	Values	Example
`volume`	Set default volume level	0-100	`volume: 80`
`audio_gain`	Audio gain adjustment	Number	`audio_gain: 2.0`
`playback_rate`	Set default playback rate	Positive number	`playback_rate: 1.5`
`speed`	Alias for `playback_rate`	Positive number	`speed: 1.5`
`preserve_pitch`	Preserve audio pitch when changing speed	`true` or `false`	`preserve_pitch: true`

Display Properties

Property	Description	Values	Example
`aspect_ratio`	Aspect ratio	Ratio format	`aspect_ratio: "16 / 9"`
`cross_origin`	Cross-origin policy	CORS values	`cross_origin: "anonymous"`
`flip`	Flip transformation	Flip options	`flip: "horizontal"`

Subtitle and Caption Properties

Property	Description	Values	Example
`subtitles`	Subtitle tracks linked to this media	String or array of strings	`subtitles: "[[lecture.en.srt]]"`
`captions`	Caption tracks linked to this media	String or array of strings	`captions: "[[lecture.en.vtt]]"`

Each entry is a wiki-link or URL, optionally with hash parameters for language, label, and default status. See the Subtitle Track Properties reference for all parameters.

Time Control Properties

Property	Description	Values	Example
`time_range`	Time segment to play	Time range format	`time_range: "10,20"`

Time Range Format

The time_range property supports the same time formats as hash properties:

Seconds: 10 or 10.5
MM:SS: "02:30"
HH:MM:SS: "1:02:30"
Ranges: "10,20" (from 10s to 20s)
Open ranges: ",30" (beginning to 30s) or "10," (10s to end)

Frontmatter Properties