Official NixOS Wiki

Sway: Difference between revisions

← Older edit
Phobos (talk | contribs)
114 edits
VisualWikitext
imported>Artturin
add notif daemon
Phobos (talk | contribs)
114 edits
mNo edit summary
 
(111 intermediate revisions by 52 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 works with your 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].


== Installation ==
== Setup ==
You can install Sway by enabling it in NixOS directly, or by using [[Home Manager]], or both.


=== NixOS ===
=== Using NixOS ===
[https://search.nixos.org/options?query=sway NixOS options for sway]
Here is a minimal configuration:
 
{{File|3={ config, pkgs, lib, ... }:
{
  environment.systemPackages = with pkgs; [
    wl-clipboard # Copy/Paste functionality.
    mako # Notification utility.
  ];
 
  # Enables Gnome Keyring to store secrets for applications.
  services.gnome.gnome-keyring.enable = true;
 
  # Enable Sway.
  programs.sway = {
    enable = true;
    wrapperFeatures.gtk = true;
  };
}|name=/etc/nixos/configuration.nix|lang=nix}}
 
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.
 
A few general comments:
* 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]
 
=== 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>
security.polkit.enable = true;
</nowiki>}}
Then you may enable Sway in your Home Manager configuration. Here is a minimal example:
 
{{File|3=wayland.windowManager.sway = {
    enable = true;
    wrapperFeatures.gtk = true; # Fixes common issues with GTK 3 apps
    config = rec {
      modifier = "Mod4";
      # Use kitty as default terminal
      terminal = "kitty";
      startup = [
        # Launch Firefox on start
        {command = "firefox";}
      ];
    };
  };|name=/etc/nixos/home.nix|lang=nix}}
 
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.
 
You may need to activate dbus manually from .zshrc to use i.e: dunst, see [https://discourse.nixos.org/t/dunst-crashes-if-run-as-service/27671/2 Dunst crashes if run as service]
 
=== Systemd services ===
Kanshi is an output configuration daemon. As explained above, we don't run Sway itself as a systemd service. There are auxiliary daemons that we do want to run as systemd services, for example Kanshi [https://gitlab.freedesktop.org/emersion/kanshi], which implements monitor hot swapping. It would be enabled as follows:
{{file|/etc/nixos/configuration.nix|nix|<nowiki>
  # kanshi systemd service
  systemd.user.services.kanshi = {
    description = "kanshi daemon";
    environment = {
      WAYLAND_DISPLAY="wayland-1";
      DISPLAY = ":0";
    };
    serviceConfig = {
      Type = "simple";
      ExecStart = ''${pkgs.kanshi}/bin/kanshi -c kanshi_config_file'';
    };
  };
</nowiki>}}
 
{{file|sway config|bash|
# give Sway a little time to startup before starting kanshi.
exec sleep 5; systemctl --user start kanshi.service
}}
When you launch Sway, the systemd service is started.
 
=== Using a greeter ===
Installing a greeter based on [[greetd]] is the most straightforward way to launch Sway.
 
==== TUIGreet ====
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";                                                 
    };                                                                 
  };                                                                   
};                                                                     
</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 ===
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">
programs.sway = {
services.getty = {
   enable = true;
   autologinUser = "your_username";
   wrapperFeatures.gtk = true; # so that gtk works properly
   autologinOnce = true;
  extraPackages = with pkgs; [
    swaylock
    swayidle
    wl-clipboard
    mako # notification daemon
    alacritty # Alacritty is the default terminal in the config
    dmenu # Dmenu is the default in the config but i recommend wofi since its wayland native
  ];
};
};
environment.loginShellInit = ''
    [[ "$(tty)" == /dev/tty1 ]] && sway
