Macroverse GitHub Showcase Page

This is the project showcase/overview page, not the primary live runtime.

Macroverse 42 — The Wired Atelier

MACROVERSE 42

The Wired Atelier

GitHub Showcase Page // not the primary live app

your whole library, live — search it, tag it, perform it

Try it live Download Source on GitHub Help & Shortcuts

move your cursor to warp the field  ·  ~ opens the live GLSL editor
run it in Macroverse — bind every slider to MIDI faders or OSC · expose hidden uniforms & numeric literals · pipe in audio FFT · watch it react
broken shader? the LLM repair chain fixes it: regex → Ollama → AI · or dream up entirely new shaders from a single prompt · A/B deck · crossfader · tag · search · perform your whole library · stream live to OBS · export to Wire

Two ways in

Standalone VJ Tool

Browse and perform with your full GLSL/ISF library. A/B crossfader, mix modes, MIDI/OSC mapping. MJPEG stream to OBS or virtual webcam. Tag, search, revert. All signals, one window.

Resolume Wire Pipeline

Load any GLSL file, check Wire compatibility, expose magic-number literals as ISF sliders, run the shader fix chain (regex → Ollama → AI), and push the finished macro straight into Resolume Wire with working parameters.

Quick start

# Download a release binary, put it in your shader folder, run:
.\Macroverse42.exe          # Windows
./Macroverse42             # Linux / Mac
# open http://localhost:8765

# Or build from source:
git clone https://github.com/aday1/Macroverse.git
cd Macroverse/api
go build -o ../Macroverse42 .
cd .. && ./Macroverse42

Features

Preview
Real-time WebGL preview for any GLSL/ISF shader
Expose
One-click: turn magic numbers into ISF sliders for Wire
Fix chain
Broken shader? Regex → Ollama → AI repairs it in order
VJ deck
A/B crossfader, mix modes, auto-cycle, MIDI/OSC mapping
Wire export
Check ISF compat, clipboard to Wire, push with params
OBS stream
MJPEG stream at /api/output/macrocam/stream
Git history
Auto-commit on save, browse and revert any version
Library
2000+ shaders: tags, categories, emoji badges, search

Screenshots

Add your own to docs/screenshots/ to populate this gallery.

Full UI
Context menu
Grid view

Help & Keyboard Shortcuts

Gallery
← → ↑ ↓ — navigate between shader cells
Gallery
Alt+← / Alt+→ — previous / next page
Gallery
1–9 — toggle preset tag on focused shader (same key removes it)
Gallery
Shift+1–9 — toggle preset VJ Set on focused shader
Gallery
A — set-toggle prompt (shows all sets, current membership)
Gallery
F — toggle favourite
Gallery
R — rename focused shader
Gallery
? — show / hide keyboard shortcut HUD
Gallery
Space — toggle auto-advance (cycles focus automatically)
Export
Export ▾ menu: CSV · JSON · paths (.txt, one per line → Resolume Avenue)

Preset VJ Sets (Shift+1 through Shift+9)

1
vj-ambient
2
vj-techno
3
vj-cosmic
4
vj-glitch
5
vj-geometric
6
vj-organic
7
vj-wire-ready
8
vj-dark
9
vj-colour

Common Actions

Preview shaderClick it in the list
SearchType in the filter box (name, tag, category)
RenameDouble-click name, or right-click → Rename
Move categoryRight-click → Move to category
Add tagsClick + next to tags, or right-click → Edit tags
Expose parametersClick Expose in the code toolbar
Send to WireClick Clipboard to Wire (after Expose)
Version historyRight-click → See versions → click any to revert
A/B VJ deckClick the VJ tab
Gallery browseClick the Gallery tab
Webcam inputRight panel → Texture inputs → Webcam
Full screenClick Full Screen in status bar, or press F11

Settings Reference

Source pathsAdd / remove folders to scan. Default: shaders/
LLM Provider ChainEnable/disable Local regex · Ollama · Cursor per-provider
Hard Reset (git)Zip the configured target folder and restore it from git. Target path configurable in Settings → Hard Reset Path.
NUKEBackup DB → clear index → rescan disk. Shader files unchanged.

OBS / Streaming

# MJPEG stream for OBS Browser Source:
http://localhost:8765/api/output/macrocam/stream

# Linux virtual webcam (requires v4l2loopback):
ffmpeg -i http://localhost:8765/api/output/macrocam/stream -f v4l2 /dev/video0