John Clausen

AudioVector / User guide

Paint with sound.

Start with a sound, follow the trace, and make it your own. This guide walks through the controls on iPhone, iPad, and Mac, from your first tone to a room-sized presentation.

Pre-order on the App Store

For AudioVector 1.0.0 · iOS/iPadOS build 25 · macOS build 17
Updated November 14, 2026. Button names below use the English interface.

iPhone and iPad guide

This guide describes AudioVector 1.0.0, build 25. The iPhone and iPad versions share the same controls; the settings panel moves below or beside the trace to suit the available space and text size.

Start with a sound

Tap Choose Audio. You can use the Tone Generator, Apple Music Web Player, Listen to another app, Open an audio file, or Try a silent demo. You do not need an AudioVector account. Apple’s optional web player has its own account and service requirements.

For a quick first trace, choose Try a silent demo. It draws a synthetic signal without playing sound. Open Controls to change the appearance, or tap Paint to start with a colorful held drawing and touch gestures enabled. Paint changes the visual settings; it does not choose or replace an audio source.

Capture another app’s audio

  1. Tap Choose Audio → Listen to another app.
  2. Tap Tap here to start capture. In Apple’s system picker, select AudioVector, tap Start Broadcast, and wait for the countdown.
  3. Open the app you want to listen to and start playback. Keep the broadcast running.
  4. Return to AudioVector. The trace responds to compatible audio. Show the scope closes the setup guide if it is still open.

Apple calls this a broadcast, but AudioVector uses it to receive audio locally. It does not upload captured audio or screen video. Microphone input is not supported; leave the microphone off. Screen video received by the capture extension is discarded.

Start Listening opens the same system capture picker. While capture is active, Stop Listening or Capture controls opens Apple’s controls so you can stop the broadcast. You can also stop it from the system recording indicator. Leaving AudioVector, hiding its controls, or switching sources does not necessarily stop a broadcast that iOS owns; use the system stop control to end it.

Some apps or protected content may block capture. If the trace stays still, confirm that AudioVector was selected in the picker, that the countdown finished, and that the source app is playing. Try a different song or app. The native Music app may mute during capture; use AudioVector’s Apple Music Web Player for the in-app Apple Music workflow. There is no separate Display Audio Capture mode in this version.

Apple Music Web Player

  1. Choose Choose Audio → Apple Music Web Player.
  2. Sign in and start a song on the Apple-hosted page. Full catalog playback depends on your Apple Music access. Account and playback controls inside the page belong to Apple.
  3. Opening the web player prepares AudioVector to listen. If Prepare audio capture is shown, tap it. If capture is not already running, tap Start audio capture, select AudioVector in the system picker, and start the broadcast. Starting the system broadcast needs your confirmation. If Capture controls is shown and audio is arriving, go straight to Show Trace.
  4. Once audio is playing and capture has started, tap Show Trace. This hides the web page while keeping it loaded so playback can continue behind the trace.

The web-player toolbar provides Back, Forward, and Reload music page. Show Trace returns to your drawing. The Music player options menu contains Open in Music, which deliberately opens the current Apple Music destination in the native Music app, and Stop web playback, which closes the current web player and stops its playback. Opening Music does not automatically stop your existing capture. Native Music playback remains subject to its capture restrictions.

On the canvas, the music controls are Previous track, Play/Pause, Next track, and Show music player. They operate the Apple Music page. If they report that playback controls are unavailable, reopen the player and use the page’s controls or reload it. These music controls are separate from Freeze, which only pauses the trace display.

Your Apple website session is stored on this device by WebKit, so closing and reopening the player does not necessarily sign you out. Apple may request sign-in again. Embedded sign-in can offer different methods from Safari; if passkey sign-in is unavailable here, use a method offered by Apple’s sign-in page. AudioVector does not add its own passkey flow.

Play a local audio file

Choose Choose Audio → Open an audio file, then select an audio file in the system Files picker. A compatible file plays directly in AudioVector and feeds the trace. An Apple Music subscription download is not an ordinary audio file that this picker can open.

For local files, the canvas button changes from Freeze to Pause/Play. Pause retains the file position; Play resumes it. System and headphone play/pause controls also work for the file opened in AudioVector. Stop ends playback and clears the trace. If Stop Listening appears instead of Stop, end the existing system broadcast first; the local-file Pause/Play control remains available. There is no local-file playlist, skip-track control, or scrubber in this version; the previous/next controls shown for an open web player operate that web player.

Opening a local file or starting the silent demo stops the embedded web player. If a system broadcast is still running, stop it separately using Apple’s recording controls.

Find your way around the canvas

