# Video Configuration

The Video Configuration page is where you upload video files, assign them to MIDI notes, and configure playback behavior.

Click on the **VIDEOS** link on the left side bar to open the Video Configuration Page.

<figure><img src="/files/2q88Esjs9EHmG57sAooK" alt=""><figcaption></figcaption></figure>

***

## Configuration Slots (A-E)

<figure><img src="/files/oHKDUvJ6jyezuyadL07l" alt="" width="440"><figcaption></figcaption></figure>

Five independent video configuration banks. Each slot has its own set of MIDI note-to-file assignments. Click a slot button to switch.

* Switching slots loads that slot's assignments immediately
* Rename any slot by clicking the pencil icon
* Switch slots during a live show via MIDI CC #119 (values: 10=A, 20=B, 30=C, 40=D, 50=E)
* Video and Lighting slots are **independent** -- you can have Video on Slot B and Lighting on Slot D

> *For more on slots:* [*Configuration Slots (A-E)*](/6.-configuration/configuration-slots.md)

## Global Video Settings

<figure><img src="/files/vyhqJ4gF2X44AZWpcMYc" alt=""><figcaption></figcaption></figure>

### MIDI Channel

Select which MIDI channel (1-16) triggers video clips. Default is **Channel 1**. The dropdown excludes whichever channel is assigned to Lighting to prevent conflicts.

### Video Mode (Beta)

> **Note**: Video Mode is only visible when **Beta Features** are enabled in [System Settings](/6.-configuration/system-settings.md).

Choose between two playback modes:

| Mode             | Description                                                                     |
| ---------------- | ------------------------------------------------------------------------------- |
| **Fast Trigger** | Standard mode. Instant video switching on MIDI trigger. Supports up to 4K.      |
| **Effects**      | Enables real-time video manipulation via MIDI CC 48-55. Limited to 1080p 60fps. |

Changing video mode requires confirmation -- a dialog warns that switching will immediately stop any currently playing video or lighting cue. See [Effects Mode](/2.-video-setup/effects-mode.md) for details.

### Playback Option

Controls what happens when a video clip reaches the end:

| Option     | Behavior                                                  |
| ---------- | --------------------------------------------------------- |
| **Loop**   | Video restarts from the beginning automatically (default) |
| **Freeze** | Video holds on the last frame                             |
| **Blank**  | Screen goes to black                                      |

### Default Video on Boot

Select which video plays automatically when the MVP starts up. Options include:

* Any video or still image
* **BLACKOUT** (starts with a black screen)

### Edit Mode

Toggle **EDIT MODE** to enable configuration changes. When off, the page is read-only to prevent accidental edits during a live performance.

***

## MIDI Assignment Grid

<figure><img src="/files/aLbA7E4lnsTCNXYAMsnO" alt=""><figcaption></figcaption></figure>

The main area contains **100 cards** (MIDI notes 0-99):

### Card 0 -- Blackout

Always present, labeled **"VIDEO 00 - MIDI: C-2"** with the description "Black Out Clip." Triggering Note 0 on the video channel sends the output to black. This card cannot be reassigned.

### Cards 1-99

Each card shows:

* **Header**: Video Number and MIDI Note (e.g., "VIDEO 01 - MIDI: C#-2"). Note names use standard MIDI naming: C, C#, D, D#, E, F, F#, G, G#, A, A#, B with octave = floor(note/12) - 2.
* **File selector**: Autocomplete dropdown to assign a video file (only functional in Edit Mode)
* **Hint line**: When assigned, shows `FileName - FileSize`, clickable to show the Video Details
* **Currently playing indicator**: Green pulse animation on the active clip's card
* **Clear button**: Small X icon to unassign the video (Edit Mode only)

To assign a video to a note:

1. Enable **Edit Mode**
2. Click the dropdown on any card
3. Select a video file from the list
4. Click **Sync Changes to Playback** to apply

***

## Media Panel (Right Column)

