Goodvibes Radio Player

Installation From A Package Manager
Installation From Source
Dependencies
License
Translations
Hacking

Goodvibes is a lightweight internet radio player for GNU/Linux. It offers a simple way to have your favorite radio stations at easy reach.

Goodvibes provides everything you can expect from a modern media player: multimedia keys binding, mpris2 support, notifications, and sleep inhibition. It can be launched with or without GUI, and comes with a command-line client.

Behind the hood, Goodvibes relies on proven and approved open-source libraries: GLib at the core, GStreamer to handle the audio, and GTK+ for the graphical user interface.

The project is hosted on Github at https://github.com/elboulangero/goodvibes.
The documentation is available at https://github.com/elboulangero/goodvibes/wiki.

Installation From A Package Manager

The easiest way to install Goodvibes is to use an existing package for your distribution.

At the moment, there's a PPA for Ubuntu users available on Launchpad. To install Goodvibes from there, please visit the following page and follow the instructions:
https://launchpad.net/~elboulangero/+archive/ubuntu/goodvibes

Debian users running the unstable release can also install from this PPA by running the following commands.

# Be root
su -

# Add repository
echo 'deb http://ppa.launchpad.net/elboulangero/goodvibes/ubuntu xenial main
' > /etc/apt/sources.list.d/goodvibes.list

# Update and add key
MISSING_KEY=$(apt-get update 2>&1 | grep NO_PUBKEY | sed "s/.*NO_PUBKEY //")
apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys $MISSING_KEY 
apt-get update

# Install
apt-get install goodvibes

There's also an ArchLinux package available:
https://aur.archlinux.org/packages/goodvibes/

Installation From Source

If there's no package for you, you will need to download the source code and compile by yourself.

At first, grab the source code using git.

git clone https://github.com/elboulangero/goodvibes.git

Compilation is done with the Autotools using the usual set of commands.

./autogen.sh
./configure
make

Installation is a one-liner, and must be run as root.

sudo make install

Of course, you need to install the required dependencies.

Dependencies

Compile-time dependencies are:

For the core: glib, libsoup, gstreamer
For the user interface: gtk+, libkeybinder

Additional run-time dependencies are listed below.

For more gory details, please refer to the file configure.ac.

Install dependencies on Debian

Compile-time dependencies:

sudo apt install build-essential autoconf autopoint
sudo apt install libglib2.0-dev libsoup2.4-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
sudo apt install libgtk-3-dev libkeybinder-3.0-dev

Run-time dependencies:

sudo apt install dconf-gsettings-backend   # to load/store configuration
sudo apt install gstreamer1.0-plugins-ugly # to listen to mp3 streams
sudo apt install gstreamer1.0-pulseaudio   # for pulseaudio users
sudo apt install gstreamer1.0-alsa         # for alsa users

License

Goodvibes is released under the General Public License (GPL) version 3.

Translations

Goodvibes uses Weblate to manage translations. If you want to help translating Goodvibes, please visit the project page at https://hosted.weblate.org/projects/goodvibes.

Hacking

Please refer to the HACKING file to get started.

nivit/goodvibes