Control or indicatorWhat it does
Choose AudioOpens source selection, capture instructions, accessibility options, and support links.
Controls / sliders iconShows or hides the settings panel. If Tone Generator is open, it returns to the settings panel. The panel’s × also hides it.
Help / ?Opens Quick Start, music compatibility, scope-reading help, privacy information, support links, and About AudioVector.
Presentation mode / outward arrowsHides the regular interface for a fullscreen trace.
Exit presentation / inward arrowsReturns to the normal canvas and settings.
Freeze / UnfreezeHolds or resumes the display for capture, demo, or tones. Audio continues. For a local file this control becomes Pause/Play instead.
StopStops the local source/tones and clears the trace. For a broadcast, use the system capture controls to stop the broadcast.
LIVE / READY / DEMO / FROZEN / PAUSEDShows whether live signal is arriving, the source is waiting, the silent demo is active, the display is frozen, or a local file is paused.
Mono / Stereo · sample rateDescribes the incoming audio format. Mono is displayed as the same signal on both sides, not converted into artificial stereo.
L / R levelsSample-peak levels in dBFS. 0 dBFS is the digital ceiling; a very quiet or absent signal reads toward −∞.
CorrelationNear +1 means left and right are similar; toward −1 means they have opposing polarity. It is a guide to the signal, not a score for your artwork.

Presentation controls normally fade after a few seconds. Tap the canvas to bring them back. Keep presentation controls visible in Accessibility prevents this, and controls also stay visible while VoiceOver is active. Returning from the background without an active source or fresh audio brings you back to settings rather than leaving a blank fullscreen canvas.

Opening settings, opening tones, returning to presentation, or rotating the device preserves the current in-memory drawing. This is not a saved image: use a device screenshot to keep artwork you want to retain, especially before clearing or stopping it.

Shape the trace

Open Controls → Signal. Sliders respond immediately; their readouts show the current value.

SettingRangeEffect
HoldOff/onSets Persistence to its maximum so earlier strokes remain while new ones continue to draw. Switching Hold off returns to the previous fading amount. Hold is different from Freeze.
Gain0.1×–8×Scales the incoming signal for the visualization. It does not change playback volume.
Persistence0–1Controls how long earlier frames remain. Low settings fade quickly; 1.00 is Hold.
Smoothing0–1Softens rapid changes in the trace; increase it for a smoother path.
Zoom0.25×–10×Magnifies or reduces the drawing on the canvas. A large zoom can move parts of it offscreen.
Sample Window256–2,048 samplesSets how much of the current signal is drawn at once. Smaller windows show shorter, crisper strokes; larger windows show more overlapping, denser geometry. It does not change the song’s playback speed.
Rotation−180°–180°Turns the drawing.
Beam Decay0–1Fades the older samples within the current trace. Higher values produce a stronger fade toward the older end.
Line Width0.5–6Changes stroke thickness; it also affects point size in Point Mode.
Intensity20%–200%Changes the trace’s brightness.
Glow0–1Adds a colored light halo around the trace. It is independent of Focus; a sharp core can still have a soft glow.
Focus0–1Changes the sharpness of the trace core. Higher values are sharper; lower values are softer.

What do these controls do? opens a short explanation in the app. When comparing Sample Window sizes, temporarily lower Persistence and Glow so old strokes and halos do not obscure the change. Use Undo afterward if you want your earlier settings back.

Choose colors and the canvas

In Trace color, choose one of four modes. Tap a color swatch to open the system color picker; changes are applied as you choose a color.

ModeControls and behavior
SolidTrace sets one color for the entire trace.
AmplitudeLow amplitude and High amplitude set the colors used as signal level changes.
BandsColor follows the frequency content. Band Detail → Simple exposes Low frequencies, Mid frequencies, and High frequencies. Advanced exposes ten frequency-color ranges. Band Separation increases the emphasis on dominant bands as you move it upward; lower values blend their colors more gently.
BounceMoves through six editable colors. Palette cycle → Back and forth follows 1–2–3–4–5–6–5–4–3–2–1…; Loop follows 1–2–3–4–5–6–1–2… . Bounce Time sets the time between neighboring colors, from 0.1 to 3 seconds. Lower is faster. Randomize Colors creates a new six-color palette. This mode follows elapsed time, not the song’s beat.

Advanced Bands offers 0–32 Hz, 33–64 Hz, 65–125 Hz, 126–250 Hz, 251–500 Hz, 500 Hz–1 kHz, 1–2 kHz, 2–4 kHz, 4–8 kHz, and 8–16 kHz+ color controls.

The standard Bounce palette begins yellow, blue, purple, pink, red, and green. Existing saved colors are kept; the built-in Paint preset has its own palette.

Open Canvas to change Background and Grid colors. Show Grid turns the grid on or off. Point Mode draws individual sample points instead of joining them into lines.

Paint, presets, Undo, Redo, and Clear Trace

