You BPM may be set to zero : check it out in Master Tab.
Try to set the Global BPM to manual/120 BPM.
MadMapper should support any camera that has AVfoundation support.
However, as a protection against crappy drivers, if MadMapper crashes while opening a camera driver once, it won't try again until you trash preferences.
You can reset this behavior by pasting the following command in Terminal.app and restarting MadMapper: defaults delete com.garagecube.MadMapper crashing-live-inputs
If you experience a crash at startup on Windows and you have installed OBS Studio on the computer, it might be caused by the “Game Capture” feature of OBS Studio, which allow this application to grab MadMapper output directly by inserting itself between MadMapper and the graphics card driver.
While it works in our test environment we received MadMapper crash reports showing a crash happening in the dll "C:\ProgramData\obs-studio-hook/graphics-hook64.dll”.
You can try uninstalling OBS Studio and restarting your computer to see if it solves your issue with MadMapper.
If you receive an error message at startup while using en eGPU, please right click on MadMapper.app to "Get Info", then make sure "Prefer External GPU" is unchecked prior to launching MadMapper.
If your installation file does not seem to work, we advise you to first make sure that your Internet connection is stable, without intermittency, then re-download the installation file available in the Downloads tab of your user account.
For further assistance, feel free to contact us via the contact form.
Go to the Output menu and activate "Show Info". "Show Cursor" can help too.
Apple stopped the support of the Python language in its latest OS, Monterey.
Which means MadMapper v1 to v4 versions are not compatible anymore with macOS Monterey.
Feel free to contact the support team for further help.
License Helping
What’s a reset?
Your MadMapper license can be used on one to several computers (seats).
You can switch your license from a computer to another at any time and as many time as you want. You'll only have to logout first from the previous computer(s).
If you don't have access to one of your computer anymore you can remotely log it out from your license by using a reset.
Such procedure is directly available in your MadMapper user account, license tab.
Please beware that it's an emergency procedure, therefore limited in time for security reasons.
I can’t import my license
First, double-check that your serial number is correct and that it is a license number that belongs to you.
If the site tells you that your licence has already been imported but you do not see it in your account, please contact our Support.
I just purchased MadMapper, I dont have my serial number
The licence(s) you purchase will automatically appear in the Licences tab of the user account that made the purchase (yours).
Serial numbers may take up to 48 hours to generate.
I don’t see my license while trying to activate MadMapper
You may not be logged in with the correct login, you may not have imported your licence(s) yet, it may not have been generated following your purchase, or your purchase may have failed.
Please check this information first (from your emails, from the MadMapper website user account) and do not hesitate to contact our Support.
How to use the license to activate MadMapper?
Login into your user account on the MadMapper website to download MadMapper.
After installed, launch the software, you’ll access to the authorisation manager first.
Select the product(s) you want to install, login with your user account and finally select your license to authorize and use MadMapper.
MadMapper tells me it can't connect to the server to authorize the program
Make sure you do not use internet connection blockers.
On macOS make sure that PROXY SOCKS is disabled in your System/Network Preferences.
How do I de-authorize MadMapper?
Go to the Account menu / Manage Authorisation: the licensing tool will allow you to de-authorize MadMapper or authorize an extension.
Use your MadMapper login and password.
I can't find my license or previous purchases in my user account
You may not be logged in with the correct login.
Try connecting with other e-mails that may have been used for your user account(s).
Can I consolidate my purchased licenses into a single license?
Our system does not allow it. But we did improve the licensing manager with the new user account, allowing to consult serial numbers, the number of seats to which they entitle as well as the number of available seats.
I need the purchase invoice for my license
If you need to re-download the purchase invoice for your license, you must go to your user account, under the orders section.
Invoices are available for download, for every order.
My computer is no longer working or has been stolen, how do I remove it from my license?
If you no longer have access to one of your computer(s) for the reasons mentioned above or for other reasons, you will not be able to de-authorize it from the software.
You must then use the remote reset procedure, available in your user account, which will allow you to remotely de-authorize a computer linked to your license.
For security reasons this procedure is an exceptional measure: you will have to wait a year before using a remote reset again.
I forgot to de-authorize my computer, what should I do?
If you forgot to de-authorize MadMapper before formatting, before reselling your computer, or for any other reason, you will no longer be able to do so directly from the software.
You must then use a remote reset (please refer to the previous article).
How many remote reset do I get with my license?
Under 10 seats you’ve got 1 reset per year (365 running days period).
From 10 seats you’ve got 2 resets per year.
I don't have any more remote reset available, how can I de-authorize a computer?
In this case, please provide us with your license’s serial number as well as the computer name you need to remove through the contact form.
We will de-authorize the computer for you, only upon presentation of a relevant document relating to the repair or theft of your computer.
Issues with MSI computers (Windows)
We have recently noticed a problem that our users sometimes encounter on their MSI computers: after a reboot, the unique machine ID changed, forcing them to re-authorize MadMapper.
We have a solution, so if you are in this situation please contact us through the contact form.
We made a demo video available here (only for beat matching) : https://youtu.be/0MbcimSV2VY
Adjust perspective for surfaces groups
If you select a surface group, the geometric adjustment in the output will only change X and Y value.
In MadMapper 4/5 you can activate “perspective” option in the group settings. In previous releases, press “alt” when moving the handle of the group, it will do perspective.
With a multi-selection of surfaces ("shadow group") press "alt" when moving the handle of the group, it will do perspective as well.
Assigning multiple OSC channel per control
It's actually limited to one assignment to a control per controller type (MIDI/OSC/DMX/etc.).
However there are two options: create cues with various "visibility" setups (add the visibility of your surfaces in some cues using Cues "Edit" mode, check Scenes & Cues doc in Help menu or look at youtube video tutorials) or use the "Controls Combiner" module to combine multiple inputs to a single control.
Background image not displayed in the output window
The output remains black if no content is loading.
The background image is only for preview.
Broadcast vs Unicast for Light mapping
Broadcast (preferred for small installations) is transferring data to all network device simultaneously and is easy to configure.
Unicast (preferred for bigger installations including a lof of DMX universes) is transferring data to each network device independently and have much better performances by sending data only where is needed.
Unicast need an extra configuration.
Cameras for live video input
MadMapper supports cameras as a source input.
On macOS you can use any USB camera for live feeds as long as it is supported by QuickTime.
We can’t recommend any specific one as we have not tested all cameras on the market.
On Windows, you can use any camera that supports DirectShow (most of them do, but check first).
Cameras for Spatial Scanning
For the spacial scanner feature we only support the Canon SDK, meaning you can use a Canon camera in full resolution, otherwise other cameras can work as webcams if compatible with quicktime (macOS) or directshow (windows).
You may not get the proper full resolution of your camera as the video signal will be processed through usb, through webcam.
macOS: everything that can be seen via QuickTime (since both QuickTime and MadMapper use AVFoundation for the cameras), and if the manufacturer provides an AVFoundation driver or uses a standard protocol.
Windows: the manufacturer must provide DirectShow support. We strongly recommend that you try the MadMapper Demo to make sure your hardware is compatible before purchasing the software. Other recommendations: the less compression the better. The higher the resolution the better. A second-hand Canon camera (entry-level) is a good way to go.
Can I scale multiple selected 3D surfaces at once?
3D Surfaces are mostly made for calibrating to the physical world object - calibrated objects can't be moved afterwards.
This is the reason why 3D surfaces cannot be modified by "group" selection.
Codec recommendation
H264 is the standard recommend video codec.
For (very) high resolutions, HAP codec is recommended.
Custom light fixture
You can do whatever you want with the pixel colors using pixels of type "custom" and choosing "Expression".
Then you're writing GLSL code and you can introduce tests and mathematical functions (GLSL compliant).
There is a short demo here: https://www.youtube.com/watch?v=QgxyNQSMmns
Disable the pop-message at startup
It’s useful, for instance, for permanent installation.
Go to MadMapper Preferences/Misc and select “Silent Mode” (avoid prompting users during permanent installations).
DMX Interfaces compatibility (Art-Net)
Any LED driver that supports Art-Net (broadcast or unicast) or sACN (multicast only) will work with MadMapper.
DMX interfaces compatibility (USB)
Officially supported devices are the garageCube usb-to-dmx, the Enttec Open USB DMX and the Enttec DMX USB Pro MKII.
We cannot guarantee compatibility and reliability anymore for other equipment.
DMX interfaces over Wi-Fi
You could use them with MadMapper, for instance the AirPixel ONE. If you face difficulties during your setup, try to deactivate the "Unicast" option in the MadMapper Preferences/DMX Output, try to deactivate "Universe Synchronisation" as well since some LED drivers don't handle it properly.
Enttec Pro & Mk2 DMX in/out
Enttec Pro & Mk2 support DMX in & out, but you can't use it for input & output simultaneously.
Fading audio
One way is to use the audio from a movie file, create scenes/cues and then update all your scenes/cues so that the parameter "Audio Linked To Opacity" of all movies in all scenes/cues is activated.
Fading effects
MadMapper will not fade between two effects.
You must use two surfaces to do that. Fading normally smoothly change the parameter, but we can't fade the "FX Name" parameter, so it just switches.
There is a spacial case for fading Visual, which is done by rendering the surface twice with different opacity & the previous & new visual.
But that is not the case for FX.
Fixture group cloning and addresses shifting
Here’s a workaround: use the "Edit/Clone Selected Fixtures" option instead of "duplicate".
It will not alter the DMX patching. Then you can right click a selection of fixtures and choose "Shift Addresses”.
Fullscreen output (macOS)
If you want to have fullscreen output(s) on video projector(s) and MadMapper user interface on another screen (ie. laptop screen), do not maximise MadMapper user interface window, or enable “Displays have separate spaces” on macOS System Preferences.
How to stream your video mapping with OBS (Windows)
Here’s a tutorial : https://www.youtube.com/watch?v=2GtTxHNCzzs&fbclid=IwAR1WRDv-AG8xzFwvcxjTDnf-PySG2o7H-Dv_Au5gGcJxHZYPRKkq4ysabZA
Import SVG fixtures
Here’s a tutorial on how to import fixture(s) from an external file using SVG: https://vimeo.com/202367567.
Note that you can make an SVG with just lines. From that you can import DMX fixtures and Video Lines surfaces.
Limit the frame rate for NDI output
Since MadMapper 4 you can force the engine FPS. To do so, go to Preferences/Engine, set Engine FPS to “Manual”, then choose the desired FPS.
The whole MadMapper engine will try to run at this FPS if possible.
Map a 3D object in MadMapper
Here’s an helpful tutorial about 3D calibration : https://www.youtube.com/watch?v=nJa0xTkTUx4
Map DMX fixtures on a media
You can’t directly map DMX fixtures on a media, but you can use as media the video output of a MadMapper projector through Syphon (macOS) or Spout (Windows).
Then you can do video compositing on your fixtures and have a better overview of your show in your previews.
Here’s a video tutorial showing the process : https://www.youtube.com/watch?v=ielXPTqh79E
Multi audio channel (Windows)
On Windows, in order to have multi-channel output, you must go to MadMapper's Audio Preferences and choose as driver type "ASIO".
Then you can restart MadMapper and check that the selected sound card is the right one. It will then output/input on all channels.
Multiple GPUs (Windows)
If you do have multiple GPUs, be sure to set the Main Display of Windows Display settings to a screen connected on the most powerful GPU.
MadMapper will do all the processing on the GPU attached to the main display.
When we'll switch from OpenGL to Direct3D on Windows, multiple GPU support will be improved, although we can't say when this will be ready.
Numbers of universes supported by MadMapper
MadMapper supports Art-Net 4, so it can address universes 0-32767 with a software limitation to 16384 universes.
Open file at startup
You can add the project file to the startup elements of your system and make sure that "fullscreen when opening a project at startup" is checked in the MadMapper Preferences/Misc tab.
Silent mode is a great option too.
There's no other way to achieve this unless you use a MiniMad device (the MadMapper standalone player).
Pixelite tip
Activate the "Skip last universe channels if needed" option.
It’s needed when using more than one universe on an output with Pixelite.
Record your video mapping
If you do need to record your mapping as a video file, there are 3 options: with a Syphon/Spout Recorder (you’ll have to publish your projector to Syphon/Spout in the Projectors Tab), an NDI recorder such as OBS or a capture card on another computer.
Recommend lens for spatial scanning
The best is to have at least one pixel of the camera for one pixel of the video projector. More is better. So if you can have a lens that makes your projection area fill the camera picture it's enough.
Scenes and Cues in a nutshell
In MadMapper you can create scenes & cues (basically presets) in the same grid. Scenes is the first row. Scenes are restoring the complete state of your mapping (surfaces, fixtures, medias, and some modules). Cues are storing a user chosen set of parameters (ie you can store only surfaces colors on a cue grid row, while storing different sets of media assignment on another row).
Short throw projectors and 3D objects
Short throw projectors are not supported for 3D calibration simply because it's impossible.
A short-throw projector will show a flat-uniform picture at a certain distance on a flat surface parallel to the projector but the picture is quite altered in the space.
However by using quad mesh warping with bezier, you might be able to project your content but not using a 3D object.
Synchronize two videos
You may want to synchronize two different videos in MadMapper, the easiest way is to create a wide video with both video side by side, then on surfaces adjust the input rectangle to use the video you want.
To do so you can use Adobe Premiere, Final Cut, DaVinci Resolve or any video editing app.
GarageCube usb-dmx driver (Windows)
If MadMapper sees your controller but can't open it, you'll probably get this message: "You must enable generic USB driver for the ShowJockey device using the free application Zadig".
So please download "Zadig" from http://zadig.akeo.ie and install it.
Start "Zadig" and choose your device, then choose driver WinUSB and press "Install Driver".
After restarting MadMapper, your device should be available.
Uninterrupted Audio module playback with scenes/cues
Select your scene or cue, open the Cue Inspector, browse to "/Modules/MyFile.mp3/Player/Replay" and uncheck the value checkbox.
Update output geometry option for groups
As it’s often requested we made a video tutorial showing our best practice: https://www.youtube.com/watch?v=uG2yFdKKHXM&feature=youtu.be
Using a Photoshop file for live preview
Simply drag & drop a PSD file to get the image loaded in the medias (you won’t have access to layers individually though).
Then if you want to work in real-time in Photoshop and map with MadMapper, you can use a NDI plugin to get the Photoshop work area streamed live in MadMapper.
3D geometry and LED fixtures?
Here’s the trick: "unfold" your shape in to a 2D representation.