Temaster

A command-line tool that turns any Spotify playlist into a music guessing game, inspired by Hitster. Test your music knowledge by guessing songs from your favorite playlists!

Features

• 🎵 Randomly plays songs from any Spotify playlist
• 🎮 Interactive command-line interface
• 🎯 Displays song information after each guess
• 🎧 Directly integrates with Spotify for playback

Requirements

• macOS operating system
• Spotify desktop app installed
• Spotify API credentials (Client ID and Client Secret)
• Go installed (version 1.16 or higher) - only needed if building from source

Installation

Option 1: Download the executable

1. Download the latest release from the Releases page
2. Make the file executable:

   chmod +x temaster

3. Move it to your PATH (optional):

   mv temaster /usr/local/bin/

Option 2: Build from source

1. Clone this repository
2. Build the project using one of these methods:

   # Using go build
   go build -o temaster ./cmd
   
   # Or using make
   make build

3. Move the executable to your PATH (optional):

   mv temaster /usr/local/bin/

Setup

1. Set up your Spotify API credentials:

   export SPOTIFY_CLIENT_ID="your_client_id"
   export SPOTIFY_CLIENT_SECRET="your_client_secret"

2. Run the program:

   temaster

How to Play

1. Enter a Spotify playlist URL when prompted
2. Try to guess the song and artist
3. Reveal the song information
4. Repeat!

License

MIT License