GNOME - Revision history

Langfingaz: /* Qt integration for GNOME */ missing semicolon

2026-08-04T11:17:06Z

Qt integration for GNOME: missing semicolon

← Older revision		Revision as of 11:17, 4 August 2026
Line 132:		Line 132:
	pkgs.qgnomeplatform		pkgs.qgnomeplatform
	pkgs.qgnomeplatform-qt6		pkgs.qgnomeplatform-qt6
	]		];
	}</syntaxhighlight>Alternatively, the older <code>qt.platformTheme</code> docs have been included below.		}</syntaxhighlight>Alternatively, the older <code>qt.platformTheme</code> docs have been included below.
	In the following example configuration, Qt applications will have a look similar to the adwaita style used by GNOME using a dark theme.		In the following example configuration, Qt applications will have a look similar to the adwaita style used by GNOME using a dark theme.

ScatteredCognition: Include QAdwaitaDecorations and QGnomePlatform instructions for Qt app theming as the qt.platformTheme option results in broken theming on NixOS 26.05

2026-08-04T11:01:33Z

Include QAdwaitaDecorations and QGnomePlatform instructions for Qt app theming as the qt.platformTheme option results in broken theming on NixOS 26.05

← Older revision		Revision as of 11:01, 4 August 2026
Line 120:		Line 120:
	The GNOME shell extension [https://extensions.gnome.org/extension/3843/just-perfection/ Just Perfection] also allows for customizing nearly all parts of the GNOME shell interface.		The GNOME shell extension [https://extensions.gnome.org/extension/3843/just-perfection/ Just Perfection] also allows for customizing nearly all parts of the GNOME shell interface.

	=== ~~GNOME~~ Qt integration ===		=== Qt integration for GNOME ===
	~~Using~~ the following example configuration, Qt applications will have a look similar to the adwaita style used by GNOME using a dark theme.		As of NixOS 26.05, the <code>qt.platformTheme = "gnome";</code> option results in broken Qt app theming when GNOME is set to dark mode. If you only want "Adwaita-looking" Qt apps so they don't look too out of place, you can install the packages for QAdwaitaDecorations and QGnomePlatform, which provide quite decent GNOME theming for Qt apps.<syntaxhighlight lang="nixos"># Install QAdwaitaDecorations and QGnomePlatform
			{ pkgs, ... }:

			{
			environment.systemPackages = [
			# Themes the app titlebars
			pkgs.qadwaitadecorations
			pkgs.qadwaitadecorations-qt6
			# Themes the apps
			pkgs.qgnomeplatform
			pkgs.qgnomeplatform-qt6
			]
			}</syntaxhighlight>Alternatively, the older <code>qt.platformTheme</code> docs have been included below.
			In the following example configuration, Qt applications will have a look similar to the adwaita style used by GNOME using a dark theme.
	{{File\|3={		{{File\|3={
	qt = {		qt = {

DHCP: style fixes

2026-07-19T13:49:48Z

style fixes

← Older revision		Revision as of 13:49, 19 July 2026
Line 75:		Line 75:
	};		};
	};		};
	}\|name=~/.config/home-manager/home.nix\|lang=nix}}Thus the settings attribute accepts an attribute set whose keys are schemas with each schema's value being a nested attribute set of the schema's keys with their appropriate GVariant value.{{Note\|Schemas in Nix are written without leading and trailing slashes. In addition, since dconf have more data types than the Nix language (for example, tuples), in some cases you'll need to convert Nix value to a GVariant value. You can achieve that by using the functions defined under <code>lib.gvariant</code>, they're documented [https://nixos.org/manual/nixpkgs/stable/#sec-functions-library-gvariant here].}}If you wish to revert all dconf settings back to their default state (reset GNOME essentially) then use the following command which resets all schemas directories available on your system, note that this will affect all programs that use dconf, including GNOME apps and extensions.<syntaxhighlight lang=~~"bash"~~>		}\|name=~/.config/home-manager/home.nix\|lang=nix}}Thus the settings attribute accepts an attribute set whose keys are schemas with each schema's value being a nested attribute set of the schema's keys with their appropriate GVariant value.{{Note\|Schemas in Nix are written without leading and trailing slashes. In addition, since dconf have more data types than the Nix language (for example, tuples), in some cases you'll need to convert Nix value to a GVariant value. You can achieve that by using the functions defined under <code>lib.gvariant</code>, they're documented [https://nixos.org/manual/nixpkgs/stable/#sec-functions-library-gvariant here].}}If you wish to revert all dconf settings back to their default state (reset GNOME essentially) then use the following command which resets all schemas directories available on your system, note that this will affect all programs that use dconf, including GNOME apps and extensions.
			<syntaxhighlight lang=console>
	$ dconf reset -f /		$ dconf reset -f /
	</syntaxhighlight>		</syntaxhighlight>
Line 204:		Line 205:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.sysprof.enable = true;		services.sysprof.enable = true;
	</syntaxhighlight>		</syntaxhighlight>

Line 210:		Line 211:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	hardware.sensor.iio.enable = true;		hardware.sensor.iio.enable = true;
	</syntaxhighlight>		</syntaxhighlight>

Line 231:		Line 232:

	{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>		{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>
	environment.gnome.excludePackages = with pkgs; [		environment.gnome.excludePackages = with pkgs; [
	showtime		showtime
	];		];
	</nowiki>\|name=/etc/nixos/configuration.nix\|lang=nix}}		</nowiki>\|name=/etc/nixos/configuration.nix\|lang=nix}}

Line 239:		Line 240:

	=== Missing cursor/cursor is a white box ===		=== Missing cursor/cursor is a white box ===
	This occurs when installing GNOME from an existing NixOS installation that used a different desktop environment that modified dconf (most likely switching from KDE to GNOME). To easily fix this alongside any number of silent incompatabilities: reset all dconf settings.<syntaxhighlight lang=~~"bash"~~>		This occurs when installing GNOME from an existing NixOS installation that used a different desktop environment that modified dconf (most likely switching from KDE to GNOME). To easily fix this alongside any number of silent incompatabilities: reset all dconf settings.
			<syntaxhighlight lang=console>
	$ dconf reset -f /		$ dconf reset -f /
	</syntaxhighlight>		</syntaxhighlight>

Davron26: scale-monitor-framebuffer and variable-refresh-rate are no longer experimental in GNOME 50. kms-modifier added

2026-06-09T17:27:17Z

scale-monitor-framebuffer and variable-refresh-rate are no longer experimental in GNOME 50. kms-modifier added

← Older revision		Revision as of 17:27, 9 June 2026
Line 144:		Line 144:

	=== Experimental features ===		=== Experimental features ===
	GNOME has a number of experimental options for features not fully completed and thus hidden from the user. As of GNOME 49, these are the experimental features you may want to ~~use~~:		GNOME has a number of experimental options for features not fully completed and thus hidden from the user. As of GNOME 50, these are the experimental features you may want to try out:
	{{File\|3={		{{File\|3={
	programs.dconf.profiles.user.databases = [		programs.dconf.profiles.user.databases = [
Line 151:		Line 151:
	"org/gnome/mutter" = {		"org/gnome/mutter" = {
	experimental-features = [		experimental-features = [
	~~"scale-monitor-framebuffer" # Enables fractional scaling (125% 150% 175%)~~
	~~"variable-refresh-rate" # Enables Variable Refresh Rate (VRR) on compatible displays~~
	~~"xwayland-native-scaling" # Scales Xwayland applications to look crisp on HiDPI screens~~
	"autoclose-xwayland" # automatically terminates Xwayland if all relevant X11 clients are gone		"autoclose-xwayland" # automatically terminates Xwayland if all relevant X11 clients are gone
			# "kms-modifiers" # allocate scanout buffers using "explicit modifiers" if your graphics driver supports it. Uncomment if you want to test NVIDIA optimizations
	];		];
	};		};

Jasi: /* Experimental features */ remove period from comment.

2026-01-10T20:43:28Z

Experimental features: remove period from comment.

← Older revision		Revision as of 20:43, 10 January 2026
Line 154:		Line 154:
	"variable-refresh-rate" # Enables Variable Refresh Rate (VRR) on compatible displays		"variable-refresh-rate" # Enables Variable Refresh Rate (VRR) on compatible displays
	"xwayland-native-scaling" # Scales Xwayland applications to look crisp on HiDPI screens		"xwayland-native-scaling" # Scales Xwayland applications to look crisp on HiDPI screens
	"autoclose-xwayland" # automatically terminates Xwayland if all relevant X11 clients are gone.		"autoclose-xwayland" # automatically terminates Xwayland if all relevant X11 clients are gone
	];		];
	};		};

Jasi: /* Experimental settings */ update for GNOME 49.

2026-01-10T20:42:45Z

Experimental settings: update for GNOME 49.

← Older revision		Revision as of 20:42, 10 January 2026
Line 143:		Line 143:
	For more details, see [https://discourse.nixos.org/t/guide-to-installing-qt-theme/35523/2 this] forum post.{{Note\|Qt integration with the adwaita style isn't perfect and your mileage may vary.}}		For more details, see [https://discourse.nixos.org/t/guide-to-installing-qt-theme/35523/2 this] forum post.{{Note\|Qt integration with the adwaita style isn't perfect and your mileage may vary.}}

	=== Experimental ~~settings~~ ===		=== Experimental features ===
	GNOME has a number of experimental ~~settings~~ for features not fully completed and thus hidden from the user. As of GNOME 48, these are the experimental features you may want to use:		GNOME has a number of experimental options for features not fully completed and thus hidden from the user. As of GNOME 49, these are the experimental features you may want to use:
	{{File\|3={		{{File\|3={
	programs.dconf.profiles.user.databases = [		programs.dconf.profiles.user.databases = [
Line 154:		Line 154:
	"variable-refresh-rate" # Enables Variable Refresh Rate (VRR) on compatible displays		"variable-refresh-rate" # Enables Variable Refresh Rate (VRR) on compatible displays
	"xwayland-native-scaling" # Scales Xwayland applications to look crisp on HiDPI screens		"xwayland-native-scaling" # Scales Xwayland applications to look crisp on HiDPI screens
			"autoclose-xwayland" # automatically terminates Xwayland if all relevant X11 clients are gone.
	];		];
	};		};

Jasi: /* Missing cursor/cursor is a white box */ give more context on advising users to reset all of dconf.

2026-01-10T20:38:07Z

Missing cursor/cursor is a white box: give more context on advising users to reset all of dconf.

← Older revision		Revision as of 20:38, 10 January 2026
Line 240:		Line 240:

	=== Missing cursor/cursor is a white box ===		=== Missing cursor/cursor is a white box ===
	This occurs when installing GNOME from an existing NixOS installation that used a different desktop environment that modified dconf (most likely switching from KDE to GNOME). To easily fix this: reset all dconf settings.<syntaxhighlight lang="bash">		This occurs when installing GNOME from an existing NixOS installation that used a different desktop environment that modified dconf (most likely switching from KDE to GNOME). To easily fix this alongside any number of silent incompatabilities: reset all dconf settings.<syntaxhighlight lang="bash">
	$ dconf reset -f /		$ dconf reset -f /
	</syntaxhighlight>		</syntaxhighlight>

Jasi: /* Excluding GNOME Applications */ update totem to showtime as totem has been sunset since GNOME 49.

2026-01-10T20:37:13Z

Excluding GNOME Applications: update totem to showtime as totem has been sunset since GNOME 49.

← Older revision		Revision as of 20:37, 10 January 2026
Line 233:		Line 233:
	{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>		{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>
	environment.gnome.excludePackages = with pkgs; [		environment.gnome.excludePackages = with pkgs; [
	~~totem~~		showtime
	];		];
	</nowiki>}}		</nowiki>\|name=/etc/nixos/configuration.nix\|lang=nix}}

	== Troubleshooting ==		== Troubleshooting ==

Jasi: /* Enable system tray icons */ use term panel instead of bar.

2026-01-10T20:34:38Z

Enable system tray icons: use term panel instead of bar.

← Older revision		Revision as of 20:34, 10 January 2026
Line 195:		Line 195:

	=== Enable system tray icons ===		=== Enable system tray icons ===
	GNOME does not currently support system tray icons. However, Ubuntu has created an [https://extensions.gnome.org/extension/615/appindicator-support/ extension] that implements this in the top ~~bar~~. You can install this extension with the following in NixOS:		GNOME does not currently support system tray icons. However, Ubuntu has created an [https://extensions.gnome.org/extension/615/appindicator-support/ extension] that implements this in the top panel. You can install this extension with the following in NixOS:
	{{File\|3={		{{File\|3={
	environment.systemPackages = [ pkgs.gnomeExtensions.appindicator ];		environment.systemPackages = [ pkgs.gnomeExtensions.appindicator ];

Jasi: /* GNOME desktop */ Remove snippet for pre-25.11 as it has passed EOL.

2026-01-10T20:29:17Z

GNOME desktop: Remove snippet for pre-25.11 as it has passed EOL.

← Older revision		Revision as of 20:29, 10 January 2026
Line 6:		Line 6:

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

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

	{		{

	~~# Pre 25.11~~
	~~services.xserver.enable = true;~~
	~~services.xserver.displayManager.gdm.enable = true;~~
	~~services.xserver.desktopManager.gnome.enable = true;~~

	~~# As of 25.11~~
	services.displayManager.gdm.enable = true;		services.displayManager.gdm.enable = true;
	services.desktopManager.gnome.enable = true;		services.desktopManager.gnome.enable = true;
Line 28:		Line 21:
	environment.gnome.excludePackages = with pkgs; [ gnome-tour gnome-user-docs ];		environment.gnome.excludePackages = with pkgs; [ gnome-tour gnome-user-docs ];

	}\|name=/etc/nixos/configuration.nix\|lang=nix}}		}\|name=/etc/nixos/configuration.nix\|lang=nix}}Mixing GNOME with other desktops (such as alternative login managers other than GDM) is not supported, make sure to disable other desktop modules before rebuilding if you encounter issues with conflicting desktops.

	~~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)~~.

	=== GNOME extensions ===		=== GNOME extensions ===