SomaFM Player

A terminal-based music player for SomaFM internet radio stations, built with Rust and featuring a beautiful TUI (Terminal User Interface).

Features

• 🎵 Stream SomaFM Radio Stations - Access all available SomaFM channels
• 🖥️ Beautiful Terminal UI - Clean, intuitive TUI built with ratatui
• 🎛️ Volume Control - Adjust volume with +/- keys (0-100%)
• 📊 Live Spectrum Visualizer - Real-time audio frequency display with animated bars
• ⏯️ Pause/Resume Playback - Control playback with P key
• 💾 Persistent Configuration - Remembers your last channel and settings
• 🎤 Real-time Metadata - Display current artist and track information

Quick Start

Install with a single command:

curl -sSL https://raw.githubusercontent.com/mpuccini/soma-play/main/install.sh | bash

Then run:

soma-player

Development Status

⚠️ This project is currently under active development and should be considered alpha software. While functional, you may encounter bugs, incomplete features, or breaking changes between versions.

Documentation Structure

This documentation is organized into several sections:

• User Guide: Everything you need to know to install and use SomaFM Player
• Developer Guide: Information for contributors and developers
• Reference: Detailed reference materials