aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md45
1 files changed, 19 insertions, 26 deletions
diff --git a/README.md b/README.md
index 8c312984..664cd1bf 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,12 @@
# sway
-"**S**irCmpwn's **Way**land window manager"
+"**S**irCmpwn's **Way**land window manager" is a **work in progress**
+i3-compatible window manager for [Wayland](http://wayland.freedesktop.org/).
-sway is a **work in progress** i3-compatible window manager for
-[Wayland](http://wayland.freedesktop.org/).
+[FAQ & wiki](https://github.com/SirCmpwn/sway/wiki)
![](https://sr.ht/qxGE.png)
-Chat on #sway on irc.freenode.net
-
## Rationale
I use i3 on xorg. Wayland is coming, and [i3way](http://i3way.org/) still has
@@ -20,44 +18,39 @@ zero lines of source code after two years.
## Installation
-### Arch Linux
+### From Packages
+
+sway is not supported by many distributions yet. Here's a list of packages
+available for you to install:
-Install [aur/sway-git](https://aur.archlinux.org/packages/sway-git/).
+* [Arch Linux](https://aur.archlinux.org/packages/sway-git/).
-### Manual
+### Compiling from Source
-Dependencies:
+Install dependencies:
* cmake
* [wlc](https://github.com/Cloudef/wlc)
* xwayland
* asciidoc
-Compiling:
+Run these commands:
cmake .
make
- # sudo make install
-
-Binary shows up in `./bin` (or `/usr/local/bin` if you `make install`).
+ sudo make install
## Configuration
- mkdir ~/.config/sway
- cp ~/.config/i3/config ~/.config/sway/
-
-Or if you don't already use i3:
-
- mkdir ~/.config/sway
- cp /etc/sway/config ~/.config/sway/
-
-Edit to your liking.
-
-[See also](http://i3wm.org/docs/)
+If you already use i3, then copy your i3 config to `~/.config/sway/config` and
+it'll work out of the box. Otherwise, copy `/etc/sway/config` to
+`~/.config/sway/config`. Run `man 5 sway` for information on the configuration.
## Running
+Run this from a tty (instead of starting x):
+
sway
-If you run this while xorg is running, it'll run inside of an x window (useful
-for testing). Otherwise, it'll run wayland properly.
+If you run it from within x, it will spawn x windows instead of using your
+hardware directly (useful for development).