Paint applies a starting appearance with Hold enabled, a quick Bounce palette, no grid, and touch controls enabled. Start a source, then adjust zoom, rotation, color, and tone settings while new strokes accumulate.

Undo and Redo step through visual-setting changes, including gestures, controller adjustments, color edits, and preset application. With a connected keyboard, Command-Z and Shift-Command-Z perform Undo and Redo; text fields retain their own text-editing history while you are typing. These commands restore settings, not previous audio or erased canvas pixels.

Clear Trace, beside Undo and Redo, clears the canvas for a new drawing without changing your settings, playback, or visual-settings history. It works while the display is frozen. Clearing the picture cannot be undone with the visual Undo button.

Tap Presets to choose Default or Paint, or save one of your own:

  1. Adjust the visuals as you like.
  2. Open Presets and optionally enter a name.
  3. Tap Save Current. A blank name receives an available name such as Preset 1. You can store up to eight personal presets.
  4. Tap a preset’s name to apply it. Tap its separate trash button and confirm Delete to remove it.

Presets save visual settings only. They do not save the current sound, tone-generator setup, playback position, or accumulated picture. Controller sensitivity, value-display preference, and the preference to zoom and rotate together are separate from visual presets.

Reset All Controls → Reset Controls restores the default visual appearance and disables touch controls. Your connected audio source remains connected. It does not delete your saved presets. Use Cancel to leave everything as it is.

Use the Tone Generator

Open Tone Generator from the top of Controls or from Choose Audio. You have four independent voices. Enable a voice with its switch. Tap anywhere else on its tone card—the title, waveform preview, or blank area—to open its editor. The switch stays a separate control so you can turn a voice on or off without opening it.

Tone settingWhat it does
Enabled / OffAdds or removes this voice from the sound and visualization.
WaveformChooses Sine, Triangle, Square, or Saw. Sine is smooth; the others introduce different corners and harmonic shapes.
FrequencySets how fast the signal repeats, from 0.1 Hz to 20,000 Hz. Drag the slider for broad exploration or tap the number, enter an exact frequency, and use the keyboard’s Done button. The slider is logarithmic, so equal travel changes frequency by a ratio rather than a fixed number of hertz.
PanPlaces this voice between fully left and fully right, with Center in the middle. Separating voices between the channels helps create two-dimensional patterns.
PhaseShifts this voice’s timing from −180° to 180°. Change it to alter how voices line up and how their combined drawing looks.
Tone levelSets this voice’s level from 0% to 100%. It changes both its contribution to the trace and, when audible, its sound level.
Time windowChooses 2 ms, 20 ms, or 100 ms for the small tone preview. It changes that preview’s horizontal timescale, not frequency or the main canvas Sample Window.
L / R previewThe small preview shows the voice’s left and right signals in cyan and pink.

Tap All Tones to return to the four cards and enable or edit another voice. Each voice keeps its own settings while you move between editors.

Mute tone output silences the generated sound while its trace continues. Tones begin muted; if you turn this off, start with a low device volume. Stop all tones disables all four voices and mutes their output. It does not stop a separate music source.

Trace enters presentation mode. Done closes the tone panel and shows the trace. Back to Settings returns to the visual controls. All three leave active tones running; use Stop all tones or a voice switch when you want to stop generating them. Moving the app to the background or an audio interruption can mute tone output; turn off Mute tone output again when you want to listen.

Tones can mix with the selected source. During broadcast capture, audible tones arrive through the captured mix; muted tones are added directly to the visualization. This keeps muting the speaker from removing your drawing signal.

For a first experiment, enable two sine voices, pan one left and one right, give them related frequencies such as 220 and 330 Hz, and adjust Phase. Then try a slightly different frequency, another waveform, or Hold. No particular ratio is required—small changes can produce very different paths.

Touch controls

Open Touch Controls / Game Controller and turn on Enable Touch Controls. The gestures follow the horizontal scope canvas, which can be rotated relative to the controls when the device is held in portrait. Try them in landscape first if the edge directions feel unfamiliar. Begin an edge swipe near the edge of the trace, away from buttons and the settings panel.

Gesture on the traceSetting
One finger, top edge, left/rightSmoothing
One finger, bottom edge, left/rightPersistence
One finger, left edge, up/downSample Window
One finger, right edge, up/downBeam Decay
Two-finger pinch/spreadZoom
Two-finger twistRotation
Three-finger pinch/spreadLine Width
Double-tapShows or hides settings; in presentation, returns to settings

Swiping right or up increases the value; left or down decreases it. Spread to increase Zoom or Line Width and pinch to reduce it.

Zoom and rotate together is on by default. Turn it off if you want one transformation per two-finger gesture: AudioVector follows the dominant initial pinch or twist until you lift your fingers. View Gesture Guide opens these mappings inside the app.

