SIMPLE SOLUTIONS

ALTTAB(1) - Linux man page online | User commands

The task switcher.

Chapter
October 2017
ALTTAB(1) ALTTAB(1)

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, alt‐ tab 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_Man‐ ager_Hints#List_of_window_managers_that_support_Extended_Window_Manager_Hints. Description of fontconfig pattern https://www.freedesktop.org/software/fontconfig/fontcon‐ fig-user.html.
October 2017 ALTTAB(1)
This manual Reference Other manuals
alttab(1) referred by
refer to dwm(1) | evilwm(1) | i3(1) | ratpoison(1) | urxvt(1) | xmonad(1)
Download raw manual
Main page № 1 (+39907)
Go top