GNOME: Difference between revisions

(10 intermediate revisions by 3 users not shown)

Line 8:

To use the GNOME desktop environment on NixOS, the following configuration options must be set:

{{file|~~/etc/nixos/configuration~~.~~nix|nix|<nowiki>~~

{{file|3={ config, pkgs, ... }:

{

# Pre 25.11

services.xserver.enable = true;

Line 18:

Line 20:

services.displayManager.gdm.enable = true;

services.desktopManager.gnome.enable = true;

}

</~~nowiki>~~}}

# To disable installing GNOME's suite of applications

# and only be left with GNOME shell.

services.gnome.core-apps.enable = false;

services.gnome.core-developer-tools.enable = false;

services.gnome.games.enable = false;

environment.gnome.excludePackages = with pkgs; [ gnome-tour gnome-user-docs ];

}|name=/etc/nixos/configuration.nix|lang=nix}}

Despite the options in NixOS versions before 25.11 being under the <code>xserver</code> module, GNOME uses [[Wayland]] by default. NixOS 25.11 and later removes support for the [[Xorg]] session entirely (though Xwayland is still included and supported for compatibility).

Line 26:

Line 35:

GNOME offers support for changing/overhauling the user interface (GNOME Shell) through the use of ''[https://extensions.gnome.org/about/ Extensions].'' Extensions are bundles of third-party [https://gjs.guide/extensions/ GJS] modules that are loaded while GNOME is running to augment the user experience. A repository of GNOME extensions can be found on GNOME's official [https://extensions.gnome.org/ webpage] and can be installed imperatively if needed by unpacking the extension in <code>~/.local/share/gnome-shell/extensions</code> directory. Extensions can only be activated if it supports the GNOME release that it's installed alongside with.

~~However~~, ~~Nix~~ automatically packages all available GNOME extensions under the <code>pkgs.gnomeExtensions</code> attribute. Extensions which require additional dependencies are then manually packaged if needed. Installed extensions can be enabled graphically through the built-in "Extensions" application or through the <code>gnome-extensions</code> command line interface.

In addition, NixOS automatically packages all officially available GNOME extensions under the <code>pkgs.gnomeExtensions</code> attribute. Extensions which require additional dependencies are then manually packaged if needed. Installed extensions can be enabled graphically through the built-in "Extensions" application or through the <code>gnome-extensions</code> command line interface.

{{file|3={

Line 162:

Line 171:

=== Discover dconf settings ===

If you wish to discover the corresponding dconf entry for a given setting in a program, you can run `dconf watch /` inside of a terminal and change the setting graphically. For example, when changing toggling the Quick-Settings option "Dark Style" from "on" to "off" and back to "on," this will be the output:<syntaxhighlight lang="shell-session">

If you wish to discover the corresponding dconf entry for a given setting in a program, you can run <code>dconf watch /</code> inside of a terminal and change the setting graphically. For example, when changing toggling the Quick-Settings option "Dark Style" from "on" to "off" and back to "on," this will be the output:<syntaxhighlight lang="shell-session">

$ dconf watch /

/org/gnome/desktop/interface/color-scheme

Line 230:

Line 239:

=== Excluding GNOME Applications ===

To exclude certain applications that are installed by default with GNOME, set the {{nixos:option|environment.gnome.excludePackages}} module option:

To exclude certain applications that are installed by default with GNOME, set the {{nixos:option|environment.gnome.excludePackages}} module option (Optional Packages: [https://github.com/NixOS/nixpkgs/blob/nixos-unstable/nixos/modules/services/desktop-managers/gnome.nix#L449-L471 gnome.nix]):

{{file|/etc/nixos/configuration.nix|nix|<nowiki>

Line 278:

Line 287:

}|name=/etc/nixos/configuration.nix|lang=nix}}

:

== ~~See also~~ ==

== References ==

* [[GNOME/Calendar]]

[[Category:Desktop environment]]

[[Category:Applications]]

[[Category:NixOS Manual]]

[[Category:GNOME]]

@@ Line 8: / Line 8: @@
 To use the GNOME desktop environment on NixOS, the following configuration options must be set:
-{{file|/etc/nixos/configuration.nix|nix|<nowiki>
+{{file|3={ config, pkgs, ... }:
 {
    # Pre 25.11
    services.xserver.enable = true;
@@ Line 18: / Line 20: @@
    services.displayManager.gdm.enable = true;
    services.desktopManager.gnome.enable = true;
-}
-</nowiki>}}
+  # To disable installing GNOME's suite of applications
+  # and only be left with GNOME shell.
+  services.gnome.core-apps.enable = false;
+  services.gnome.core-developer-tools.enable = false;
+  services.gnome.games.enable = false;
+  environment.gnome.excludePackages = with pkgs; [ gnome-tour gnome-user-docs ];
+}|name=/etc/nixos/configuration.nix|lang=nix}}
 Despite the options in NixOS versions before 25.11 being under the <code>xserver</code> module, GNOME uses [[Wayland]] by default. NixOS 25.11 and later removes support for the [[Xorg]] session entirely (though Xwayland is still included and supported for compatibility).
@@ Line 26: / Line 35: @@
 GNOME offers support for changing/overhauling the user interface (GNOME Shell) through the use of ''[https://extensions.gnome.org/about/ Extensions].'' Extensions are bundles of third-party [https://gjs.guide/extensions/ GJS] modules that are loaded while GNOME is running to augment the user experience. A repository of GNOME extensions can be found on GNOME's official [https://extensions.gnome.org/ webpage] and can be installed imperatively if needed by unpacking the extension in <code>~/.local/share/gnome-shell/extensions</code> directory. Extensions can only be activated if it supports the GNOME release that it's installed alongside with.
-However, Nix automatically packages all available GNOME extensions under the <code>pkgs.gnomeExtensions</code> attribute. Extensions which require additional dependencies are then manually packaged if needed. Installed extensions can be enabled graphically through the built-in "Extensions" application or through the <code>gnome-extensions</code> command line interface.
+In addition, NixOS automatically packages all officially available GNOME extensions under the <code>pkgs.gnomeExtensions</code> attribute. Extensions which require additional dependencies are then manually packaged if needed. Installed extensions can be enabled graphically through the built-in "Extensions" application or through the <code>gnome-extensions</code> command line interface.
 {{file|3={
@@ Line 162: / Line 171: @@
 === Discover dconf settings ===
-If you wish to discover the corresponding dconf entry for a given setting in a program, you can run `dconf watch /` inside of a terminal and change the setting graphically. For example, when changing toggling the Quick-Settings option "Dark Style" from "on" to "off" and back to "on," this will be the output:<syntaxhighlight lang="shell-session">
+If you wish to discover the corresponding dconf entry for a given setting in a program, you can run <code>dconf watch /</code> inside of a terminal and change the setting graphically. For example, when changing toggling the Quick-Settings option "Dark Style" from "on" to "off" and back to "on," this will be the output:<syntaxhighlight lang="shell-session">
 $ dconf watch /
 /org/gnome/desktop/interface/color-scheme
@@ Line 230: / Line 239: @@
 === Excluding GNOME Applications ===
-To exclude certain applications that are installed by default with GNOME, set the {{nixos:option|environment.gnome.excludePackages}} module option:
+To exclude certain applications that are installed by default with GNOME, set the {{nixos:option|environment.gnome.excludePackages}} module option (Optional Packages: [https://github.com/NixOS/nixpkgs/blob/nixos-unstable/nixos/modules/services/desktop-managers/gnome.nix#L449-L471 gnome.nix]):
 {{file|/etc/nixos/configuration.nix|nix|<nowiki>
@@ Line 278: / Line 287: @@
 }|name=/etc/nixos/configuration.nix|lang=nix}}
 :
-== See also ==
+== References ==
-* [[GNOME/Calendar]]
 [[Category:Desktop environment]]
 [[Category:Applications]]
 [[Category:NixOS Manual]]
 [[Category:GNOME]]