Skip to content

Theys96/blind-song-scanner

Repository files navigation

Blind Song Scanner

Live on: play.blindsongscanner.com

QR code scanner web application for playing Spotify songs blindly:

  • Log in with a Spotify Premium account.
  • Scan a QR code with a Spotify song URL (i.e. https://open.spotify.com/track/...).
  • The app immediately starts playing the song without revealing any details about it.

This app was designed to enable a range of musical party games. For example, physical tiles may be printed with a song's name, artist and/or publication year on the other side. To create such tiles, see https://github.com/Theys96/blind-song-scanner-generator.


If you happen to know more about whether the design of this app complies with or violates the Spotify Design & Branding Guidelines, please let me know!

Development

This application was built with npm/11.0.0 and vite/5.4.8. The project's code is in a work-in-progress state, it has several glitches and many opportunities for refactoring.

To install and start this React app locally, clone the repository and run:

npm install
npm run start

To get the Spotify log-in to work, create a client in the Spotify for Developers dashboard and fill in the Client ID in app/data/config.ts.

Make sure to apply linting after making changes:

npm run lint:fix

Screenshots

Log in screen

Scanning

Start screen

Playing a track

Invalid QR code

About

QR code scanner for playing Spotify songs blindly

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published