Show Settings Values controls the temporary value pill shown while using gestures or a game controller. It does not remove the normal readouts next to sliders. Touch controls are bypassed while VoiceOver is enabled so they do not compete with VoiceOver’s gestures.

Game controller

Pair a compatible game controller in the device’s Bluetooth settings, then return to AudioVector. No separate controller-enable switch is needed. Hold a button or move a stick to adjust; release it to stop. A small stick movement gives a gentler change than full tilt. Release controls to neutral after connecting or returning from a dialog before making a new adjustment.

ControlAction
Left stick up / downIncrease / decrease Zoom
Right stick right / leftIncrease / decrease Rotation
L1 / L2, or LB / LTIncrease / decrease Sample Window
R1 / R2, or RB / RTIncrease / decrease Beam Decay
D-pad up / downIncrease / decrease Smoothing
D-pad right / leftIncrease / decrease Persistence
Triangle / Circle, or Y / BIncrease / decrease Glow
Square / Cross, or X / AIncrease / decrease Line Width
Left stick clickToggle Show Grid
Right stick clickToggle Point Mode
Options / MenuSwitch between presentation and settings

Button positions follow the system’s controller mapping. In Touch Controls / Game Controller, Controller Sensitivity ranges from 0.25× to 3×, with 1× as normal speed. It scales how quickly the controller changes settings without changing touch gestures. View Game Controller Guide opens the mappings, and Show Settings Values controls the adjustment pill.

Accessibility, language, and saved settings

Open Accessibility in Controls or Choose Audio:

OptionEffect
Control backgroundTransparent leaves the trace sharp behind controls; Semi-transparent adds a material background; Opaque gives a solid panel.
Higher contrastStrengthens separation and makes control panels opaque. System Increase Contrast or Reduce Transparency can also make panels opaque.
Larger textIncreases the app’s control text; system text-size settings are respected as well. Panels reflow and can be scrolled.
Selection symbolsAdds selected/unselected symbols so choices are not indicated by color alone.
Keep presentation controls visibleKeeps fullscreen controls from automatically fading away.

VoiceOver and Voice Control are configured in the device’s accessibility settings. Buttons and sliders have spoken labels and values. With Voice Control you can use those labels, such as Controls, Choose Audio, and the slider names; use the system’s numbered overlay when a control needs more precise targeting. AudioVector’s main experience remains an animated trace; it does not offer a motion-free visualization mode.

The app uses the language chosen by iOS or iPadOS, including the app-specific language preference where available. Supported languages are English, Spanish, French, German, Portuguese (Brazil), Russian, Turkish, Vietnamese, Indonesian, Hindi, Japanese, Korean, Simplified Chinese, and Traditional Chinese. There is no separate in-app language picker.

Rendering speed adjusts automatically: AudioVector targets up to 120 frames per second on supported ProMotion displays, normally 60 on standard displays, and 30 in Low Power Mode, within the attached display’s limit. iOS controls the delivered rate, so these are targets rather than a guaranteed constant frame rate. There is no in-app frame-rate slider.

Visual settings, personal presets, and interaction/accessibility preferences are saved locally. The accumulated picture is held in memory, not saved as a project. Selecting a preset does not load audio or tone settings. On a fresh launch, choose a source again; do not rely on a previous capture or fullscreen state restarting automatically.

Troubleshooting and useful distinctions

  • Nothing is drawing: choose a source, confirm playback, and check that Freeze is off. For capture, use Show capture instructions and verify Apple’s broadcast is actually running. For tones, enable at least one voice and give it a nonzero Tone level.
  • Only a line appears: mono or very similar left/right signals can naturally make a narrow line. Try a stereo source, or pan different tone voices left and right.
  • Too bright or crowded: lower Intensity, Glow, Persistence, or Sample Window. If Hold is on, Clear Trace starts a fresh canvas.
  • Changing Sample Window seems subtle: old strokes can cover the difference. Compare with Persistence near zero and lower Glow, then restore your preferred settings.
  • Touch gestures do nothing: enable them, start away from visible controls, and check whether VoiceOver is using the touch surface. Gestures are based on the horizontal canvas orientation.
  • Controller does nothing: return from the source/help/web-player screen, release sticks and buttons, and try again. Check the Bluetooth connection and the system’s button mapping.
  • A local file stopped after an interruption: use its canvas Play button to resume. File playback and web-player transport are separate controls.
  • Apple Music will not play or sign in: open the web player to inspect Apple’s message. Check connectivity and account access, then reload if needed. Sign-in options can differ from Safari. Opening the native Music app is not a way to bypass its capture restrictions.
  • You want to keep a drawing: capture a screenshot before Stop, Clear Trace, or closing the app. A visual preset stores settings, not the picture.
  • You need help: open Help → Support & privacy for the website, Privacy Policy, and Email support. Help → Support & privacy → About AudioVector shows version and build information; Copy build information copies these details so you can paste them into a support report. Include your device, audio source, and the steps that led to the problem.

