Dhun 1.1.1 · धुन

If v1.1 crashed the moment you entered ambient mode with a visualizer selected — this is the fix. Please update.

The bug

The visualizer shaders ship inside the app (Contents/Resources/Dhun_Dhun.bundle), and they were there all along — but the Swift Package Manager–generated Bundle.module accessor used to find them never looks in Contents/Resources for executable targets. It checks exactly two places: the app bundle's root, and an absolute path into the build directory of the machine that compiled it. So the visualizers worked perfectly on one computer in the world (the dev machine, via that second path) and called fatalError on every other Mac.

v1.1.1 resolves the resource path by hand via Bundle.main, and the build script now fails loudly if the shader bundle is ever missing from a build. Nothing else changed.

How to update

One line in Terminal (no Gatekeeper dialog):

curl -fsSL https://raw.githubusercontent.com/Ayush-pbh/dhun/main/install.sh | sh

Homebrew: brew update && brew upgrade --cask dhun, then xattr -d com.apple.quarantine /Applications/Dhun.app

Or download Dhun-1.1.1.dmg below (first launch: System Settings → Privacy & Security → Open Anyway).

See the v1.1.0 notes for everything that shipped in 1.1 — the eight audio-reactive visualizers, React to sound, the debug overlay, and the About pane.

---

Dhun is an independent project and is not affiliated with or endorsed by Spotify.

Dhun 1.1 · धुन

The music update. Dhun no longer just shows you what's playing — it listens.

🌌 Visualizers

Ambient mode (⌘-click the square or use the menu bar) can now replace its blurred backdrop with one of eight full-screen generative Metal scenes, every one steered by Spotify's actual audio — captured with ScreenCaptureKit, analyzed with an Accelerate FFT, and condensed into control signals. Never a bar chart: bass moves the large masses, mids stir turbulence, highs add flicker, and every scene stays alive in quiet passages.

• Ambience Plasma — WMP-era energy clouds and tendrils
• Ink in Water — frame-feedback blooms that remember the song
• Murmuration — a 14,000-bird GPU flock
• Volumetric Explosion — raymarched blasts that detonate on bass hits and never loop
• MoonWalk — a moonlit flight whose speed rides the music
• Cloud Canal & Calm Flow — serene scenes that borrow only your colors
• Movement — the live spectrum painted into slowly drifting light

Every scene takes one of five color moods — or Album colors, tinted live from the current cover.

🎚️ React to sound

A new toggle (Settings → Extras, also in the debug overlay) mutes the audio reaction without leaving ambient mode: scenes keep their idle drift, and no audio is captured at all while it's off.

🔬 Debug overlay

For the curious: a live waveform straight from the capture pipeline, the renderer's real FPS, plus a scene dropdown and reaction switch — so you can hop between visualizers from inside ambient mode.

⚙️ Settings & About

The Settings pane got a cleanup, and a new About tab with version info, links (GitHub, ayusht.me), the full shader credits, and the license.

🔐 Permissions

The visualizers need macOS's Screen & System Audio Recording permission to hear Spotify (Dhun never touches the microphone, and captures nothing when React to sound is off). macOS only asks once — if the waveform flatlines, enable Dhun in System Settings → Privacy & Security → Screen & System Audio Recording and relaunch.

📜 License change

Dhun 1.1 is licensed CC BY-NC-SA 4.0 (v1.0 was MIT and remains so). The change lets Dhun adapt visualizer shaders from the Shadertoy community, whose default license is CC BY-NC-SA 3.0. Adapted scenes — Volumetric Explosion (Duke), MoonWalk (Nikos Papadopoulos / 4rknova), Cloud Canal (Stéphane Cuillerdier / Aiekick), Calm Flow (Sebastien Durand) — carry attribution headers in the source and full credits in the README and the About tab. Ambience Plasma, Ink in Water, Murmuration, and Movement are original scenes by Ayush Tripathi.

Install

Easiest — one line in Terminal, no Gatekeeper dialog:

curl -fsSL https://raw.githubusercontent.com/Ayush-pbh/dhun/main/install.sh | sh

Homebrew: brew install --cask ayush-pbh/tap/dhun then xattr -d com.apple.quarantine /Applications/Dhun.app (Homebrew quarantines unnotarized apps and v6 removed --no-quarantine).

Or download Dhun-1.1.dmg below and drag Dhun into Applications. Dhun isn't notarized yet, so the first launch shows "Dhun" Not Opened — click Done (not "Move to Trash"), then System Settings → Privacy & Security → scroll to the bottom → Open Anyway. One time only. Needs macOS 13+ and the Spotify desktop app.

---

Dhun is an independent project and is not affiliated with or endorsed by Spotify.

Dhun 1.0 · धुन

The first release of Dhun — whatever Spotify is playing, living on your desktop as art.

✨ Highlights

• Floating album-art square — borderless, draggable, remembers its place
• Vinyl persona — a record that actually spins while music plays (5–78 RPM), with five duotone color schemes or tints pulled live from the album cover
• Palette engine — dominant colors extracted from every cover, feeding the glow, gradients, and vinyl tint
• Wallpaper mode — blurred-art, full-bleed, or palette-gradient desktops on every track change
• Live vinyl desktop — a spinning record rendered between your wallpaper and your desktop icons
• Notch island — hover near the camera for artwork, live progress, and controls
• Ambient mode, track toasts, menu bar controls, Liquid Glass hover pill (macOS 26)
• Click-through mode, screen-sharing invisibility, launch at login — every feature is a Settings toggle

📦 Install

1. Download Dhun-1.0.dmg below and drag Dhun to Applications
2. First launch: right-click → Open (not notarized yet, so Gatekeeper blocks a plain double-click once)
3. Approve the Automation prompt so Dhun can read the current track from Spotify

Requires macOS 13+ and the Spotify desktop app.