mirrors/sway
1
0
Fork 0
mirror of https://github.com/swaywm/sway.git synced 2025-04-25 06:40:35 +00:00
Code Issues Projects Releases Packages Wiki Activity

Updated Home (markdown)

Drew DeVault 2017-04-29 10:59:50 -04:00
parent 00d0df1114
commit 1b3d89d503
1 changed files with 11 additions and 22 deletions

33
Home.md

@ -68,9 +68,7 @@ Rotation is not currently supported. This needs to be implemented in WLC. See ht
#### Keyboard layout
You have to set the keyboard layout before starting sway, e.g. `XKB_DEFAULT_LAYOUT=de sway`
It is also possible to set other options known from `setxkbmap` with the environment variables `XKB_DEFAULT_MODEL`, `XKB_DEFAULT_LAYOUT`, `XKB_DEFAULT_VARIANT`, `XKB_DEFAULT_OPTIONS`.
This example enables switching between the american layout, and the german layout without dead keys with `Alt-Shift`. Supported parameters are defined in `/usr/share/X11/xkb/symbols/*`.
You have to set the keyboard layout before starting sway, e.g. `XKB_DEFAULT_LAYOUT=de sway`. Using a script is recommended. It is also possible to set other options known from `setxkbmap` with the environment variables `XKB_DEFAULT_MODEL`, `XKB_DEFAULT_LAYOUT`, `XKB_DEFAULT_VARIANT`, `XKB_DEFAULT_OPTIONS`. This example enables switching between the american layout, and the german layout without dead keys with `Alt-Shift`:
```
export XKB_DEFAULT_LAYOUT=us,de
@ -79,6 +77,8 @@ export XKB_DEFAULT_OPTIONS=grp:alt_shift_toggle,
sway
```
Supported parameters are defined in `/usr/share/X11/xkb/symbols/*`.
* Make caps lock work as escape: `export XKB_DEFAULT_OPTIONS=caps:escape`
* Swap escape and caps lock: `export XKB_DEFAULT_OPTIONS=caps:swapescape`
@ -150,8 +150,8 @@ URxvt*background: rgba:0000/0000/0200/c800
Be aware that this configuration will conflict with the `URxvt.reversevideo` and if you enable the reversevideo option, the text will become transparent instead of the background.
### I'm not using logind but still want DBus/PolKit/power management to work.
What can I do?
If you're using ConsoleKit2, launch sway using
@ -165,31 +165,28 @@ Alternatively, you could omit the `ck-launch-session` part.
xbacklight is, of course, a tool for X. You can use [brightnessctl](https://github.com/Hummer12007/brightnessctl) instead or just directly manipulate /sys/class/backlight.
## Troubleshooting
### Enable logging
### How do I report issues?
We will expect two things from you: your configuration and a debug log. Obtain a debug log like so:
sway -d 2> ~/sway.log
Upload this file to a pastebin and include it in bug reports, requests for support, etc.
Upload this file, along with your config, to [gist.github.com](https://gist.github.com), and include this in a GitHub issue (or when asking for help on IRC).
### I just installed sway. I can move my mouse cursor but my keyboard does not work.
Are you pressing keys that are bound to do anything? **Read the [config file](https://github.com/SirCmpwn/sway/blob/master/config.in).** If `$mod+Return` is bound to `exec urxvt` (which it is by default) - do you have Urxvt installed? Try `$mod+2` or `$mod+8` - does it switch workspaces?
### I can't run anything.
Check for keyboard shortcuts in the config file to start your launcher. Are you trying to run x applications? You probably don't have [xwayland](https://wayland.freedesktop.org/xserver.html) installed. Consult your distribution's documentation for instructions on installing xwayland.
### My keyboard shortcuts does not work.
If you're running sway on top of X11, with i3 running, i3 will intercept any key presses that would otherwise be sent to sway. If you use the exact same key bindings then sway will never receive them.
### i3-dmenu-desktop does not work.
There's a [patch](https://github.com/i3/i3/pull/2265) but it cannot be merged upstream.
@ -197,12 +194,10 @@ See [issue #511](https://github.com/SirCmpwn/sway/issues/521) for more info.
You can still apply the patch manually though:
```bash
wget 'https://patch-diff.githubusercontent.com/raw/i3/i3/pull/2265.patch'
sudo patch -p0 /usr/bin/i3-dmenu-desktop < 2265.patch
```
bash
$ wget 'https://patch-diff.githubusercontent.com/raw/i3/i3/pull/2265.patch'
$ sudo patch -p0 /usr/bin/i3-dmenu-desktop < 2265.patch
```
### My favorite application isn't displayed right, how can I fix this?
@ -210,7 +205,6 @@ $ sudo patch -p0 /usr/bin/i3-dmenu-desktop < 2265.patch
* [Debugging improperly displayed X-applications](https://github.com/SirCmpwn/sway/wiki/Debugging-improperly-displayed-X-applications)
#### Disabling client-side GTK3 decorations
Try one of the following:
@ -218,29 +212,24 @@ Try one of the following:
* Patch the application to remove decorations. See [gtk_window_set_decorated](https://developer.gnome.org/gtk3/stable/GtkWindow.html#gtk-window-set-decorated)
* Make an upstream pull-request, that makes decorations optional at runtime.
#### Disabling client-side Qt decorations
Qt currently defaults to using the X11 backend instead of its native Wayland backend. To use the Wayland backend, set `QT_QPA_PLATFORM=wayland`. Then Qt will also draw client-side decorations for all windows, to disable this, set `QT_WAYLAND_DISABLE_WINDOWDECORATION="1"`
#### Window rules to adjust sway's borders
If you want to use a particular application's built-in window decorations over the sway borders, you can write a rule like this in your config:
for_window [id="nautilus"] border none
#### Blank window in Java application.
* Try to set `_JAVA_AWT_WM_NONREPARENTING=1` in your environment. [Source](https://github.com/SirCmpwn/sway/issues/595)
### I run an [Arch Linux based distribution without systemd.](https://wiki.parabola.nu/OpenRC) and sway does not start.
Use the hook files provided [here](https://github.com/SirCmpwn/sway/wiki/Sway-without-systemd-on-Arch-Linux).
### I have a multi-gpu setup (like intel+nvidia or intel+amd) and sway does not start
Unless specified otherwise, `wlc` will choose a card for you and you could have a similar message in sway's log: