This repository contains a generic template for Budgie Desktop defaults that can be used by operating systems.
  • Meson 92.4%
  • Shell 7.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Joshua Strobl 8972211469 feat: 0.6.1 release
Signed-off-by: Joshua Strobl <me@joshuastrobl.com>
2026-09-14 21:40:39 +03:00
.claude/skills/commit docs: add contributing guidelines, AI policy, DCO, and agent docs 2026-09-14 21:30:49 +03:00
budgie feat: transform into a generic Budgie Desktop defaults project 2026-09-13 16:29:30 +03:00
gnome feat(gnome): add options for the default background 2026-09-14 21:31:22 +03:00
scripts Initial commit 2023-02-04 20:03:22 +02:00
.gitignore Initial commit 2023-02-04 20:03:22 +02:00
AGENTS.md docs: add contributing guidelines, AI policy, DCO, and agent docs 2026-09-14 21:30:49 +03:00
CLAUDE.md docs: add contributing guidelines, AI policy, DCO, and agent docs 2026-09-14 21:30:49 +03:00
CODEOWNERS Add CODEOWNERS 2023-09-17 18:17:25 +03:00
CONTRIBUTING.md docs: add contributing guidelines, AI policy, DCO, and agent docs 2026-09-14 21:30:49 +03:00
DCO.txt docs: add contributing guidelines, AI policy, DCO, and agent docs 2026-09-14 21:30:49 +03:00
LICENSE Initial commit 2023-02-04 20:03:22 +02:00
meson.build feat: 0.6.1 release 2026-09-14 21:40:39 +03:00
meson_options.txt feat(gnome): add options for the default background 2026-09-14 21:31:22 +03:00
meson_post_install.sh Initial commit 2023-02-04 20:03:22 +02:00
README.md feat(gnome): add options for the default background 2026-09-14 21:31:22 +03:00

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.