Tuner is a GNU/Linux app to listen to internet radio

3c55484 Persist last volume in gsettings

~louis77 pushed to ~louis77/Tuner git

14 days ago

dc96446 Initial commit

~louis77 pushed to ~louis77/Tuner2 git

14 days ago

#icon Tuner

#Minimalist radio station player

Discover and Listen to your favourite internet radio stations.

License: GPL v3 Screenshot 01

#Contributors wanted!

I've started Tuner in May 2020 when COVID-19 began to change our lives and provided me with some time to finally learn things that I couldn't during my life as a professional developer.

I moved from macOS to Linux as a daily driver, learned a little about Linux programming, and chose Vala as the language for Tuner. At the time I was running elementary OS, and they have excellent documentation for beginning developers on how to build nice-looking apps for elementary. That helped me a lot to get started with all the new stuff.

At the time, I never expected Tuner to be installed by the thousands on other great distros, like Arch, MX Linux, Ubuntu, Fedora. In August 2020, I released Tuner as a Flatpak app, and it was installed over 18.000 times on Flathub alone ever since! Users began to send me their appreciations but also bug reports and feature requests. Some friendly contributors made Tuner available on MX Linux and Arch AUR repos.

Maybe it was around this time when I started to feel not only the euphoria that comes with Open Source projects but also the weight of responsibility. I feared to move on because I didn't want to break things, so I took a break :-).

Yet, users keep sending bug reports and feature requests. I want Tuner to live on and be the best tiny internet radio receiver for the Linux environment.

Would you be interested in joining the project as a developer or package maintainer?

Things I need help with:

  • Deeper integration into the GNOME desktop environment (DBus and such)
  • Development of new features for Tuner (skills: Vala/C)
  • Create and maintain Tuner packages for distros. Do you know how we can get Tuner into some official repos?
  • Help me fixing those Flatpak bugs users are reporting
  • Translate Tuner into more languages

Interested? Send me an email or get in touch with me on Freenode louis771.



Tuner is available on Flathub, but there are some known bugs: https://flathub.org/apps/details/com.github.louis77.tuner

#elementary OS

Install Tuner via elementary's App store: https://appcenter.elementary.io/com.github.louis77.tuner

#Arch Linux / AUR

Arch-based GNU/Linux users can find Tuner under the name tuner-git in the AUR:

$ yay -S tuner-git

Thanks to @btd1377 for supporting Tuner on Arch Linux!

#MX Linux

MX Linux users can find Tuner by using the MX Package Installer (currently under the MX Test Repo tab)

Thanks to SwampRabbit for packaging Tuner for MX Linux!


I love listening to radio while I work. There are tens of tousands of cool internet radio stations available, however I find it hard to "find" new stations by using filters and genres. As of now, this little app takes away all the filtering and just presents me with new radio stations every time I use it.

While I hacked on this App, I discovered so many cool and new stations, which makes it even more enjoyable. I hope you enjoy it too.


  • Uses radio-browser.info catalog
  • Presets various selection of stations (random, top, trending, genres)
  • Save favourite stations
  • Sends a click count to radio-browser.info on station click
  • Sends a vote count to radio-browser.info when you star a station
  • DBus integration to pause/resume playing and show station info in Wingpanel


  • More selection screens (Popular networks, Country-specific)
  • More filter options (country)
  • Community-listening: see what other users are listening to right now
  • Other ideas? Create an issue!

#Environment Variables

  • TUNER_API - a : separated list of API servers to read from, e.g.
    • export TUNER_API="de1.api.radio-browser.info:nl1.api.radio-browser.info"; com.github.louis77.tuner




Make sure you have the dependencies installed:

sudo apt install git valac meson
sudo apt install libgtk-3-dev libgee-0.8-dev libgranite-dev libgstreamer1.0-dev libgstreamer-plugins-bad1.0-dev libsoup2.4-dev libjson-glib-dev libgeoclue-2-dev libgeocode-glib-dev

Then clone this repo and build it locally:

meson build && cd build
meson configure -Dprefix=/usr
sudo ninja install


#Free Software Foundation

FSF Member badge

I'm a member of the Free Software Foundation. Without GNU/Linux and all the great work from people all over the world producing free software, this project would not have been possible.

Consider joining the FSF, here is why.


Tuner uses the community-driven radio station catalog radio-browser.info. Tuner is not responsible for the stations shown or the actual streaming audio content.