vMix Folder Player

Number the files in a folder and this app will automatically generate a vMix playlist, plus a simplified web UI for users who only need the essential controls.

Base vMix Preset

Create a base.vmix preset in the content folder or its parent folder. The closest matching preset is used.

Content folder
  |-- base.vmix        <- used first, when present
  |-- 01 Video.mp4
  |-- 02 Audio.mp3

Parent folder
  |-- base.vmix        <- fallback for child folders
  |-- Session A
      |-- 01 Video.mp4

For overlays, title base inputs exactly:

Cam  -> camera input
Mic  -> microphone input

In the folder configuration, the cam and mic options are independent. Selected layers are ordered Mic (when selected), then Cam (when selected), then any visual overlay. If an image has the cam option enabled, the generator creates a colour input so the camera and image can be layered. Audio, video, photo-folder slideshows, and PowerPoint slides receive the selected camera input directly as a layer.

Content Folder

Number files to set playlist order. Unnumbered items are ignored.

Content folder
  |-- 01 Welcome.mp4
  |-- 02 Teaching.mkv
  |-- 03 Meditation.mp3
  |-- 03 Slide.png        <- overlays 03 Meditation.mp3
  |-- 04 Deck.pptx        <- PowerPoint slideshow
  |-- 05 Photos           <- folder slideshow
  |   |-- image-1.jpg
  |   |-- image-2.jpg
  |-- Notes.txt           <- ignored

Same number = overlay:

07 Audio.mp3
07 Image.png

Result:
07 Audio.mp3 + Image.png overlay

+ = reuse one overlay:

03 Audio.mp3
08 Audio.mp3
03+08 Photos

Result:
03 Audio.mp3 + Photos overlay
08 Audio.mp3 + Photos overlay

_ = sub-item ordering:

06_1 Slide.png
06_2 Slide.png

Supported inputs include images, video files, audio files, photo folders, and PowerPoint .pptx files.

Overview

1. Create a folder and order all the files with leading numbers.

2. Open the folder in the app and click "Open Config".

3. Review the playlist config. If needed, enable or disable the mic, adjust volume, or change the slideshow rotation time.

4. Save the config, go back, and click "Setup Folder in vMix". The app will create a .vmix preset file and open it in vMix.

5. The app also opens a simple web UI for users who are new to vMix and only need a "Next" button:

Run Dev

npm run css
npm run dev

Publish

Publishing uses Electron Builder's GitHub publisher configuration from package.json. Releases are published automatically when a version tag is pushed to GitHub.

npm version x.x.x
git push origin master --tags

The tag push starts the release workflow, builds the Windows installer, and publishes a GitHub release for that tag.

Format

npm run format

Test

npm run format:check
npm test

GitHub Actions runs the same checks on every push and pull request.

Links

• vMix Docs