Console audio stream player for Windows and macOS.
Run the executable, pick a station or enter a custom URL.
During playback:
| Key | Action |
|---|---|
+ |
Volume up (+5%) |
- |
Volume down (-5%) |
p |
Pause / Resume |
s |
Station menu |
q |
Quit |
Or pass a URL directly:
./koji-stream-player http://ice1.somafm.com/spacestation-128-mp3
Edit stations.txt next to the executable. One station per line, Name|URL format:
Bassdrive (DnB)|http://ice.bassdrive.net:80/stream32
SomaFM DEF CON|http://ice1.somafm.com/defcon-128-mp3
# Lines starting with # are ignored
Use http:// for streams that support ICY metadata (track titles). https:// works for playback but metadata may not be available.
Apple Silicon only. Unsigned binary — allow in Privacy & Security, and:
chmod +x ./koji-stream-player
Optimized for internet radio (Icecast/Shoutcast). Supported audio formats:
- MP3 (most internet radio stations)
- AAC / HE-AAC (e.g. Bassdrive)
The bundled VLC is stripped down to audio streaming essentials — no video, no local file playback.
libVLC + LibVLCSharp (LGPL).