Back to contents ↑

AudioVector for macOS

The Mac version keeps the trace in the main window and puts its controls in an inspector. You can also move those controls to their own window, leaving a display free for the artwork. The instructions below match AudioVector 1.0.0, Mac build 17.

Start with a sound

Listen to another app

  1. Open AudioVector and click Start in the top bar, or choose Scope → Start (Command-R).
  2. Allow macOS capture access when asked. The permission is normally under System Settings → Privacy & Security → Screen & System Audio Recording; its name can vary with macOS version. Enable AudioVector, then reopen the app if macOS asks you to.
  3. Play audio in the app you want to visualize. AudioVector receives compatible system audio while that app remains responsible for playback and volume.
  4. Return to AudioVector and adjust the trace. You can also start this source with Controls → Input & Monitoring → Listen to another app.
  5. Click Stop when finished. If the app is still connecting, the same button reads Cancel.

This is a system-audio source, rather than a picker for an individual application. Multiple playing apps can contribute to it. No virtual audio driver or multi-output device is required. AudioVector requests the macOS capture permission to receive audio; it does not create a screen recording. Source apps may restrict capture, so an audible source does not always guarantee capturable audio.

The Mac version has no embedded Apple Music web-player panel. Play music in your usual compatible app or browser and use system-audio capture. Do not look for the iPhone's ReplayKit broadcast picker or its old Display Audio Capture option on Mac.

Open a local audio file

  1. Show Controls and find Input & Monitoring.
  2. Click Open an audio file, choose a supported audio file in the macOS file picker, and open it. Playback and visualization start together. Mono and stereo files are supported; files with more than two channels are not supported by this player.
  3. The source readout displays the filename. Use the visual controls while it plays.
  4. Click Stop to end file playback, or choose Listen to another app to switch to system audio. Open the file again to play it again.

On Mac, Freeze freezes the drawing while file playback continues. It is not a file Pause button. This build does not expose file seeking, a resumable pause control, or the iOS headphone-playback controls. A named preset never selects or reopens an audio file.

Draw with the Tone Generator

The Tone Generator works without another audio source or capture permission. Open Controls → Input & Monitoring → Tone Generator. It opens an opaque, separate window containing four numbered tone editors. The main inspector is temporarily hidden while that window is visible.

  1. Leave Silence enabled for a quiet start. It mutes what you hear while leaving enabled tones in the trace.
  2. Turn on the Playing / Stopped switch for a tone. Each of the four voices can be enabled independently.
  3. Choose a Waveform and adjust Frequency, Pan, Phase, and Volume directly in that tone's rectangle. Mac tone controls are already inline; there is no separate edit-card screen to open.
  4. Enable a second tone and give the two tones different pan or frequency settings. Their interaction makes the trace more complex.
  5. Use Done, or close the tone window, when you want to return to the main controls. Closing the editor does not turn off enabled tones.
  6. Use Stop all tones to disable all four voices. The main Stop button stops tones and the active external source together.

Tone controls:

ControlWhat it does
Playing / Stopped switchEnables or disables that voice. Its other settings remain available for editing.
WaveformSine gives a smooth repeating signal; Triangle has straight rising and falling portions; Square switches between levels; Saw repeatedly ramps and returns. Combining waveform shapes produces different trace geometry.
FrequencyChanges how quickly the tone repeats, from 0.1 to 20,000 Hz. Drag the slider for exploration, or click the outlined number field and type a precise value. Press Return or leave the field to finish. The slider gives more space to the lower frequencies rather than distributing every hertz evenly.
PanPlaces the tone between the two channels: −1 is left, 0 is center, +1 is right. Pan changes the drawing as well as the audible placement.
PhaseShifts that voice's timing, from −180° to +180°, relative to its cycle and the other voices. Small changes can turn a straight relationship into a loop or alter how patterns meet.
VolumeChanges that voice's level from 0 to 1. It affects both the signal being drawn and, when Silence is off, the sound.
Time windowChanges only that tone's small preview: 2 ms, 20 ms, or 100 ms. It does not change the main trace's Sample Window or the tone's frequency.
L / R previewShows the voice's left and right channel signals. It is a preview, not an additional source or editable waveform.
SilenceMutes all generated tones at the speakers while preserving their visual signal. It does not mute music in another app.
Stop all tonesDisables every generated voice and enables Silence. An external capture or local file can continue.

Start at a low listening volume before turning Silence off. Tones can mix with captured system audio or a local file; turning Silence on does not remove them from that combined trace. An output-device interruption can turn Silence back on while leaving the visual tones enabled.

Find your way around the window

