Guide

How GrooveDMX works.

The app listens to the music, detects beat, section and genre, picks a look from that and writes 512 DMX channels onto the cable forty-four times per second. All on the phone, without the internet. This guide explains every function, from the first show to troubleshooting.

Your first show

Connect the interface: a USB DMX cable with an FT232 chip to the phone, or an Art-Net interface on the same network.
Add your fixtures in the rig screen: pick a profile, enter the DMX address, set the position in the room.
On the start screen, choose the source: microphone or your own folder.
Start the show. The app listens, finds the beat and goes.
Fine-tune on the desk screen: check the genre, tick the looks you want, adjust the faders.

The show also runs without an interface. The room view shows what the rig would be doing, which makes it easy to set things up from the sofa.

What happens under the hood

The path from sound to cable is always the same. If something is wrong, walk it from the start, exactly like the self-test in the app.

Capture: Microphone or built-in player. The microphone picks up the whole room, the player lets the app listen to itself: no reverb, no delay.
Analysis: Eighty-six times per second: frequency bands, noise profile, level. From that come tempo, sections and percussion.
Detection: Tempo with a confidence value, sections from silence to outro, kick, clap and hi-hat separately, genre from six sound features.
Show: One look per section, with its effects layered on top of each other. Colour mood, gobo choice and group patterns keep running alongside.
Output: Offset by position in the room, afterglow measured against the beat, then 512 channels over USB or Art-Net.

The frame clock hangs on the output, not on the analysis. Otherwise the show’s clock would run in bursts, because audio hardware delivers in bursts.

The screens

The order follows the question you ask first in a room: is it running, what should it do, how does it look.

Start: Is it running, what should the show do, preview with tempo, section and output, music source and quick controls.
Desk: Genre, what is coming in, the looks, the four faders and the channel preview.
Rig: Add fixtures, pick profile and address, position in the room, movement window, room size.
Colour: Choose a colour set or fixed colours, plus the gobo choice and a preview of the room.
Settings: Brightness, output path, language, Pro and Club, safety notes and legal texts.

Modes

Microphone: The app listens to the room. Gain compensates for a quiet rig, and the level is measured against the room’s noise floor.
Built-in player: The app plays music from a folder you grant access to and listens to itself. No room reverb, no travel time, the microphone stays off. Part of Pro.
AI mode: Plans a whole track in advance from the song map it measured itself. Runs on the phone, no server. In this mode the app picks the looks, so the selection on the desk is not used. Part of Pro.
Bass light organ: The light runs through the room as a wave and flashes on the detected beat. Gobos stay open, the heads point at the floor, and they only move to a new spot while the lamp is dark.

Choosing looks

A look is a handful of effects layered on top of each other. On the desk screen you tick which ones may appear.

A tap ticks a look on or off. Hold your finger down and you see it on the rig straight away, for as long as you hold. After that the show carries on where it was. The preview only starts after about two tenths of a second, otherwise a stray look flashes over the rig on every tap.

Nothing ticked does not mean dark, it means the usual vocabulary. The raw selection is always shown, so you can see what you decided yourself.

The look names stay German in every language: they are the app’s identifiers, used by the saved selection, the AI plan and your own show designs.

The 17 groove looks: Kreisen, Pendeln, Schwenken, Kreiseln, Welle, Weitergabe, Stakkato, Gegenlauf, Bänder, Farbregen, Getreten, Streuung, Fächer, Sog, Gegenwelle, Herzschlag and Zug.
The big moments: Intro, break, build, drop, escalation, outro, strobe storm, breathing, standing light, silence and idle light. The show picks these by section itself.
Blaulicht: A beacon like on an emergency vehicle: red and blue alternating, odd and even heads in counter phase, six bars there and back. Manual only, the automatic show never throws it in.
Scheinwerfer: A directed beam instead of a wash. Manual only as well.
Magnet: Before the drop the heads creep towards the middle and flicker, on the drop they fly apart. Both follow the music, not a clock of their own.

The four buttons

Blackout, haze, blind and strobe carry a symbol instead of a word. These are the buttons you reach for while looking somewhere else.

Blackout: Everything dark, stays on until you switch it off again. Reachable even when the desk is locked.
Haze: Switches the hazer, also stays on.
Blind: Work light for as long as you hold it. It deliberately ignores the master brightness: if you press it, you want to see right now.
Strobe: Manual strobe, also only while held. A work light left on by accident lights the dance floor for the rest of the night.

The faders

