The Budgie Desktop a modern desktop designed to keep out the way of the user. It features heavy integration with the GNOME stack in order for an enhanced experience.
We are slowly moving to a modular architecture, which you see via our organization page as well as our Budgie 11 workboard.
IRC: #budgie-desktop-dev on irc.freenode.net
Budgie Desktop consists of a number of components to provide a more complete desktop experience.
The main Budgie menu provides a quick and easy to use menu, suitable for both mouse and keyboard driven users. Features type-as-you-search and category based filtering.
The session dialog provides the usual shutdown, logout, options which can be activated using the User Indicator applet.
The run dialog provides the means to quickly find an application in a popup window. This window by default is activated with the ALT+F2 keyboard shortcut, providing keyboard driven launcher facilities.
Raven provides an all-in-one center for the Budgie Desktop. With built in applets, a notification center to archive missed notifications, and a settings view to control all elements of the Budgie Desktop, it's truly the one stop shop.
Budgie Desktop supports the freedesktop notifications specification, enabling applications to send visual alerts to the user. These notifications support actions, icons as well as passive modes.
To ensure the user doesn't miss the notification, it's automatically archived into the Raven Notification view for quick and easy access.
As well as supporting the usual level of media integration you'd expect, such as media player controls on notifications, support for cover artwork, and global media key support for keyboards, Raven supports all MPRIS compliant media players.
When one of these players are running, such as VLC, Rhythmbox or even Spotify, an MPRIS controller is made available in Raven for quick and simple control of the player, as well as data on the current media selection.
The budgie-polkit-dialog provides a PolicyKit agent for the session, ensuring a cohesive and integrated experience whilst authenticating for actions on modern Linux desktop systems.
budgie-desktop has a number of build dependencies that must be present before attempting configuration. The names are different depending on distribution, so the pkg-config names, and the names within Solus, are given:
- accountsservice >= 0.6
- gio-2.0 >= 2.46.0
- gio-unix-2.0 >= 2.46.0
- gnome-bluetooth-1.0 >= 3.18.0
- gnome-desktop-3.0 >= 3.18.0
- gobject-2.0 >= 2.44.0
- gobject-introspection-1.0 >= 1.44.0
- gtk+-3.0 >= 3.16.0
- ibus-1.0 >= 1.5.11
- libgnome-menu-3.0 >= 3.10.1
- libpeas-gtk-1.0 >= 1.8.0
- libpulse >= 2
- libwnck >= 3.14.0
- meson
- mutter >= 3.18.0
- polkit-agent-1 >= 0.110
- polkit-gobject-1 >= 0.110
- upower-glib >= 0.9.20
- uuid
And:
- vala >= 0.28
- gtk-doc (For documentation building from git only)
To install these on Solus:
sudo eopkg it glib2-devel libgtk-3-devel gtk-doc libpeas-devel gobject-introspection-devel util-linux-devel pulseaudio-devel libgnome-menus-devel libgnome-desktop-devel gnome-bluetooth-devel mutter-devel polkit-devel libwnck-devel upower-devel accountsservice-devel ibus-devel vala meson
sudo eopkg it -c system.develClone the repository:
git clone https://github.com/solus-project/budgie-desktop.gitNow build it:
cd budgie-desktop
meson build --prefix=/usr --sysconfdir=/etc
cd build
ninja -j$(($(getconf _NPROCESSORS_ONLN)+1))
sudo ninja installNote: When building a distro package, please ensure you use:
meson build --prefix=/usr --sysconfdir=/etc --buildtype plain
This ensures your distro flags are respected.
Please look at ./src//3.20/sass and ./src/theme/3.18/sass to override aspects of the default theming. Budgie theming is created using SASS, and the CSS files shipped are minified. Check out ./src/theme/README.md for more information on regenerating the theme from SASS.
Alternatively, you may invoke the panel with the GTK Inspector to analyse the structure:
budgie-panel --gtk-debug=interactive --replaceIf you are validating changes from a git clone, then:
./src/panel/budgie-panel --gtk-debug=interactive --replaceNote that for local changes, GSettings schemas and applets are expected to be installed first with make install.
Note that it is intentional for the toplevel BudgiePanel object to be transparent, as it contains the BudgieMainPanel and BudgieShadowBlock within a singular window.
Also note that by default Budgie overrides all theming with the stylesheet, and in future we'll also make it possible for you to set a custom theme. To do this, test your changes in tree first. When you have a reasonable theme put together, please open an issue and we'll enable setting of a custom theme (no point until they exist.)
As and when new features are implemented - it can be helpful to reset the configuration to the defaults to ensure everything is still working ok. To reset the entire configuration tree, issue:
budgie-panel --reset --replace &In order to override the default panel layout, you should provide your own panel.ini in the system-wide vendor directory:
$(datadir)/budgie-desktop/panel.ini`Note that the system configuration directory is the domain of the system administrator, and you should not ship a panel.ini in this location. This location is:
$(sysconfdir)/budgie-desktop/panel.iniThis is to allow users to make global layout changes for all users on the system. Please see ./data/panel.ini for a reference.
To override the specific GSettings, you should implement gschema overrides. For an example of this, please see our branding package.
budgie-desktop is available under a split license model. This enables developers to link against the libraries of budgie-desktop without affecting their choice of license and distribution.
The shared libraries are available under the terms of the LGPL-2.1, allowing developers to link against the API without any issue, and to use all exposed APIs without affecting their project license.
The remainder of the project (i.e. installed binaries) is available under the terms of the GPL 2.0 license. This is clarified in the headers of each source file.
Copyright © 2014-2016 Ikey Doherty, Solus Project & Others
Also see our contributors graph!