Skip to content
/ tuner Public
forked from tuner-labs/tuner

GNU/Linux app to discover and play internet radio stations

License

Notifications You must be signed in to change notification settings

technosf/tuner

 
 

Repository files navigation

icon Tuner License: GPL v3 Translation status Translation status

Discover and Listen to your favourite internet radio stations

Minimalist radio station player - Tuner Version 2

Screenshot 01

I love listening to radio while I work. There are tens of thousands 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.

-- louis77

Features

  • Explore ever changing radio stations indexed in radio-browser.info
  • See the top selections of listened to and saved stations from the index
  • Find different station content genres and subgeneres from the index
  • Jukebox - Play a new random station every ten minutes
  • Save your favourite stations
  • Search for stations and content by keyword
  • Save your favorite station searches
  • Export your favorite stations to m3u playlists
  • DBus integration to pause/resume playing and show station info in Wingpanel
  • Updates station click count at station index on station play
  • Updates station vote count at station index when you star a station

Internationalization & Translation

Tuner is Internationalized, and is available in various languges. Translations are hosted on Weblate. Please help by translating Tuner into your language or fix any translation issues you find.

Thanks to the Weblate team for generously hosting Tuner for free!

Recent Updates

December 2025 all things Tuner have become a Github Organization called tuner_labs to ensure Tuner continues to be available and we invite you to participate in keeping it a great source of music discovery and Internet Radio player.

January 2025 Version 2 released with major new features and performance improvements.

Installation

Tuner is primarily developed and distributed as a Flatpak on Flathub.

It can also be built and distributed via other platforms and distos. Please help make Tuner work on your favorite Disto/Package.

Status and Support

Join in or start discussion about tuner... Feature request, observations and Issues can be documented with tickets on Github

Build, Maintance and Development of Tuner

Building, developing and maintianing Tuner is detailed seperately and in detail in the DEVELOP markdown.

Known Issues

If AAC/AAC+ streams don't play (found on Elementary OS 6) install the following dependency

sudo apt install gstreamer1.0-libav

'Failed to load module "xapp-gtk3-module"'

Running Tuner from the CLI with flatpak run com.github.louis77.tuner may produce a message like the following:

Gtk-Message: 10:01:00.561: Failed to load module "xapp-gtk3-module"

This relates to Gtk looking for Xapp (which isn't used by Tuner) and can be ignored.

Environment Variables

The radio station index server can be specified via and environmental varible at startup:

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

Contribute

Help is apreciated:

  • 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? Please open an issue, start a discussion or offer up a pull request.

Origin Story

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.

-- louis77

Credits

Free Software Foundation

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.

Update 2021-08-01: I'm no longer a member of the Free Software Foundation.

-- louis77

Disclaimer

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.

About

GNU/Linux app to discover and play internet radio stations

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Vala 95.3%
  • Meson 2.9%
  • Shell 1.1%
  • CSS 0.7%