README.md

JSMusicDB

A music player and database written using LIT and TypeScript. Using modern JavaScript to reduce the normal framework overhead JSMusicDB is less than 120KB while zipped.

Screenshots

Desktop

Light mode

Dark mode

Mini album details on scroll

Now playing screen with a spectrum analyzer

Now playing screen with classic LEDs

All artists start with the same letter

Endless list of all albums

Various playlists

Mobile

API keys

Add the following to your local .env file to use last.fm and fanart

LASTFM_APIKEY=[your key]
LASTFM_SECRET=[your secret]
FANART_APIKEY=[your key]

Development server

Run npm run start for a dev server. Navigate to http://localhost:5173/. The app will automatically reload if you change any of the source files.

Build

Run npm run build to build the project. The build artifacts will be stored in the dist/ directory.

PWA

Use jsmusicdb as frontend if you don't want to host your version.