Groundwave is a console player for internet radio streams.
----------------------------------------------------------
This application is a CLI front-end for GST123. It has been tested by me
on Debian 12 "Bookworm" and Debian 13 "Trixie" for over a year without
problems. Groundwave is my first project in C. You can find Antenna, the
python version of this application, elsewhere on this server. The two
apps are functionally identical.
Files
-----
TEXT groundwave.c
TEXT LICENSE
BIN groundwave_0.1.5_amd64.deb
BIN groundwave_0.1.6_amd64.deb
IMG Screenshot
Installing the application:
---------------------------
To install on an amd_64 Debian 13 system:
0. omit the quotation marks from all commands in the steps that follow.
1. download the .deb file associated with the version 0.1.5 release.
2. as root, enter the folder with the .deb file and execute the following
command: "apt install ./groundwave_0.1.5_amd64.deb"
3. to start the program, type "groundwave"
4. to uninstall type "apt remove groundwave"
Or you can compile the code with gcc and place it in /usr/bin/. You'll
also need to install gst123.
NOTE: Groundwave 0.1.5 has been tested extensively. Groundwave 0.1.6 has
been heavily refactored and I'm testing it as of June 2026.
General navigation:
-------------------
All commands must be followed by the ENTER key.
Some terminal clients will permit you to paste with the Shift-CTRL-v key
combination. This is handy for entering URLs.
To add a station:
-----------------
Press "a" at the main menu and enter the station URL and name at the
prompts.
Two good sources of station URLs are https://radio-locator.com and
https://www.radio-browser.info.
To play a stream from the list:
-------------------------------
Enter the number of the stream at the main menu prompt.
To delete a station:
--------------------
Press "d" at the main menu and enter the station number at the prompt.
To edit a station:
------------------
Press "e" at the main menu and enter any new information at the prompts.
To move a station:
------------------
Press "m" at the main menu and choose the station number at the prompt.
Then enter "u" for up or "d" for down at the prompt. You can enter "u"
or "d" as many times as you like. Enter "m" to return to the main menu.
To play a stream URL without adding it to the list:
---------------------------------------------------
Press "p" at the main menu and enter the URL at the prompt.
To play a random station (Easter Egg!):
---------------------------------------
Press "r" at the main menu.
Database Location:
------------------
The station database is in a csv file called "groundwaverc" in the
~/.local/share/groundwave/ directory.