MadMapper Projection Mapping for VJs: A Setup That Survives Load-In

LIVE PERFORMANCEVJ

Build most of your MadMapper setup before you reach the venue: input, output size, test pattern, quad and mesh warp, locked outputs and a saved project. Here…

01/ ARTICLE

Snow leopard photograph rendered as a halftone with 8px cells at 45 degrees, the kind of high-contrast visual a VJ would feed into a mapping app subject: snow leopard · look: halftone · cell 8px · angle 45° · shape circle · Image made with kott.io

What order should you build a MadMapper setup in?

Build it in this order: feed the video in, set the output size, align with the test pattern, warp the surfaces, lock the outputs, then save the project. Most of that can happen at home against a rough stand-in for the venue. Only the alignment step needs the real projector and the real wall.

Diagram of a four step chain from source to resize to dither to output, showing the order content moves before it reaches a projector diagram · left to right: source, resize, dither, output · seed 7

Projection mapping in MadMapper is the process of taking an input, such as a movie, an image or a live feed from another app, and placing parts of it on surfaces that you warp to fit physical objects. This guide follows the order of MadMapper's own documentation. Where a value comes from the docs, it is linked. Where a step depends on your venue, it says so instead of inventing a number.

The official One Projector Setup tutorial is the right first watch if you have never opened the app. What follows is the load-in version for a VJ who already has visuals running.

How do you send your VJ app into MadMapper?

Use Syphon on macOS, Spout on Windows, or NDI on either. MadMapper's feature list names "Spout-Syphon send / receive" and "NDI send / receive" as the way it shares textures with other graphics applications, so your VJ software publishes a texture and MadMapper picks it up as an input.

Keep that split. Your VJ app owns the look and the performance; MadMapper owns the geometry. If you are still choosing the VJ side, picking your first VJ software covers it.

MadMapper can also play files itself. The feature list mentions native HAP decoding, which matters if you run pre-rendered clips rather than a live feed.

How do you set the output size and display?

Open the Outputs tab with Cmd+5 on macOS or Ctrl+5 on Windows. The Outputs docs describe a Video Output as the way to add outputs for connected displays, projectors or LED wall processors.

Three fields do most of the work:

  • Destination picks the physical display or a virtual target. It shows the GPU, the resolution and the frequency, so you can confirm the projector is running at the mode you expect before you blame your mapping.
  • Output Size sets the pixel width and height. You can lock the aspect ratio and toggle fullscreen.
  • Flip mirrors the output horizontally, vertically or both. The docs call it essential for rear projection.

Match the output size to the projector's native resolution when you know it, because a mismatch makes the display scale the image and softens the edges you just aligned. Your GPU decides how many outputs you can run; the features page says it is limited only by what the GPU can handle. If you are sizing a laptop for this, see what hardware you need to VJ.

For a bigger canvas, a Destination can split one canvas across several displays. The docs give the example of a 4K canvas divided into a 2x2 grid of 1080p outputs for a video wall controller.

How do you align with the test pattern, quad and mesh warp?

Turn on Show Test Pattern on the output, then fit a quad to the surface, and add mesh warp only where the quad cannot follow the shape.

The test pattern is a built-in test card for alignment, and it belongs to each output. It tells you whether the projector, the cable and the destination are right before any of your content is involved. If the test card is wrong, no amount of warping fixes it.

Quads, circles, triangles, masks and lines are the surface types listed on the features page. Start with a quad and pull its corners to the corners of the real surface. Switch on mesh warping per surface when straight edges do not match, for example a curved or uneven face. MadMapper lists "unlimited points Bezier Meshwarping", and the mesh warping guide describes generating a grid over the image and lowering that grid's opacity with an additive blend mode so you can still see the content underneath while you adjust.

Use bezier masks to cut out windows, doors or anything the light should not hit. The features page lists multiple bezier masks per surface with feathering. A short feather hides a slightly imperfect edge better than a hard cut does.