'';
</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"];
</nowiki>}}
=== Secret Service ===
It is recommended to enable a secret service provider such as [https://wiki.gnome.org/Projects/GnomeKeyring Gnome Keyring]. For more information on secret services check the [[Secret Service]] page.
Install and enable:
{{File|3=services.gnome.gnome-keyring.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}
In order to unlock the keyring through logins from greeters and screen locking utilities you will need to enable them through PAM.
{{File|3=security.pam.services = {
  greetd.enableGnomeKeyring = true;
  swaylock.enableGnomeKeyring = true;
  # If using a display manager such as GDM
  #gdm.enableGnomeKeyring = true;
};|name=/etc/nixos/configuration.nix|lang=nix}}
== Configuration ==
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 ===
Changing layout for all keyboards to German (de):<syntaxhighlight lang="console">
input * xkb_layout "de"
</syntaxhighlight>The same thing accomplished in Home Manager:<syntaxhighlight lang="nix">
wayland.windowManager.sway.input."*".xkb_layout = "de";
</syntaxhighlight>
</syntaxhighlight>


=== Home Manager ===
=== High-DPI scaling ===
[https://rycee.gitlab.io/home-manager/options.html#opt-wayland.windowManager.sway.enable Home Manager options for sway]
Changing scale for all screens to factor 1.5:<syntaxhighlight lang="console">
output * scale 1.5
</syntaxhighlight>


<syntaxhighlight lang="nix">
=== Brightness and volume ===
wayland.windowManager.sway = {
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>
users.users.yourusername.extraGroups = [ "video" ];
programs.light.enable = true;
environment.systemPackages = [ pkgs.pulseaudio ];
</nowiki>}}
 
{{file|||
 
# Brightness
bindsym XF86MonBrightnessDown exec light -U 10
bindsym XF86MonBrightnessUp exec light -A 10
 
# Volume
bindsym XF86AudioRaiseVolume exec 'pactl set-sink-volume @DEFAULT_SINK@ +1%'
bindsym XF86AudioLowerVolume exec 'pactl set-sink-volume @DEFAULT_SINK@ -1%'
bindsym XF86AudioMute exec 'pactl set-sink-mute @DEFAULT_SINK@ toggle'
|name=Sway Config|lang=bash}}Or alternatively in Home Manager:
{{File|3=wayland.windowManager.sway = {
   enable = true;
   enable = true;
   wrapperFeatures.gtk = true ;
   config = {
};
    keybindings = {
home.packages = with pkgs; [
      # Brightness Controls
   swaylock
      "XF86MonBrightnessDown" = "exec light -U 10";
  swayidle
      "XF86MonBrightnessUp" = "exec light -A 10";
  wl-clipboard
       
  mako # notification daemon
      # Volume Controls
  alacritty # Alacritty is the default terminal in the config
      "XF86AudioRaiseVolume" = "exec pactl set-sink-volume @DEFAULT_SINK@ +1%";
   dmenu # Dmenu is the default in the config but i recommend wofi since its wayland native ];
      "XF86AudioLowerVolume" = "exec pactl set-sink-volume @DEFAULT_SINK@ -1%";
]
      "XF86AudioMute" = "exec pactl set-sink-mute @DEFAULT_SINK@ toggle";
    };
  };
};|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 ==
 
=== Cursor is missing icons or too tiny on HiDPI displays ===
 
==== With programs.sway ====
<syntaxhighlight lang="nix>
{
  programs.sway.extraPackages = with pkgs; [
    adwaita-icon-theme # mouse cursor and icons
    gnome-themes-extra # dark adwaita theme
    ...
   ];
}
</syntaxhighlight>
 
In ~/.config/sway/config
<syntaxhighlight>seat "*" xcursor_theme Adwaita 32</syntaxhighlight>
 
==== With 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}}
 
=== 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>
 
  fonts = {
    packages = with pkgs; [
      noto-fonts
      noto-fonts-cjk
      noto-fonts-emoji
      font-awesome
      source-han-sans
      source-han-sans-japanese
      source-han-serif-japanese
    ];
    fontconfig.defaultFonts = {
      serif = [ "Noto Serif" "Source Han Serif" ];
      sansSerif = [ "Noto Sans" "Source Han Sans" ];
    };
  };
 
</syntaxhighlight>
</syntaxhighlight>


== Info ==
=== Swaylock cannot be unlocked with the correct password ===


=== Clipboard ===
Add the following to your NixOS configuration.


For clipboard support
<syntaxhighlight lang="nix>
<syntaxhighlight lang="nix">
  security.pam.services.swaylock = {};
environment.systemPackages = with pkgs; [ wl-clipboard ];
</syntaxhighlight>
</syntaxhighlight>


to use [https://github.com/brunelli/wl-clipboard-x11/ wl-clipboard-x11] which is a wrapper to use wl-clipboard as a drop-in replacement to X11 clipboard tools
The <code>programs.sway.enable</code> option does this automatically.
 
=== Inferior performance compared to other distributions ===
 
Enabling realtime may improve latency and reduce stuttering, specially in high load scenarios.


<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
nixpkgs.overlays = [
security.pam.loginLimits = [
   (self: super: {
   { domain = "@users"; item = "rtprio"; type = "-"; value = 1; }
    wl-clipboard-x11 = super.stdenv.mkDerivation rec {
    pname = "wl-clipboard-x11";
    version = "5";
 
    src = super.fetchFromGitHub {
      owner = "brunelli";
      repo = "wl-clipboard-x11";
      rev = "v${version}";
      sha256 = "1y7jv7rps0sdzmm859wn2l8q4pg2x35smcrm7mbfxn5vrga0bslb";
    };
 
    dontBuild = true;
    dontConfigure = true;
    propagatedBuildInputs = [ super.wl-clipboard ];
    makeFlags = [ "PREFIX=$(out)" ];
    };
 
    xsel = self.wl-clipboard-x11;
    xclip = self.wl-clipboard-x11;
  })
];
];
</syntaxhighlight>
</syntaxhighlight>
{{Note|This will recompile all packages that have xclip or xsel in their dependencies|warn}}


=== Polkit ===
Enabling this option allows any program run by the "users" group to request real-time priority.
 
=== WLR Error when trying to launch Sway ===
 
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.}}


