Skip to content
Mini Spotify player with visualizations.
Branch: master
Clone or download
Latest commit b0bb81c Feb 26, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
src A simple implementation of Seascape Feb 26, 2019
.pretierrc.json some scaffolding, typescript, electron, etc Jan 12, 2019
LICENSE updated README with instruction on how to target the right Python ver… Feb 26, 2019
binding.gyp IPC bug fix, and fixing the build on MacOS Jan 25, 2019
package.json semantic versioning 1.0.0-beta Jan 28, 2019
tsconfig.json better layout, spotify auth, meh state management Jan 13, 2019 fix building on windows Jan 25, 2019

Lofi: a tiny Spotify player


Lofi is a mini Spotify player with visualizations. It is not a replacement for the Spotify Desktop app, nor does it play music independently of the Spotify app; instead, Lofi works alongside it to provide a more intuitive and pleasant access to common features, including pausing/playing, and previous/next track. Lofi also displays cover art and track info stylishly and it facilitates WebGL-powered audio visualizations for both Windows and MacOS. In other words, it's a "tiny Spotify player" or a "mini mode" for the Spotify desktop app.

It is possible to make Lofi work with other audio sources (including YouTube and SoundCloud), and that might make it on the roadmap at some point.

Design goals

  • A small, 1:1 aspect ratio player depicting album art
  • An always-on-top "widget-like" app
  • Minimalist (no extraneous controls)
  • Multiple-screen capable
  • Windows and MacOS compatible
  • Visualization-ready (WebGL)
  • ≤ 100MB memory footprint


To build, you'll need node-gyp, a compatible Python version (2.x), and your operating system's SDK (Microsoft Build Tools or Xcode). Linux native compilation is currently not supported. First, you'll need to run:

$ yarn install

If you have more than one Python installation on your system, you can prevent the build from failing by editing the package.json file in the root directory. Edit the build argument from

"build": "node-gyp rebuild --target=4.0.1 --arch=x64 --dist-url="


"build": "node-gyp rebuild --target=4.0.1 --arch=x64 --dist-url= --python path/to/python27"

Now you can run yarn install again.

To build from scratch, run yarn run dist. Find the output in /dist.

$ yarn run dist

To develop, open up a Terminal and type:

$ yarn run build
$ yarn run development
$ yarn run start

Use yarn run production (instead of development) to start the front-end in non-interactive mode.

Bugs, issues, and contributing

See something you don't like? Have a feature request? Is your computer on fire? Feel free to open an issue or make a pull request. The more the merrier.



You can’t perform that action at this time.