⚠️ THIS PROJECT IS STILL IN DEVELOPMENT ⚠️

Generate an app key with AdonisJS

node ace generate:key

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

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

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

• 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

• 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

Copyright © 2025 Thomas Evano.