Skip to content

streaming.md

Latest commit

 

History

History
68 lines (41 loc) · 2.35 KB

streaming.md

File metadata and controls

68 lines (41 loc) · 2.35 KB

Streaming

cliamp can play audio from URLs, M3U/PLS playlists, and podcast RSS feeds.

HTTP Streams

Play audio directly from URLs:

cliamp https://example.com/song.mp3
cliamp http://radio-station.com/stream.m3u
cliamp local.mp3 https://example.com/remote.mp3   # mix local + remote

For non-seekable HTTP streams, the UI shows ● Streaming with a static seek bar, and seek keys are silently ignored.

PLS Playlists

PLS playlist files are supported alongside M3U:

cliamp https://radio.cliamp.stream/lofi/stream.pls

Podcasts

Play any podcast by passing its RSS feed URL:

cliamp https://example.com/podcast/feed.xml

Episode titles and the podcast name are extracted from the feed and shown in the playlist.

Xiaoyuzhou (小宇宙)

Play individual episodes from Xiaoyuzhou by passing the episode URL:

cliamp https://www.xiaoyuzhoufm.com/episode/xxxx

Radio Catalog

Press R in the player to browse and search 30,000+ online radio stations from the Radio Browser directory. Use / to search by name, Enter to play, and a to append a station to the playlist.

Track Info

For live radio, cliamp shows the current track from the stream's inline ICY metadata (StreamTitle). This works for most stations, in any codec (MP3, AAC, Opus, ...).

Some broadcasters send no inline metadata and publish now-playing through a separate API instead. cliamp pulls those automatically:

Station Source Shown
FIP (and FIP Jazz, Rock, Groove, Reggae, Electro, Metal, Monde, Nouveautes) Radio France livemeta API Artist - Title
NTS 1 / NTS 2 NTS live API Current show

NTS is live DJ radio with no per-track tagging, so it shows the show/host name rather than a song.

Load URL at Runtime

Press u while playing to load a new stream or playlist URL without restarting. Supports the same URL types as CLI arguments: direct audio URLs, M3U/PLS playlists, RSS podcast feeds, and yt-dlp compatible links.

Run Your Own Radio Station

Run your own internet radio with cliamp-server. Point it at a directory of audio files and it starts broadcasting. Supports multiple stations, live metadata, and on-the-fly transcoding.

See also: playlists.md for M3U playlist details.