Allows you to remotely control the local Spotify app on your computer through a REST API or socket.io connection.
Supports macOS (full control) and Windows (limited control).
For API details, see api.md.
| Platform | Support Level | Notes |
|---|---|---|
| macOS | ✅ Full | Uses AppleScript to control Spotify directly. Full support for playback, volume, seeking, etc. |
| Windows | ⚠ Limited | Uses Spotify deep links. Can start playback of specific tracks or albums, but does not support pause, volume, next/prev, etc. |
macOS:
Download .dmg
Windows:
Download .exe
The app runs a local server on port 8801 by default.
- REST API and socket.io interface for remote Spotify control
- Designed to work with Bitfocus Companion via a custom module
- Status variables and feedback support (macOS only)
| Action | macOS | Windows |
|---|---|---|
| Play/Pause/Toggle | ✅ | ❌ |
| Play Track by ID | ✅ | ✅ |
| Play Track by ID in Context | ✅ | ✅ |
| Next/Previous | ✅ | ❌ |
| Seek / Set Position | ✅ | ❌ |
| Volume Up/Down/Set/Mute | ✅ | ❌ |
| Repeat / Shuffle Modes | ✅ | ❌ |
Built with Electron.
npm install
npm start