MadMapper miniMAD User manual
1
mini
The hardware companion of MadMapper
User guide
2
mini
MiniMad is a all-in-one dedicated device for video mapping and LED mapping
based on the Raspberry Pi platform.
Easy to use, small and versatile, it can replace your computer for your future
mapping projects. The possibilities and limitations will be detailed in this guide.
MiniMad will either be congured with MiniMad Video to play a video-mapping,
or with MiniMad Light to play recorded DMX sequences.
WARNING :
MiniMad Video and MiniMad Light cannot be installed at the same time on the
same MiniMad.
www.madmapper.com
Designed and developed by garageCube and
1024 architecture
3
MINIMAD VIDEO
FEATURES 4
Surfaces
Media
Projector
Export
Network Synchronisation
CONTROLS 7
Buttons
Keyboard
MicroModul8
OSC
MiniMad Controller (OSC)
Network Synchronisation
MINIMAD LIGHT
FEATURES 13
Record
Export
Audio
CONTROLS 15
Buttons
Keyboard
Micromodul8
OSC
MiniMad Controller (OSC)
OSD
TOUCH OSC 18
INFORMATION
SPECIFICATIONS 20
Technical Specications
In the box
Turning o the MiniMad
SD-Card good practice
ADDITIONAL INFORMATIONS 22
TROUBLESHOOT 23
4
MiniMad VIDEO FEATURES
SURFACES
MiniMad supports 4 types of surfaces:
- Quad
- Triangle
- Circle
- Mask
Other surface types (line, 3D surface) and FX are
not supported yet.
MEDIA
MiniMad Video supports a single media at a time
on every surfaces.
Every image les supported by MadMapper will be
exported to MiniMad.
During the export process, movie les will be
transcoded and their resolution adapted to
maximize smoothness, depending on the selected
projector’s resolution and various settings found in
the Advanced panel.
There is no duration limit for your video les, but
they will not be able to exceed a size of 4GB (the
maximal size of a le on a FAT32 partition) for a
16GB SD-card, the largest capacity supported by
MiniMad.
PROJECTOR
The device supports a single projector connected
to the HDMI port.
The maximum supported resolution is 1080p
(1920×1080).
In case the selected resolution is not supported
by the actual connected projector, the device will
use the projector’s default resolution and display a
notication.
5
EXPORT
In MadMapper, click File > Export Video Mapping to MiniMad.
FFmpeg Tools is required to export MadMapper project to MiniMad, so please download FFmpeg Tools
Installer using the provided link.
You can either insert the MiniMad SD-card in your computer, or select a remote MiniMad connected on
the local network via ethernet (make sure both the MiniMad and the computer are on the same network).
If required, you may need to update your MiniMad SD-card, please refer to the dedicated UPDATE YOUR
MINIMAD SD-CARD section.
If necessary, update MiniMad as advised before exporting.
Then, select the projector you want to export to MiniMad, adjust the output resolution, the audio output,
the playback options, optionally unselect and reorder your medias.
In the case your mapping consists in a single fullscreen-quad with no color correction applied - typically
when displaying on a TV-screen, a video-wall, a straight video-projection or perspective-corrected by
the projector itself - MadMapper will propose you to switch the Fullscreen maximum quality mode on, so
your media will be exported using the best possible resolution (up to 1080p30).
Note that when this mode is on, mapping and color correction controls are disabled on the MiniMad.
You can also specify a nickname for the the Bonjour OSC Discovery, or disable it completely to prevent
the MiniMad from appearing in applications supporting Bonjour.
(cf CONTROLS / OSC section for more details).
FEATURESMiniMad VIDEO
6
EXPORT
For OSC control, you can either select automatic network conguration or manual network conguration
and input the IP-address and mask the MiniMad will use on the network.
When using automatic network conguration, the MiniMad will try to acquire its IP address and
mask from a DHCP server if there’s one available on the network, else it will use its internal network
conguration mechanism, getting a random 169.x.y.z IP address with a 255.0.0.0 network mask.
When using manual network conguration, and in case you export to several MiniMad units on the same
network, make sure each MiniMad has a unique IP address.
Once your mapping and media has already been exported to the MiniMad, you then have to option to
either export the mapping or the media.
You can also reset all of the export settings to default by clicking “Load Default Settings”.
Finally, click the “Export” button to start the export.
The process may take some time depending on the number of movie les and their duration.
MadMapper will avoid transcoding movie les that are already optimised on the SD-card.
Once exported, the SD-card should be automatically ejected so you can directly stick it in your MiniMad.
SYNCHRONISATION
Connect the MiniMad units on the same ethernet network to synchronise media-playback automatically.
Movie synchronisation happens on every MiniMad units playing a movie with the exact same frame
count and framerate, even though their le names are dierent.
Every media-related action made on any MiniMad happens instantly and automatically to every MiniMad
units:
- media change
- pause
- restart
- playback mode
- audio mode
- image display-time
Note that media change works properly if every MiniMad units contain a le with the same name, even
though its content is dierent.
Create a MadMapper project using the video-wall template, import your pictures and videos,
and export the dierent projectors to as many synchronised MiniMad units.
The setup couldn’t be easier: Just connect all your MiniMad with an ethernet cable to a network switch,
and wait until they automatically synchronise.
Note that you can also connect two MiniMad units directly using an ethernet cable.
FEATURESMiniMad VIDEO
7
CONTROLS
Up
change playback mode
Right
next media
Blue
next control point
Up
control point position
Right
control point position
Up
selected surface luminosity
Right
Contrast +
Left
previous media
Down
pause media / start media
over in “Play once…” modes
long press: restart movie
Red (toggle ON/OFF)
activate mapping control
Yellow
previous control point/
Left
move control point
Down
control point position
Yellow(toggle ON/OFF)
activate image control
Left
Contrast -
Down
selected surface luminosity
MiniMad VIDEO
BUTTONS
Blue
next surface / all surfaces
Red
previous surface / all surfaces
Red + Blue
hold to shutdown
Blue + Yellow
display info
Red + Blue
hold to shutdown
8
CONTROLS
KEYBOARD
As an alternative to the MiniMad’s buttons, you can use any USB keyboard as a remote.
Using a wireless USB keyboard may be particularly interesting when the device is not easily accessible.
Attach the keyboard to one of the four USB ports prior to powering it on and follow the following
keyboard map to control all functions:
Backspace
restart media / start media over in “Play once…” modes
Numbers
direct access to the
10 rst media
H
display help
D
display info
Q
shutdown
A
change audio output
P
change playback mode
Enter
next surface
Up
control image
display time
Right
next media
Down
control image
display time
C
activate cropping control
I
activate
image control
M
activate
mapping
control
Left
previous
media
Space
pause media playback / start
media over in “Play once…”
modes
Tab
next control point
MiniMad VIDEO
9
CONTROLS
MICROMODUL8
- Blue buttons: direct access to the 16 rst media
- First master knob: master luminosity
- Second master knob: master audio-level
OSC
The MiniMad declares itself as “MiniMad Video( - Nickname)( - ProjectorName)”, using the Bonjour
protocol, where Nickname can be specied in the Advanced tab of the Export Video Mapping to
MiniMad dialog, and ProjectorName is the name of the corresponding projector in MadMapper if there
are several projectors in the project, for example: “MiniMad Video - LOBBY - Projector-1”.
MiniMad listens to OSC commands on port 1111, in case the OSC software you’re using doesn’t support
Bonjour.
List of commands:
- /playing + integer OSC value (0 = pause, 1 = play): play/pause the media playback
- /pause: pauses the playback
- /play: starts the playback after a pause
- /replay: restarts the current media / starts media over when in “Play once…” modes
- /previous_media: previous media
- /next_media: next media
- /playback_mode/{playback mode index}: set the playback mode (cf media playback mode list in
MadMapper’s export window), example: /playback_mode/1 will set “Repeat media list” playback mode
- /media_name/{media name}: set the current media by name, example: /media_name/machine-1.
mov will play movie called machine-1 (on miniMAD movies have the .mov extension, images the .png
extension)
- /media_index/{media index}: set the current media by index, example: /media_index/2 will play the
third media in the playlist
- /media_index + integer OSC value: set the current media by index using a variable
- /image_time + integer OSC value: change the image display time in seconds
- /master_audio_level + oat OSC value: master audio-level for the targeted MiniMad
- /master_luminosity + oat OSC value: master luminosity for the targeted MiniMad
- /master_luminosity/all + oat OSC value: master luminosity for all connected MiniMad units
- /shutdown + int OSC value: value = 1 will trigger the MiniMad shutdown which will be eective after 2,5
seconds, unless cancelled by a value = 0
- /shutdown/all + int OSC value: identical to /shutdown except it applies for all MiniMad units in the
same group
Note that all indices start at 0.
MiniMad VIDEO
10
MiniMad VIDEO CONTROLS
MiniMad Controller (OSC)
In MadMapper, create a new MiniMad
Controller module and get the full-control
of the selected MiniMad (Video or Light) at a
glance, control its parameters using control
mapping (Keyboard, Midi, OSC, BPM,
Oscillators, etc) and Cues.
11
In addition to controlling the media playback, you can adjust manually the mapping and the image
settings:
CONTROLSMiniMad VIDEO
12
TOUCH OSC
Please refer to the dedicated TOUCH OSC section.
MiniMad VIDEO CONTROLS
NETWORK SYNCHRONISATION
When connected to a network, all the MiniMad units share the same media controls (media change,
pause, restart, playback mode, audio mode, image display time) which means that every change that’s
made on any MiniMad is instantly reected on all of them.
DISCLAIMER
MiniMad network synchronisation can induce a one-frame delay between the dierent MiniMad units.
Therefore MiniMad is not the best solution for setups using edge-to-edge screens, side-by-side or soft-
edge projections, using content that would highlight this delay.
For such a setup, we advice you to use MadMapper software on a computer with several video-outputs.
For better synchronisation, we also advice you prefer 720p over 1080p projector resolution..
13
MiniMad LIGHT FEATURES
RECORD
In MadMapper, once your xtures are setup, open Tools --> MadLight Recorder.
Click “Start Recording” to start recording the DMX output.
Click “Stop Recording” to stop the recording.
Optionally, you can select an audio track to be played back while recording.
The newly recorded DMX sequence will be added in the sequences list.
Click Edit Sequence to make adjustments to your sequence - adjust the in & out frames by using the
dedicated Loop controls (keyboard shortcuts are available for quicker operation), add an audio track and
select the way it synchronises with DMX playback.
Click Edit Sequence again to stop editing.
Then, check and reorder the sequences you want to export to the MiniMad, select the Playback mode,
press Play and use the Previous and Next buttons to get a preview within MadMapper.
EXPORT
In the MadLight Recorder dialog, check the sequences you want to export then click Export to MiniMad
to open the export dialog.
By default, MiniMad will use the same DMX interface as MadMapper, but you can select a dierent one
using MiniMad DMX Output.
For ArtNet, SACN or OSC control, you can either select automatic network conguration (using DHCP) or
manual network conguration and input the IP-address and mask the MiniMad will use on the network.
14
MiniMad LIGHT FEATURES
In Advanced tab, you can also specify a nickname for the the Bonjour OSC Discovery, or disable it
completely to prevent the MiniMad from appearing in applications supporting Bonjour.
(cf CONTROLS / OSC section for more details)
You can reset all of the export settings to default by clicking “Load Default Settings”.
You can either insert the MiniMad SD-card in your computer, or select a remote MiniMad connected on
the local network via ethernet (make sure both the MiniMad and the computer are on the same network).
If required, you may need to update your MiniMad SD-card, please refer to the dedicated UPDATE YOUR
MINIMAD SD-CARD section.
If necessary, update MiniMad as advised before exporting.
Once the SD-card is ready, click Export to export selected sequences to the SD-card.
Once exported, the SD-card should be automatically ejected so you can directly stick it in your MiniMad.
AUDIO
MiniMad can either play audio through its audio mini-jack connector, or through an external USB
system-compliant audio device, enabling the MiniMad to play audio le with as many channels as your
device provides, in addition to an enhanced audio quality.
Make sure to plug the audio USB device prior to powering the miniMAD on.
Note also that the MiniMad might not be able to provide enough USB-power to your device depending
on its power consumption.
In this case please use an externally-powered USB hub in between the MiniMad and your device.
15
MiniMad LIGHT CONTROLS
Right
next sequence
Left
previous sequence
Down
pause media
long press: restart sequence
Up
change playback mode
Numbers
direct access to the
10 rst sequences
Backspace
restart sequence
Esc
toggle blackout
BUTTONS
KEYBOARD
Space
pause sequence
Left
previou sequence
Right
next sequence
Down
decrease luminosity
Up
increase
luminosity
Yellow + Up/Down
control Luminosity
Yellow +Red
toggle Blackout
Red + Blue
hold to shutdown
Q
shutdown
16
MiniMad LIGHT CONTROLS
MICROMODUL8
- Blue buttons: direct access to the 16 rst sequences
- First master knob: master luminosity
- Second master knob: master audio-level
OSC
The MiniMad declares itself as “MiniMad Light( - Nickname)” using the Bonjour discovery protocol, where
Nickname can be specied in the the Export MadLight Sequences to MiniMad dialog, for example:
“MiniMad Light - MAIN ROOM”
MiniMad listens to OSC commands on port 1111, in case the OSC software you’re using doesn’t support
Bonjour.
List of commands:
- /playing + integer OSC value (0 = pause, 1 = play): play/pause the media playback
- /pause: pauses the playback
- /play: starts the playback after a pause
- /replay: restarts the current sequence
- /previous_media: previous sequence
- /next_media: next sequence
- /playback_mode/{playback mode index}: set the playback mode (cf media playback mode list in
MadMapper’s export window), example: /playback_mode/1 to set the Repeat sequence list playback
mode
- /media_name/{sequence name}: set the current sequence by name, example: /media_name/light_
sequence_3 to play the sequence called light_sequence_3
- /media_index/{sequence index}: set the current sequence by index, example: /media_index/2 to play
the third sequence
- /media_index + integer OSC value: set the current sequence by index
- /master_audio_level + oat OSC value: set the master audio-level
- /master_luminosity + oat OSC value: set the master luminosity
- /shutdown + int OSC value: value = 1 will trigger the MiniMad shutdown which will be eective after 2,5
seconds, unless cancelled by a value = 0
Note that all indices start at 0.
17
MiniMad LIGHT CONTROLS
MiniMad Controller (OSC)
In MadMapper, create a new MiniMad
Controller module and get the full-control
of the selected MiniMad at a glance, control
its parameters using control mapping
(Keyboard, Midi, OSC, BPM,
Oscillators, etc) and Cues.
TOUCH OSC
Please refer to the dedicated TOUCH OSC section.
OSD
When connected to an HDMI display, the MiniMad will display some useful information like the software
version, ethernet status, playback mode, currently playing sequence, etc. .
18
Touch OSC CONTROLS
TOUCH OSC
The following TouchOSC layout controls
both MiniMad Video and MiniMad Light.
Works exactly like the MiniMad physical buttons
20
INFORMATION
TECHNICAL SPECIFICATIONS
• Raspberry Pi 2 Model B
• 7 buttons control panel
• HDMI output up to 1080p60 (1920×1080 at 60Hz)
• 16 GB MicroSD-card + adapter
• 2 Amps power supply
• Size 9x6x3 cm
IN THE BOX
• 1 x 16 GB microSD-card class 10 installed with MiniMad software and an
SD-card adapter
• 1 x power supply 100-240V including EU, AUS, UK and US plug
• Size 9x6x3 cm
Other manuals for miniMAD
2
Table of contents
