Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dvx/lofi
🎵🔉 A mini Spotify player with WebGL visualizations.
https://github.com/dvx/lofi
audio-player media mini-spotify-player spotify spotify-desktop tiny-spotify-player webgl
Last synced: 29 days ago
JSON representation
🎵🔉 A mini Spotify player with WebGL visualizations.
- Host: GitHub
- URL: https://github.com/dvx/lofi
- Owner: dvx
- License: mit
- Created: 2019-01-12T20:44:33.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-02T06:08:08.000Z (7 months ago)
- Last Synced: 2024-10-01T21:22:30.437Z (about 1 month ago)
- Topics: audio-player, media, mini-spotify-player, spotify, spotify-desktop, tiny-spotify-player, webgl
- Language: TypeScript
- Homepage: http://lofi.rocks
- Size: 14.4 MB
- Stars: 1,188
- Watchers: 21
- Forks: 68
- Open Issues: 79
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
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
```
# Bugs, issues, and contributing
Found a 🐛? Have a feature request? Feel free to open an [issue](https://github.com/dvx/lofi/issues) or [contribute](https://github.com/dvx/lofi).
As always, you are more than welcome join our [Discord](https://discord.gg/YuH9UJk) 🎤 server. The more the merrier! 🎉
Don't forget to ⭐ and/or fork this repo.
# License
MIT