Four faders belong to the genre and change with it: intensity, transition, offset and movement speed. Whatever you set by hand belongs to that genre and is there again next time. The button “reset faders to genre” forgets your own setting.

Two faders deliberately stay out of it, because they describe the room and not the music: master brightness and minimum brightness. A genre change that suddenly alters the brightness of the room would be a nasty surprise.

Intensity: How hard the show hits. Techno starts at 0.95, Ruhig at 0.57.
Transition: How softly brightness trails off. Flashes are exempt, they go out unbraked.
Offset: How strongly fixtures react one after another by their position in the room.
Movement speed: How fast moving heads travel, capped between 8 and 90 degrees per second. A head driven faster than it can move shows less movement, not more.

Colour and gobos

Colour set: Seventeen sets, plus one from your own colours. The show hands them out in turn, always by position in the room: neighbours get the same colour, otherwise it looks like confetti.
Fixed colours: One fixed colour means standstill, several mean changes between exactly those. A colour set and fixed colours are mutually exclusive.
How much colour: Two, at most three colours in the room at the same time. More looks lively on paper and like a funfair in the room.
Gobos: Chosen by name, not by slot number, because two heads have their dots in different slots of the wheel. A gobo stays for at least four seconds, otherwise the wheel turns more than it stands still.

Rig and room

The app works with positions in the room, not with fixture numbers. That is the only reason a wave travels through the venue and not through the address list.

Adding fixtures: Pick a profile, set the DMX address, give it a name. A rig that is only half understood is rejected rather than guessed.
Position: Where the fixture hangs or stands. Waves, chases and colour distribution follow it.
Movement window: The allowed range for pan and tilt. Without it the head lights up the wall or your guests’ faces.
Room size: Width, depth and height. That lets hand-offs and floor targets aim at real points in the room.
Room view: Shows the rig from above with its beams. Good for setting up, even without a rig connected.

Output and continuous operation

USB: Cables with an FT232 chip, plus Enttec and uDMX. The phone needs USB host, that is OTG.
Art-Net: Over Wi-Fi to an interface on the same network. The app also keeps the radio awake, otherwise Android bundles the packets and the show stutters.
Screen off: The show keeps running as a foreground service, with a stop button in the notification.
No server: The “internet” permission is only needed for Art-Net on your own network. Nothing goes outside.

Pro and Club

Locked features stay visible and carry a padlock, nothing is hidden. After the purchase your own choice is back straight away, because it was stored the whole time.

Player (Pro): Play and analyse music from your own folder.
AI mode (Pro): Plan the arc of a track in advance.
More fixtures (Pro): Free drives eight fixtures. A bigger rig stays fully saved, the remaining fixtures stay dark, and the list names which ones.
PIN lock (Club): Locks the desk against other hands. After five attempts the waiting time grows. Blackout always stays free.
Autostart (Club): The app becomes the home screen and starts the show after booting, even after a power cut.
Fallback show (Club): After two seconds of silence a chosen look keeps running at a fixed practice tempo, so the room does not look dead.
Opening hours (Club): Weekdays with a start and end time. Outside them everything stays dark, inside the show runs by itself. Blind and strobe still work, and a time past midnight counts towards the starting day.
Rooms (Club): Switch saved rigs with one tap, for example for two rooms in the same building.

When something is off

No light: First the self-test in the app, then the signal path from the start: source, level, tempo, output path, address. Check the minimum brightness, some lamps produce no light below a threshold.
Show ignores the music: Raise the gain on the microphone. Below 25 percent tempo confidence the show deliberately does not trust the grid.
Movement judders: Lower the movement speed or stretch the cycle. A target that jumps across the whole window leaves the speed limit no ramp.
Heads point the wrong way: Check the movement window in the rig. A number in the window is not a direction in the room.
Show stutters over Wi-Fi: Art-Net needs a stable network. The app keeps the radio awake with the screen off, but an overloaded network is still a problem.
Only eight fixtures light up: That is the limit of the free version. The fixture list names which ones stay dark.

Safety

Strobe: The app flashes up to twelve times per second. That can trigger seizures in people with photosensitive epilepsy. Warn your audience clearly beforehand.
Lasers: Operate only as the manufacturer says and within the rules that apply. Class 3R and above need a laser safety officer. Never aim at eyes or into the audience.
Rigging: Fix fixtures properly and add a safety cable. The movement limits in the app do not replace mechanical safety.
Haze: Haze can set off smoke detectors. Clear it with the venue beforehand.
Kill switch: Always keep a way to switch the lights off independently of the app.