<figure><img src="/files/9Fdzh9DXdwpTPPQypcda" alt="" width="337"><figcaption></figcaption></figure>

### Sync Changes to Playback

After making any changes, click **"Sync Changes to Playback"** to apply your changes. Changes do not take effect until synced.

### Upload Videos

Drag and drop video files onto the **upload zone**, or click to browse.

**Accepted formats:**

| Extensions                              | MIME Types                                               |
| --------------------------------------- | -------------------------------------------------------- |
| `.mp4`, `.mov`, `.m4v`, `.mkv`, `.webm` | video/mp4, video/quicktime, video/x-matroska, video/webm |
| `.jpg`, `.jpeg`                         | image/jpeg                                               |

Still images (.jpg, .jpeg) are supported and display as persistent stills on screen.

**Upload validation:**

* **Filename characters**: Only letters, numbers, dashes, underscores, dots, and spaces are allowed. Files with other characters are rejected with an alert.
* **Duplicate detection**: If an uploaded file's basename (extension stripped, case-insensitive) matches any existing video file, the upload is blocked. A dialog shows "File Already Exists" with the conflicting filename and instructions to delete the existing file or rename the new file first. There is no overwrite option.

Upload progress is shown in the **Upload Queue Widget** in the bottom-right corner.

### Search Stock Videos

Click **"Search Stock Videos"** to browse and download from a library of over half a million royalty-free videos. Requires a Wi-Fi internet connection. See [Stock Videos](/2.-video-setup/stock-videos.md) for details.

### Free Disk Space

Shows the remaining storage space available on the device.

### Unassigned Videos

Lists all uploaded video files that are not currently assigned to any MIDI note in the current slot. From here you can:

* View file details by clicking the info icon
* Delete files (with confirmation)

> **Note**: You cannot delete a file that is assigned in other configuration slots. A dialog will inform you which slots reference the file.

### Video Info Dialog

Click the info icon on any video to see detailed information:

<figure><img src="/files/B0gjMEhEQnchWjriPmcn" alt="" width="375"><figcaption></figcaption></figure>

| Field          | Description                                                                  |
| -------------- | ---------------------------------------------------------------------------- |
| **Thumbnail**  | Video preview image                                                          |
| **Filename**   | Full filename                                                                |
| **Resolution** | (e.g., "1080p (1920x1080)")                                                  |
| **Codec**      | Video format (e.g., "h264")                                                  |
| **File Type**  | Extension in uppercase (e.g., "MP4")                                         |
| **Duration**   | Total length (formatted m:ss)                                                |
| **File Size**  | Video file size (KB, MB, GB)                                                 |
| **Frame Rate** | FPS (e.g., "30 fps")                                                         |
| **Source**     | Source name with author link (stock), or "Local Upload" with date (uploaded) |

For still images (.jpg/.jpeg), only Resolution, File Type, and File Size are shown (no codec, duration, or framerate).

***

## Tips

* **Edit Mode is your safety net**: Leave it off during shows to prevent accidental changes.
* **Sync after editing**: Don't forget to click "Sync Changes to Playback" -- changes aren't active until synced.
* **Still images**: Upload .jpg files and assign them just like videos. They display as persistent stills on screen.
* **Effects mode is 1080p only**: If you enable Effects Mode, videos above 1080p will not play properly. Use Fast Trigger mode for 4K content.

***

## Related Pages

* [Stock Videos](/2.-video-setup/stock-videos.md) -- Free video library
* [All-Intra & Timecode Sync](/4.-timecode-setup/all-intra-videos.md) -- Video preparation for timecode
* [Effects Mode](/2.-video-setup/effects-mode.md) -- Real-time video manipulation
* [Configuration Slots (A-E)](/6.-configuration/configuration-slots.md) -- Multi-slot system
* [Triggering Overview](/5.-triggering/triggering-overview.md) -- All trigger methods


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.4cast.world/2.-video-setup/video-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
