Installation

macOS compatibility: Cymatik pre.3 requires macOS 14 Sonoma or later. macOS 12 Monterey and macOS 13 Ventura are not supported.

macOS

  1. Confirm that About This Mac shows macOS 14 Sonoma or newer
  2. Download the universal Apple Silicon and Intel build from the compatibility and download section
  3. Open the DMG and drag Cymatik into Applications
  4. If Gatekeeper asks for confirmation, follow the current notice on the purchase download page
  5. Launch Cymatik from Applications and enter your activation key

Windows

  1. Download the installer from the download page
  2. Double-click the downloaded Cymatik-Setup-1.0.0-pre.3.exe installer
  3. Windows SmartScreen may appear — click "More info" then "Run anyway" (beta is not yet code-signed)
  4. Follow the installer wizard. Default installation is recommended.
  5. Launch Cymatik from your Start Menu or Desktop
Note: Cymatik requires Windows 10 or later with a WebGPU-compatible GPU (most NVIDIA/AMD cards from 2015+).

First Run

When you first launch Cymatik, the app will:

  1. Initialize the WebGPU renderer (takes 2–3 seconds)
  2. Load the default preset (Helix Storm)
  3. Listen for audio input

You'll see a canvas with geometric visuals moving slowly. To see real reactivity, connect audio.

Audio Setup

Choosing an Audio Input

In the Perform tab, you'll see an Input dropdown. Cymatik supports three audio sources:

🎤 Microphone

Your computer's built-in mic or an external USB microphone. Good for live performances or picking up ambient sound.

Input: Microphone (or your USB device name)

🔊 Desktop Audio

Captures system audio — perfect for visualizing Spotify, YouTube, Twitch, etc. Click the ↺ Refresh button to rescan devices. If Desktop Audio doesn't appear:

  • Windows 10/11: Enable "Stereo Mix" in Sound Settings (may require driver update)
  • Alternative: Use VB-Cable or VirtualAudio to route audio

Testing Your Audio

Click the 🔊 Test button to see a live input level meter for 3 seconds. Green bar = audio is being detected.

Adjusting Sensitivity

Use the Level slider to adjust how loud the input needs to be to trigger visuals. Lower = more sensitive.

Interface Guide

Perform Tab

This is where you control what Cymatik is currently doing.

Audio Input

Select your mic, desktop audio, or file. The Level slider controls sensitivity. Reactivity scales how much audio influences the visuals (higher = more dramatic).

Shape

Choose from 7 selectable shape families. Each architecture responds to audio differently: Resonance Sphere, Vortex, Helix Harmonic Tunnel, Torus, Chladni Plate, Sacred Mandala, and Hypercube.

Preset

Pre-configured color, motion, and effect combinations. Click Apply to load.

Auto-Play

Automatically cycles through parameters on beat. Useful for live settings where you want hands-off randomization. Expand Automations to control which parameters change.

BPM & Tempo

Cymatik detects your audio's BPM automatically. Tap Tempo lets you tap along to manually set it. BPM Lock freezes the tempo so it doesn't re-detect.

Snapshots

Save the current look to one of 8 slots. Press 1–8 to recall, or Shift+1–8 to save.

Looks Tab

Fine-tune how Cymatik renders.

Motion

Rotation speed, depth, zoom, and complexity. These affect camera movement and shape detail level.

Color & Glow

Choose color palette, shift hue, adjust glow intensity, and line weight.

Effects

Trail = motion blur persistence. Bloom = light diffusion. Fog = atmospheric depth. Width Fill = line thickness.

Post FX

Advanced effects pipeline: chromatic aberration, vignette, depth of field. These run on the GPU for high performance.

Advanced (Collapsible)

The full parameter set: yaw/pitch/roll, geometry mix, physics, emitters, particle systems, and more. Explore here once you're comfortable with basics.

System Tab

App-level controls.

Resolution & FPS

Choose export resolution (up to 4K) and a target frame rate of 30 or 60 fps. Export performance depends on your hardware, effects, and operating system. These settings do not change the live-playback target.

Performance

Quality slider (lower = better performance, higher = better visuals). Adjust if you're getting frame drops.

Show FPS Counter

Displays real-time frame rate, frame time, and memory usage in top-right corner. Useful for monitoring performance.

Export

Record your visualization in the format supported by the current platform and runtime. Cymatik attempts MP4 (H.264) where available and falls back to WebM. Start Export begins recording; Stop Export finishes and offers the file.

Snapshots & Slots

Save and load 8 named looks. Use the dropdown to pick a slot, then Store to save or Recall to load.

Snapshots & Presets

What's the Difference?

