SonicRadio

A TUI radio player making use of Radio Browser API and Bubbletea.

Installation

• Install using go:

  Internal player version (requires CGO):

  go install github.com/dancnb/sonicradio/cmd/sonicradio@latest  
  

  External players only (no CGO):

  go install github.com/dancnb/sonicradio/cmd/sonicradio_external@latest  
  

• Clone this repository and build from source.

  Depending on version (for the internal player implementation), some additional prerequisites are needed based on the platform (ex: CGO required for non-Windows), since this project uses https://github.com/gopxl/beep, respectively https://github.com/ebitengine/oto.

• Optional third-party backend players:

  One of the following tools must be installed and available in the PATH:

  • Mpv : https://mpv.io/
  • FFplay : https://ffmpeg.org/ffplay.html, comes bundled with ffmpeg
  • VLC: https://www.videolan.org/vlc/
  • MPlayer: http://www.mplayerhq.hu/design7/dload.html
  • Music Player Daemon: https://www.musicpd.org/

• Download binaries available in Releases page.

Usage

After the installation, the command to run the application:

    sonicradio #sonicradio_external

Available options:

      -debug: creates a log file "sonicradio-[epoch millis].log" in OS specific temp dir

Keybindings

Key(s)	Action
↑/k	up
↓/j	down
ctrl+f/pgdn	next page
ctrl+b/pgup	prev page
g/home	go to start
G/end	go to end
enter/l	play
space	pause/resume
-	volume -
+	volume +
←/<	seek backwards
→/>	seek forward
i	station info
f	favorite station
a	autoplay station
A	add custom station
d	delete station
p/shift+p	paste deleted station
/	filter results
s	open search view
#	go to station number
esc	go to now playing
shift+tab	go to prev tab
tab	go to next tab
v	change view
?	toggle help
q	quit

License

Sonicradio is licensed under the MIT License.

Third-party dependencies

Bubbletea MIT License