<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
environment.systemPackages = with pkgs; [ polkit_gnome ];
hardware.graphics.enable = true;
</syntaxhighlight>
</syntaxhighlight>


nix generated sway config
=== Systemd user services missing environment variables (PATH, etc) ===
When sway is launched with out display manager systemd won't inherit the users environment variables. To fix this add the following to your home-manager configuration:
{{File|3=wayland.windowManager.sway.systemd.variables = ["--all"];|name=home.nix|lang=nix}}
 
=== Touchscreen input bound to the wrong monitor in multi-monitor setups ===
 
See this [https://github.com/swaywm/sway/issues/6590#issue-1021207180 GitHub issue for Sway] and the solution give in [https://github.com/swaywm/sway/issues/6590#issuecomment-938724355 this response].
 
Using [[Home Manager]] add the following to your Sway configuration:
<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
${pkgs.polkit_gnome}/libexec/polkit-gnome-authentication-agent-1
  wayland.windowManager.sway = {
    [...]
    config = {
      [...]
      input = {
        [...]
        "type:touch" = {
          # Replace touchscreen_output_identifier with the identifier of your touchscreen.
          map_to_output = touchscreen_output_identifier;
        };
      };
    };
  };
</syntaxhighlight>
</syntaxhighlight>


normal sway config
=== GTK apps take an exceptionally long time to start ===
<syntaxhighlight lang="bash">
This occurs because GTK apps make blocking calls to freedesktop portals to be displayed. If Sway is not integrated with dbus and systemd, it will not be able to communicate via the <code>org.freedesktop.portal.Desktop</code> portal. To fix this, see the [[Sway#Using NixOS|description]] of default Sway configurations earlier. Adding the following to your sway configuration, if it is not already present, may resolve the issue:
# NixOS
include /etc/sway/config.d/*
exec /run/current-system/sw/libexec/polkit-gnome-authentication-agent-1
 
# Home Manager
===dbus-issues: no icons in tray, can't open files from Nautilus with the right program===
exec ~/.nix-profile/libexec/polkit-gnome-authentication-agent-1
</syntaxhighlight>


=== Systemd integration ===
If you're using Gnome-Apps like Nautilus on NixOS with Sway, you might run into issue with settings standard applications to open files from Nautilus (e.g. there being no way of linking PDF to your preferred PDF-reader). You might  also experience tray icons not showing up in your bar.


In an article on the sway wiki [https://github.com/swaywm/sway/wiki/Systemd-integration], a way to integrate Sway with systemd user services is proposed. Starting sway that way has some benefits:
This is fixed by running <code>dbus-update-activation-environment --all</code> after starting your session. Make it permanent by adding <code>exec dbus-update-activation-environment --all</code> to your sway config file.


* Logging for Sway is done the same way it is done for every other user service.
== Tips and tricks ==
* Services like Waybar, kanshi, redshift can depend on <code>graphical-session.target</code> and can therefore be started as their own user service, including convenient service management and logging.


'''Don't forget to additionally start <code>sway-session.target</code>with one of the methods described in the sway wiki.'''
=== Toggle monitor modes script ===
<syntaxhighlight lang="nix">
Following script toggles screen / monitor modes if executed. It can also be mapped to a specific key in Sway.
{ config, pkgs, lib, ... }: {


  programs.sway = {
First add the Flake input required for the script<syntaxhighlight lang="nix">
    enable = true;
{
     extraPackages = with pkgs; [
  inputs = {
      swaylock # lockscreen
     [...]
      swayidle
     wl-togglescreens.url = "git+https://git.project-insanity.org/onny/wl-togglescreens.git?ref=main";
      xwayland # for legacy apps
      waybar # status bar
      mako # notification daemon
      kanshi # autorandr
     ];
   };
   };


   environment = {
   outputs = {self, nixpkgs, ...}@inputs: {
     etc = {
     nixosConfigurations.myhost = inputs.nixpkgs.lib.nixosSystem {
       # Put config files in /etc. Note that you also can put these in ~/.config, but then you can't manage them with NixOS anymore!
       system = "x86_64-linux";
       "sway/config".source = ./dotfiles/sway/config;
      specialArgs.inputs = inputs;
      "xdg/waybar/config".source = ./dotfiles/waybar/config;
      [...]
      "xdg/waybar/style.css".source = ./dotfiles/waybar/style.css;
</syntaxhighlight>Map the script binary to a specific key<syntaxhighlight lang="nix">
{ config, pkgs, lib, inputs, ... }:{
  home-manager.users.onny = {
    programs = {
       [...]
      wayland.windowManager.sway = {
        enable = true;
        config = {
          [...]
          keybindings = lib.mkOptionDefault{
            [...]
            "XF86Display" = "exec ${inputs.wl-togglescreens.packages.x86_64-linux.wl-togglescreens}/bin/wl-togglescreens";
          };
        };
      };
     };
     };
  };
</syntaxhighlight>


  # Here we but a shell script into path, which lets us start sway.service (after importing the environment of the login shell).
=== Screenshots ===
  environment.systemPackages = with pkgs; [
Screenshots using grim, slurp, and [https://github.com/XodTech/grimshot grimshot] for selection screenshots/full screen screenshots.
    (
      pkgs.writeTextFile {
        name = "startsway";
        destination = "/bin/startsway";
        executable = true;
        text = ''
          #! ${pkgs.bash}/bin/bash


          # first import environment variables from the login manager
Install tools
          systemctl --user import-environment
{{File|3=environment.systemPackages = with pkgs; [
          # then start the service
  grim
          exec systemctl --user start sway.service
  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 {


  systemd.user.targets.sway-session = {
      # Super + Shift + S
    description = "Sway compositor session";
      # Screenshot a selection that saves to ~/Screenshots and copies to clipboard.
    documentation = [ "man:systemd.special(7)" ];
      "${modifier}+Shift+s" = "exec selection=$(slurp) && grim -g \"$selection\" - {{!}} tee ~/Screenshots/$(date +%Y-%m-%d_%H-%M-%S).png {{!}} wl-copy";
    bindsTo = [ "graphical-session.target" ];
     
    wants = [ "graphical-session-pre.target" ];
      # Print Screen Button
    after = [ "graphical-session-pre.target" ];
      # 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";


  systemd.user.services.sway = {
    description = "Sway - Wayland window manager";
    documentation = [ "man:sway(5)" ];
    bindsTo = [ "graphical-session.target" ];
    wants = [ "graphical-session-pre.target" ];
    after = [ "graphical-session-pre.target" ];
    # We explicitly unset PATH here, as we want it to be set by
    # systemctl --user import-environment in startsway
    environment.PATH = lib.mkForce null;
    serviceConfig = {
      Type = "simple";
      ExecStart = ''
        ${pkgs.dbus}/bin/dbus-run-session ${pkgs.sway}/bin/sway --debug
      '';
      Restart = "on-failure";
      RestartSec = 1;
      TimeoutStopSec = 10;
     };
     };
   };
   };
};|name=/etc/nixos/home.nix|lang=nix}}


   services.redshift = {
=== Screen sharing ===
{{File|3={ pkgs, ... }:
{
  # xdg portal + pipewire = screensharing
  xdg.portal = {
    enable = true;
    wlr.enable = true;
  };
   services.pipewire = {
     enable = true;
     enable = true;
     # Redshift with wayland support isn't present in nixos-19.09 atm. You have to cherry-pick the commit from https://github.com/NixOS/nixpkgs/pull/68285 to do that.
     alsa.enable = true;
     package = pkgs.redshift-wlr;
     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.}}


  programs.waybar.enable = true;
=== Auto mounting ===


  systemd.user.services.kanshi = {
==== USB storage devices (e.g. Flash Drives) ====
    description = "Kanshi output autoconfig ";
You can use [https://github.com/coldfix/udiskie udiskie] to automatically mount external storage medias.
    wantedBy = [ "graphical-session.target" ];
 
    partOf = [ "graphical-session.target" ];
You will need to install and enable [https://www.freedesktop.org/wiki/Software/udisks/ udisks2].
    serviceConfig = {
{{File|3=services.udisks2.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}
      # kanshi doesn't have an option to specifiy config file yet, so it looks
Then, in Home Manager you can enable udiskie.
      # at .config/kanshi/config
{{File|3=services.udiskie.enable = true;|name=/etc/nixos/home.nix|lang=nix}}
      ExecStart = ''
Udiskie will automatically mount attached USB storage media.
        ${pkgs.kanshi}/bin/kanshi
 
      '';
See related info on [[USB storage devices]].
      RestartSec = 5;
 
      Restart = "always";
==== 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 wl-gammarelay-rs ===
Add <code>wl-gammarelay-rs</code> to programs.sway.extraPackages, then add the following to sway config:
<syntaxhighlight>
# start daemon
exec wl-gammarelay-rs
 
# bind shortcut to reset brightness
bindsym $mod+Control+0 exec busctl --user set-property rs.wl-gammarelay / rs.wl.gammarelay Brightness d 1
 
# bind shortcut to dim screen for a particular output
bindsym $mod+Control+Underscore exec busctl --user set-property rs.wl-gammarelay /outputs/DP_1 rs.wl.gammarelay Brightness d 0.5
 
</syntaxhighlight>


}
=== Inhibit swayidle/suspend when fullscreen ===
Add to sway config:
<syntaxhighlight>
# When you use `for_window` the command you give is not executed
# immediately. It is stored in a list and the command is executed
# every time a window opens or changes (eg. title) in a way that
# matches the criteria.


# inhibit idle for fullscreen apps
for_window [app_id="^.*"] inhibit_idle fullscreen
</syntaxhighlight>
</syntaxhighlight>
[[Category:Window managers]]
[[Category:Applications]]
Retrieved from "https://wiki.nixos.org/wiki/Sway"