A web application that allows users to search for artists and automatically add their top 5 songs to designated "incoming" playlists on Spotify. Built with Go, featuring a responsive web interface, REST API, and comprehensive security features.

• Artist Search: Fuzzy matching to find artists even with typos or variations
• Web Scraping Artist Discovery: Automatically extract and add artists from web pages (Reddit posts, music blogs, forums)
• Automatic Track Addition: Adds top 5 tracks from found artists to selected playlists
• Duplicate Detection: Prevents adding the same artist's tracks multiple times with override option
• Playlist Management: Works with playlists in your "Incoming" folder on Spotify
• Responsive Web Interface: Works seamlessly on desktop, tablet, and mobile devices
• Embedded Spotify Player: Listen to your playlists directly in the web interface
• REST API: Programmatic access for automation and integration
• CLI Commands: Command-line interface for scripting and automation
• Security Features: CSRF protection, rate limiting, input validation, and security headers
• Comprehensive Logging: Structured logging with multiple levels and HTTP request tracking

1. Spotify Developer Account: Create an app at Spotify Developer Dashboard
2. Go 1.21+: For building from source

make install

# Download the latest release for your platform
wget https://github.com/toozej/go-listen/releases/latest/download/go-listen-linux-amd64
chmod +x go-listen-linux-amd64
mv go-listen-linux-amd64 go-listen

git clone https://github.com/toozej/go-listen.git
cd go-listen
go build -o go-listen .

1. Copy the sample environment file:

   cp .env.sample .env

2. Edit .env with your Spotify credentials:

   # Required: Add your Spotify API credentials
   SPOTIFY_CLIENT_ID=your_spotify_client_id_here
   SPOTIFY_CLIENT_SECRET=your_spotify_client_secret_here
   
   # Optional: Customize server settings
   SERVER_HOST=localhost
   SERVER_PORT=8080

3. Start the application:

   ./go-listen serve

4. Open your browser to http://localhost:8080

1. Select a Playlist: Choose from your "Incoming" folder playlists using the searchable dropdown
2. Search for an Artist: Enter an artist name (fuzzy matching handles typos)
3. Add Tracks: Click "Add Artist" to add their top 5 tracks to the selected playlist
4. Handle Duplicates: If tracks already exist, you'll get an option to add anyway
5. Listen: Use the embedded Spotify player to listen to your updated playlist

Automatically discover and add artists from web pages:

1. Enter a URL: Paste a link to a Reddit post, music blog, or forum discussion
2. Optional CSS Selector: Target specific page sections (e.g., div.post-content)
3. Scrape & Add: The system extracts artist names, fuzzy matches them to Spotify, and adds their top 5 tracks
4. Review Results: See which artists were successfully added, which failed, and which were duplicates

Example URLs:

• Reddit music recommendation threads
• Music blog "best of" lists
• Forum discussions about artists
• Concert lineup pages

# Scrape artists from a URL and add to playlist
go-listen scrape https://example.com/artists --playlist PLAYLIST_ID

# Use a CSS selector to target specific content
go-listen scrape https://reddit.com/r/music/... \
  --selector "div[data-test-id='post-content']" \
  --playlist PLAYLIST_ID

# Force add even if duplicates exist
go-listen scrape https://example.com/artists \
  --playlist PLAYLIST_ID \
  --force

See REST API Documentation

Example configurations are provided in the configs/ directory:

• configs/development.env - Development settings with verbose logging
• configs/production.env - Production settings with optimized logging

docker run -d \
  --name go-listen \
  -p 8080:8080 \
  -e SPOTIFY_CLIENT_ID=your_client_id \
  -e SPOTIFY_CLIENT_SECRET=your_client_secret \
  --restart unless-stopped \
  toozej/go-listen:latest

See docker-compose.yml

See docs/deployment.md for detailed deployment instructions including systemd service setup, Kubernetes deployment, and reverse proxy configuration.

• Configuration Guide - Detailed configuration options and examples
• Deployment Guide - Production deployment instructions
• Development Guide - Local development instructions
• API Documentation - REST API reference

The application includes several security features:

• CSRF Protection: Prevents cross-site request forgery attacks
• Rate Limiting: Prevents abuse with configurable limits per IP
• Input Validation: Sanitizes and validates all user input
• Security Headers: Implements security headers (HSTS, CSP, etc.)
• Structured Logging: Comprehensive logging for security monitoring

For production deployment, consider:

• Running behind a reverse proxy with HTTPS
• Implementing additional authentication if needed
• Monitoring logs for security events
• Adjusting rate limits based on usage patterns