i3-compatible Wayland compositor
Go to file
Calvin Lee 843ad38b3c Implement Tray Icons
This commit implements the StatusNotifierItem protocol, and enables
swaybar to show tray icons. It also uses `xembedsniproxy` in order to
communicate with xembed applications.
The tray is completely optional, and can be disabled on compile time
with the `enable-tray` option. Or on runtime with the bar config option
`tray_output none`.

Overview of changes:
In swaybar very little is changed outside the tray subfolder except
that all events are now polled in `event_loop.c`, this creates no
functional difference.

Six bar configuration options were added, these are detailed in
sway-bar(5)

The tray subfolder is where all protocol implementation takes place and
is organised as follows:

tray/sni_watcher.c:
	This file contains the StatusNotifierWatcher. It keeps track of
	items and hosts and reports when they come or go.
tray/tray.c
	This file contains the StatusNotifierHost. It keeps track of
	sway's version of the items and represents the tray itself.
tray/sni.c
	This file contains the StatusNotifierItem struct and all
	communication with individual items.
tray/icon.c
	This file implements the icon theme protocol. It allows for
	finding icons by name, rather than by pixmap.
tray/dbus.c
	This file allows for asynchronous DBus communication.

See #986 #343
2017-06-07 17:49:16 -07:00
assets Recompressed PNG files 2017-01-05 21:49:28 -05:00
CMake Implement Tray Icons 2017-06-07 17:49:16 -07:00
common FreeBSD fixes 2017-06-06 09:45:50 +02:00
completions/zsh Use CMAKE_INSTALL_FULL_DATA{,ROOT}DIR 2016-12-17 01:00:39 +01:00
contrib Move awesome config to contrib/ 2017-01-14 16:03:41 -05:00
include Implement Tray Icons 2017-06-07 17:49:16 -07:00
protocols Add redshift support 2016-12-28 02:04:51 -05:00
security.d Fix #1087 2017-02-26 05:49:42 -05:00
sway Implement Tray Icons 2017-06-07 17:49:16 -07:00
swaybar Implement Tray Icons 2017-06-07 17:49:16 -07:00
swaybg Add client support for HiDPI 2016-09-05 11:36:48 -04:00
swaygrab FreeBSD fixes 2017-06-06 09:45:50 +02:00
swaylock Add -DVERSION flag for release version numbers 2017-04-26 15:56:46 +02:00
swaymsg Add -DVERSION flag for release version numbers 2017-04-26 15:56:46 +02:00
wayland Implement Tray Icons 2017-06-07 17:49:16 -07:00
.build.yml Update .build.yml 2017-04-26 22:37:15 -04:00
.clang-format Update .clang-format - not entirely usable yet 2017-01-10 23:30:34 -05:00
.editorconfig Create .editorconfig 2016-07-04 14:12:32 +02:00
.gitignore remove archive from git, add *.a to gitignore 2015-12-03 15:52:21 +02:00
.travis.yml Add libcap check to CMake 2017-04-07 03:14:16 +03:00
CMakeLists.txt Implement Tray Icons 2017-06-07 17:49:16 -07:00
config.in Update config.in 2017-04-30 22:52:19 -04:00
CONTRIBUTING.md Fix broken link in CONTRIBUTING.md 2017-01-05 15:56:40 -07:00
HACKING.md Add HACKING.md 2017-04-29 10:54:08 -04:00
LICENSE MIT license 2017-01-06 13:45:48 -05:00
README.md Mention Patreon in README.md 2017-05-11 11:47:42 -04:00
sway.desktop Add Wayland and Xorg session files 2015-08-20 23:12:34 +02:00

sway Donate with fosspay

"SirCmpwn's Wayland compositor" is a work in progress i3-compatible Wayland compositor. Read the FAQ. Join the IRC channel (#sway on irc.freenode.net).

If you'd like to support Sway development, you can contribute to my Patreon page or you can contribute to bounties for specific features. Anyone is welcome to claim a bounty and you can make a bounty for any feature you wish, and Patreon is more useful for supporting the overall health and maintenance of Sway.

Release Signatures

Releases are signed with B22DA89A and published on GitHub.

Status

Installation

From Packages

Sway is available in many distributions. Try installing the "sway" package for yours. If it's not available, check out this wiki page for information on installation for your distributions.

If you're interested in packaging Sway for your distribution, stop by the IRC channel or shoot an email to sir@cmpwn.com for advice.

Compiling from Source

Install dependencies:

  • cmake
  • wlc
  • wayland
  • xwayland
  • libinput >= 1.6.0
  • libcap
  • asciidoc
  • pcre
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 *
  • pam **
  • imagemagick (required for image capture with swaygrab)
  • ffmpeg (required for video capture with swaygrab)

*Only required for swaybar, swaybg, and swaylock

**Only required for swaylock

Run these commands:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_SYSCONFDIR=/etc ..
make
sudo make install

On systems with logind, you need to set a few caps on the binary:

sudo setcap cap_sys_ptrace=eip /usr/local/bin/sway
sudo setcap cap_sys_tty_config=eip /usr/local/bin/sway

On systems without logind, you need to suid the sway binary:

sudo chmod a+s /usr/local/bin/sway

Configuration

If you already use i3, then copy your i3 config to ~/.config/sway/config and it'll work out of the box. Otherwise, copy the sample configuration file to ~/.config/sway/config. It is usually located at /etc/sway/config. Run man 5 sway for information on the configuration.

My own dotfiles are available here if you want some inspiration, and definitely check out the wiki as well.

Running

Instead of running startx, run sway. You can run sway from within X as well, which is useful for testing.