ghp2017 / auxilia

A server that runs on a Raspberry Pi enabling several users to enjoy a shared music experience.

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

auxilia's Issues

Mobile Optimization

iPhone vertical orientation display & action needs refining

Frontend current time ahead

The progress bar starts moving when the automation script starts, meaning that the actual time difference between the two is a good 5 seconds or more

Error handling

Particularly refresh_access_token and interactions between frontend and backend

Need Cookies for users

on refresh, app currently allows multiple up/down votes;

need limit for users adding songs

Message Display

On the website when the user attempts to do something that they can't (or to give acknowledgement of an action), a message should pop up on the website.

Upvote

When you add a song immediately upvote it yourself, make it appear so

Admin Page

Include things like a safe mode and threshold for downvotes -> kicking out songs from queue

Current Time not synchronized

Currently updated client-side. But, if you refresh the page or load it while a song is playing, it doesn't actually show whats playing until the next song is played.

Downvotes threshold

Still need to implement this feature

Website Duration Display

Currently only displays total seconds, instead of popular MINUTE:SECOND format

Can add same song multiple times

Need limit for users; when users song is played, then they can add another to the queue.

Safe Mode

Self explanatory

Queue Explicit/Implicit

Queue doesn't replace implicit songs with explicit, instead just prepends the explicit songs. Also needs to refresh the implicit song with every added song

Just for fun:

In the README.md file, add your github username and quick sentence catchphrase/intro/description/self-bestowed-title for posterity.

Make 'add' buttons bigger

As well as any other buttons to be touched

Need loading animation for search

Previously, when searching, users could not have been sure if the app was auto-correcting too slowly or just not working.