# music-cli

> A free, browser-based music player for coders. Stream 40+ curated radio stations, play YouTube in audio-only "Listen" mode, and watch verified English and French live channels — all in one tab, no account required.

music-cli (https://music-cli.luongnv.com) is a web app built by Luong Nguyen (https://luongnv.com). It runs entirely in the browser, stores playlists and preferences locally, and is open source under the MIT license.

## Pages

- [YouTube player](https://music-cli.luongnv.com/): Search YouTube or paste a URL. "Listen" mode hides the video and requests the lowest quality for audio-only playback; "Watch" mode shows the video. Playlists persist locally, support repeat/reorder, resume position, and can be shared to another device via QR code. Favorite channels surface their latest uploads.
- [Radio](https://music-cli.luongnv.com/radio): 40+ curated internet radio stations (Lo-fi/Chill, Electronic, Synthwave, Jazz, Classical, Pop, Rock, French, Spanish, Italian). Filter by genre or mood (focus, relaxed, energetic, melancholic, peaceful...).
- [Live](https://music-cli.luongnv.com/live): Verified live YouTube channels in English and French (news, music), with search and Type/Language/Topic filters. Dead links are pruned regularly.
- [Privacy policy](https://music-cli.luongnv.com/privacy)
- [Terms](https://music-cli.luongnv.com/terms)

## Key facts

- Free, no sign-up, works on desktop and mobile browsers.
- Media Session API support: lock-screen controls and hardware media keys.
- Analytics and the YouTube player load only after cookie consent.
- Source code: https://github.com/luongnv89/music

## WebMCP tools

In browsers implementing WebMCP (`navigator.modelContext`), the site registers tools so agents can drive playback directly: `list_stations`, `play_station`, `pause`, `resume`, `now_playing`, `search_youtube`.

## Optional

- [Author](https://luongnv.com): Luong Nguyen, AI & Cybersecurity Engineer, Paris.