lofi
lofi copied to clipboard
🎵🔉 A mini Spotify player with WebGL visualizations.
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. Lofi also displays cover art and track info stylishly and it facilitates WebGL-powered audio visualizations for both Windows, MacOS and Linux. In other words, it's a "tiny Spotify player" or a "mini mode" to enhance the Spotify desktop app.
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, MacOS and Linux compatible
- Visualization-ready (WebGL)
- ≤ 100MB memory footprint
Building
To build, you'll need node-gyp
, a compatible Python version (2.x), and your operating system's SDK (Microsoft Build Tools or Xcode).
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.
Append the following on the "build": ...
line:
--python path/to/python27
Now you can run yarn install
again.
Distribution
To create a setup file, run yarn run dist
. The output will be located in ./dist
.
$ yarn run dist
Development
To develop, open up a Terminal and type:
$ yarn run development
$ yarn run start
node-sass
compatibility
You might need to change the node-sass
version inside package.json
to be compliant with your nodejs
version or the node-gyp
build might fail.
Please refer to the Node version support policy matrix on the node-sass
web site.
Bugs, issues, and contributing
Found a 🐛? Have a feature request? Feel free to open an issue or contribute.
As always, you are more than welcome join our Discord 🎤 server. The more the merrier! 🎉
Don't forget to ⭐ and/or fork this repo.
License
MIT