spotube icon indicating copy to clipboard operation
spotube copied to clipboard

Support Hitster

Open DwainZwerg opened this issue 11 months ago • 2 comments

Is there an existing issue for this?

  • [x] I have searched the existing issues

Pain

Hitster is a music quiz in which you have to predict the year of release, the title and the artist of a particular song. There are certain cards with the correct solution printed on the back and a QR code on the front. This QR code is normally scanned by the Hitster app and then played using the Spotify app in the Hitster app (without displaying the year, title, cover, or artist; there is only a play/pause button and a button to stop playing the song). Due to the Spotify Shuffle function, it is now the case that you can only play the game properly with a Spotify Premium (because instead of the desired song, some other song is played); in addition, the use has never been privacy-friendly because you needed a Spotify account.

Suggested solution

The QR codes are all coded in the following scheme: http://www.hitstergame.com/de/00268 So a five-digit ID behind http://www.hitstergame.com/de/. I would create a mapping that assigns each Hitster ID to its matching Spotify song (as a URL or whatever you need (or YouTube Music)). For the client, I envision the following solutions:

  1. spotube registers on Android http://www.hitstergame.com/de/ as a supported link. A user uses the Android QR code scanner to get the URL, which is then opened in Spotube. Spotube plays the correct song from the invidious instance selected in the Spotube settings in another newly written player (which only has the play/pause button and a “cancel” button) according to the mapping. Advantages: No QR code reader needs to be integrated into Spotube and Spotube does not need camera permission. Disadvantage: You have to write a new player into the already functioning app. You have to rely on the supported link feature of Android to work properly.
  2. A new Hitster mode will be integrated into Spotube: A QR code scanner is integrated so that the link is already captured by Spotube itself. The new player then plays the song corresponding to the mapping. Advantage: You don't have to rely on Android's supported link feature working as intended. Disadvantages: Spotube requires camera permission and a QR code reader and a new player must be integrated into Spotube.
  3. You write a small app “Hitster FOSS”, which has integrated the mapping, the QR code reader and the rudimentary player and retrieves the correct title from Spotube via an API (this is how the interaction between Hitster and Spotify works).
  4. You write a small app “Hitster FOSS”, which contains the mapping, the QR code reader, this rudimentary player and the retrieval algorithm of the Spotify songs from invidious.

Useful resources

The linked links

Additional information

I would really appreciate it if you would take on this feature request.

Self grab

  • [ ] I'm ready to work on this issue!

DwainZwerg avatar Jan 18 '25 13:01 DwainZwerg

Hi @DwainZwerg,

some assistance from my side to your feature. You find the mapping of the urls to spotify track here: https://hitster.jumboplay.com/hitster-assets/gameset_database.json

As you see in the json, a URL is formated like: http://www.hitstergame.com/de/%SKU%/%CardNumber%. And the app maps the cardnumer via json to a spotify track ID.

Love to see a alternative to the Hister app as well 😁

Haxe18 avatar Feb 16 '25 19:02 Haxe18

Hi, I also already thougth about such app. It would be cool to not need Spotify for playing it. However, I think the most important step is to get the metadata of the song from the spotify ID. Having that you will only need to map the hitster id to the spotify id and then resolve at least the song name and the singer and the rest is not that hard. I just overflew the spotify api but it seems that you need an spotify token even for requesting the meta data.

adrianhoehne avatar Nov 05 '25 07:11 adrianhoehne