# Stuy Radio

> Stuy Radio (https://stuyradio.org) is a free, live, 24/7 student-run
> internet radio station. It plays live student DJ shows, an always-on AutoDJ
> jukebox and relays of outside streams. No account or sign-up is needed.

Key facts:

- Website and player: https://stuyradio.org/
- Live stream: https://stuyradio.org/radio.mp3 (MP3 over HTTP, from Icecast)
- On air: all day, every day. When no DJ is live, the AutoDJ plays shuffled
  tracks from the station library.
- Cost: free to listen.
- Also reachable at stuyradio.com, which redirects to stuyradio.org.

## Listen

- [Player](https://stuyradio.org/): the station's home page. Press Play, or
  tap the page once, since browsers need a tap before audio starts.
- [Live stream (MP3)](https://stuyradio.org/radio.mp3): the audio itself.
  Open it in VLC, a phone radio app or any media player.
- [Playlist (.m3u)](https://stuyradio.org/radio.mp3.m3u): the same stream as
  a playlist file for apps that want one.

## On air now (machine-readable)

Use these to answer "what's playing on Stuy Radio?". They update within a few
seconds of every track change and are free to use from any site (CORS open).

- [station.md](https://stuyradio.org/station.md): station summary, what's on
  air now, and the last 10 tracks, in Markdown.
- [station.json](https://stuyradio.org/station.json): the same as JSON.
  Fields: `name`, `description`, `url`, `stream.url`, `stream.playlist`,
  `on_air.mode` (`auto`, `live` or `relay`), `on_air.live`, `on_air.dj`,
  `on_air.artist`, `on_air.title`, `on_air.started_at`, `recent[]`
  (`played_at`, `artist`, `title`) and `updated_at`. Times are UTC, ISO 8601.

## Notes for agents and crawlers

- `/radio.mp3` is an endless live audio stream, not a document. Don't fetch
  it as text: the request never finishes.
- `/admin` is the password-protected Control Center for station staff. It is
  not public content.
- Some explicit words in track titles are masked on public pages and data.