1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
Goodvibes
=========
**Goodvibes** is a lightweight internet radio player for GNU/Linux. Save your
favorite stations, play it, that's it.
There is no function to search radio stations, you'll have to enter the URL of
the audio stream by yourself. Not very user-friendly, I know, but doing better
than that is not simple.
Places of interest:
- **Development** is hosted here, on [GitLab](https://gitlab.com/goodvibes/goodvibes)
- **Documentation** is available on [Read the Docs](https://goodvibes.readthedocs.io)
- **Translation** takes place on [Weblate](https://hosted.weblate.org/projects/goodvibes)
## Installing
You have a few options to install Goodvibes:
1. Install the package provided by your Linux distribution (if any).
2. Install the Flatpak app available from [Flathub][].
3. Install a package from an unofficial repository.
4. Build from source (see below).
For more details, please refer to the [Installation page in the documentation][installation].
[flathub]: https://flathub.org/apps/io.gitlab.Goodvibes
[installation]: https://goodvibes.readthedocs.io/en/stable/installation.html
## Building from source
*Note*: The following commands are for a Debian-like distribution. If you're
using another distribution, please adjust the package names and replace `apt`
by your package manager.
*Note*: These instructions are for advanced users. Beginners should use it with
caution.
Goodvibes is written in C and builds with Meson.
At first, make sure that you have all the dependencies required.
```console
# ~ Build dependencies ~
# Build toolchain
sudo apt install build-essential git meson
# Core dependencies
sudo apt install libglib2.0-dev libsoup-3.0-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
# GUI dependencies
sudo apt install libgtk-3-dev libkeybinder-3.0-dev
# Test utils (optional)
sudo apt install appstream-util desktop-file-utils libgtk-3-bin libxml2-utils
# ~ Runtime dependencies ~
# To load and store settings
sudo apt install dconf-gsettings-backend
# To play MPEG-DASH streams and AAC codec
sudo apt install gstreamer1.0-plugins-bad
# To play HLS streams
sudo apt install gstreamer1.0-plugins-ugly
# GStreamer audio backend
if dpkg -s pipewire >/dev/null 2>&1; then
sudo apt install gstreamer1.0-pipewire
elif dpkg -s pulseaudio >/dev/null 2>&1; then
sudo apt install gstreamer1.0-pulseaudio
else
sudo apt install gstreamer1.0-alsa
fi
# ~ Additional tooling for developers (optional) ~
# To edit the UI files
sudo apt install glade
# To inspect radio streams
sudo apt install gstreamer1.0-tools
# To read the doc offline
sudo apt install devhelp gstreamer1.0-doc \
libglib2.0-doc libgtk-3-doc libsoup-3.0-doc
# GTK examples
sudo apt install gtk-3-examples
```
Now you're ready to get the source code and build it:
```console
git clone https://gitlab.com/goodvibes/goodvibes.git
cd goodvibes
meson setup build
ninja -C build
```
Then you can run the application in-tree, without installing anything:
```console
./goodvibes-launcher.sh
```
You can also install it:
```console
sudo ninja -C build install
```
## Credits
The artwork was made by [Hector Lahminèwskï](https://lahminewski-lab.net/).
Goodvibes wouldn't exist without free and open-source software such as
[GLib][], [LibSoup][], [FFmpeg][], [GStreamer][], [GTK][] and many more.
[glib]: https://wiki.gnome.org/Projects/GLib
[libsoup]: https://wiki.gnome.org/Projects/libsoup
[ffmpeg]: https://www.ffmpeg.org/
[gstreamer]: https://gstreamer.freedesktop.org/
[gtk]: https://www.gtk.org/
## License
Goodvibes is free software, released under the [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html).
|
