for macOS
Ambient Player
Play any YouTube, Vimeo, or direct video fullscreen behind every app on your Mac. No chrome — just atmosphere. Paste a URL, hit play, and stay on task with a built-in Pomodoro / Flowtime timer, guided breaks, and a 7-channel ambient sound mixer.
Not sure which one? Apple menu → About This Mac. If the chip starts with "Apple M", pick Apple Silicon. Otherwise, Intel.
Install in 4 steps
- Unzip the download. Double-click the
.zipin your Downloads folder. You'll getAmbientYT.app. - Move it to Applications. Drag
AmbientYT.appinto your Applications folder. - Remove the quarantine flag. macOS blocks unsigned apps with a misleading "app is damaged" error. You'll fix it by running one short command in Terminal.
How to open Terminal: press ⌘+Space to open Spotlight, type
terminal, and press Return.
Or in Finder: Applications → Utilities → Terminal.app.In the Terminal window, paste this and press Return:
xattr -cr /Applications/AmbientYT.app
Nothing visible happens — that's success. You can close Terminal now.
- Launch it. Double-click the app in Applications. A small floating control bar appears on screen — that's the entire UI.
The floating control bar
Everything happens from a small bar that floats above your desktop. From left to right:
- ▶ / ⏸ Play / Pause — toggle the video.
- 🔇 Mute / Unmute — silence audio without stopping the visuals.
- 🌐 URL — paste any YouTube, Vimeo, or direct
.mp4/.webmlink to play it as your ambience. - Timer pill (mm:ss) — click to open Pomodoro / Flowtime. Pomodoro counts a fixed focus block (default 25 min) then a fixed break (default 5 min). Flowtime lets you focus as long as you want and auto-suggests a break of focus ÷ 5 (capped at 20 min). A thin progress bar runs along the top of the screen, color-matched to your video.
- ☕ Break — fullscreen blur overlay with a synchronized breathing animation and a fresh activity idea each time (100 built-in, plus your own from Settings).
- 🎚 Mixer — 7 ambient channels (rain, café, forest, fireplace, brown noise, ocean, wind), each with its own volume. Layer them however you like — your mix is remembered.
- ⚙ Settings — set timer durations, paste your own sound URLs into the mixer, and add custom break activities.
- ✕ Quit — fully exits the app.
The video itself sits behind every other window, above the wallpaper. Clicks pass through to whatever app is in front, and audio keeps playing while you work. Your last video, mix, and settings are remembered between launches.
Coming soon
Favorites & folders — saving videos and grouping them into folders (plus quick next / random buttons) is planned for v1.2. For now, your last-loaded video is remembered between launches, but there's no UI yet to keep a library.
Tips & troubleshooting
- • "App is damaged" on launch: you missed step 3. Run
xattr -cr /Applications/AmbientYT.appin Terminal and try again. - • Can't find the app: there's no Dock icon by design. Look for the floating control bar. If it's hidden, relaunch from Applications.
- • YouTube ads: they still play unless you sign into YouTube Premium inside the app (a YouTube limitation, not ours).
- • Video won't load: some YouTube videos disable embedding. Pick a different one — the curated library only contains embeddable videos.
- • Quitting: click the ✕ on the floating bar. There's no Dock or menu-bar icon to quit from.
macOS only • Unsigned build • Built with Electron