starred/soundfeed
1
0
Fork 0
mirror of https://github.com/adamchairly/soundfeed.git synced 2026-04-25 21:45:51 +03:00
Code Issues Projects Releases Packages Wiki Activity
A tiny music release tracker built using Spotify API
117 commits 6 branches 0 tags 2.1 MiB
Find a file
Exact
Székely Ádám 2f3557c826 chore: update readme and bump version
2026-04-08 21:55:08 +02:00
.github/workflows remove snyk workflow 2026-03-04 22:33:31 +01:00
backend feat: improve security 2026-04-08 21:50:01 +02:00
frontend chore: update readme and bump version 2026-04-08 21:55:08 +02:00
.dockerignore docker compose setup 2026-01-02 17:02:30 +01:00
.env.example refactor: local compose, pages 2026-02-25 23:15:28 +01:00
.gitignore chore: migration to coolify started 2026-02-25 19:35:22 +01:00
docker-compose.override.yaml feat: improve security 2026-04-08 21:50:01 +02:00
docker-compose.yaml feat: improve security 2026-04-08 21:50:01 +02:00
LICENCE Added licence and readme 2026-01-02 19:17:12 +01:00
README.md chore: update readme and bump version 2026-04-08 21:55:08 +02:00

README.md

Soundfeed

Soundfeed version

Follow artists you want to hear

License: MIT Backend Tests

.NET Next.js PostgreSQL

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

License

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