bionic (1) alttab.1.gz

NAME

       alttab - the task switcher

SYNOPSIS

       alttab  [-w  N]  [-mm  N] [-bm N] [-mk N] [-kk N] [-t NxM] [-i NxM] [-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.

       -w NUMBER
              resource: alttab.windowmanager
              default: autodetect

              Control how to obtain window list and set focus. NUMBER may be 0, 1 or 2:

              0: No WM, raw X.

              Only  "leader"  windows  are  listed,  since Xlib has no other means to recognize main application
              window. List order is random. 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. Nevertheless,
              this mode is suitable for dwm(1) and other managers which don´t expose window list via EWMH.

              1: EWMH compatible.

              Compatible WM list is in [SEE ALSO] below. Tested in xmonad(1) (EWMH must be allowed,  details  in
              doc/xmonad.md), i3(1), evilwm(1).

              2: Ratpoison.

              Alttab  uses  ratpoison(1)  own  perfect remote control capability. Additionally, alttab registers
              itself in its "unmanaged list" automatically.

       -mm NUM
              resource: alttab.modifier.mask
              default: 8 (Mod1Mask aka left Alt)

              Main modifier mask. See /usr/include/X11/X.h.

       -bm NUM
              resource: alttab.backscroll.mask
              default: 1 (ShiftMask)

              Backward scroll modifier mask.

       -mk NUM
              resource: alttab.modifier.keysym
              default: 0xffe9 (XK_Alt_L aka left Alt)

              Keysym of main modifier alone. See /usr/include/X11/keysymdef.h. Keep in sync with -mm.

       -kk NUM
              resource: alttab.key.keysym
              default: 0xff09 (XK_Tab)

              Keysym of main key.

       -t NNxMM
              resource: alttab.tile.geometry
              default: 112x128

              Maximum size of a single tile (mini-window). If switcher doesn´t  fit  the  screen,  tile  may  be
              thinner.

       -i NNxMM
              resource: alttab.icon.geometry
              default: 32x32

              Size of icons.

       -s NUMBER
              resource: alttab.icon.source
              default: 0

              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.

              2: Prefer icon from file when it better match requested size (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(1) and rxvt(1). See [SEE ALSO]
              for fontconfig pattern. It´s neigher GTK font pattern nor legacy XLFD.

       Your Xresources database probably already have *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 it will fail to detect it.

AUTHOR

       Copyright 2017 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.

                                                  October 2017                                         ALTTAB(1)