Logo Welcome to Station

Station is a simple Python CLI application that helps organizing Internet-Radio-Stations.

Station Screenshot CLI

With Station you can do a lot:

• show your stations
• play a station
• run a 3 seconds playback test for all your stations to check if they are OK
• delete stations from your library
• search for IRS by name at https://www.radio-browser.info
• get information for all your stations from https://www.radio-browser.info
• record a stream from a station
• generate html with all your stations
• generate xml for RadioTray
• generate a m3u-playlist for your prefered audio player

If you think that is cool, go on with the installation.

There is also a TUI version available: StationTx

Installation

Option 1 (recommended): Using pipx

1. Make sure pipx is installed on your system. Otherwise, install it using your GNU/Linux distribution's package manager.

2. Run the following command from the terminal:

   pipx install --include-deps git+https://codeberg.org/ralfhersel/station
   

3. To launch Station, run station from whatever directory in your terminal.

Option 2: Manual installation

Since Station is a simple Python file, the installation has no bells and whistles. Simply go to the folder under which you would like to install the application and run these commands in a terminal:

git clone https://codeberg.org/ralfhersel/station.git
cd station

Station has a few dependencies. Please install these packages with the package manager of your GNU/Linux distribution:

mpv, pyradios

If anything is missing, Python will tell you when you start Station for the first time. Here is how to start it:

python station.py

All station data is stored in a CSV-File: data/station.csv. The installation comes with a pre-filled list of stations. You can edit this list manually or let the script do it it for you (si station_name).

Troubleshooting

You may run into problems, if you don't have basic knowledge about a Linux terminal or how to start a Python script. Station is not made for absolute beginners. But I did my best, to make it as easy as possible. If you struggle to install the dependencies (pip, pipx, mpv, pyradios) then choose another Internet-Radio-Player for Linux - there are many.

Installing pyradios may give you a headache. That is because the Python-Library is not part of all common Distro-Repositories. If you don't find it in your distro's repos, try:

pip install pyradios

It is very likely that your distribution will complain about this command and recommend to install it from the repos. Since you could not find it, try this brute method:

pip install pyradios --break-system-packages

License and Contact

License: GPL3

Contact: Ralf Hersel (ralf.hersel@gmx.net)