Soundfeed

Follow artists you want to hear

About

Soundfeed tracks your favorite Spotify artists and displays new releases in a clean, chronological feed.

No login, account or any personal detail required.

Warning

As of February 6, 2026, Spotify introduced heavy limiting to their API, and access is now tied to a premium subscription.

Features

• Follow Spotify artists
  • Follow artists by searching
  • Unsubcribe from artists
  • Reorder followed artist in the grid
• Sync existing account
  • Recover your feed using a recovery code
• Manage your feed
  • Trigger manual sync
  • Dismiss already seen feed entries

Getting Started

Prerequisites

• Docker & Docker Compose
• Spotify API credentials

Quick Start

1. Clone the repository

   git clone https://github.com/adamchairly/soundfeed
   cd Soundfeed

2. Create .env file

   • Example structure is provided in .env.example
   • Get Spotify Client ID and Client Secret here

3. Start services

   docker-compose up -d --build

4. Access the application

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:8080

License

This project is licensed under the MIT License - see the LICENSE file for details.