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.
It is easy to use, small and versatile for your future video mapping projects.
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 synchronization
CONTROLS 7
Buttons
Keyboard
Network synchronization
miniMAD LIGHT
FEATURES 10
Record
Export
Audio
CONTROLS 12
Buttons
Keyboard
Micromodul8
INFORMATION
SPECIFICATIONS 14
Technical Specications
In the box
Activate and update

4
miniMAD VIDEO FEATURES
SURFACES
miniMAD supports 3 types of surfaces:
- Quad (including mask and mesh warping)
- Triangle
- Mask
Other surface types (Circle, 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 maxi-
mize smoothness, depending on the selected
projector’s resolution and various settings found in
the Advanced panel.
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.
Eject the SD-card from the miniMAD and insert it in your computer.
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.
FEATURES
miniMAD VIDEO

6
EXPORT
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.
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 optimized on the SD-card.
SYNCHRONIZATION
Connect the miniMADs on the same ethernet network to synchronize media-playback automatically.
Movie synchronization happens on every miniMADs 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
miniMADs:
- media change
- pause
- restart
- playback mode
- audio mode
- image display-time
Note that media change works properly if every miniMADs 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 synchronized miniMADs.
The setup couldn’t be easier: Just connect all your miniMAD with an ethernet cable to a network switch,
and wait until they automatically synchronize.
Note that you can also connect two miniMADs directly using an ethernet cable.
Ethernet cables
FEATURES
miniMAD VIDEO

7
6
BUTTONS
Left
previous media
Right
next media
Up
change playback mode
Down
pause media
long press : restart movie
Left
move control point
Right
move control point
Up
move control point
Down
move control point
Red(toggle ON/OFF)
Mapping control mode
Yellow
previous control point / surface /
all surfaces
Blue
next control point / surface / all surfaces
Right
Contrast +
Up
Brightness +
Down
Brightness -
Yellow (toggle ON/OFF) 
Image control mode
Left
Contrast -
VIDEO PLAYBACK
/ CONTROLS
MEDIA MODE
MAPPING MODE
IMAGE MODE
CONTROLS
Up
change playback mode
Right
next media
Blue
next control point/surface/all surfaces
Up
move control point
Right
move control point
Up
Brightness +
Right
Contrast +
Left
previous media
Down
pause media
Long press: restart movie
Red(toggle ON/OFF)
Mapping control mode
Yellow
previous control point/surface/
all surfaces
Left
move control point
Down
move control point
Yellow(toggle ON/OFF)
Image control mode
Left
Contrast -
Down
Brightness -
miniMAD VIDEO
BUTTONS
Blue
next surface
Red
previous surface
Blue + Yellow
display info
Blue + Yellow
display info

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
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
Tab
next control point
miniMAD VIDEO

9
CONTROLS
MICROMODUL8
- Blue buttons: direct access to the 16 rst medias
- First master knob: master luminosity
- Second master knob: master audio-level
OSC
- /pause: pauses the playback
- /play: starts the playback after a pause
- /replay: restarts the current media
- /previous_media: previous media
- /next_media: next media
- /set_playback_mode/{playback mode index}: set the playback mode (cf media playback mode list in
MadMapper’s export window), example: /set_playback_mode/1 will set “Repeat media list” playback
mode
- /set_media_by_name/{media name}: set the current media by name, example: /set_media_by_name/
machine-1.mov will play movie called machine-1 (on miniMAD movies have the .mov extension, images
the .png extension)
- /set_media_by_index/{media index}: set the current media by index, example: /set_media_by_index/2
will play the third media in the playlist
- /set_media_by_index + integer OSC value: set the current media by index using a variable
- /set_image_time + integer OSC value: change the image display time in seconds
- /set_master_luminosity + oat OSC value: master luminosity for the targeted miniMAD
- /set_master_luminosity/all + oat OSC value: master luminosity for all connected miniMADs
Note that all indices start at 0.
The miniMAD declares itself as “miniMAD OSC”, using the Bonjour protocol.
NETWORK SYNCHRONIZATION
When connected to a network, all the miniMADs 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 reected on all of them.
DISCLAIMER
miniMAD network synchronization can induce a frame delay between the dierent miniMADs.
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 directly MadMapper on a computer with several video-outputs.
miniMAD VIDEO

10
miniMAD LIGHT FEATURES
RECORD
In MadMapper, once your xtures
are setup, open Tools --> MadLight
Recorder.
Click “Record” to start recording the
DMX output. Click “Record” again to stop
the recording.
When recorded, adjust the in & out
frames by using the dedicated Loop
controls.
Then, check and reorder the sequences
you want to export to the miniMAD
and press Play to get a preview within
MadMapper.