Installation
============

.. include:: icons.rst
.. highlight:: none

The easiest way to install Goodvibes is to use the package provided by your
Linux distribution, if any. It's 100% hassle free, however you might not get
the latest version, depending on your distro.

If you want to make sure to install and run the latest version at all times,
then the best is to install the Flatpak app.

Finally, for the adventurous, it's always possible to grab the source code and
build it.



|flathub-logo| Flathub
----------------------

* `Flatpak app on Flathub <https://flathub.org/apps/io.gitlab.Goodvibes>`_

::

        flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
        flatpak install flathub io.gitlab.Goodvibes



|debian-logo| Debian
--------------------

* `Debian repository <https://packages.debian.org/sid/sound/goodvibes>`_

::

        sudo apt install goodvibes



|ubuntu-logo| Ubuntu
--------------------

* `Ubuntu repository <https://packages.ubuntu.com/search?keywords=goodvibes>`_

::

        sudo apt install goodvibes



|fedora-logo| Fedora
--------------------

* `Fedora repository <https://src.fedoraproject.org/rpms/goodvibes>`_

::

        sudo dnf install goodvibes



|opensuse-logo| openSUSE
------------------------

* `openSUSE multimedia:apps repository <https://software.opensuse.org/package/goodvibes>`_
  (rolling release "Tumbleweed", stable release 15.x "Leap")

::

        # For Tumbleweed (for other releases, adjust the url)
        sudo zypper addrepo https://download.opensuse.org/repositories/openSUSE:Factory/standard/openSUSE:Factory.repo
        sudo zypper refresh
        sudo zypper install goodvibes

You can find more install instructions on the `Expert Download page
<https://software.opensuse.org/download/package?package=goodvibes&project=openSUSE%3AFactory>`_.



|archlinux-logo| Arch Linux
---------------------------

* `Archlinux User Repository <https://aur.archlinux.org/packages/goodvibes>`_

::

         git clone https://aur.archlinux.org/goodvibes.git
         cd goodvibes
         makepkg -si

* `Étienne Deparis' Unofficial Archlinux User Repository <https://archlinux.umaneti.net/>`_
  (for a prebuilt binary package)

::

        # Setup the repository first, then:
        pacman -S goodvibes



|void-logo| Void Linux
----------------------

* `Void Linux package <https://github.com/void-linux/void-packages/tree/master/srcpkgs/goodvibes>`_

::

        xbps-install -S goodvibes



|source-logo| Release Tarballs
-------------------------------

If there is no package for your distribution, and if you have some packaging
skills, please get in touch, your contribution is welcome!

For build instructions, refer to https://gitlab.com/goodvibes/goodvibes.