ninefold

---

Pick your top 9 albums, EPs and singles. Make a board for your lore or current era, then share a link or PNG.

Live Action · Frontend repo

Quick start

Requires Java 21, Maven 3.9+ and Node.js 22.12+. Set JAVA_HOME to your JDK.

git clone https://github.com/yofujitsu/lore-fm.git
cd lore-fm
cp .env.example .env

Edit .env with your catalog settings:

• Spotify: create an app in the Developer Dashboard, select Web API, then copy Client ID and Client Secret from Settings. Spotify requires Premium for Web API access.
• MusicBrainz: no API key needed. Enable it and use your own email in the User-Agent below.

SPOTIFY_CLIENT_ID=your-client-id
SPOTIFY_CLIENT_SECRET=your-client-secret
MUSICBRAINZ_ENABLED=true
MUSICBRAINZ_USER_AGENT=Ninefold/1.0.0 (mailto:you@example.com)

Keep credentials in the backend .env and restart the backend after changing them.

Start the backend from lore-fm:

mvn spring-boot:run

Open another terminal in lore-fm and start the frontend:

cd ../lore-fm-frontend
npm ci
npm run dev

Open 127.0.0.1:5173. The backend runs on port 8080.

To build locally, run mvn verify in lore-fm and npm run build in lore-fm-frontend.

Contributing

Open an issue or send a focused pull request. Run mvn verify before submitting backend changes. Follow the Code of Conduct.

License

MIT. Music artwork and provider assets keep their own terms; see Third-party notices.