For AI & Developers
Want a site that is fully yours? Give the rulebook to an AI assistant (or read it yourself) and build any site you like. If it follows the rules, aimusiclist can list and play your songs.
The AI rulebook
One file that explains, in a way AI can follow, everything a personal site needs to connect to aimusiclist.com.
- The song list file (catalog) and its fields
- Automatic registration and ownership check
- Playback addresses and the CORS rules
- Genre keys, limits and error codes
How to use it
Download the rulebook
It is a single text file.
Give it to your AI
Attach or paste it into ChatGPT, Claude or another AI, and describe the site you want.
Publish and connect
Put the site online with https. When it has public songs, it registers itself with aimusiclist automatically.
What a connected site provides
A short overview. The rulebook has the exact details.
| Address | What it does |
|---|---|
/.well-known/aimusiclist/catalog.json | The list of songs and albums you publish on aimusiclist (with ETag). |
/.well-known/aimusiclist/verify?c=… | Ownership check: answers a challenge with an HMAC of your secret. |
/a/{track_id} | Plays the song (supports Range). CORS only for aimusiclist and only for published songs. |
/c/{album_id} · /i/{track_id} · /l/{track_id} · /p | Album cover, song image, lyrics and profile image (optional). |
POST https://aimusiclist.com/api/v1/sites/auto | Registers your site automatically. No sign-up needed. |
POST https://aimusiclist.com/api/v1/ping | Tells aimusiclist that your list changed. |
aimusiclist never receives song files. It only reads your list and plays from your site, so you stay in control.