Interactive sound maps: place sounds on a map, move a listener among them and hear the space in real time — on headphones (stereo or binaural), on loudspeakers (up to 32 outputs), or outdoors, by GPS, with "Real World" maps. On the web, in the iPad app (the editor) and on iPhone (the player first).
About the labels in this guide. EarMotion can be displayed in English (⚙︎ Settings › Language). This guide quotes each label exactly as it appears on screen in English.
When it opens, EarMotion shows its home screen. Without an account, on the web: Discover EarMotion, Sign in, Sign up, then the Open-access maps, with search and sorting — tap ▶︎ Play on one of them to listen to it. Once signed in, you see My maps: your maps only, and the space used by your sounds (for example "5.7 / 20 GB"; a click opens the details). In the app, My maps opens without an account (see "On iPad and iPhone", at the end of this section).
In an open map, the top bar offers two modes:
The other controls of the top bar: ← Maps (back to the list; the EARMOTION logo does the same), Save (in Edit mode only; a dot on the button signals unsaved changes), ⬡ 3D (2D / 3D view), Start sound / Stop sound with the master volume slider, ? (help), the gear (Settings) and the speech-bubble button (Report a problem…). When you open in Play a map you cannot edit, only the volume, ?, the gear and the speech bubble remain; you then leave the map through the logo.
Browsers only allow sound after a first gesture: the first touch, click or key press starts it. To make it wait for the Start sound button instead, uncheck Start audio automatically (this device) (Output › Audio output › Advanced settings).
The first time you open a map in Edit mode on a device, EarMotion asks for the workspace: Desktop computer, Laptop, Tablet or Phone; the one that suits the screen is marked "Recommended here". Tablet enlarges the controls for the finger and writes the name of each tool under its icon; Phone shows the map full screen with a bottom bar (+ Sound, Listen, Sounds, Full (the full editor)). The question is only asked once: to change later, use the gear › Workspace, with a map open (checkbox Ask me again each time). It is a setting of the device, not of the map.
A dot on Save signals unsaved changes. If you leave the map (← Maps or the logo) with changes, EarMotion offers Save and leave, Leave without saving or Stay on the map. What changes during Play (cues, scenario, remote commands) does not count: to keep a change, go back to Edit mode and save. Careful: closing the tab or reloading the page asks no question.
In EarMotion, space arises from the relation between three dimensions:
Depending on the listening situation, these spaces can be independent, partly linked or directly superimposed:
The chosen situation thus defines how the composed space is shown, traveled and heard.
In Edit mode, the left column is arranged in four groups, according to what you want to do.
At the very bottom, outside the groups, is the Module library. The right column holds, from top to bottom: the Modules row (the active modules and Manage…), Map (name, history, weight, footprint), Visualization, then the inspector (INSPECTOR) of the selected object. On a narrow screen (under 820 px, an iPad half window), the columns become drawers: ☰ opens the left one, ◨ the right one; on a tablet in portrait, only the left column is a drawer.
A group title folds and unfolds with one click; this choice is remembered on the device. A new map only opens Compose; a group opens by itself when the map uses it (a module chosen for it, cameras, loudspeakers, a radio) or when you switch on a module in it, and it never closes by itself while you work; a group with no entry to show is not displayed.
These entries are not always all there. Many of them belong to a module and only appear if that module is activated for this map: Timing, Sample ring, Trajectory sequencer, Cues, Non-linear scenario, Parameter graph, Adaptive Wave, OSC, Visual, Sharing, Analytics, and in Interactions the sub-menus Camera, Audience simulator and MIDI controller. Others follow the content: Radios and streams only appears if the map carries at least one radio, Speaker calibration only if it has loudspeakers. Real World is a module: its entry appears when "Real World mode" is activated.
The manager lists the modules by group, with what each one does, its status when it is not finished ("partial", "beta", "coming soon") and the permissions it asks for (microphone, camera, location…); Filter modules… helps you find them. Activating a module also activates the one it depends on (except "Real World mode" and "Visual mode", which you activate yourself); while that base is off, the module does nothing. Deactivating a module the map uses asks for confirmation and tells you what will disappear. Nothing is ever deleted: you remove the tool, not the content. These choices are saved with the map.
The EarMotion app is the same on both devices, but it does not open in the same place.
A group brings EarMotion accounts together around one or more administrators. Create: storage counter on the home screen › My account › Groups › Create a group. Let people in: invite by e-mail (Invitations tab) or share the group's link (Link tab, with its 10-character code); depending on the group's setting, the link lets people in right away, or sends a request that the administrator accepts (Requests tab). Join: open the link you received, or paste the link or the code in Groups; nothing happens without your consent. Share a map with a group, read-only or editable: the map's invite button › "Share with a group"; it appears for members under "Maps from my groups". A member can leave the group at any time (Group tab). Groups are managed on the web, at earmotion.net.
A class links student accounts to one or more teacher accounts. It is managed on the web, at earmotion.net: the iPad and iPhone app applies the teachers' rights and the modules the class allows, but does not show the class.
Storage counter on the home screen › My account › My public address: choose a name (field ?u=, never your e-mail address), then Set. The maps you make public (◇ button on their card; a padlock when they are private) are visible there to everyone, without an account. Web only.
Each card shows a thumbnail, the size of the map, its number of sources and loudspeakers, its weight and an estimate of its footprint. Buttons: ▶︎ Play; if you can edit it, ✎ Edit, ✎ next to the name (rename) and ⤓ Export (.zip package with the sounds); ▭ Keep on device (see below); if you own it, on the web: ◇ / padlock (public / private), two figures (invite collaborators), key (link, QR code, open access or password; a padlock with a keyhole when a password is set) and the trash can (delete) — line drawings whose name appears on hover. See § 13 Sharing.
Right column › Map › checkbox Kept on this device: checked on an online map, it keeps a copy on this device (with its sounds, in the app), which plays and can be edited without a network. The online map remains, and your changes go back to it when you save (Synchronize). Unchecking removes the copy from the device: the online map remains too. A map that only lives on this device is published with Put online, and also stays here. The same action exists in My maps: ▭ Keep on device, then ⇅ Sync and Remove from device. If the map has changed here AND online, nothing is overwritten: EarMotion asks whether to keep this device's version, take the online version, or keep both.
On the web, just below this checkbox, a map kept on the device shows Offline sounds: Make available downloads to this device the sounds the map uses, with progress in percent and megabytes; if restarted, the download resumes where it stopped. The state is stated plainly — "Available offline", "Partly downloaded", "Not available offline" — and Remove frees the space (the map stays local, but it will need the network again to play its sounds). In the app, the sounds of a map kept on the device are copied there automatically.
The web version of EarMotion itself stays available offline after a first visit. The rule is "network first": while you are online, you always get the latest version; without a network, the cached copy takes over. Not to be confused with the Real World offline pack (see § 9).
In the iPad app, gear › Sound version: Automatic (recommended), Original (heaviest), Ambisonic 4 channels (medium), Triphonic (light, for phones) (three channels), Stereo (light), Mono (very light). A light version greatly reduces the download and the memory used by maps with many channels; reopen the map to apply it. Estimate and compatibility… estimates the weight and what the device can play. Above 400 MB to download, the app asks (Large map): Original sounds or Light version. In Edit mode, the original sounds always play. On iPhone, this choice is called Sound quality (player Settings). On the web, this choice does not exist.
Compose › Library: Open the library… opens the sounds window; From files… and Record (microphone) add a sound without opening it. The window (AUDIO LIBRARY) has two tabs, which are two different scopes.
Both tabs have a Search for a sound… bar, which ignores case and accents, and a All folders filter. In This map, the table columns — File, Uses (how many sources use it), BPM, Group, Folder — sort with a click on their header. Folders are how your account is organized, shared by all your maps; groups are a color, saved with the map. The This map bar also offers Detect tempos (the BPM of sounds that have none), + New group and Create a folder. Check several rows to act on a batch: Put in a group, Move to a folder, Detect tempo, Delete from server….
A banner tells you the state of the files on the server (Check). If some are missing or corrupted: Show only those and Clean up the map…, which removes the dead entries from sound lists, without ever emptying a source.
Manage files opens the server's file manager (FILE MANAGER): listen, trim, replace the content (the name is kept, so sources stay valid) or delete — before deleting, it tells you which maps of the account use the sound.
An imported sound is attached to the map: it belongs to the map from the moment it is imported, and it survives a reload even if it is placed nowhere — you can import first and choose later. On import, sounds are converted to MP3 and split by channel.
Several gestures, as you prefer: drag a sound from the Library onto the map; + Source, first button of the Tools bar, or + New source in the inspector when nothing is selected (the source appears in the center of the view, never under the listening cursor); with a finger, a long press on an empty part of the map; in 3D view, a double-click in empty space. Dropping several files at once opens Distribute the files: All in the same place, In a circle, In a grid, In the empty spaces, At random, or A single source (sound list).
Select a source (in Edit mode) to adjust it. At the top, Fields chooses what the inspector shows: Simple (the essentials), Advanced (everything) or Custom (the ⚙︎ button next to it checks the fields one by one). It is a setting of this device; Simple by default in the Tablet and Phone workspaces.
Source channels… opens the SOURCE CHANNELS panel. Ambisonic source: Decode file as an ambisonic field (AmbiX, FuMa or Format A, order 1 to 4; the channels then become virtual loudspeakers). Then Channels & layout: a preset (Mono, Stereo, Quadraphonic, Octophonic, Dolby Atmos 7.1.4, Custom), Save preset, Lock channels, ↺ Reset positions and the table of channels.
Compose › Source manager › Open the manager…: all the sources in a table (SOURCE MANAGER), editable directly (Shift or Ctrl: several sources, one setting for all). ⛃ Columns chooses the parameters shown, ⧉ Copy copies the table for a spreadsheet; clicking a row selects the source.
Compose › Source manager › + Sound card input (module "Audio input / microphone") creates a source fed by an input of your audio interface or by the microphone: in the inspector, Detect, then choose the device and the channels (Mono (1) or Stereo (2)).
Three source types do not play a file. Web link and Music (Spotify / Apple Music) open when the listener enters their zone during playback: Open automatically (otherwise a button is shown) and Delay before reopening (s); on a phone, a Spotify, Apple Music or Deezer link opens the app. A YouTube link plays in an embedded player; Vimeo and Dailymotion first require ▶︎ Load the Vimeo player (or Dailymotion), because these services set cookies. The module "Video player (YouTube and others)" is activated when you place the first such source; when it is deactivated, these zones no longer do anything.
Web radio (stream) plays an online radio (Icecast / SHOUTcast), spatialized like an ordinary source: in the inspector, Preset webradio offers verified radios (FIP, SomaFM, Radio Paradise, TSF Jazz…) and Search for a web radio… queries the free radio-browser.info directory by name, country, region or theme (module "Icecast radio"). A stream is stereo: its two channels are visible and can be spread out on the map, like a multichannel source.
As soon as a map contains at least one stream, a Radios and streams entry appears in the Compose group. It brings together the connection mode and the modulation:
A stream that drops reconnects by itself, spacing out its attempts so as never to insist with a radio that refuses.
Right column › Map (under the "Modules" row): the name (click to rename), Edit history…, a summary (sources, files, output, active modules), the weight and an estimate of the footprint: the bandwidth needed to load the map in one minute, data per hour of listening, g CO₂e and Wh (fixed network; count ×5 to 10 on 4G). Clicking the estimate opens the usage statistics; the method is explained in How the displayed footprint is calculated. Presentation page (module of the same name) opens the map's public page. Advanced settings: ▚ Console (tabs Log, Playing, Files, Audible — the log, what is playing, the map's sounds, what can be heard) and ▤ Usage statistics… (loads, sessions, listening time, data, footprint — visible to the owner). The same estimate appears on each card in My maps.
Compose › Source manager › Reverb › + Reverb zone places a reverb zone in the center of the map. Its sheet, Reverb zone, opens in the right column: Name, Trigger (Listener in the zone or Source in the zone), Target (all sources or one layer), Reverb type, Duration, Level, Zone shape (circle or polygon), Radius, Gradient center, Intensity, X / Y position, Delete the zone. Import a reverb (.wav) uses your own impulse response; Remove the file goes back to the chosen type. In the iPad and iPhone app, reverb zones sound too, eight at most at a time: beyond that, a zone stays dry.
In Play, move the listener with the mouse or a finger: the mix follows your position and orientation relative to the zones. Interact › Interactions › Navigation cursor: Color, Size, Cursor above the finger (with touch, the cursor sits above your finger so it stays visible), Smoothing, Orient along the movement, Rotation responsiveness, Sensitivity / speed, Inertia; and, on loudspeakers, On speakers, the cursor makes no sound (saved with the map: only the people detected and the other participants then make the sources sound).
| Mode (Output › Audio output › Output mode) | Use |
|---|---|
| Headphones — stereo | Simple left / right panning, very light. |
| Headphones — binaural (3D sound) | 3D sound on headphones — ideal on mobile / in the app. |
| Speakers — multichannel (one speaker per output) | Each physical loudspeaker on its own output (installation; up to 32 outputs, depending on the audio interface). |
| Speakers — Envelope (spatialized over all speakers) | The sound is spread over the whole setup by the Envelope law (the loudspeakers nearest to the source, as seen from the listening cursor, carry most of it); option The sound turns with the listener (the sound field follows the listener's orientation). |
If the interface has fewer outputs than the map has loudspeakers, each extra loudspeaker is played by the nearest loudspeaker present on the map.
To let the listener choose their output in Play, activate the module Output choice in Play (group "Listener side (Play)"): an output selector then appears at the bottom right of the screen. Without it, a visitor can only choose, in the gear, Headphone listening: Stereo or Binaural (3D sound), when the map plays on headphones.
The same map does not sound the same from one output to another, and in one case — multichannel — the zones you have drawn are not used at all. → Audio outputs, and what to adapt (stereo, binaural, 5.1, Atmos).
On the web, all the sources are mixed into a single ambisonic field, and only that field is converted into 3D sound: the decoding cost stays the same whatever the number of sources, and the height of sources can be heard. If ambisonics cannot load, a circle of virtual loudspeakers (the dome) takes over. Audio output › Advanced settings (binaural output): Shared 3D rendering, Binaural engine (Ambisonic (default) or Virtual speaker dome), then Ambisonic order ("Order 3 — 16 channels" or "Order 4 — 25 channels") for ambisonics, or Virtual speakers (16 (light), 24 (balanced), 32 (precise)) and Panning (Sharp or Diffuse) for the dome. The engine and the order are settings of this device, not of the map. The engine choice and its settings only appear if the module HOA binaural (virtual dome) is active. In the iPad and iPhone app, 3D sound is always ambisonic: only the Ambisonic order can be set.
Output › Audio output › Speaker table opens SPEAKERS AND CALIBRATION: Speaker preset (mono, stereo, 2.1, LCR, quadraphonic, LCRS, 5.0, 5.1, 6.1, 7.1, Dolby Atmos 5.1.2 to 9.1.6, Auro-3D 9.1 to 13.1, NHK 22.2, octophonies, hexaphony, ambisonic cube, Double Octo, Domes 12 and 24, Creapolis, 3D grid 4×4×4) and your own presets (Save preset): choosing a preset places it at once, and ↶ Restore brings back the previous layout as long as you have not changed it; Map scale (in units per meter), Speaker scale, Fit to map, Listener height; for each loudspeaker: name, channel, X / Y / Z position, distance, Delay (ms) and Gain (dB). ⟳ From distances computes delays and gains from the listening cursor, 0 ms / 0 dB resets them, Correction on lets you listen without the corrections. Every change applies at once: a cell of the table, + Speaker, ✕, Import JSON; Apply is optional (it commits the field being edited); Export JSON saves the layout. On the map, each loudspeaker is drawn facing the centre of the scene. With multichannel output, the floating Output levels panel shows the level of each channel. The Speaker calibration entry (Output) appears as soon as the map has loudspeakers; measuring with a microphone requires the module "Calibration measurement".
Audio output › Advanced settings:
The Tempo sync module aligns loops on a common tempo and snaps triggers to its beats (DJ-style mixing). It makes Interact › Timing › Tempo sync (this device) appear: Shared tempo (BPM) and Sync engine — Variable speed (pitch follows tempo) or Time-stretch (pitch preserved). The sounds must be clean loops, with their BPM in the Library (Detect tempos); in the inspector, Lock to tempo is set source by source, and Pitch (semitones) in Time-stretch mode. A setting of this device: it does not travel with the map. The DJ-XR — assisted mixing (this device) panel needs its own module.
In Edit mode, the floating Tools bar sits over the map; a second one, Display, appears if you check Floating “Display” bar (right column › Visualization). You move them by their header; the small double-arrow button switches them between horizontal and vertical. In the Tablet workspace, each tool's name is written under its icon; in the Phone workspace, the Tools bar gives way to the bottom bar (+ Sound).
What is drawn on the map — never the sound. The Display bar offers Names, Glow (highlight of audible sources), SPK + zones (speakers and zones), then Sources, Channels, Src names (source names), SPK (speakers), SPK names (speaker names), SPK zones (speaker zones), Grid.
The same settings live in the right column › Visualization, a list with two columns: the first ("fn") says whether the item is active, the "eye" whether it is drawn. You will find there the display (sources, channels, names, loudspeakers, zones, grid), the rendering of active modules (their state is only shown there: you activate them with Manage…), the map's objects (reverb zones, 3D models, texts and images) and the layers. ⤢ Detach moves it into a floating window. These settings are saved with the map, except the floating bar (a setting of the device).
The ⬡ 3D button switches the map to 3D view (in the iPad app too). Three buttons then appear in the top bar:
The mouse wheel or two fingers zoom; ⌘ + drag pans the view.
Compose › Appearance › 3D scenery › Import a 3D model accepts .glb, .gltf, .dae and .obj files. This section only appears in 3D view, with the module "Blender import (3D models)", which also activates "Project export". The selected model opens 3D model: Scale, Rotation, Height (Z), Delete model.
With the module VR (headset and preview), the 3D view offers VR preview (walk through the map with a headset's field of view and eye height, looking around with the mouse) and, if a headset responds, VR (your head steers the listening). Headset mode has not yet been tried on a real headset.
The basemap is draped on the ground, with a level of detail that follows the zoom; the route line is laid on the ground, and Real World › Terrain & 3D › 3D terrain (real elevation) drapes the map over the real terrain and tilts the view (Tilt, Terrain exaggeration) — see § 7.
Real World is a module: Manage… (Modules row, at the top of the right column) › group Real world › check Real World mode. The map is then anchored to a real place, and the Real World entry appears in the Compose group of the left column. On a new map, three of its sub-entries each have their own module, to check in the same place: OpenStreetMap basemap (sub-entry Basemap), Route simulator (sub-entry Simulation) and GPS (sub-entry GPS).
The Georeferencing sub-entry shows the Latitude and Longitude of the center, the Rotation (orientation relative to north) and the Scale (map units per real meter). The Set the real area… button opens the Real-world area window, laid over the OpenStreetMap map:
The Basemap sub-entry shows / hides the OpenStreetMap basemap, sets its opacity and gives the surface area of the zone (with its dimensions). The Terrain & 3D sub-entry turns on 3D terrain (real elevation), with view tilt (0–75°) and terrain exaggeration (0–4×).
urbanisme, pente and vitesse.est (setting, slope,
estimated speed) ready to condition sounds and corpus.The Simulation sub-entry replays the route without leaving home:
Right column › Visualization › Story timeline (real world): a strip at the bottom of the map, in Edit mode as in Play, shows the route, the scenario steps and the sources along the way. Dragging it moves the listener along the route. Tapping a segment enlarges it; ‹ goes back to the previous level.
For long routes, the route can be split into content sectors:
The Non-linear scenario entry (left column, Interact group) builds a branching narrative. It belongs to the module of the same name: on a new map, activate it in the manager (see § 1). Under The narrative, a banner shows the state of the graph ("valid graph", warnings, errors — isolated steps or dead ends).
A scenario works on any map — an installation in a room, a sound piece, an abstract map: its zone entry conditions apply to the zones of the sources.
What Real World adds when it is active, and what is missing without it: the Route progress condition — the distance traveled along the route — and the real position in the log. The other conditions — zone, variable, elapsed time, manual trigger — work everywhere.
Open the editor… (sub-entry The narrative) opens the dedicated editor, which fills the whole screen. You leave it with ← Map, or Esc on the keyboard.
Three areas, the same as in the adaptive radio editor:
+ Step or a double-click in empty space = a new step; dragging the dot on the edge of a step = a new link; Re-center brings the whole graph back on screen. To delete the selection: Delete on the keyboard, or Delete the step / Delete the link at the bottom of the inspector (on an iPad without a keyboard).
At the top right, Interface: Simple · Standard (default) · Advanced. It sets what is offered when you create, and nothing else: in Simple, a step only offers its title, "Triggers when" and "Does", with four actions; + ◇ Condition only appears in Advanced.
What the map already contains always stays visible and editable, whatever the level: a choice, a variable or a ◇ condition that is already there appears — and its group opens by itself. What is in use is never hidden, otherwise the step would become incomprehensible and editing destructive. The level is a setting of your device, not of the map: it follows you from one map to another.
For each step, the inspector sets:
For each link: conditions (all required) and a priority (the highest wins). The narrative moves forward while the map is playing (sound started); on a Real World map, it moves forward during the simulation, during sequencer playback or with real GPS. The scenario can also be written by hand: The narrative › Advanced JSON › Validate & apply, with checking.
circ.…, modules, OSC).The scenario, cues and remote control (OSC, tablet, modules) share the same vocabulary of actions. A step action — or a timed action — can:
At the Simple level, only four actions are offered (start, stop, layer, black screen). The same commands can be sent from outside: see Controlling EarMotion with OSC.
Non-linear scenario › Narrative log lists what has happened: activated steps and, in Real World, sector changes and GPS events. Export saves it (JSON file), Clear empties it. It is useful to check a narrative in an accelerated simulation.
Interact group › Parameter graph (module of the same name). It links what happens in the scene (proximity of a source, position or speed of the cursor, the device's sensors) to what adjusts it (repeat rate, volume of a source, master volume), with building blocks: curve, threshold, operation. Open the editor…; Sensors authorizes this device's sensors; Simulate supplies simulated values, so you can tune without a phone.
The Adaptive Wave entry (Interact group; module of the same name): Open the editor… opens its dedicated editor, in three sections: Fragments (the tagged content), Circumstances (the thresholds of the journey) and Rules. The checkbox Resonance (continuous playback: voice, music, sound effects) turns on continuous playback on three channels — the voice reads the narrative in order (held back at the chosen moments), while music and sound effects adapt to the circumstances according to the rules.
The rules. A rule reads "when these circumstances → then this": you check the circumstances (or their negation), then what it does to each channel — hold back the voice, ask the music or the sound effects for a given tag, adjust the amount. Priority, waiting time, scope and fine processing (panning, low-pass, speed) appear at the Advanced level, and always if the rule uses them. A modified rule takes effect without cutting the sound: you can adjust it while listening.
The adaptive radio plays on any map, not only in Real World: it follows the listener, whatever moves them — mouse, finger, sequencer or GPS. It starts when the map plays and stops with it.
The Generate with AI — step by step… button opens a 3-step assistant: describe your story → copy the prepared prompt and paste it into the AI of your choice (Claude, ChatGPT…) → paste its answer back. The map plays straight away: voices without an audio file are read by the device's speech synthesis (no key, no cost). A demo to listen to: the public map "Adaptive Wave — Radio résonante". All the details: Adaptive Wave, the guide.
To listen in the field without a network, the Offline sub-entry of Real World prepares a pack:
This pack belongs to Real World: it contains the map and all its sounds, not the basemap — without a network, the track and the zones are enough. For an ordinary map kept on the device, what you need is Offline sounds (right column, Map accordion; see § 2). In the iPad / iPhone app, a map that is "Kept on this device" keeps its sounds on the device.
The Layers window opens with the Layers button of the floating Tools bar, in Edit mode; you move it by its title and resize it by its corner. A layer groups sources and annotations:
layerEnable,
layerVolume, layerOpacity; see Controlling EarMotion with OSC).On Real World maps, three layers are created automatically: Route (track) (shows / hides the line in 2D and 3D), Basemap (shows / hides the OpenStreetMap basemap) and Info (for your annotations). The target layers of the scenario editor (see § 8) rely on this same system.
Left column, Interact group › Trajectory sequencer: an automatic trajectory for the listener. The entry belongs to the module of the same name: on a new map, activate it in the manager. Trajectories are saved with the map.
Interact group › Cues (module "Cues and state recall").
Capture the current state records what you are hearing — cursor position, layers, source
volumes, master volume — in a cue. You name it, replay it (▶︎) or link it to a trigger: a key (1,
a, F1) or a MIDI message (pc:5, note:60). A cue can also be
recalled by its name from the scenario, OSC or the tablet.
Add a playhead creates a cycle of a chosen length, which replays cues at given moments; several playheads run together, and none of them moves the listener.
Left column, Output group › Audio output › Recorder: choose the Format, then ● Record audio captures the output of the application (your listening, exactly as you hear it); ■ Stop produces the file, which downloads. If the sound has not started, ● starts it. The format is a setting of this device, not of the map: it is not saved with it, and a line under the selector says what is going to happen. A format that is not possible here is greyed out, with its reason.
On speakers (multichannel, Envelope), the recording is always a 24-bit WAV with one track per output: 16 outputs, 16 tracks, about 8.3 GB per hour; beyond 4 GB the file becomes an RF64, which ffmpeg, Reaper or Audition read. MP3 carries only 2 channels: when you ask for it, this WAV is what is recorded, and a message says so. MP4 gives two files with the same name: the room WAV downloads when you stop, then the video, without sound, is offered by the Download the video button of a message that stays on screen (a browser lets only one file download per click).
The video contains neither visual mode nor the interface panels (a message reminds you). If the tab goes to the background, the image freezes while the sound continues. Leaving the map with ← Maps during a recording stops it and downloads the file first; a video still on offer must be downloaded or declined (Don't keep it) before the page leaves — a departure nobody asked for (a room's watchdog, a remote command) waits for it only two minutes, then tries to download it; closing the tab loses it.
In the app, the format is the device's: the editor's selector is greyed out, and the
player's (next to ●) does not appear. On iPad and iPhone,
2-channel AAC (.m4a), delivered through the share sheet; in the desktop application, a 2-channel 24-bit WAV, stored
in ~/Documents/EarMotion/recordings. In multichannel, these two formats keep only outputs 1 and 2, and a
message says so.
The recorder belongs to the "Output recorder" module (Audio outputs group): on a new map, activate it in the manager to make the section appear. Not to be confused with "Audio recording (listener side)", which makes recording available to the listener in Play mode and requires the "Project export" module; the listener then chooses the format next to the ● button.
Left column, Share group › Analytics. This entry belongs to the "Analytics and traces" module: on a new map, activate it in the manager to make it appear (see § 1).
Analytics dashboard → (a button of the Analytics entry, or the Analytics link on the home screen — on the web, once signed in) opens the Session analytics page: the sessions grouped by map, ⤓ Download the selection (ZIP), and a path player that replays the listener's trajectory with the recorded sound (color of the line as you choose: intensity, speed or time; ◇ start, ✕ end). You must be signed in: you see the sessions of your maps. The Navigation descriptors module adds measures of the path, a sheet per session and a Printable report (PDF).
On the website, in My maps, the key button on a map's card opens the Sharing panel. When a password is set, this button becomes a padlock with a keyhole. Only the owner of the map sees this button. It does not exist in the iPad / iPhone app: share from the website.
In Edit mode, the Sharing entry of the Share group in the left column (with Multi-user and Export) and the Open on a device (iPad / iPhone / web) section of ⚙︎ Settings belong to the "Project export" module. On a new map, activate it in Manage modules… (see § 1). The card buttons (key, two figures) do not depend on this module. They do not exist in the app, nor for a map that only lives on this device. A copy kept on the device and linked to its online map keeps them.
The two figures button on the card opens the Share the map window. To give someone rights, enter their e-mail address, choose a role — View (see the map) or Edit (change it) — then tap + Invite. The person must have an account with this e-mail address: the map then appears in their My maps. If editing together went wrong, the version history (Map, right column) lets you go back.
In the same window (two figures button), Create the links gives two secret addresses, with no sign-up: one to listen to the map, the other to see the analysis results. Anyone who has them can open them. Send by e-mail prepares them in your mail app. Regenerate replaces them with new links. Revoke closes both. These links never allow the map to be edited.
Still in this window (two figures button), Create the link gives an address that opens this map in Edit mode, without an account, on the computer of an installation: cameras, loudspeakers, screens. You remain the owner: this link allows neither deleting the map nor inviting anyone. But anyone who has it can edit the map: only give it to the room's computer. Revoke closes it.
Your public maps (◇ button on their card; padlock = private) are gathered at your address ?u=your-name. You choose it in Settings › My account › My public address (click the storage counter on the home screen).
In Edit mode, left column › Share › Sharing › Multi-user (modules "Project export" and "Multi-user"): several listeners on the same map. Check Multi-user, then Invite participants (QR)…. Each participant scans the QR code with their phone or tablet, on the same network, and moves their own listener. The sound is played by the main device (yours), which mixes all the participants. The option "Each participant plays the sound" is not available yet. Participants heard: All together or One at a time. Max number of participants: from 1 to 32.
In Edit mode, ⚙︎ Settings › Remote control › Open remote control (QR)… (module "Remote tablet"). In the Remote control window, Create a session (QR) shows a QR code to scan with a tablet or a phone. The QR code opens the same map in Play on that device; the sound is still played by the main device. Each connected controller becomes one more listener on the map, moved with a finger. Several controllers can connect: they appear in the Connected controllers list, and + Add another controller adds one. For a saved map, the QR code stays the same from one session to the next.
Both devices must be on the same network (Wi-Fi or wired). The EarMotion server is only used to put them in touch; after that they communicate directly. If this fails, the Fallback code (copy-paste) replaces the QR code, and the tablet's answer is scanned (Scan the answer) or pasted (Paste). Some company or school networks block this kind of connection.
Capture the background when the space is empty. Detection compares the image with a background model. If this background is captured while people are already there, each of them produces two detections: where they are, and the hole they left in the background. Hence the ↺ Recapture the background button, to use when the room is empty. Lock exposure fixes the brightness of the image to the current lighting: do it when the room is lit as it will be at opening time, otherwise the image readjusts with each visitor.
Tracking people. Each person detected gets a number they keep from one frame to the next, even if they move from one camera to another or briefly disappear behind someone. This is not only about display: triggers remember who has already entered a zone, so an identity that changes restarts the sound. The Tracking stability slider (Interactions › Camera › Motion detection) sets the smoothing: the higher it is, the less the position shakes, but the more sluggish it becomes. The smoothing adapts to movement — it calms stillness without slowing down movement.
By default, the preview shows the image with the detection on top. The other modes (raw image, grayscale, averaged background, learned noise, presence, mask only) are for fine-tuning. If there is no image, the preview says so — it never stays black without an explanation.
The Camera and Audience simulator sub-menus of Interactions, the OSC entry of Interact and the Remote control section of ⚙︎ Settings each belong to a module ("Camera", "Audience simulator", "OSC", "Remote tablet"). On a new map, activate them in Manage modules… to make them appear (see § 1).
On loudspeakers (multichannel, Envelope), the listening cursor also makes the zones sound. For an installation to respond only to the audience detected, check Interactions › Navigation cursor › On speakers, the cursor makes no sound. This setting is saved with the map and has no effect on headphones.
Interact › Interactions › MIDI controller (module "MIDI") › MIDI controller (XY)…: two knobs or faders steer the listening cursor (CC1 = X, CC2 = Y). MIDI requires Chrome or Firefox: Safari, the iPad and the iPhone do not support it.
Left column › Interact › OSC (module "OSC") › Local bridge. The full instructions are on the
page Controlling EarMotion with OSC. Each action has its own address:
/emt/play, /emt/masterVolume, /emt/listenerXY, /emt/cueGo…; the
full list is under Recognized addresses. In a browser, you must start the small bridge
program on the computer, then tap Connect the bridge….
Send back the cursor position sends the position back to your controller. The desktop
application used for installations receives OSC directly (UDP, port 9130), but only the older addresses
(/transport/play, /listener/xy…) — see the OSC page.
Visual mode adds an image to the map: a video file (mp4 or webm, muted — the sound comes from the map), a 3D object (glb · gltf · dae · obj) slowly orbiting, or a generated image (shader). You activate it in Manage modules… (module "Visual mode"). Its settings are in the left column, in Edit mode: Output › Visual; choose the Type, then the File (an address, or Import a file…). Preview in the editor shows the result without leaving the editor. In Play (web, iPhone), the image is shown on a single screen. The scenario can turn it on or off (the "Visual layer" action).
The parts that follow each depend on a module that requires Visual mode: "3D animation" (orbit, deformation, light), "3D FX" (node editor, advanced rendering), "3D camera" (animation keys) and "Video mapping" (multiple screens).
0 keys = automatic orbit (speed, distance and camera height can be set in the panel — a negative height gives a low-angle shot) · 1 key = fixed shot · 2 keys or more = trajectory, smoothed (loop optional). A key = an instant t + a camera position + an aim point.
How the editor works, during the preview: clicking a key ◆ freezes the preview on it — what you see is exactly what the camera will show at that instant. Then dragging the diamond ◆ (position) or the square ▪︎ (aim) in the minimap changes the view live; the bar under the minimap sets the heights (camera and aim) of the selected key. In the sequencer at the bottom: ▶︎/⏸︎ replays or freezes the trajectory, clicking/dragging on the timeline moves the playhead, dragging a diamond changes its instant, ◇+ inserts a key at the playhead (it captures the current view, exactly), × deletes the selected key. The transport is local to the preview: external screens keep following the shared clock.
Node editor (effects)… builds the effects by connecting blocks: sources (3D scene,
Video, Generative), then effects (Color, A/B blend,
Kaleidoscope, Feedback (trail), Bloom, Sound-reactive,
Custom shader in GLSL), down to the Output. To add a block:
+ block, right-click on the workspace, or the n key (search by name).
Simple rendering removes the graph. All shaders receive the real sound level
(uAudio), the listener's position (uCursor) and the proximity of the nearest zone
(uProx).
| Key / gesture | Context | Action |
|---|---|---|
| ↑ ↓ ← → | 3D view, "Listener view" on | Move forward / back along the heading; turn the listener's heading. |
| Delete / ⌫ | 3D view, Edit mode | Delete the selected item (annotation, 3D model, source, loudspeaker). |
| Delete / ⌫ | Scenario editor | Delete the selected step or link. |
| Esc | 2D editor | Clear the multiple selection (cancels the selection rectangle). |
| Esc | Windows / guided tour | Close or cancel. |
| Esc | Dedicated editors (scenario, graph…) | Close the editor in front. |
| Enter | Input fields in windows | Confirm (rename, password, collaborator, address search…). |
| ← → | Guided tour ("?" help) | Previous / next step. |
| Any key, click or touch | First gesture on the page | Starts the sound, if "Start audio automatically (this device)" is checked: this is the default (Output › Audio output › Advanced settings). |
| Shift+click | Editor (map or source list) | Add to / remove from the multiple selection; select a range in the list. |
| Ctrl/Cmd+click | Source list | Toggle a row in the selection. |
| Ctrl/Cmd+drag | Play mode, if the map allows zoom in Play (Compose › Appearance › Map size); ▶︎ preview outside the Tablet workspace: always | Move the view instead of the listener. |
| Mouse wheel | 2D map (in Play: if the map allows zoom in Play; ▶︎ preview outside the Tablet workspace: always) | Zoom toward the pointer. |
| Two fingers: pinch / drag | 2D map, Edit mode (touch) | Zoom / pan the view. |
| Two fingers: pinch / drag | 2D map, Play mode (touch), if the map allows zoom in Play — not in 3D, nor with the Multitouch module (two fingers are two listeners there) | Zoom / move the map (the listener stays put); zooming all the way out shows the whole map again. Without this setting, the map opens as large as the screen allows and cannot be zoomed. |
| Long press in empty space | 2D map, Edit mode (touch, except in the Phone workspace) | Place a source there. |
| Shift+vertical drag | 3D view, object selected | Set the height (Z) of the object. |
| Alt+vertical drag | 3D view, source selected | Set the radius of the zone. |
| Two-finger pinch | 3D view (touch) | Zoom — or resize the selection if the Scale tool is active. |
| Double-click (double-tap) in empty space | 3D view, Edit mode | Create a source there. |
| Double-click | Scenario editor / Real World route | Create a step / delete a point of the route. |
| Key chosen for a cue (1, a, F1…) | "Cues" module | Recall this cue (never while typing, nor with Ctrl/Cmd or Alt). |
| Mouse · ZQSD, WASD or arrows · Esc | VR preview | Look · walk · exit. |
| c · double-click | Screen window (Visual mode) | Corner calibration · full screen. |
| Right-click or n | Node editor | Add a block. |
There is no Ctrl+S shortcut (yet): use the Save button. There is no Ctrl+Z either, nor copy / paste from the keyboard.
This almost always means its module is not activated for this map; a new map starts with no module active. Activate it in Manage modules…. Two paths lead there: at the top of the right column (Modules row, Manage… button), or through the Module library, the last entry of the left column. It is the only place where you activate a module (see § 1). Other cases: a folded group title (Compose, Output, Interact, Share) hides its entries — tap it to see them. In a narrow window (iPad in split screen, tablet in portrait), the left column opens with ☰ and the right one with ◨. Finally, Radios and streams only appears if the map carries at least one radio, and Real World only if the "Real World mode" module is activated.
A dot on Save signals unsaved changes. If you then leave with ← Maps or the logo, EarMotion offers: Save and leave, Leave without saving or Stay on the map. Closing the tab or the application asks nothing. In Play, Save does not appear: go back to Edit mode to save. In the iPad app, unsaved changes are kept on the device. When you reopen the map, choose Restore these changes (they are not saved yet) or Open the saved version.
In a browser, there is nothing to do: replacing a sound on the server makes the cached copies obsolete — they are recognized by their date and size. Reopen the map. If the map has offline sounds (see § 2), use Remove then Make available to reload the copy. In the application (iPad, iPhone, desktop), a sound that has already been downloaded stays the one on the device, and no command can refresh it yet.
When no reliable position arrives for a while, the "GPS signal lost" banner appears. The listener stops where they were and the sounds already playing continue; everything resumes at the next accepted position. Choose the right profile in Real World › GPS › Travel profile (GPS): On foot, By bike, Public transport, By car (passenger), By car (driver), Custom.
Yes — prepare the offline pack (see § 9) until the badge reads "Pack complete — playable offline". In "Fully offline" mode, the basemap is not shown without a network: everything comes from the pack.
On iPhone, the app always opens on the player. To edit, check Editing mode in the player's Settings: an Edit button appears on the home screen and opens the editor for the session. At the next launch, the app starts on the player again. On iPad, it opens on the editor.
That is intended: the sound never switches to the phone's speaker unless you decide so. The player shows "Headphones disconnected: playback is paused."; start playback again.
⚙︎ Settings › Workspace (with a map open) offers four choices: Desktop computer and Laptop; Tablet, with controls enlarged for the finger; Phone, with the map full screen, the simplest. The question is only asked once per device; check Ask me again each time to see it again.
After very intensive use (3D + map), some browsers degrade the display (black map). No data is lost: reload the tab or restart the browser.
They must have an account with exactly the e-mail address you invited (two figures button); the map then appears in their My maps. Without an account, use the confidential link (same window) or sharing with a link and password (key button). These buttons are on the website, not in the app.
The ? button (on the home screen and in the editor's top bar) offers the Guided tour (the menus of the screen you are on, step by step) and this Full guide. Below them are the requests to the team: Help, Report a problem…, Suggest an improvement…, Track my request…. A request only exists once you have entered the confirmation code received by e-mail. Esc leaves the tour at any time, and your Play / Edit mode is restored.