Sway: Difference between revisions
m Added home manager config alternative |
m Added link to SwayFX Page |
||
| (14 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
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. | [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]. | ||
[https://github.com/swaywm/sway/wiki/i3-Migration-Guide i3 migration guide] | |||
== Setup == | == Setup == | ||
| Line 11: | Line 10: | ||
{ | { | ||
environment.systemPackages = with pkgs; [ | environment.systemPackages = with pkgs; [ | ||
wl-clipboard # wl-copy and wl-paste for copy/paste from stdin / stdout | wl-clipboard # wl-copy and wl-paste for copy/paste from stdin / stdout | ||
mako # notification system developed by swaywm maintainer | mako # notification system developed by swaywm maintainer | ||
| Line 28: | Line 25: | ||
}|name=/etc/nixos/configuration.nix|lang=nix}} | }|name=/etc/nixos/configuration.nix|lang=nix}} | ||
By default, the Sway module in NixOS comes with a set of extra packages, including | 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>. | |||
The default Sway configuration is symlinked to <code>/etc/sway/config</code> and <code>/etc/sway/config.d/nixos.conf</code>. The latter file contains dbus and systemd configuration that is critical to using apps that depend on XDG desktop portals with Sway, and should be included in any custom configuration files. | The default Sway configuration is symlinked to <code>/etc/sway/config</code> and <code>/etc/sway/config.d/nixos.conf</code>. The latter file contains dbus and systemd configuration that is critical to using apps that depend on XDG desktop portals with Sway, and should be included in any custom configuration files. | ||
| Line 37: | Line 36: | ||
=== Using Home Manager === | === Using Home Manager === | ||
To set up Sway using [[Home Manager]], | To set up Sway using [[Home Manager]], you must first enable [[Polkit]] in your NixOS configuration. | ||
{{file|/etc/nixos/configuration.nix|nix|<nowiki> | {{file|/etc/nixos/configuration.nix|nix|<nowiki> | ||
security.polkit.enable = true; | security.polkit.enable = true; | ||
</nowiki>}} | </nowiki>}} | ||
Then you | Then you may enable Sway in your Home Manager configuration. Here is a minimal example: | ||
{{File|3=wayland.windowManager.sway = { | {{File|3=wayland.windowManager.sway = { | ||
| Line 92: | Line 91: | ||
When you launch Sway, the systemd service is started. | When you launch Sway, the systemd service is started. | ||
=== Using greeter === | === Using a greeter === | ||
Installing a greeter based on [ | Installing a greeter based on [[greetd]] is the most straightforward way to launch Sway. | ||
Tuigreet does not | ==== TUIGreet ==== | ||
Tuigreet is a simple and lightweight option that does not require a separate compositor to launch. | |||
{{file|||<nowiki> | {{file|||<nowiki> | ||
| Line 108: | Line 108: | ||
}; | }; | ||
</nowiki>|name=/etc/nixos/configuration.nix|lang=nix}} | </nowiki>|name=/etc/nixos/configuration.nix|lang=nix}} | ||
==== Regreet ==== | |||
[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}} | |||
=== Automatic startup on boot === | === Automatic startup on boot === | ||
The snippet below will start Sway immediately on startup, without a greeter and '''without login prompt'''. Only consider using this in conjunction with [[Full Disk Encryption]] | 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 lang="nix"> | <syntaxhighlight lang="nix"> | ||
| Line 120: | Line 124: | ||
[[ "$(tty)" == /dev/tty1 ]] && sway | [[ "$(tty)" == /dev/tty1 ]] && sway | ||
''; | ''; | ||
</syntaxhighlight>When launched directly from the TTY | </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> | ||
wayland.windowManager.sway.systemd.variables = ["--all"]; | wayland.windowManager.sway.systemd.variables = ["--all"]; | ||
</nowiki>}} | </nowiki>}} | ||
== Configuration == | == Configuration == | ||
Sway | 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>. | ||
=== Keyboard layout === | === Keyboard layout === | ||
| Line 140: | Line 144: | ||
=== Brightness and volume === | === Brightness and volume === | ||
You | 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|/etc/nixos/configuration.nix|nix|<nowiki> | {{file|/etc/nixos/configuration.nix|nix|<nowiki> | ||
users.users.yourusername.extraGroups = [ "video" ]; | users.users.yourusername.extraGroups = [ "video" ]; | ||
| Line 172: | Line 176: | ||
}; | }; | ||
}; | }; | ||
};|name=/etc/nixos/home.nix|lang=nix}} | };|name=/etc/nixos/home.nix|lang=nix}}For an on screen display for audio and brightness, check [[swayosd]]. | ||
=== Input === | |||
==== Touchpad ==== | |||
See the [https://www.mankier.com/5/sway-input sway-input man page] for options. | |||
{{File|3=wayland.windowManager.sway = | |||
{ | |||
enable = true; | |||
config.input = { | |||
"type:touchpad" = { | |||
# Enables or disables tap for specified input device. | |||
tap = "enabled"; | |||
# Enables or disables natural (inverted) scrolling for the specified input device. | |||
natural_scroll = "enabled"; | |||
# Enables or disables disable-while-typing for the specified input device. | |||
dwt = "enabled"; | |||
}; | |||
}; | |||
};|name=/etc/nixos/home.nix|lang=nix}} | |||
== Troubleshooting == | == Troubleshooting == | ||
| Line 190: | Line 213: | ||
In ~/.config/sway/config | In ~/.config/sway/config | ||
<syntaxhighlight> | <syntaxhighlight>seat "*" xcursor_theme Adwaita 32</syntaxhighlight> | ||
seat "*" xcursor_theme Adwaita 32 | |||
</syntaxhighlight> | |||
==== With Home Manager ==== | ==== With Home Manager ==== | ||
Using [[Home Manager]] | Using [[Home Manager]] you may configure the mouse cursor size and theme. The reason that your cursor might be missing in some applications, is because <code>XCURSOR_THEME</code> is missing, which will cause applications relying on <code>XWAYLAND</code> to misbehave. Setting <code>sway.enable = true</code>, combined with the <code>name</code>, <code>package</code> and size will set the correct environment variables, which sway will then use. | ||
{{File|3=home.pointerCursor = { | |||
name = "Adwaita"; | |||
package = pkgs.adwaita-icon-theme; | |||
size = 24; | |||
x11 = { | |||
enable = true; | |||
defaultCursor = "Adwaita"; | |||
}; | }; | ||
sway.enable = true; | |||
== | };|name=/etc/nixos/home.nix|lang=nix}} | ||
If fonts for certain languages are missing in Xorg applications (e.g. Japanese fonts don't appear in Discord) even though they're in the system, you can set them as default fonts in your configuration file. | === Missing fonts in Xorg applications === | ||
If fonts for certain languages are missing in Xorg applications (e.g. Japanese fonts don't appear in Discord) even though they're in the system, you can set them as default fonts in your configuration file. | |||
<syntaxhighlight lang="nix> | <syntaxhighlight lang="nix> | ||
| Line 261: | Line 280: | ||
=== WLR Error when trying to launch Sway === | === WLR Error when trying to launch Sway === | ||
When this happens on a new | When this happens on a new NixOS system, enabling OpenGL in configuration.nix may fix this issue. | ||
{{Note|<code>hardware.opengl</code> was renamed to <code>hardware.graphics</code> in NixOS 24.11.}} | {{Note|<code>hardware.opengl</code> was renamed to <code>hardware.graphics</code> in NixOS 24.11.}} | ||
| Line 339: | Line 358: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== | === Screenshots === | ||
Screenshots using grim, slurp, and [https://github.com/XodTech/grimshot grimshot] for selection screenshots/full screen screenshots. | |||
{ pkgs, ... }: | |||
Install tools | |||
{{File|3=environment.systemPackages = with pkgs; [ | |||
grim | |||
slurp | |||
sway-contrib.grimshot | |||
];|name=/etc/nixos/configuration.nix|lang=nix}} | |||
Example Home Manager configuration. | |||
{{File|3=wayland.windowManager.sway = { | |||
enable = true; | |||
config = let | |||
modifier = config.wayland.windowManager.sway.config.modifier; | |||
in { | |||
modifier = "Mod4"; | |||
keybindings = lib.mkOptionDefault { | |||
# Super + Shift + S | |||
# Screenshot a selection that saves to ~/Screenshots and copies to clipboard. | |||
"${modifier}+Shift+s" = "exec selection=$(slurp) && grim -g \"$selection\" - {{!}} tee ~/Screenshots/$(date +%Y-%m-%d_%H-%M-%S).png {{!}} wl-copy"; | |||
# Print Screen Button | |||
# Screenshot the currently focused screen, save to ~/Screenshots and copy to clipboard. | |||
"Print" = "exec grimshot save output - {{!}} tee ~/Screenshots/$(date +%Y-%m-%d_%H-%M-%S).png {{!}} wl-copy"; | |||
}; | |||
}; | |||
};|name=/etc/nixos/home.nix|lang=nix}} | |||
=== Screen sharing === | |||
{{File|3={ pkgs, ... }: | |||
{ | { | ||
# xdg portal + pipewire = screensharing | # xdg portal + pipewire = screensharing | ||
| Line 353: | Line 401: | ||
pulse.enable = true; | pulse.enable = true; | ||
}; | }; | ||
} | }|name=/etc/nixos/configuration.nix|lang=nix}}{{Tip|Make sure that you do not have conflicting definitions for xdg.portal in Home Manager.}} | ||
=== Auto mounting === | |||
==== USB storage devices (e.g. Flash Drives) ==== | |||
You can use [https://github.com/coldfix/udiskie udiskie] to automatically mount external storage medias. | |||
You will need to install and enable [https://www.freedesktop.org/wiki/Software/udisks/ udisks2]. | |||
{{File|3=services.udisks2.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}} | |||
Then, in Home Manager you can enable udiskie. | |||
{{File|3=services.udiskie.enable = true;|name=/etc/nixos/home.nix|lang=nix}} | |||
Udiskie will automatically mount attached USB storage media. | |||
See related info on [[USB storage devices]]. | |||
==== MTP (Android Phone Storage) ==== | |||
File managers that support [https://wiki.gnome.org/Projects/gvfs GVfs], such as [[Thunar]], can mount MTP devices using GVfs. See the page on [[MTP]] for related information. | |||
{{File|3=services.gvfs.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}} | |||
=== SwayFX === | |||
[https://github.com/WillPower3309/swayfx SwayFX] is a fork of Sway that adds eye-candy effects, installing it is as simple as replacing your Sway package with SwayFX. Check the [[SwayFX]] page on the wiki for additional details. | |||
{{File|3=wayland.windowManager.sway = { | |||
enable = true; | |||
package = pkgs.swayfx; | |||
# Needed to build without errors. | |||
checkConfig = false; | |||
# SwayFX options must be configured through extraConfig. | |||
extraConfig = '' | |||
shadows enable | |||
corner_radius 11 | |||
blur_radius 7 | |||
blur_passes 2 | |||
''; | |||
};|name=/etc/nixos/home.nix|lang=nix}} | |||
=== Screen dimming with | === Screen dimming with wl-gammarelay-rs === | ||
Add <code>wl-gammarelay-rs</code> to programs.sway.extraPackages, then add the following to sway config: | Add <code>wl-gammarelay-rs</code> to programs.sway.extraPackages, then add the following to sway config: | ||
<syntaxhighlight> | <syntaxhighlight> | ||