Spotilocal

A simple Windows application that saves your current Spotify track information to text and image files!

Inspired by Snip, but using a different approach for faster updates.

• ⚡ Real-time updates of track information; < 1s delay, no rate limiting
• 💻 Runs in the background; find it in the system tray

Settings

• Empty content files when paused - Update cover art to transparent image, and empty text file contents when you pause Spotify.
• Save JSON file - Save player state to JSON file.

Note

The JSON state file will never be emptied on pause, because it contains the isPlaying boolean.

Future feature ideas:

• Custom templating for text files
• Specify which image resolutions you want to save, if any
• Custom output directory?
• Previous / Next tracks
• Display track information in settings menu?
• Display track controls in settings menu?
• Spotilocal REST API
• Spotilocal WebSockets API
• Support local track metadata and cover art
• Add support Podcast episode track data
• Add support Audiobook track data
• Explore supporting macOS / Linux

Development

How it technically works

It loads the Spotify web player in a hidden window to detect track changes and saves them to text files.

It doesn't need to send a single API request on top of the default player!

Recommended IDE Setup

• VSCode + ESLint + Prettier

Project Setup

Install

npm install

Development

npm run dev

Build

npm run build:win