by dvx

dvx / lofi

πŸŽ΅πŸ”‰ A mini Spotify player with WebGL visualizations.

506 Stars 29 Forks Last release: 3 months ago (1.5.0) MIT License 175 Commits 4 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Lofi: a tiny Spotify player

Website β€’ FAQ

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,
    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

, 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

file in the root directory. Edit the build argument from
"build": "node-gyp rebuild --target=4.0.1 --arch=x64 --dist-url=https://atom.io/download/electron"


"build": "node-gyp rebuild --target=4.0.1 --arch=x64 --dist-url=https://atom.io/download/electron --python path/to/python27"

Now you can run

yarn install

To build from scratch, run

yarn run dist
. Find the output in
$ yarn run dist

To develop, open up a Terminal and type:

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


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


You might need to change the

version inside
to be compliant with your
version or the
build might fail.

| NodeJS | Minimum node-sass version | Node Module | | ------- | ------------------------- | ----------- | | Node 12 | 4.12+ | 72 | | Node 11 | 4.10+ | 67 | | Node 10 | 4.9+ | 64 | | Node 8 | 4.5.3+ | 57 |

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, make a pull request or join our Discord server. The more the merrier.



We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.