Button or readoutUse
Start / Stop / CancelStarts system-audio capture when stopped; stops active sources and tones when running; cancels a connection in progress.
FreezeHolds the displayed trace while audio continues. Turn it off to resume drawing. It is available while the app is running.
FullscreenEnters presentation mode on the app's presentation window. Press Escape to return.
ControlsShows or hides the main inspector. Shortcut: Shift-Command-C.
Remote Controls window iconOpens a separate controls window. It operates the same trace and settings as the main inspector.
Detach Controls icon inside the inspectorOpens Remote Controls and hides the main inspector.
Status text / spinnerShows Connecting, Running, Frozen, Stopped, or an input problem. The spinner indicates a connection in progress.
Undo / RedoSteps backward or forward through visual edits, including slider, color, geometry, orientation, and preset changes. It does not rewind audio or recreate a previous recording.

In presentation mode, the small top bar contains Start / Stop, Remote Controls, and Exit Presentation. It hides after a short idle period. Move the pointer over the trace to reveal it. VoiceOver or the Keep presentation controls visible preference keeps it accessible without waiting for a hover.

Shape the trace: every dashboard slider

Open Controls → Sliders. Drag a slider with your mouse or trackpad. Double-click a dashboard slider to restore its default, or right-click it and choose Reset to Default. The small mark beneath the slider indicates its default position. Settings change the drawing; the visual Gain and Balance controls do not adjust the volume of the source you hear.

SliderRangeWhat it changes
Gain0.25–4Scales the input used for visualization. Increase it to give a quiet signal more presence; reduce it if the shape extends too far. It does not turn up your speakers.
Zoom0.25–10Enlarges or reduces the drawn trace. Use it to move between the whole pattern and details within it.
Persistence0–1Controls how much previous drawing remains visible between frames. Low values leave short-lived strokes; high values build trails. At exactly 1, the readout becomes Hold, retaining earlier strokes so you can build an image.
Smoothing0–1Smooths changes along the trace. Lower values retain more small detail; higher values produce a softer, less jagged path.
Sample Window256–4,096 samplesSets how many recent samples make up each trace. Smaller windows produce shorter, more instantaneous shapes; larger windows produce longer, denser geometry. It is a sample count, not a song duration or beat length.
Beam Decay0–1Fades older samples within the current trace, emphasizing the newer end. 0 gives uniform brightness along that trace; higher values give stronger falloff. This differs from Persistence, which retains previous frames.
Intensity0.2–2Changes the brightness of the drawn trace.
Line Width1–8Changes the thickness of the stroke or size of the points.
Glow0–1.5Adds colored light around the sharp trace. It changes the surrounding halo independently of Focus. At zero, that halo is off.
Focus0–1Changes the beam profile: lower values soften it, higher values sharpen it. Use Glow when you want surrounding light while retaining the core.
Balance−1–1Changes the relative left/right contribution to the visualization. Negative values favor the left channel; positive values favor the right; zero is balanced.
Rotation−180° to +180°Turns the trace. Use Scope → Reset View to restore the original orientation and zoom.

There are no iOS-style pinch-and-twist canvas gestures in this Mac build. Use the dashboard sliders, keyboard commands, or a game controller.

Background, geometry, and orientation

Under Background & Geometry, choose a background style:

  • Off gives a black canvas without a grid.
  • Solid uses the selected Background color.
  • Grid uses the selected Background color with the selected Grid color over it.

Click Background, Trace, or Grid to open the macOS color picker. The Trace color is used in Solid color mode; other color modes expose their own palettes.

Geometry → Line joins samples into strokes. Points draws the samples separately. Under Orientation, Flip Horizontal and Flip Vertical mirror the trace on their respective axes. Present Fullscreen enters presentation mode, like the top-bar Fullscreen button.

Choose and edit trace colors

Open Controls → Color Mode. Each mode changes how the live signal receives color; it does not recolor an audio file or change playback.

Solid

Select Solid, then choose Trace under Background & Geometry. Every new stroke uses that color.

Level

Select Level and choose Quiet and Peak colors. The trace blends between them according to the signal's level. The keyboard/menu equivalent is named Amplitude.

Bands

Select Bands, then choose Band Detail → Simple or Advanced. Click each band color to edit it.

Simple uses three palettes: Low · 20–300 Hz, Mid · 300 Hz–3 kHz, and High · 3 kHz+. Advanced exposes ten labels: 0–32 Hz, 33–64 Hz, 65–125 Hz, 126–250 Hz, 251–500 Hz, 500 Hz–1 kHz, 1–2 kHz, 2–4 kHz, 4–8 kHz, and 8–16 kHz+.

Band Separation runs from 0 to 1. Lower values blend active band colors; higher values emphasize the dominant bands more strongly. These color controls interpret recent audio activity; they do not split playback into separate tracks.

Bounce

