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