Phosphor user manual
How to play a show with Phosphor, from the first clip to mapped projectors, LEDs and lasers. Help › User Manual (or the ? button at the top of the app) opens this page in your language.
On this page: Install · Play · Music and the beat · Quick visuals · Effects and shaders · Control · Phones · Mapping and outputs · LEDs and DMX · Lasers · Video in and out · Saving and shows · AI assistants · Updates and help
Install
Download Phosphor for a Mac (Apple silicon or Intel), Windows 10 or 11, or a Raspberry Pi 5 from the download page, or open it in Chrome or Edge with nothing to install. On a Mac, unzip it and drag Phosphor into Applications. On Windows, run the installer, or unzip the .zip and run Phosphor.exe; if SmartScreen warns once, press More info, then Run anyway. After that, Phosphor updates itself.
Play: layers, clips and transitions
- Drop movies, pictures or sound files into the clip grid. Each layer plays one clip at a time, and the layers mix with blend modes. Group layers and use the crossfader between groups.
- The grid has as many columns as you like, and banks for the keys 1 to 9. One click on a column header fires that column on every layer.
- Choose how a clip comes in: cut, fade, blend, or any effect as a transition. Launch it now, on the next beat or on the next bar.
- Each clip keeps its own settings. Trigger modes per clip: normal, toggle, flash (plays while held) and piano.
- Movies play their own sound, and sound files can be clips too. A cue list follows timecode (MTC, LTC) when the show has to run to a soundtrack.
Music and the beat
- Phosphor finds the tempo of the music by itself. Tap tempo, MIDI clock and Ableton Link work too.
- The music can come from a microphone, an audio input, the phones of people watching the session, or the clips Phosphor itself plays (Audio › Clip sound).
- Match the beat finds a movie's own visual rhythm and locks it to the tempo.
Quick visuals and Auto show
- From the top bar, ⌘K or a mapped pad: Surprise (a random look on every layer), Shuffle, React to the music, Fill clips with variations and Instant Set.
- Auto show moves to the next column every few bars and throws a Surprise on the drops, so the show runs itself.
Effects, generators and shaders
- Dozens of effects and generators are built in, including a Rutt-Etra, master effects and text layers.
- ISF shaders run as generators and effects: 325 of the 327 in the ISF collection import, and most MadMapper materials. Shaders with audio inputs follow the music.
- The Shader Editor panel compiles as you type, with a live preview.
More: ISF shaders, where to put them and what works.
Control: MIDI, OSC and the keyboard
- Right-click any slider, button, pad or clip cell, press Listen, then move a knob or hit a key: it is mapped. Right-click again to forget, invert or set the range.
- Right-click › Modulate puts an LFO, the audio level, the beat, a step sequencer or an envelope on any value.
- OSC works the same way, with OSC Query so other apps find Phosphor's controls. Build your own control surfaces (pages, XY pads, colour) and export a TouchOSC layout. Controllers with lights get the state back.
More: VJ with a MIDI controller.
Phones
- Start a session and scan the QR code (or type phosphor.local) for a remote page on any phone on the same Wi-Fi: mixer, clips, your control surface, layer pictures and Auto show.
- Audience play shows a second code, also as a layer on the output: guests line up and take timed turns at the controls you allow.
Mapping and outputs
- Add an output for each projector or screen. Drag a surface's corners onto the wall, turn it into a mesh to warp it, and add masks with soft edges.
- Two projectors overlap? Edge blending hides the seam. Each output has its own colour correction.
- Line slices and 3D models (OBJ) cover most objects. Venue presets remember a whole room.
- Outputs › Stage shows every output where it really is in the venue: drag and size them on one big canvas.
- Phosphor renders at 60 frames a second by default, or 30, or the display's own rate.
More: projection mapping step by step.
LEDs and DMX
- Lay LED strips, rings, matrices and video-wall tiles on the picture in the LED / DMX panel. The pixels under them go out over Art-Net or sACN, or one universe of USB DMX.
- Find PixLites reads how each Advatek PixLite output is patched, and Add makes the matching strips. Flash and Chase show which string is which and which way it runs.
- Choose the network adapter for the lights, so the rig can have its own Ethernet while the computer stays on Wi-Fi.
- A lighting desk or another program can control Phosphor over Art-Net or sACN (DMX in). LED / DMX › Record DMX records what comes in and plays it back.
- Moving heads and fixtures from the Open Fixture Library work in their basic modes.
More: LED pixel mapping over Art-Net or sACN.
Lasers
- The Laser Designer draws shapes, waves, Lissajous figures, beams and words, plays ILDA files, and traces live video or pictures into outlines. Draw lines by hand over an onion skin and animate them.
- Phosphor sends to Ether Dream, Helios, LaserCube and IDN lasers, with zones, dark areas, arming, a safety floor per projector, a test pattern for lining up, and Blackout.
Video in and out
- Plays H.264, HEVC, ProRes, VP9, AV1 and Hap, decoded by the hardware. Cameras, capture cards, network streams, Syphon, Spout and NDI come in as sources.
- Send the output out over Syphon, Spout or NDI, stream it to YouTube or Twitch (two at once, with a recorded copy) or to RTMP and SRT, and record H.264, HEVC, ProRes or Hap.
Saving and shows
- Undo works everywhere, and crash recovery brings the show back after a crash.
- File › Save Packed Show… puts the whole show in one .phosphorpack file (the project, every media file, shaders and LUTs) to carry to another computer. Open it there with File › Open.
- Session panel › Send this show sends it to another Phosphor on your network; nothing arrives without a yes on the other side.
- File › Export Show writes a standalone app with the media inside. Lock Controls makes it play-only, with a password to get back in.
- Phosphor opens Resolume compositions (.avc), VDMX projects and MadMapper projects, and finds missing media.
More: an installation that runs itself.
AI assistants
AI apps that speak MCP can list, set and trigger every control in Phosphor and see the output: start Phosphor with --mcp.
Updates and help
- Phosphor finds and installs updates itself (Help › Check for Updates…).
- Help › Report a Bug sends a problem straight to us. We aim to fix what you report within 24 hours.
- Questions and ideas: G Workshop support.