README.md
May 4, 2026 ยท View on GitHub
Lowfi
A SomaFM client for your terminal.
Installation
npm install -g lowfi
Version 1.0 Update
Lowfi v1.0 is now a dedicated SomaFM client.
Previous versions used SoundCloud playlists, but SoundCloud stream behavior changed in ways that made long-term CLI playback unreliable.
To keep Lowfi stable and simple, the project moved to SomaFM-only streaming.
Usage
lowfi --help
List Stations
lowfi list
Play a Station
Interactive picker:
lowfi play
Play by station ID:
lowfi play groovesalad
Play with options:
lowfi play groovesalad --quality highest --volume 0.7
--quality supports: highest, high, slow
--volume is between 0 and 1
Prerequisites
- mpv: playback engine
License
MIT