Skip to main content
The Auto DJ system intelligently manages your audio environment by automatically controlling ambient effects and background tracks based on your chosen immersion mode.

​
Immersion Modes

Choose from four distinct modes that define your listening experience:

Music

Pure procedural music with no ambient effects. Perfect for focused work.

Atmosphere

Adds core weather and nature effects for enhanced immersion.

World

Full immersion with all effects and ambient tracks enabled.

Manual

Complete user control - Auto DJ makes no automatic changes.

​
Mode Details

Just the beat and chords. No atmosphere or world effects.Ideal for:
  • Deep focus work
  • When you want minimal distraction
  • Pure musical background
  • Programming or writing
What’s active:
  • ✅ Procedural music engine
  • ✅ Piano, drums, chords
  • ❌ Rain, thunder, campfire, jungle
  • ❌ Ambient tracks
Music mode provides the cleanest audio experience with just the core LoFi beat.

​
Switching Modes

Change immersion modes in the Settings panel:
1

Open Settings

Press J to open the settings panel
2

Find Immersion Section

Look for the “Immersion” section with four mode buttons
3

Select Mode

Click any mode button to activate it:
  • Music
  • Atmosphere
  • World
  • Manual
4

Auto-Apply

The mode activates immediately and adjusts all effects accordingly

​
Visual Feedback

Mode buttons show clear active states:
StateAppearanceMeaning
InactiveTransparent background, thin borderMode is not active
ActiveWhite background, black text, boldCurrently selected mode
HoverSlightly brighter backgroundButton is interactive

​
Persistent Settings

Your mode selection is automatically saved:
  • Selected mode is stored in localStorage
  • Persists across app restarts
  • No account or cloud sync required
  • Instant restore on launch

​
Technical Implementation

The Auto DJ system uses custom events to coordinate changes: 
window.dispatchEvent(
  new CustomEvent("auto-dj-mode-changed", { 
    detail: { mode: "ATMOSPHERE" } 
  })
);
Components listen for mode changes and adjust their behavior accordingly.

​
Ambient Tracks

World mode includes access to 9 ambient background tracks:
City atmosphere with distant seagull calls
Submerged white noise and bubbling sounds
Peaceful nighttime environmental sounds
Gentle ocean waves lapping on sand
Subtle office sounds for workspace immersion
Urban environment with traffic and life
Computer fan and hard drive sounds
Rhythmic train travel ambience
Gentle to strong wind sounds
Ambient tracks can be controlled individually using number keys 1-9. See Keyboard Shortcuts for details.

​
Mode Comparison

FeatureMusicAtmosphereWorldManual
Procedural Music✅✅✅⚙️ User controlled
Rain/Thunder❌✅✅⚙️ User controlled
Campfire/Jungle❌✅✅⚙️ User controlled
Ambient Tracks❌❌✅⚙️ User controlled
Auto Control✅✅✅❌

​
Best Practices

Start Simple

Begin with Music mode and gradually add more immersion as needed

Match Your Task

Use Music for focus, World for creative work

Adjust Volume First

Set comfortable volume levels before choosing a mode

Experiment

Try all modes to find what works best for you
Many users find Atmosphere mode provides the perfect balance - enough immersion to stay engaged without becoming distracting.

​
Keyboard Shortcuts

While Auto DJ manages effects automatically, you can always override:
  • Press A, S, D, F to toggle individual effects
  • Press 1-9 to control ambient tracks
  • Press K to stop all ambient sounds
Manual controls work in all modes except Manual mode (where they’re the only control method).

Build docs developers (and LLMs) love

Get started for freeTalk to us