https://github.com/spoddify-mopped/spoddify-mopped

A spotify player for office use, with a voting system to select music and automatic song sorting.
https://github.com/spoddify-mopped/spoddify-mopped

ble esp32 music music-player raspberry-pi spotify ui

Last synced: about 1 month ago
JSON representation

A spotify player for office use, with a voting system to select music and automatic song sorting.

• Host: GitHub
• URL: https://github.com/spoddify-mopped/spoddify-mopped
• Owner: spoddify-mopped
• License: mit
• Created: 2021-10-22T09:42:32.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-03-14T21:27:43.000Z (over 1 year ago)
• Last Synced: 2024-04-24T03:35:22.498Z (7 months ago)
• Topics: ble, esp32, music, music-player, raspberry-pi, spotify, ui
• Language: TypeScript
• Homepage:
• Size: 2.94 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  





  



  Features | 

  Installation | 

  Screenshots



[![npm Version](https://badgen.net/npm/v/spoddify-mopped)](https://www.npmjs.com/package/spoddify-mopped)

[![Test](https://github.com/spoddify-mopped/spoddify-mopped/actions/workflows/test.yml/badge.svg)](https://github.com/spoddify-mopped/spoddify-mopped/actions/workflows/test.yml)

[![Build](https://github.com/spoddify-mopped/spoddify-mopped/actions/workflows/build.yml/badge.svg)](https://github.com/spoddify-mopped/spoddify-mopped/actions/workflows/build.yml)



Spoddify Mopped is a Spotify player for office use, with a voting system to select music and automatic song sorting.

It is intended to run on a Raspberry Pi and some esp32 boards for remote controlling and voting.

But it can be run on any other machine as well.

![Overview](https://user-images.githubusercontent.com/36125892/159121882-7d1a191c-c29d-4297-9e5e-297353c08bb8.png)

## Features

- Play playlists based on votes

- Discover new music and insert songs to automatically sorted playlists

- Browse artist, albums and playlist

- View the current playing song

- Modern user interface

- Secure Spotify login

## Installation Instructions

For detailed instructions on how to setup Node.js and SpoddifyMopped follow these guides:

- [Setup manually](https://github.com/davidborzek/spoddify-mopped/wiki/Manual-Installation)

## Plugins

Spoddify Mopped can be extended using plugins. Plugins are Node.js modules prefixed by `spoddify-mopped-`.

They have direct access to the Spoddify Mopped API (e.g. controlling playback, listening to player events, ...).

### Plugin Installation

You can easily install plugins, by installing the associated Node.js module globally:

```bash

npm i -g spoddify-mopped-gpio

```

## Screenshots

![Player](https://user-images.githubusercontent.com/36125892/159121237-03c6723d-be22-44a8-8e1b-f34bc9abff46.png)

![Search](https://user-images.githubusercontent.com/36125892/159121281-33175177-a8a0-442e-943d-90f9542c5e0d.png)

![Album](https://user-images.githubusercontent.com/36125892/159121333-00fbc16d-be00-4fad-88f9-406ea65e37ad.png)

![Artist](https://user-images.githubusercontent.com/36125892/159121335-377d436a-efa7-4644-83fc-e029c1bff591.png)

![Playlist](https://user-images.githubusercontent.com/36125892/159121337-0b66f6f9-c977-4c5e-be24-afd21c3d1a88.png)

## Contributing

Contributing and pull requests are very welcome.

More information about contributing to this project can be found [here](CONTRIBUTING.md)