Auxilia
A server that runs on a Raspberry Pi enabling several users to enjoy a shared music experience.
Features
- Collaborative Playlist Building -- share your favorite songs with your friends, and discover their music tastes
- Keep The Party Going -- when the queue drops low, songs that fit the mood are added to the playlist, so no user needs to sacrifice time and effort to keep music playing
- User feedback -- Thumbs up/down to influence the flow of the queue
Hardware Features
- Physical volume and play/pause control
- Sturdy, durable speaker housing
Getting Started
These instructions will walk you through the steps needed to begin the experience.
Setup
The Raspberry Pi will host the server running the Auxilia web app, so you'll need to set up the server, and users should go to the Pi's IP address on the local network.
Having a Good Time
Here's how it works: After you search for a song and click "add," the queue automatically updates across all devices and reflects the change. Upvoting or downvoting can impact the order of songs that are played, or if a song (added by algorithm) accrues enough downvotes, it will delete itself.
Admin Page
The admin page allows a user to toggle "safe mode" - to allow or prohibit songs with content warnings, set the number of downvotes needed to remove a song from the queue, and the maximum number of songs any one user can request.
Dependencies
- Flask - The web framework used
- Flask-SocketIO - Websockets
- Spotify Web API - Retrieves data from Spotify's catalog
- Requests - HTTP for Humans
- Redis - Database and Cache
Our Team
- @chaseWilliams
- @kaimckeever
- @DrewCutch
- @arvinpoddar
- @Nicksh1
License
This project is licensed under the MIT License - see the LICENSE file for details
Acknowlegments
- Hats off to the good folks at HackBerry Lab- Zane and Chris- for good advice, good times, and good 3D Printers
- Thanks to Tim for kind suggestions and biting sarcasm