Skip to main content

Building Budgie Desktop

Build Dependencies

budgie-desktop has a number of build dependencies that must be present before attempting configuration. The names are different depending on distribution. The following is a list of pkg-config dependencies currently required to build Budgie from source.

  • accountsservice >= 0.6.40
  • alsa-lib >= 1.1.0
  • budgie-screensaver (or gnome-screensaver on Debian / Ubuntu)
  • budgie-session
  • gee-0.8 >= 0.20.0
  • gio-2.0 >= 2.64.0
  • gio-unix-2.0 >= 2.64.0
  • gnome-desktop-3.0 >= 41.0
  • gnome-settings-daemon >= 41.0
  • gobject-2.0 >= 2.64.0
  • gobject-introspection-1.0 >= 1.64.0
  • gstreamer-1.0
  • gtk+-3.0 >= 3.24.0
  • ibus-1.0 >= 1.5.10
  • libcanberra-devel
  • libgnome-menu-3.0 >= 3.10.3
  • libnotify >= 0.7
  • libpeas-gtk-1.0 >= 1.26.0
  • libpulse >= 2
  • libwnck >= 3.36.0
  • libxfce4windowing
  • meson
  • magpie 0.9.x
  • polkit-agent-1 >= 0.110
  • polkit-gobject-1 >= 0.110
  • upower-glib >= 0.99.0
  • uuid

And:

  • gtk-doc (For documentation building from git only)
  • sassc (to build theming)
  • vala >= 0.52.0
Important Information

Please ensure you install budgie-screensaver before configuration. If you are on a Debian-based system, ensure you are install gnome-screensaver.

Run-time dependencies

budgie-desktop requires/recommends the following to be installed:

  • zenity (to display mutter based dialogs)
  • dconf-cli (to handle resetting of dconf)
  • xdotool (lock keys applet)

Installing Build Dependencies

sudo pacman -S base-devel git
sudo pacman -S accountsservice budgie-session budgie-screensaver gnome-settings-daemon gobject-introspection ibus intltool libgee libpeas libwnck3 libxfce4windowing meson magpie sassc vala zenity

Cloning the repository

git clone https://github.com/buddiesofbudgie/budgie-desktop.git
cd budgie-desktop
git submodule update --init

Configuring

cd budgie-desktop
meson setup build --prefix=/usr --sysconfdir=/etc --libexecdir=/usr/lib

Building

ninja -j$(($(getconf _NPROCESSORS_ONLN)+1)) -C build

Note: When building a distro package, please ensure you use:

meson build --prefix=/usr --sysconfdir=/etc --buildtype plain

This ensures your distro flags are respected.

Installing

sudo ninja install -C build