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 congured 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 Specications
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
notication.

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 conguration or manual network conguration
and input the IP-address and mask the MiniMad will use on the network.
When using automatic network conguration, 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
conguration mechanism, getting a random 169.x.y.z IP address with a 255.0.0.0 network mask.
When using manual network conguration, 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 dierent.
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 dierent.
Create a MadMapper project using the video-wall template, import your pictures and videos,
and export the dierent 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 specied 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 eective 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.