1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282
|
<!--
The source of alttab.1. Read doc/development.md.
vim:ft=markdown
Copyright 2017-2018 Alexander Kulak.
This file is part of alttab program.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved. This file is offered as-is,
without any warranty.
-->
alttab(1) -- the task switcher
==============================
## SYNOPSIS
`alttab` [`-w` <N>] [`-d` <N>] [`-sc` <N>] [`-mk` <str>] [`-kk` <str>] [`-bk` <str>] [`-mm` <N>] [`-bm` <N>] [`-t` <NxM>] [`-i` <NxM>] [`-vp` <str>] [`-p` <str>] [`-s` <N>] [`-theme` <name>] [`-bg` <color>] [`-fg` <color>] [`-frame` <color>] [`-font` <name>] [`-v`|`-vv`]
## DESCRIPTION
The task switcher designed for minimalistic window managers or standalone X11 session.
Unlike task switchers integrated in most simple WMs,
`alttab` features visual interface and convenient
tactile behaviour, switching windows on releasing Alt key.
Being lightweight and depending only on core X11 libs,
it still features customizable look and behaviour.
## OPTIONS
Most command line options have corresponding X resource, see doc/alttab.ad for example.
* `-w` <NUMBER>:
resource: alttab.windowmanager
default: autodetect, fallback to <3>
Control how to obtain window list and set focus. <NUMBER> must be between 0 and 3:
<0>: No WM, raw X.
Set this value manually, as it's not autodetected.
Only top-level viewable children of root window are listed.
Running **-w 0** under WM is discouraged: hidden windows or windows on another desktops will not be listed; instead, some strange windows may be included.
<1>: EWMH compatible.
Compatible WM list is in [SEE ALSO] below. alttab functions in xmonad (EWMH must be
allowed, details in doc/wm-setup.md), i3, evilwm, xfwm4, metacity, jwm, openbox, fluxbox,
icewm, enlightenment, blackbox, aewm, fvwm, sawfish.
The following WMs support EWMH partially but work in **-w 1** mode too:
dwm (issue #9), matchbox (issue #34), windowmaker (issue #9),
xpra (issue #37), cwm (issue #35), ctwm (issue #39), lwm (issue #40),
awesome (issue #41).
<2>: Ratpoison.
Alttab uses ratpoison own remote control capability. Additionally, alttab registers itself in its "unmanaged list" automatically.
<3>: Ancient WM.
Fallback, worse than <0>.
Search for application windows at random nodes of window tree (WM is probably reparenting)
and select only those with a name, including non-viewable (WM is probably iconifying).
May cause lag.
Tested in twm, flwm, wm2.
* `-d` <NUMBER>:
resource: alttab.desktops
default: <0>
Show windows belonging to desktops (workspaces, groups). <NUMBER> must be between 0 and 3:
<0>: Current desktop.
This is default, although in non EWMH-compatible WM, except ratpoison, it's effectively the same as <1>.
<1>: All desktops.
<2>: All desktops, excluding special (-1) one.
In various EWMH WM this desktop may be designed hidden
or containing sticky windows. In i3, it's "scratchpad".
<3>: All desktops, excluding current and special.
* `-sc` <NUMBER>:
resource: alttab.screens
default: <1>
Show windows belonging to xrandr/xinerama screens. <NUMBER> must be 0 or 1:
<0>: Current screen.
As defined according to `-vp` <pointer> or `-vp` <focus>.
<1>: All screens.
This is default.
* `-mk` <str>:
resource: alttab.modifier.keysym
default: Alt_L
Keysym of main modifier. String or number accepted.
Suitable examples: Control_L, Super_L.
* `-kk` <str>:
resource: alttab.key.keysym
default: Tab
Keysym of main key.
For example, grave (aka tilde), Escape.
* `-bk` <str>:
resource: alttab.backscroll.keysym
default: any Shift, according to ShiftMask
Keysym of backward scroll key.
* `-mm` <NUM>:
resource: alttab.modifier.mask
OBSOLETED, guessed from -mk instead.
* `-bm` <NUM>:
resource: alttab.backscroll.mask
OBSOLETED, guessed from -bk instead.
* `-t` <NNxMM>:
resource: alttab.tile.geometry
default: <112x128>
Size of a single tile (mini-window). If switcher doesn't fit the viewport (`-vp`), tile may be thinner.
* `-i` <NNxMM>:
resource: alttab.icon.geometry
default: <32x32>
Size of icons.
* `-vp` <str>:
resource: alttab.viewport
default: <focus>
Limit viewport for the switcher.
The switcher always has variable size and position,
but tries to never break out of `-vp` container,
while `-p` specifies position relative to this container.
Together these options allow for multi-monitor support.
Possible values for `-vp`:
<focus>: in multihead configuration: the monitor which shows
largest part of currently focused window. If this part is shared
with other monitors, then the smallest of these monitors is choosen.
In single head configuration: the geometry of default root window.
<pointer>: the monitor which has mouse pointer, otherwise
the same as <focus>.
The "multihead" above means more than one active XRANDR output.
They are detected at runtime, so hopefully monitors
may be attached/detached without restarting alttab.
<total>: the geometry of default root window.
If you specify this in tiling multihead, then the switcher
will be drawn relative to the entire combined screen, crossing
monitors' borders.
<WxH+X+Y>: Specific position relative to default root window.
This allows for static manual bounding if XRANDR detection fails.
Suppose X operates in tiling configuration for two 2560х1440 monitors,
resulting in combined screen of 5120x1440 size. Then the switcher
may be positioned at the center of the right monitor
with -vp 2560x1440+2560+0 -p center.
* `-p` <str>:
resource: alttab.position
default: center
Position of switcher: "center", "none" or specific position relative
to upper left corner of viewport, in the form <+X+Y>.
* `-s` <NUMBER>:
resource: alttab.icon.source
default: 2
Source of icons. <NUMBER> must be between 0 and 3:
<0>: Use icons from X11 window attributes only.
<1>: Load icon from file if not found in window attributes.
Alttab searches for PNG icons under:
/usr/share/icons
/usr/local/share/icons
~/.icons
~/.local/share/icons
Directory structure should obey freedesktop standard, but desktop files are ignored,
instead file name is expected to be equal to application class.
That is, if alttab doesn't recognize an icon for window of class foo,
as obtained by 'xprop WM_CLASS', then just drop a 32x32 icon into
/usr/local/share/icons/hicolor/32x32/apps/foo.png.
<2>: Prefer icon from file when it matches requested size better (see `-i` option).
<3>: Use icons from files only.
* `-theme` <name>:
resource: alttab.theme
default: <hicolor>
Desktop theme for application icons. Used when `-s` is 1, 2 or 3.
The following three options accept color names or <#rrggbb>. Special value <\_rnd_low> or <\_rnd_high> produce random color from lower or upper RGB space respectively.
* `-bg` <color>:
resource: alttab.background
default: <black>
Tile background color.
* `-fg` <color>:
resource: alttab.foreground
default: <grey>
Foreground color.
* `-frame` <color>:
resource: alttab.framecolor
default: <#a0abab>
Color of frame around selected tile.
* `-font` <name>:
resource: alttab.font
default: *xft:sans-10*
Label font name in format: `xft:fontconfig_pattern`, like in emacs and rxvt. See [SEE ALSO] for fontconfig pattern. It's neither GTK font pattern nor legacy XLFD.
Your Xresources database probably already has \*background, \*foreground or \*font wildcard definitions, which alttab will obey. Precedence order (preferred first):
alttab.font resource,
`-font` option,
wildcard resource like \*font in xfd: format.
* `-v`, `-vv`:
resource: no
default: silent
Verbosity.
* `-h`:
short help
##CAVEATS
Run alttab after WM, or autodetection will fail.
##AUTHOR
Copyright 2017-2018 Alexander Kulak `<sa-dev AT rainbow POINT by>`.
##REPORTING BUGS
Please [report issues on github](https://github.com/sagb/alttab/issues).
##SEE ALSO
skippy-xd(1)
[EWMH compatible WM list](https://en.wikipedia.org/wiki/Extended_Window_Manager_Hints#List_of_window_managers_that_support_Extended_Window_Manager_Hints).
[Description of fontconfig pattern](https://www.freedesktop.org/software/fontconfig/fontconfig-user.html).
|