1. Add Your Music
Put your audio/video files in the music/ folder of your repo. Supported formats: .mp3 .ogg .wav .flac .aac .m4a .mp4 .webm
The GitHub Actions workflow auto-generates music/index.json on every push, so the player finds your files automatically.
2. Enable GitHub Pages
- Go to your repo → Settings → Pages
- Under Source, choose GitHub Actions
- Push any commit — the deploy workflow runs automatically
- Your site:
https://<username>.github.io/<repo>
3. Add Songs via YouTube (yt-dlp)
Open a GitHub Issue with the title:
ytdlp: https://youtube.com/watch?v=...
The Actions workflow downloads the audio as MP3 and commits it to music/ automatically.
4. Export / Import Playlist Order
Export: Click the ↓ button in the playlist header to save your track order as playlist.json.
Import: Click ↑ and select a saved playlist.json to restore that order.
5. Drag & Drop Reorder
Grab the ⠿ grip on any track row and drag it to a new position. The order persists in your browser and can be exported.