Skip to content

Repository files navigation

StillSound

StillSound Studio

Version Downloads Stars Issues License Rust Tauri Windows

The Universal Media Sync Engine. Automatically pauses Spotify when any video plays.

Download · Demo · How it works


StillSound automatically pauses your Spotify when you play a video (on YouTube, Twitter, Reddit, Netflix, Twitch, etc.) and resumes it when you stop. No more alt-tabbing to pause your music during lectures or while browsing feeds.

Demo

StillSound Demo

Versions & Changelog

v2.0.0 (The Universal Update)

  • Universal Multi-Site Support: StillSound is no longer just for YouTube. It now seamlessly supports Twitter, Reddit, Netflix, Prime Video, Twitch, Coursera, Udemy, and more. Manage enabled sites via toggles directly in the app.
  • Dynamic Island UI: A complete aesthetic overhaul featuring an iOS-inspired Dynamic Island, complete with album art, track details, and playback controls.
  • Audio-Responsive Aesthetics: The desktop app and extension now glow and pulse with the exact colors of the Spotify album art you are currently listening to.
  • Multi-Device Hand-off: Transparently shows exactly which device Spotify is playing on (e.g., iPhone) and gracefully transitions state across devices.
  • Bi-Directional Volume Sync: Changes to your volume in the native Spotify app or on your phone instantly reflect on StillSound's new slider.
  • Extension Controls: Full music playback controls (Play, Pause, Next, Prev) right from your browser's extension popup.

v1.2.0

  • Multi-Browser Sync: Intelligent cross-browser aggregation ensures Spotify only resumes when ALL connected browsers have stopped playing. No more race conditions when switching between Firefox and Brave.

v1.1.0

  • Minimize to Tray: Keep the app running in the system tray without cluttering your taskbar.
  • Autostart: Optionally launch StillSound on system boot.

v1.0.0

  • Initial release featuring the core WebSocket sync engine and Spotify OAuth PKCE flow.

How It Works

┌─────────────────────┐     WebSocket      ┌──────────────────┐     Spotify API     ┌──────────┐
│ Multiple Browsers   │ ◄───────────────► │  StillSound App  │ ◄────────────────► │  Spotify  │
│ (Chrome, FF, Brave) │   localhost:9876    │  (Desktop)       │     OAuth + REST    │          │
└─────────────────────┘                    └──────────────────┘                     └──────────┘
  1. The browser extension detects when a supported video plays or pauses on any of the enabled websites.
  2. It intelligently aggregates the state and sends it to the StillSound desktop app over a local WebSocket.
  3. The desktop app commands Spotify to pause or resume accordingly.

Installation

Desktop App (Windows)

  1. Download the latest .exe installer from the Releases page.
  2. Run the installer — choose where to install.
  3. Launch StillSound from the Start Menu or desktop.

Browser Extension (Chrome / Brave / Firefox)

Chrome & Brave

  1. Download or clone this repository to get the browser-extension folder.
  2. Open Browser → chrome://extensions/
  3. Enable Developer Mode (toggle in the top right).
  4. Click Load Unpacked → select the browser-extension folder.

Firefox

  1. Open Firefox → about:debugging → "This Firefox".
  2. Click Load Temporary Add-on.
  3. Select the manifest.json inside the browser-extension folder.

First-Time Setup

The app walks you through setup:

  1. Spotify Client ID — Go to Spotify Developer Dashboard, create an app, copy the Client ID, and set the Redirect URI to http://127.0.0.1:8921/callback.
  2. Connect — Click "Connect to Spotify" in the app, sign in, and approve.

That's it. Open a YouTube video and your Spotify will pause automatically.


Building from Source

Requires Rust, Node.js, and MSVC Build Tools.

# Development
npm run dev

# Build installer (.exe)
npm run build

The installer is output to src-tauri/target/release/bundle/nsis/.


Project Structure

├── src/                    # Frontend (HTML/CSS/JS)
│   ├── index.html
│   ├── styles.css
│   └── main.js
├── src-tauri/              # Rust backend
│   ├── src/lib.rs          # Sync engine
│   ├── tauri.conf.json     # App & installer config
│   └── Cargo.toml          # Dependencies
└── browser-extension/      # Chrome extension
    ├── manifest.json
    ├── background.js
    ├── content.js
    ├── popup.html
    └── popup.js

Credits

Built by saketjndl (.sodiumcyanide).

If StillSound helps your study sessions, consider starring the repo


License

MIT

About

StillSound Studio is a cross-platform desktop application that automatically plays ambient background audio from Spotify whenever a YouTube video is paused. When the video resumes, the ambient audio fades away. This prevents jarring silence when you pause educational videos, keeping you focused and immersed.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages