elamperti / OpenWebScrobbler

🎧 An open source web scrobbler for Last.fm
https://openscrobbler.com/
GNU General Public License v2.0
319 stars 38 forks source link

WIP! Setlist.fm OpenScrobbler Option #248

Open seankolczynski opened 1 month ago

seankolczynski commented 1 month ago

Goal

The aim of this project is to add Setlist.fm as a source for scrobbling on OpenScrobbler. This would behave in the pattern of Albums, with the flow of search, select, and scrobble for the desired tracks.

What's Setlist.fm?

Setlist.fm is an wiki for tracking live music performances. Populated mainly by user volunteers, a setlist is simply a list of songs performed by an artist during a concert. Information like Date/Time, Venue, live/tape, covers, and even individual sets are tracked. All of this data is available via their free API.

In the same way that a Last.fm user may want to scrobble an offline album, they may want to track music they saw live in concert.

Design

Screenshot 2024-08-21 at 5 52 23 PM

A "Setlist" option will be added to the home page. Clicking it will take the user to a search bar, where they can search for their desired set. At the moment, this is actually an "input" bar, where the user needs to give the exam setlist.fm url. This url always has a UUID for each setlist, so we can literally rip that from the address. In the future, it could be nice to allow the user to search recent setlists from a specific artist/venue directly in OpenScrobbler, but for now I find this flow to be convenient enough

Once the search is run, a landing page similar to the "Album" page will be brought up. The list of songs is presented, and the user can select specific ones, or just scrobble the whole setlist.

Requirements

This project will require

elamperti commented 1 month ago

Hi! This is great work, thanks for your effort! I'll be trying it soon to see how it's going so far, let me know when it's ready for review 😁

seankolczynski commented 1 month ago

Hi! This is great work, thanks for your effort! I'll be trying it soon to see how it's going so far, let me know when it's ready for review 😁

thanks for the reply! this is still a WIP, I just like having the PR to kinda view my changes. I'll reach out if I have questions or when it's actually functional! :)