https://github.com/thomasevano/musickeeper
win back control on music
https://github.com/thomasevano/musickeeper
adonisjs apple-music deezer hexagonal-architecture music music-manager musicmanager shadcn-ui soundcloud spotify svelte sveltekit tailwindcss tidal typescript youtube-music
Last synced: 5 months ago
JSON representation
win back control on music
- Host: GitHub
- URL: https://github.com/thomasevano/musickeeper
- Owner: Thomasevano
- License: agpl-3.0
- Created: 2024-01-13T17:51:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-13T19:03:12.000Z (5 months ago)
- Last Synced: 2026-01-13T21:35:15.736Z (5 months ago)
- Topics: adonisjs, apple-music, deezer, hexagonal-architecture, music, music-manager, musicmanager, shadcn-ui, soundcloud, spotify, svelte, sveltekit, tailwindcss, tidal, typescript, youtube-music
- Language: Svelte
- Homepage: https://musickeeper.app
- Size: 987 KB
- Stars: 12
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MusicKeeper
⚠️ THIS PROJECT IS STILL IN DEVELOPMENT ⚠️
## Use it on your own
Generate an app key with AdonisJS
```bash
node ace generate:key
```
### SelfHost MusicKeeper using Docker
you can use the docker-compose.yml file or this one
```yaml
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
```bash
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](https://github.com/thomasevano/musickeeper/wiki/How-to-create-a-Spotify-app))
Then run the app
```bash
pnpm build
```
You can now access the app on
## 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
- [x] Connect your Spotify account
- [x] Extract your playlists as text files (available in [v0.1.0](https://github.com/Thomasevano/musickeeper/tree/v0.1.0) only)
- [x] Listen later list (available in v0.2.0 >=)
- [x] Tracks
- [x] Albums
- [ ] Artists
- [ ] Playlists
- [ ] Sort Listen later list
- [ ] Do not depend on Spotify API
## 📝 License
Copyright © 2025 [Thomas Evano](https://github.com/thomasevano).