MusicKeeper

[!NOTE] THIS PROJECT IS STILL IN DEVELOPMENT

MusicKeeper lets you keep the music you find outside your streaming platform. Paste a link to a track, album, or playlist and it resolves the same item across platforms via MusicBrainz, so you can save it to a listen-later list without losing it when a friend shares a Spotify link but you use Apple Music.

Live demo: musickeeper.app

Stack: Svelte + Inertia on AdonisJS (hexagonal architecture — domain/application/infrastructure layers), TypeScript, unit + functional + E2E tests (Playwright), self-hosted via Docker.

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
      - VITE_APP_NAME=MusicKeeper
      - MB_APP_CONTACT_EMAIL= # contact email for MusicBrainz

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 dev server

pnpm dev

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

To build and run a production bundle instead, use pnpm build then pnpm start.

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

Since v0.2.0

• Listen later list
  • Tracks
  • Albums
  • Artists
  • Playlists
• Search
• Local first
• Offline Support
• PWA
• Sort Listen later list
• Sync List with multiple devices
• Share list

v0.1.0

• Extract your playlists as text files (available in this version only)

📝 License

Copyright © 2025 Thomas Evano.