Select Bounce and edit the six numbered colors. Bounce Time, from 0.1 to 3 seconds, sets the time for each transition between neighboring palette colors. A smaller value moves through the palette faster. This is a timed cycle, not a beat detector.

Choose Palette cycle → Back and forth for 1 → 2 → 3 → 4 → 5 → 6 → 5 → 4 → 3 → 2 → 1…, or Loop for 1 → 2 → 3 → 4 → 5 → 6 → 1…. Randomize Colors replaces the six colors with a new selection; use Undo if you prefer the previous one.

The Default preset's palette is yellow, blue, purple, pink, red, and green. The Paint preset intentionally has its own palette. Your saved presets and restored session can retain different colors.

Reactive

Choose Reactive, then BPM or Instrument where available.

  • BPM advances through the six-color palette with detected beats. Edit the numbered colors to choose that palette. On macOS 27 or later, analysis needs a short warm-up and holds the current color when a reliable result is unavailable. Earlier supported macOS versions use the built-in beat detector. A BPM value appears when available. There is no BPM-sensitivity slider to adjust in this release.
  • Instrument, available on macOS 27 or later, blends the selected Vocals, Drums, Bass, and Other sounds colors according to detected activity. It is analysis-driven color, not instrument isolation or separate audio tracks.

Read the status below the controls if a color is holding still. Analysis can lag the music and may not always produce a reliable result; the trace itself continues to use live audio. Energy is not an available mode in this release.

Input mode and monitoring

Input & Monitoring → Channel Mode chooses the relationship used to draw the trace:

  • L / R uses the left and right channels.
  • M / S represents the shared center component (Mid) and the difference between channels (Side).
  • Swap L/R exchanges the channels before drawing.

The format readout shows MONO or the channel count and sample rate when available. L CLIP and R CLIP indicate captured peaks at digital full scale. If you hear distortion, reduce the level in the source app; reducing visual Gain does not repair the original audio.

Correlation describes the relationship between channels. Values near +1 indicate closely matching channels, near 0 indicate little correlation, and near −1 indicate opposite polarity. Strongly negative values can indicate cancellation if the audio is combined to mono. Mono audio often draws a simple line; use stereo material or differently panned tones when you want wider shapes.

Presets, Undo, and starting another picture

Default restores the factory starting appearance and standard input-view settings. Paint is a starting point for accumulating artwork, with Persistence set to Hold, a colored palette, and a more enlarged trace. Neither factory preset starts a sound source for you.

To save a look, open My Presets…, enter a name, and click Save Current. Mac supports up to eight named presets, and a nonblank name is required. Duplicate names receive a numbered suffix. Click Load beside a saved preset to apply it. Click its trash button and confirm Delete to remove it; deletion keeps the current controls as they are.

Presets store visual settings, palettes, orientation, and input-view choices. They do not store audio, the current drawing, a selected audio source, or tone-generator voices. Undo and Redo operate on visual-setting edits, not on the sound or a saved image. When you are typing in a text field, the usual text-editing Undo command acts on that text.

Scope → Reset View restores Zoom, Rotation, and horizontal/vertical flips. Reset All… restores the default visual and input-view settings after confirmation, keeps your saved presets, and does not stop capture.

To let a held picture fade away without stopping audio, lower Persistence from Hold, let fresh frames replace it, then raise it again when ready. Mac build 17 does not have the iOS Clear Trace button. Keep a screenshot of artwork you want to retain: saved presets and session restoration save settings, not canvas pixels.

Use a game controller

Pair a compatible controller in macOS Bluetooth settings, or connect it using its supported wired connection. Bring AudioVector to the front and release all sticks and buttons once after connecting or returning to the app. Hold a control to change a value; release it to stop. Partial stick movement makes finer changes than full tilt.

Open Controls → Game Controller for the built-in View Game Controller Guide, Show Settings Values, and Controller Sensitivity.

Controller inputAction
Left stick up / downIncrease / decrease Zoom
Right stick right / leftIncrease / decrease Rotation
L1 / L2, or LB / LTIncrease / decrease Sample Window
R1 / R2, or RB / RTIncrease / decrease Beam Decay
D-pad up / downIncrease / decrease Smoothing
D-pad right / leftIncrease / decrease Persistence
Triangle / Circle, or Y / BIncrease / decrease Glow
Square / Cross, or X / AIncrease / decrease Line Width
Left stick clickToggle the grid
Right stick clickToggle Points / Line geometry
Options / MenuToggle fullscreen presentation

Button positions follow the operating system's controller mapping. Controller Sensitivity changes the overall adjustment speed from 0.25× to 3×; 1× is the default. Right-click that slider to reset it. Show Settings Values controls the temporary value pill over the trace while using the controller. These two preferences are saved separately from visual presets and do not become Undo steps.

Multiple displays and Remote Controls

