Differences between revisions 1 and 3 (spanning 2 versions)
Revision 1 as of 2019-07-26 17:17:00
Size: 2897
Editor: ?JeromeBardot
Comment:
Revision 3 as of 2020-05-20 00:32:10
Size: 2841
Editor: PaulWise
Comment: whitespace, link fixes
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= What is SWAY? = = What is Sway? =
Line 3: Line 3:
The SWAY Window Manager ([[https://swaywm.org/|swaywm]]), is a tiling Wayland compositor and a drop-in replacement for the [[https://wiki.debian.org/i3|i3 window manager]] for X11. It works with your existing i3 configuration and supports most of i3's features, plus a few extras. The [[https://swaywm.org/|Sway Window Manager]] is a tiling Wayland compositor and a drop-in replacement for the [[i3|i3 window manager]] for X11. It works with your existing i3 configuration and supports most of i3's features, plus a few extras.
Line 5: Line 5:
SWAY in Debian Sway is not available as an option in the Debian Installer but can be added post-installation in [[DebianBullseye|Debian 11/Bullseye]] and newer.
Line 7: Line 7:
SWAY is not included in any of the official Debian installers and is not available in the main stable (Buster) repositories. Sway '''does not support''' the proprietary NVIDIA drivers in any form.
Line 9: Line 9:
= Installation from unstable and experimental = <<TableOfContents(4)>>
Line 11: Line 11:
The following instruction have been test on Debian testing with an existing i3wm but it will work if you use something else (the configuration will just be a little more time consuming). Please check in your current repository before continue. == Installation from unstable and experimental ==
Line 13: Line 13:
Add repositories and update package list Installing Sway from the repos in Debian 11 and newer is often as easy as typing:
Line 15: Line 16:
# echo 'deb http://ftp.debian.org/debian experimental main contrib non-free' > /etc/apt/sources.list.d/experimental.list
# echo 'deb http://ftp.debian.org/debian unstable main contrib non-free' > /etc/apt/sources.list.d/unstable.list
# apt update
}}}
Install requirement and sway
{{{
# apt-get -t unstable install swaybg
# apt-get -t experimental install sway
}}}
Install more tools to feet your needs (lockscreen, screenshot) :
{{{
# apt install swayidle swaylock grim slurp
# apt install sway
Line 29: Line 19:
Please at this step not start your session on sway or you will probably be stuck. Do the configuration which permit to use mouse and essential keyboard shortcut. This brings in a minimal installation. Additional packages are also available, such as:
Line 31: Line 21:
= Configuration =  * DebPkg:sway-backgrounds - This package contains a set of desktop backgrounds that come with Sway.
 * DebPkg:swaybg - Sway's wallpaper utility for Wayland compositors.
 * DebPkg:swayidle - Sway's idle management daemon. {{{swayidle}}} listens for idle activity on your Wayland compositor and executes tasks on various idle-related events.
 * DebPkg:swaylock - Sway's screenlocking utility for Wayland.
Line 33: Line 26:
== From i3 ==
If like me you come from i3 you should first read the official (small) [[ https://github.com/swaywm/sway/wiki/i3-Migration-Guide | documentation]].
At this step, do not start your session on Sway as you will most likely be stuck. Configure it first.
Line 36: Line 28:
So first you need to migrate existing files : ----

== Configuration ==

=== From i3 ===

If you're coming from i3, it's best to read the brief [[ https://github.com/swaywm/sway/wiki/i3-Migration-Guide|official i3 migration guide]].

To migrate existing i3 files:
Line 43: Line 43:
At this point you need to edit your ~/.config/sway/config to migrate i3 stuff to sway one. It’s time to follow [[ https://github.com/swaywm/sway/wiki/i3-Migration-Guide | documentation]]. You also need to have your keyboard layout information. This can help:
Line 45: Line 45:
You also have to had your keybord layout information.
Line 49: Line 48:
Can help you.
Line 51: Line 49:
Add something like that in you the ~/.config/sway/config file. Add something like this in your {{{~/.config/sway/config}}} file:
Line 61: Line 59:
and also You probably also want this in your Sway configuration file:
Line 67: Line 65:
When it’s done you will disconnect yourself from i3 session and log back to sway.
Maybe you have to fix some small issues.
When it’s done, you can disconnect yourself from your i3 session and log back to Sway.
Line 70: Line 67:
=== From scratch ===
Line 71: Line 69:
== From scratch == The best reference for configuring Sway from scratch can be found on their official wiki: https://github.com/swaywm/sway/wiki
Line 73: Line 71:
Not try myself but i think a good start is : ----
Line 75: Line 73:
{{{
$ mkdir ~/.config/sway
$ cp /etc/sway/config ~/.config/sway/config
$ cat ~.Xresources >> ~/.Xdefaults
}}}
== See also ==
Line 81: Line 75:
[[https://swaywm.org|Official Sway homepage]]
Line 82: Line 77:
== More info == [[https://github.com/swaywm/sway/wiki|Official Sway wiki (Github)]]
Line 84: Line 79:
for more info you can check the sway [[https://github.com/swaywm/sway/wiki|wiki]] [[WikiPedia:Sway (window manager)|Sway on Wikipedia]]

=== Debian-specific information ===

[[DebianBug:sway|Bugs]]

[[DebianPts:sway|Package tracker]]

[[DebianMan:sway|Manual page]]

[[https://security-tracker.debian.org/tracker/source-package/sway|Security tracker]]

What is Sway?

The Sway Window Manager 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.

Sway is not available as an option in the Debian Installer but can be added post-installation in Debian 11/Bullseye and newer.

Sway does not support the proprietary NVIDIA drivers in any form.

Installation from unstable and experimental

Installing Sway from the repos in Debian 11 and newer is often as easy as typing:

# apt install sway

This brings in a minimal installation. Additional packages are also available, such as:

  • sway-backgrounds - This package contains a set of desktop backgrounds that come with Sway.

  • swaybg - Sway's wallpaper utility for Wayland compositors.

  • swayidle - Sway's idle management daemon. swayidle listens for idle activity on your Wayland compositor and executes tasks on various idle-related events.

  • swaylock - Sway's screenlocking utility for Wayland.

At this step, do not start your session on Sway as you will most likely be stuck. Configure it first.


Configuration

From i3

If you're coming from i3, it's best to read the brief official i3 migration guide.

To migrate existing i3 files:

$ mkdir ~/.config/sway 
$ cp ~/.config/i3/config ~/.config/sway/config
$ cat ~.Xresources >> ~/.Xdefaults

You also need to have your keyboard layout information. This can help:

$ swaymsg -t get_inputs

Add something like this in your ~/.config/sway/config file:

 input * xkb_layout "us,de,ru"
 input * xkb_variant "colemak,,typewriter"
 input * xkb_options "grp:win_space_toggle"
 input "MANUFACTURER1 Keyboard" xkb_model "pc101"
 input "MANUFACTURER2 Keyboard" xkb_model "jp106"

You probably also want this in your Sway configuration file:

include /etc/sway/config.d/*

When it’s done, you can disconnect yourself from your i3 session and log back to Sway.

From scratch

The best reference for configuring Sway from scratch can be found on their official wiki: https://github.com/swaywm/sway/wiki


See also

Official Sway homepage

Official Sway wiki (Github)

Sway on Wikipedia

Debian-specific information

Bugs

Package tracker

Manual page

Security tracker