This repository contains a generic template for Budgie Desktop defaults that can be used by operating systems.
- Meson 92.4%
- Shell 7.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .claude/skills/commit | ||
| budgie | ||
| gnome | ||
| scripts | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| CODEOWNERS | ||
| CONTRIBUTING.md | ||
| DCO.txt | ||
| LICENSE | ||
| meson.build | ||
| meson_options.txt | ||
| meson_post_install.sh | ||
| README.md | ||
Budgie Desktop Defaults
This repository contains a generic template for Budgie Desktop defaults that can be used by operating systems.
We expose the following configure-time options:
| Option | Type | Default | Description |
|---|---|---|---|
menu-logo |
string | none |
budgie-menu logo, as an icon name or an absolute path. none skips the override, leaving budgie-menu on its start-here-symbolic default. |
pinned-apps |
array | Dolphin, Firefox, Rhythmbox, Discover, Parole | Desktop file IDs pinned in the Icon Tasklist applet. An empty array skips the override. |
background |
string | unset | Path to the default background image, e.g. /usr/share/backgrounds/budgie/default.jpg. The file:// prefix is added for you. Unset ships no background override. |
background-dark |
string | unset | Path to the background image used in dark mode. Falls back to background when unset, and requires background to be set. |
picture-options |
combo | zoom |
How the background is drawn: wallpaper, centered, scaled, stretched, zoom, or spanned. Only written when background is set. |
with-gedit |
boolean | true |
Install the gedit preferences override. When false, no gedit override is shipped. |
gedit-scheme |
string | oblivion |
Default gedit color scheme. Ignored when with-gedit is false. |
color-scheme |
combo | prefer-dark |
One of default, prefer-dark, or prefer-light. Should align with the default GTK theme. |
gtk-theme |
string | Pocillo-dark |
Default GTK theme. Other themes will work, but we take no responsibility for any breakage they cause. |
icon-theme |
string | Papirus |
Default icon theme. Papirus is recommended. |
For example:
meson setup build \
-Dmenu-logo=/usr/share/pixmaps/fedora-logo-sprite.svg \
-Dpinned-apps=org.gnome.Nautilus.desktop,firefox.desktop \
-Dbackground=/usr/share/backgrounds/budgie/default.jpg \
-Dwith-gedit=false \
-Dcolor-scheme=prefer-light \
-Dgtk-theme=Pocillo \
-Dicon-theme=Papirus
Contributing
Pull requests for additional options / flexibility are welcome.
Forks of this are encouraged for greater customization for your own operating system.
LICENSE
This is licensed under CC-BY-SA 4.0. You have a legal right to copy, redistribute, transform / modify, and build on this project for commercial and/or non-commercial purposes. See LICENSE for more details.