Media Player
The Media Player input source lets you play videos and display photos as a source in your production — for pre-recorded content, B-roll, title cards, and photo slideshows.
Adding a media source
- Tap + on an empty source slot
- Select Media Player
- Choose a file from your photo library or files:
- Video — Plays back in the source slot with audio
- Photo — Displays as a static image
- Graphic — Displays a graphic/image file
Playback controls
| Control | Description |
|---|---|
| Play | Start or resume playback |
| Pause | Pause at the current position |
| Stop | Stop and reset to the beginning |
| Seek | Jump to a position (0–1, where 0.5 = halfway) |
| Rate | Playback speed (0.1x to 4x, default 1x) |
| Loop | Repeat playback continuously |
Loop modes
| Mode | Description |
|---|---|
| Once | Play once and stop |
| Infinite | Loop continuously |
| Count | Loop a specific number of times |
Framing modes
| Mode | Description |
|---|---|
| Fit | Scale to fit within the frame, preserving aspect ratio (may show black bars) |
| Fill | Scale to fill the frame, cropping edges if needed |
| Free | Stretch to fill the frame exactly (may distort) |
Layering modes
Media players support two layering modes:
| Mode | Description |
|---|---|
| Full Screen | The media fills the entire frame — the default for standard playback |
| Overlay | The media acts as a floating overlay on top of the program output |
Using overlay mode
Overlay mode turns a media player into a toggleable overlay — useful for video bumpers, animated lower thirds, or B-roll that composites on top of a live camera.
- Edit the media player source
- Under Layering, choose Overlay
- Set position, scale, and opacity as needed
- Tap the source thumbnail to toggle it on/off the overlay stack
In overlay mode:
- Playback starts automatically when the overlay is toggled on
- A progress bar appears on the thumbnail showing playback position
- Auto-dismiss (enabled by default) removes the overlay from the stack when playback finishes — useful for video bumpers that should disappear on their own
Audio
Video files include audio, which appears in the mixer at the source’s slot number. Photo and graphic sources produce no audio.
OSC control
| Address | Args | Description |
|---|---|---|
/pmix/media/{n}/play |
— | Play |
/pmix/media/{n}/pause |
— | Pause |
/pmix/media/{n}/stop |
— | Stop and reset |
/pmix/media/{n}/seek |
float 0–1 | Seek to position |
/pmix/media/{n}/rate |
float | Set playback rate |
/pmix/media/{n}/loop |
int 0/1 | Enable/disable loop |
Use cases
- Pre-roll video — Play an intro video before your live show starts
- B-roll — Cut to pre-recorded footage during a live production
- Title cards — Display a static image/graphic between segments
- Music videos — Play a music video as a source