Zen Code Ambience 🧘

Ambient soundscapes for focus — rain, thunder, train, cafe chatter, lofi, piano, white noise & more.

Quick Access

Method	How
Browser (any device)	Visit aayushrajaji-09.github.io/zen-code-ambience — works instantly. Install as PWA on mobile/desktop.
Chrome Extension	Load extension/ folder in chrome://extensions (Developer Mode) or submit to Chrome Web Store. Side panel support included.
IDE Extension	Install aayush.zen-code-ambience-1.0.0 from the Antigravity marketplace.
Terminal (CLI)	Run ./zen-ambiator.ps1 (PowerShell) or ./zen-ambiator.zsh (zsh/mpv).

---

Features

• 14 Audio Channels: Organized into collapsible categories (Nature, Weather, Cozy, Music).
• ⏭ Skip Track: Each channel contains a library of 3-5 alternate tracks. Cycle through them instantly.
• 🔊 Master Volume: Proportional global volume scaling.
• 📻 Web Audio White Noise: Procedurally generated continuous white noise (no files, zero-latency).
• Smooth Fade Transitions: 300ms volume fade when toggling play/pause to prevent sudden audio pops.
• Vibrant Aesthetics: Glassmorphic dark-theme design with pulsing borders and equalizer visualizers.

---

🧠 The Science of Sound & Productivity

Listening to music and ambient noise has been scientifically proven to boost focus, efficiency, and creative problem-solving:

• State Positive Affect & Efficiency: In a study by Dr. Teresa Lesiuk (University of Miami), software developers who listened to music completed tasks more quickly and produced higher-quality ideas compared to working in silence. The music acts as a mood regulator, elevating positive affect, which in turn enhances cognitive thinking and systematic problem-solving.
• Creative Abstract Thinking: Research published by Dr. Ravi Mehta (University of Illinois) shows that moderate ambient noise (~70 dB, similar to café chatter or soft rain) triggers a slight cognitive challenge that fosters abstract processing, leading to higher creative output compared to absolute silence or loud environments.

By mixing natural sounds, rain, and instrumental music, you can design the optimal acoustic sweet-spot for your brain to trigger a flow state.

---

Project Structure

zen-code-ambience/webview.html     ← Antigravity extension (main product)
zen-ambiator.ps1 / .zsh            ← CLI players
docs/                              ← GitHub Pages site (PWA)
  ├── index.html                   ← same webview + PWA manifest
  ├── manifest.json                ← PWA install manifest
  ├── sw.js                        ← service worker (offline cache)
  └── icons/                       ← app icons
extension/                         ← Chrome extension
  ├── manifest.json                ← Manifest V3
  ├── popup.html                   ← popup / side panel
  └── icons/

---

🌐 Enable GitHub Pages (one-time)

1. Go to repo Settings → Pages
2. Source: Deploy from a branch
3. Branch: main, folder: /docs
4. Save. The site is live at https://aayushrajaji-09.github.io/zen-code-ambience/ within 2 minutes.

🧩 Load Chrome Extension (developer mode)

1. Open chrome://extensions
2. Enable Developer mode (top-right toggle)
3. Click Load unpacked → select the extension/ folder
4. Pin the extension to the toolbar. Click to open, or right-click → "Open side panel" for persistent playback.

---

💻 CLI Version (zen-ambiator.ps1)

If you want to use the mixer directly from your terminal (outside the IDE), run:

./zen-ambiator.ps1

CLI Features:

• Fully interactive console HUD with high-tech ASCII art.
• Monospace progress bars displaying channel volumes.
• Toggle channels, skip tracks, and adjust master/channel volumes with simple commands:
  • [Num] (e.g. 1, 2) — Toggle play/pause for a channel.
  • s [Num] (e.g. s 1) — Skip track.
  • v [Num] [Val] (e.g. v 1 80) — Set channel volume (0-100%).
  • mv [Val] (e.g. mv 70) — Set master gain volume.
  • m — Mute all.
  • q — Quit.

---

👤 Maintained & Operated By

Aayush Rajaji
Founder & CBO @ AIGyde · Founder @ Greston Global · Co-Founder @ FounderTube
GitHub (@Aayush-Rajaji) · LinkedIn

---

📄 License

MIT License.