Skip to content

Theys96/blind-song-scanner

Repository files navigation

Blind Song Scanner

Live on: play.blindsongscanner.com
Please note that this is a demo product which can only be used by registered demo Spotify users. Host the application yourself with your own Spotify developer client credentials.

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.

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 dev

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