GNOME: Difference between revisions
m →GNOME desktop: fix typo |
scale-monitor-framebuffer and variable-refresh-rate are no longer experimental in GNOME 50. kms-modifier added |
||
| (10 intermediate revisions by 2 users not shown) | |||
| 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, ... }: | ||
{ | { | ||
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. | ||
=== GNOME extensions === | === GNOME extensions === | ||
| Line 152: | 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 | === Experimental features === | ||
GNOME has a number of experimental | 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 160: | Line 151: | ||
"org/gnome/mutter" = { | "org/gnome/mutter" = { | ||
experimental-features = [ | experimental-features = [ | ||
" | "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 | ||
]; | ]; | ||
}; | }; | ||
| Line 171: | Line 161: | ||
=== Discover dconf settings === | === Discover dconf settings === | ||
If you wish to discover the corresponding dconf entry for a given setting in a program, you can run | 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 / | $ dconf watch / | ||
/org/gnome/desktop/interface/color-scheme | /org/gnome/desktop/interface/color-scheme | ||
| Line 204: | Line 194: | ||
=== 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 | 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 ]; | ||
}|name=/etc/nixos/configuration.nix|lang=nix}}You can also install the extension outside of Nix and it will function the same. | |||
}|name=/etc/nixos/configuration.nix|lang=nix}} | |||
=== Profiling (with sysprof) === | === Profiling (with sysprof) === | ||
| Line 243: | 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 | |||
]; | ]; | ||
</nowiki>}} | </nowiki>|name=/etc/nixos/configuration.nix|lang=nix}} | ||
== Troubleshooting == | == Troubleshooting == | ||
=== 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> | ||
| Line 272: | Line 261: | ||
=== Automatic login === | === Automatic login === | ||
For automatic login, include this in your NixOS configuration adjusting the "<your username>" part with your username: | |||
{{File|3={ | {{File|3={ | ||
services | services.displayManager.autoLogin.enable = true; | ||
services | services.displayManager.autoLogin.user = "<your username>"; | ||
}|name=/etc/nixos/configuration.nix|lang=nix}} | }|name=/etc/nixos/configuration.nix|lang=nix}} | ||