Load-in stepWhat to use in MadMapperWhat it protects you from
Confirm the displayDestination shows GPU, resolution, frequencyProjector running at the wrong mode
Check the signal pathShow Test Pattern on the outputDebugging mapping when the cable is the problem
Fit the surfaceQuad corners, then mesh warpContent spilling past the real edges
Hide spillBezier mask with featheringLight on windows, doors or neighbours
Keep projectors in syncFrame DelayOlder and newer projectors drifting apart
Rear projectionFlipA mirrored image behind a screen
Freeze the resultLock the output, then save the projectA stray click ruining the alignment

What breaks at load-in, and how do you guard against it?

Most load-in failures are small settings changing under pressure, not software bugs. The docs point to several, and each has a cheap guard.

An output gets disabled mid-show. The docs say that disabling an active output during a show closes its fullscreen projection immediately. Outputs can be locked, so lock them once the alignment is done.

Mixed projectors fall out of sync. If the venue gives you an older projector next to a newer one, use Frame Delay on the output. The docs describe it as adding small delays so mixed setups stay in sync. How much delay you need depends on the hardware, so judge it by eye with fast content on screen.

The image is mirrored. Rear projection needs Flip. Check it with the test pattern before the doors open, not with your logo on screen.

The mapping is fine but the visuals look wrong on an LED wall. That is usually a content problem, not a mapping one. Why your visuals moire on the LED wall covers pixel pitch against a camera sensor.

You lose the project. MadMapper's Advanced docs list Project Backup & Recovery and Performance Optimization as their own topics. The page that lists them does not give settings, so read those pages for your version. Whatever the version, save a copy of the finished project under a new name before the event, and use Save Video Snapshot on the output to keep a frame of how the map looked when it was right. The Outputs docs say it exports the current frame, for example as an 8-bit RGBA PNG.

Keep this as a checklist you can copy into your notes:

  1. Input arrives from the VJ app over Syphon, Spout or NDI.
  2. Destination shows the right display, resolution and frequency.
  3. Output Size matches the projector.
  4. Flip set correctly for front or rear projection.
  5. Test pattern checked, then switched off.
  6. Quads fitted, mesh warp only where needed.
  7. Masks feathered.
  8. Frame Delay set if projectors differ.
  9. Outputs locked.
  10. Project saved under a new name, snapshot exported.

Can you control it from MIDI or OSC?

Yes. The features page lists MIDI input and output, OSC input and output with OSC Query support, gamepads and Stream Deck as controllers. Most VJs drive the content from their VJ app and leave MadMapper as the geometry layer, so you may only need a few controls in MadMapper itself, such as master opacity or scene changes. If you are choosing hardware for the VJ side, VJ controllers compared covers the options.

Where to take it next

The setup above has to be right on the day. The look of the visuals you can work on at home. If your content leans on dithered or halftone textures, build and preview it in kott studio, then send it into your mapping setup as a clip or a feed from your VJ app.

Frequently Asked Questions

Does MadMapper work with Resolume or TouchDesigner?

MadMapper can receive video from other apps through Syphon on macOS, Spout on Windows, or NDI. Any app that can publish to one of those can feed it, and MadMapper's own docs describe texture sharing with other graphics applications.

How do I get an alignment grid in MadMapper?

Use the output's Show Test Pattern toggle for the built-in test card, or add one of the built-in grid generators as content. MadMapper's mesh warping guide lowers the grid's opacity and switches its blend mode to additive so the picture underneath stays visible.

Can MadMapper split one canvas across several projectors?

Yes. Destinations can split one canvas across displays, for example a 4K canvas into a 2x2 grid of 1080p outputs. Soft-edge blending is listed among MadMapper's engine features for overlapping projectors.

Images in this article were made with kott.io.

02/ OUT

Try it in the studio

Every setting described above is a real control. Open your own image and sweep it.

In kott, the beat, the bass or an EQ band you define can move any control of any effect: how the audio routing works.

All journal entries