bjarneo--cliamp/docs/streaming.md

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.

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.