Developer Documentation

Build upon the Music Verse platform.

Public API

Music Verse exposes its library data via a simple JSON endpoint. Changes to the repository (via the sync script) automatically update this endpoint.

GET /music_list.json

Returns an array of all available audio files in the library using their relative paths.

Example Response

{
  "stats": {
    "totalSongs": 24,
    "totalSize": "85.4 MB",
    "lastUpdated": "1/21/2026, 10:30:00 PM"
  },
  "songs": [
    "Cartoon - On & On.mp3",
    "Lost Sky - Fearless.m4a",
    "NCS - Invincible.mp3"
  ]
}

Usage with Fetch

fetch('https://bhanu2006-24.github.io/music-verse-v1/music_list.json')
  .then(response => response.json())
  .then(data => console.log(data));

CLI Reference

For maintainers running the project locally, the following commands are available:

npm run sync

Reads downloads.json and downloads any new videos/playlists found locally.

node scripts/sync_music.js

npm run dev

Starts a local development server for previewing the app.

http-server .