MusicKeeper

⚠️ THIS PROJECT IS STILL IN DEVELOPMENT ⚠️

Use it on your own

Generate an app key with AdonisJS

node ace generate:key

SelfHost MusicKeeper using Docker

you can use the docker-compose.yml file or this one

services:
    musickeeper:
      build: ghcr.io/thomasevano/musickeeper:latest
      container_name: musickeeper
      ports:
        - "8080:8080"
      environment:
        - PORT=8080
        - APP_KEY=
        - SESSION_DRIVER=memory
        - SPOTIFY_CLIENT_ID=your-spotify-client-id
        - SPOTIFY_CLIENT_SECRET=your-spotify-client-secret
        - SPOTIFY_BASIC_TOKEN=your-spotify-basic-token
        - SPOTIFY_BASE_URL=https://api.spotify.com
        - SPOTIFY_REDIRECT_URI= #URL of your musickeeper instance you 
        - VITE_BASE_URL= # URL with port of your musickeeper instance
        - VITE_APP_NAME=MusicKeeper

Use Locally

git clone https://github.com/thomasevano/musickeeper.git
cd musickeeper
pnpm install
cp .env.example .env

Edit the .env file with the Spotify credentials of the app you created on the Spotify developer dashboard(you can find documentation to create one here)

Then run the app

pnpm build

You can now access the app on http://127.0.0.1:3333

FAQ

What ?

MusicKeeper is a music manager app that help you manage, extract your music between different streaming platforms and why not in the future, legally and easily buy the music you loves to finally own back your music

Why ?

• You got music recommandations by friends, online communities, etc but you lost them.
• You want to take back control on your music, own the files and why not exit from music providers

Features

• Connect your Spotify account
• Extract your playlists as text files (available in v0.1.0 only)
• Listen later list (available in v0.2.0 >=)
  • Tracks
  • Albums
  • Artists
  • Playlists
• Sort Listen later list
• Do not depend on Spotify API

📝 License

Copyright © 2025 Thomas Evano.