How saran-pt/beats-me works
Beats Me is a Spring Boot service that turns a user's Spotify listening history into a playlist. The workflow begins when a user opens the app, is redirected to Spotify authorization, and returns with an authorization code. The callback exchanges that code for an access token, fetches top tracks and the user ID, creates a playlist, and adds the tracks. The README also describes fetching recently played songs, but the sampled service implements top tracks; no genre-classification stage is shown. The graph reflects sampled calls and documented capabilities, not unsampled implementation details.
Main entry points: SpotifyService.java Spotify service · ApiController.java HTTP controller · SpotifyAutoApplication.java Spring Boot app
Components 9
Web application
- Spring Boot app
src/main/java/spotifyapi/spotifyAuto/SpotifyAutoApplication.java - HTTP controller
src/main/java/spotifyapi/spotifyAuto/controller/ApiController.java
Spotify integration
- Spotify service
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Spotify authorization
- Spotify Web API
Playlist creation
- Recent listening history
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Create playlist
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Add tracks
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java
Other components
- Spotify user
Connections 14
- Spotify user → HTTP controller: opens app
src/main/java/spotifyapi/spotifyAuto/controller/ApiController.java - Spring Boot app → HTTP controller: serves routes
- HTTP controller → Spotify service: requests auth
src/main/java/spotifyapi/spotifyAuto/controller/ApiController.java - Spotify service → Spotify authorization: builds authorization URL
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Spotify user → HTTP controller: returns with code
- HTTP controller → Spotify service: passes callback code
src/main/java/spotifyapi/spotifyAuto/controller/ApiController.java - Spotify service → Spotify authorization: exchanges code
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Spotify service → Create playlist: calls
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Spotify service → Recent listening history: fetches top tracks
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Spotify service → Spotify Web API: gets user ID
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Create playlist → Spotify Web API: creates playlist
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Create playlist → Add tracks: submits track URIs
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Add tracks → Spotify Web API: adds tracks
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java - Recent listening history → Spotify Web API: requests top tracks
src/main/java/spotifyapi/spotifyAuto/service/SpotifyService.java