Open Remote Controls from the top-bar window icon or Scope → Remote Controls (Shift-Command-D). Move that window to the display where you want to make adjustments, then enter Fullscreen on the presentation display. The remote window provides Start/Stop, Freeze/Unfreeze, fullscreen switching, and the full inspector.

Main windows share the same source, trace settings, and visual-edit history. A change from another window or a controller affects them together. One window owns fullscreen presentation; the selected presentation window is not always the window you most recently clicked. If another window is the one entering fullscreen, exit presentation and move that window to the display you want before presenting again.

Accessibility and comfortable controls

Expand Controls → Accessibility:

  • Control background: choose Transparent, Semi-transparent, or Opaque.
  • Higher contrast: gives controls a solid, higher-contrast backing.
  • Control text size: choose Standard, Large, or Extra Large. Larger settings also reflow the dashboard into a single column and apply to the detached tone editor.
  • Keep presentation controls visible: stops the presentation bar from hiding automatically.

The app has a dark interface and responds to system Increase Contrast and Reduce Transparency by using an opaque control background. Detached controls and tone windows already use an opaque background. VoiceOver automatically keeps presentation controls visible. Standard labeled controls can be navigated with VoiceOver and Voice Control; the main trace exposes a status label, and the Input & Monitoring readouts provide text for audio status and correlation. Those readouts are not a spoken description of every shape in the artwork.

The trace's continuous motion is central to the app; AudioVector does not claim Reduced Motion support for the main visualization. See the separate accessibility page for the current support and testing scope.

The interface follows the supported language selected by macOS. Use macOS language settings to choose an app-specific language where your system provides that option. This release includes English, Simplified Chinese, Traditional Chinese, French, German, Hindi, Indonesian, Japanese, Korean, Brazilian Portuguese, Russian, Spanish, Turkish, and Vietnamese.

Keyboard shortcuts and built-in help

ShortcutAction
Command-RStart / Stop, or Cancel while connecting
Command-FFreeze / Unfreeze
Control-Command-FFullscreen / Exit Fullscreen
EscapeExit presentation
Command-0Reset View: zoom, rotation, flips
Shift-Command-0Reset All Controls, with confirmation
Shift-Command-CShow / hide the main controls
Shift-Command-DOpen Remote Controls
Command-1Solid color mode
Command-2Amplitude / Level color mode
Command-3Bands color mode
Command-4Bounce color mode
Command-5Reactive color mode
Command-ZUndo
Shift-Command-ZRedo

The Help menu contains Quick Start, Permissions Help, Privacy Policy, Keyboard Shortcuts, and Understanding the Controls, plus support-website and email links. Permissions Help → Open System Settings opens macOS settings. Choose AudioVector → About AudioVector for the installed version/build information and support links.

What is remembered, and what is not

When you return to AudioVector, the previous session's visual settings, palettes, selected preset, control visibility, and tone parameters are restored separately from named presets. Tone voices return disabled. Capture, file playback, Freeze, and fullscreen do not automatically resume. The previous canvas image is not a saved project or recording.

Troubleshooting on Mac

  • Ready / Stopped: click Start for system audio, open a local file, or enable a tone.
  • Waiting for sound: capture is active but the signal is very quiet. Start or resume playback in the source app, check its output, or try a known stereo file.
  • Audio unavailable / missing trace: check capture permission, then try Stop and Start. Reopen AudioVector if macOS changed its permission. A source can restrict capture even though you can hear it.
  • Trace is motionless but music continues: turn off Freeze. At Hold, old strokes can also make new movement less obvious; temporarily reduce Persistence to inspect the fresh signal.
  • Trace is too large or too dense: lower Zoom or Gain, reduce Sample Window, or lower Persistence. Reset View only resets zoom/orientation; Default resets the wider appearance.
  • Colors do not follow the beat immediately: Reactive analysis needs time and a usable signal. Check its status; the color can hold while it warms up or lacks a reliable result.
  • Tones draw but cannot be heard: Silence may be on, a voice's Volume may be zero, or the output device may have changed. Check those before raising listening volume.
  • A controller does nothing: make AudioVector the active app, close help or reset prompts, check the controller's system connection, and release all controls before trying again.
  • Need to report a problem: include the Mac model, macOS version, AudioVector build from About, chosen source, and the steps that trigger it. A screenshot or short recording can show the relevant controls and trace; avoid including account credentials or private material.

Back to contents ↑

Contact

Need a hand?

Email support@johnclausen.com for support or privacy questions, or audiovector@johnclausen.com for AudioVector inquiries. Include your device, operating-system version, AudioVector build, chosen audio source, and the steps that led to the problem. A screenshot or short recording can help if you choose to share one. Please leave out passwords and verification codes.

Using TestFlight? Open TestFlight → AudioVector → Send Beta Feedback. The TestFlight invitation remains available while the beta is open.

Privacy policy · Accessibility information