Preset Snapshot
18 built-in starting points (Helix Storm, Galactic Bloom, Flower of Life, and more). The factory definitions are fixed. Your custom saves. 8 slots. Can be overwritten anytime.
Click in Perform tab, then Apply. Press 1–8 to load, Shift+1–8 to save.

Workflow: Create a Custom Look

  1. Start with a preset you like (e.g., "Aurora Veil")
  2. Tweak parameters in the Looks tab until it's perfect
  3. Press Shift+1 (or any 1–8) to save to snapshot #1
  4. Now you can recall it anytime with 1
Pro tip: Snapshots are stored locally. Back them up by exporting the snapshot data (System tab).

Export & Recording

Exporting a Video

  1. In System tab, set your desired resolution and FPS
  2. Connect audio and let it play for a few seconds to prime the visuals
  3. Click Start Export
  4. The app records to the supported MP4 or WebM format as your audio plays
  5. Click Stop Export when done
  6. Click the Download link to save the video

Tips for Great Exports

  • Use fullscreen mode (F): No UI elements in the render
  • Pre-set your audio: Get the exact section you want to export playing
  • 4K is demanding: Use a lower resolution or frame-rate target if frames drop
  • Format: MP4 availability depends on the runtime; WebM is used as a fallback

Streaming Setup

OBS / Streamlabs

  1. Open Cymatik and set it up the way you want
  2. In OBS, add a new source: Window Capture
  3. Select the Cymatik window
  4. Position and scale in your scene as desired
  5. If using Desktop Audio input in Cymatik, your audio will react live on stream

Keyboard Control While Streaming

Press F to toggle fullscreen/windowed. In fullscreen, use:

  • H = hide UI (clean visuals only)
  • 1–8 = recall snapshots
  • Shift+1–8 = save snapshots

MIDI Control

Connecting a MIDI Controller

  1. Plug in your MIDI device
  2. In Cymatik, click Enable MIDI (in the UI)
  3. Select your device from the dropdown

Mapping Controls

MIDI Learn maps incoming controls to app parameters. Device support depends on your operating system, controller driver, and the runtime's MIDI access.

Popular Setups

🎚️ Mixer / 8 Faders

Map each fader to Motion, Intensity, Color, Effects, etc. for live tweaking.

🎛️ DJ Controller

Use HPF/LPF knobs to control frequency-based parameters. Map pads to snapshot recall.

📟 Pad Controller

Map 8 pads to your 8 snapshot slots for instant scene switching.

Reference

Keyboard Shortcuts

Key Action
F Toggle fullscreen
H Toggle UI Hidden (fullscreen only)
Escape Exit fullscreen / show UI
1–8 Recall snapshot in slot #
Shift+1–8 Save current state to snapshot slot #
M Toggle meter display (audio levels)

Shape Descriptions

Cymatik Sphere

Geodesic sphere with radial symmetry. Pulsates with bass.

Vortex Spiral

Spiraling tornado. Treble frequencies tighten the spiral.

Helix Harmonic Tunnel

Double-helix DNA structure spiraling forward.

Torus Pulse

Ring geometry that pulses radially with beat detection.

Chladni Plate

Standing-wave patterns inspired by physical cymatics.

Sacred Mandala

Layered radial symmetry shaped by rhythm and frequency.

Hypercube 4D

A projected four-dimensional cube with audio-reactive depth and rotation.

Troubleshooting

❓ "No audio input available"

Solution: Check Windows Sound Settings. If using Desktop Audio, enable Stereo Mix. If it's not available, your driver may not support it — try a VB-Cable virtual audio cable instead.

❓ Frame drops / stuttering

Solution: Lower the Performance slider in System tab. 4K export is CPU-intensive; if recording, close other apps. Check Task Manager to see if something else is maxing your GPU.

❓ SmartScreen warning on launch

Solution: The Windows pre-release installer is not yet code-signed. Download only from cymatik.live, then click "More info" → "Run anyway" if you choose to proceed.

❓ MIDI device not detected

Solution: Plug it in before launching Cymatik. If still not showing, try clicking the refresh button or restarting the app.

❓ Audio reactivity is slow or unresponsive

Solution: Increase the Reactivity slider in the Perform tab. Lower the Level slider to catch quieter sounds. Enable Beat Detection for tempo-based reactivity.

❓ Export file is huge / won't play

Solution: Export format depends on runtime support. If a WebM export does not play in your editor, use VLC or convert with FFmpeg: ffmpeg -i video.webm video.mp4

❓ Something other issue?

Solution: Check the in-app logs or contact support. Beta feedback is valuable — let us know what broke.

Getting Help

Cymatik is in active development. If you find a bug or have a feature request:

Beta users' feedback directly influences what gets built next. Your voice matters.