AudioPlayer

New in this Version

-- 28.12.2025 --

• New category/genre unsorted added
• After entering a title and a url in Play Url this value are stored automatically in unsorted
• Newly added items appear after a restart in the Unsorted playlist
• Pipx installation works when pyalsa is installed before with your package manager (see Installation)

-- 23.12.2025 --

• Play URL added. Now you can enter an url to play it

-- 21.12.2025 --

• Small design changes
• Playlist items can now be played by hiting enter key or mouse click
• Prepared for playlist editing - but still not working

A textual.app for playing online radio streams

The app was actually developed for the Raspberry Pi to provide a simple but attractive interface for a Raspi LCD display. However, the app works in principle on all Linux distributions that meet the following requirements:

• a terminal which supports Rich Python library
• can run a VLC-Player
• uses ALSA soundsystem (also pipewire with ALSA)

You can run the app also remote with ssh.

The app can also be controlled in a browser.
To do so go into the src/tui_audioplayer directory and run python3 server.py

Installation

you can install the app with pip install tui_audioplayer

Pipx

pipx will work when pyalsa is installed manually

I could not manage to install pyalsa via pip, so I tried the following steps, which works for me:

• first install pyalsa with your package manager
• Create a softlink from the pyalsa directory to the pipx venv-directory

Typically pyalsa is installed in /usr/lib64/python3.13/site-packages
After installing tui_audioplayer with pipx, the pipx venv for tui_audioplayer is located in $HOME./local/share/pipx/venvs/tui-audioplayer/lib/python3.13/site-packages/

> cd $HOME./local/share/pipx/venvs/tui-audioplayer/lib/python3.13/site-packages/
> ln -s pyalsa /usr/lib64/python3.13/site-packages/pyalsa

You can also clone the repository
go into te src folder and run python3 -m tui_audioplayer

On Raspi

If you want to install the package on a Raspi, you will possibly get an error. The problem is the pyalsa package. This package has to be installed with sudo apt install python3-pyalsa Then run pip install tui_audioplayer again.

Playlist

The Playlist is the JSON version off XSPF.

Each Category/Genre has its own folder in the Playlist folder. You can create categories as you like.

Every category/genre folder contains a playlist file (.jspf). The playlist file has the same name in lower case as the category e.g.: category Jazz playlist file name jazz.jspf.

The playlist entries -the radio stations- are organized in tracks as followed:

• location: the url (in []) where the music comes from
• title: the radio station name
• image: the file name for the image of the radio station. The image is a 400x400 png in the same folder of the playlist. Please avoid spaces in file names.

To open and close the Playlist press the p key

Issues

• Key events are ignored for changing the volume, so changing the volume works only with mouse scrolling up or down.