# Grooveline

> Grooveline is a live DJ streaming radio platform. DJs book broadcast slots, receive auto-provisioned Icecast streaming credentials, and go live to a public audience. Listeners tune in to live sets and browse an archive of past broadcasts and recordings. Focus is electronic music.

Grooveline is self-service: a DJ signs up, books a time slot, and broadcasts using the Grooveline Broadcaster desktop app (or any Icecast/RTMP-compatible software). The live stream and schedule are public at grooveline.org. A public JSON API at api.grooveline.org exposes the schedule, DJ roster, live status, and health.

## Key pages

- [Home / Live player](https://grooveline.org/): Listen to the current live stream, see who's on air now and next, and browse the upcoming schedule.
- [Go Live / Broadcast](https://grooveline.org/broadcast): Sign up as a DJ, book a broadcast slot, and get streaming credentials.
- [Start DJ (free)](https://grooveline.org/start-dj): Overview of broadcasting free on Grooveline.
- [Archive](https://grooveline.org/archive): Past broadcasts and recorded DJ sets.
- [About](https://grooveline.org/about): What Grooveline is and how it works.
- [Blog](https://grooveline.org/blog/): Guides on DJ streaming, radio setup, software (OBS, vMix, MediaMTX), and internet radio history.

## Public API (api.grooveline.org)

All endpoints are GET and return JSON unless noted. No auth required for these public read endpoints.

- [Live status](https://api.grooveline.org/live): Whether anyone is broadcasting now, and the current DJ/stream details.
- [Schedule](https://api.grooveline.org/schedule): Upcoming booked broadcast slots (alias of /slots).
- [DJ roster](https://api.grooveline.org/djs): List of active DJs with genre, bio, avatar, broadcast count, and profile URL.
- [DJ profile](https://api.grooveline.org/api/dj?dj=NAME): A single DJ's profile, upcoming and past broadcasts, and published recordings.
- [Recordings](https://api.grooveline.org/recordings): Paginated list of published recorded sets.
- [Health](https://api.grooveline.org/health): Service and database health check.
- [DJ sitemap](https://api.grooveline.org/sitemap-djs.xml): XML sitemap of DJ profile pages.

## Agent / MCP discovery

- [Agent card](https://grooveline.org/.well-known/agent-card.json): Capabilities and interface descriptor.
- [MCP server card](https://grooveline.org/.well-known/mcp/server-card.json): Model Context Protocol resource descriptor.
- [Agent skills](https://grooveline.org/.well-known/agent-skills/index.json): Available agent skills.

## Notes

- DJ profile pages live at https://grooveline.org/dj/?dj=NAME (URL-encode the DJ name).
- Booking, credentials, and account management require a signed-in DJ account and are not part of the public read API.
- Content is primarily electronic music (techno, house, and related genres).