- 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)
- Play URL added. Now you can enter an url to play it
- Small design changes
- Playlist items can now be played by hiting enter key or mouse click
- Prepared for playlist editing - but still not working
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
you can install the app with pip install tui_audioplayer
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
pipxvenv-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
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.
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
- Key events are ignored for changing the volume, so changing the volume works only with mouse scrolling up or down.