Sway: Difference between revisions

[https://swaywm.org/ Sway] is a tiling [[Wayland]] compositor and a drop-in replacement for the [[i3]] window manager for X11. It can work with an existing i3 configuration and supports most of i3's features, plus a few extras. For users migrating from i3, see the [https://github.com/swaywm/sway/wiki/i3-Migration-Guide i3 migration guide].

== Setup ==

Here is a minimal configuration:

 

{{File|3={ config, pkgs, lib, ... }:

   # Enables Gnome Keyring to store secrets for applications.

   services.gnome.gnome-keyring.enable = true;

   programs.sway = {

    wrapperFeatures.gtk = true;

By default, the Sway module in NixOS comes with a set of extra packages, including [https://codeberg.org/dnkl/foot/ Foot] terminal, [[Swayidle]], [[Swaylock]], and [https://codeberg.org/adnano/wmenu/ wmenu], which may be configured under the <code>[https://search.nixos.org/options?show=programs.sway.extraPackages programs.sway.extraPackages]</code> option. You may also want to include <code>wl-clipboard</code> for clipboard functionality, as well as a screenshot utility such as [https://github.com/emersion/slurp Slurp] or [[Flameshot]] for screenshot region selection.  

 

Additionally, for a more customizable bar implementation than <code>sway-bar</code>, [[Waybar]] may be enabled with <code>programs.waybar.enable</code>.

* There is some friction between GTK theming and Sway. Currently the Sway developers suggest using gsettings to set gtk theme attributes as described here [https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland]. There is currently a plan to allow GTK theme attributes to be set directly in the Sway config.

* Running Sway as a systemd user service is not recommended [https://github.com/swaywm/sway/wiki/Systemd-integration#running-sway-itself-as-a---user-service] [https://github.com/swaywm/sway/issues/5160]

{{File|3=wayland.windowManager.sway = {

     wrapperFeatures.gtk = true; # Fixes common issues with GTK 3 apps

     config = rec {

 

See [https://nix-community.github.io/home-manager/options.xhtml#opt-wayland.windowManager.sway.enable Home Manager's Options for Sway] for a complete list of configuration options.

 

 

=== Systemd services ===

    };

=== Using a greeter ===

Installing a greeter based on [[greetd]] is the most straightforward way to launch Sway.

 

Tuigreet is a simple and lightweight option that does not require a separate compositor to launch.

 

{{file|||<nowiki>

services.greetd = {                                                     

   enable = true;                                                        

   settings = {                                                          

     default_session = {                                                 

      command = "${pkgs.tuigreet}/bin/tuigreet --time --cmd sway";

      user = "greeter";                                                

     };                                                                  

   };                                                                    

[https://github.com/rharish101/ReGreet Regreet] is a clean and customizable GTK-based greeter written in Rust. It will automatically find Sway and remembers the last picked option. Additional configuration options may be found under [https://search.nixos.org/options?&query=regreet programs.regreet].

{{File|3=programs.regreet.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}

The snippet below will start Sway immediately on startup, without a greeter and '''without a login prompt'''. Only consider using this in conjunction with [[Full Disk Encryption]].

</syntaxhighlight>When launched directly from the TTY, Sway will not inherit the user environment. This may cause issues with systemd user services such as application launchers or [[Swayidle]]. To fix this, add the following to your Home Manager configuration:{{file|home.nix|nix|<nowiki>

{{File|3=services.gnome.gnome-keyring.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}

  swaylock.enableGnomeKeyring = true;

Sway may be configured for specific users using Home Manager or manually through configuration files. The default location is <code>/etc/sway/config</code>, and custom user configuration in <code>~/.config/sway/config</code>.

Changing scale for all screens to factor 1.5:<syntaxhighlight lang="console">

output * scale 1.5

</syntaxhighlight>

You may set the brightness and volume function keys by binding the key codes to their corresponding commands within your sway config. The following configurations accomplish this using <code>light</code> and <code>pulseaudio</code>:

{{file|||

|name=Sway Config|lang=bash}}Or alternatively in Home Manager:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Add <code>wl-gammarelay-rs</code> to programs.sway.extraPackages, then add the following to sway config:

 

 

 

</syntaxhighlight>

Add to sway config:

# When you use `for_window` the command you give is not executed

# immediately. It is stored in a list and the command is executed

# matches the criteria.