tabbed

Fork of suckless' tabbed with my personal patches
git clone https://git.instinctive.eu/tabbed.git
Log | Files | Refs | README | LICENSE

tabbed.1 (3767B)


      1 .TH TABBED 1 tabbed\-VERSION
      2 .SH NAME
      3 tabbed \- generic tabbed interface
      4 .SH SYNOPSIS
      5 .B tabbed
      6 .RB [ \-a ]
      7 .RB [ \-c ]
      8 .RB [ \-d ]
      9 .RB [ \-k ]
     10 .RB [ \-s ]
     11 .RB [ \-v ]
     12 .RB [ \-g
     13 .IR geometry ]
     14 .RB [ \-n
     15 .IR name ]
     16 .RB [ \-p
     17 .RB [ s {+/-} ] \fIpos\fR ]
     18 .RB [ \-o
     19 .IR normbgcol ]
     20 .RB [ \-O
     21 .IR normfgcol ]
     22 .RB [ \-t
     23 .IR selbgcol ]
     24 .RB [ \-T
     25 .IR selfgcol ]
     26 .RB [ \-u
     27 .IR urgbgcol ]
     28 .RB [ \-U
     29 .IR urgfgcol ]
     30 .RB [ \-r
     31 .IR narg ]
     32 .RI [ "command ..." ]
     33 .SH DESCRIPTION
     34 .B tabbed
     35 is a simple tabbed container for applications which support XEmbed. Tabbed
     36 will then run the provided command with the xid of tabbed as appended
     37 argument. (See EXAMPLES.) The automatic spawning of the command can be
     38 disabled by providing the -s parameter. If no command is provided
     39 tabbed will just print its xid and run no command.
     40 .SH OPTIONS
     41 .TP
     42 .B \-a
     43 hide tab bar when there is only one client.
     44 .B \-c
     45 close tabbed when the last tab is closed. Mutually exclusive with -f.
     46 .TP
     47 .B \-d
     48 detaches tabbed from the terminal and prints its XID to stdout.
     49 .TP
     50 .B \-f
     51 fill up tabbed again by spawning the provided command, when the last tab is
     52 closed. Mutually exclusive with -c.
     53 .TP
     54 .BI \-g " geometry"
     55 defines the X11 geometry string, which will fixate the height and width of
     56 tabbed.
     57 The syntax is
     58 .RI [=][ width {xX} height ][{+-} xoffset {+-} yoffset ].
     59 See
     60 .BR XParseGeometry (3)
     61 for further details.
     62 .TP
     63 .B \-k
     64 close foreground tabbed client (instead of tabbed and all clients) when
     65 WM_DELETE_WINDOW is sent.
     66 .TP
     67 .BI \-n " name"
     68 will set the WM_CLASS attribute to
     69 .I name.
     70 .TP
     71 .BR \-p " [" s {+-}] \fIpos\fR
     72 will set the absolute or relative position of where to start a new tab. When
     73 .I pos
     74 is is given without 's' in front it is an absolute position. Then negative
     75 numbers will be the position from the last tab, where -1 is the last tab.
     76 If 's' is given, then
     77 .I pos
     78 is a relative position to the current selected tab. If this reaches the limits
     79 of the tabs; those limits then apply.
     80 .TP
     81 .BI \-r " narg"
     82 will replace the
     83 .I narg
     84 th argument in
     85 .I command
     86 with the window id, rather than appending it to the end.
     87 .TP
     88 .B \-s
     89 will disable automatic spawning of the command.
     90 .TP
     91 .BI \-o " normbgcol"
     92 defines the normal background color.
     93 .RI # RGB ,
     94 .RI # RRGGBB ,
     95 and X color names are supported.
     96 .TP
     97 .BI \-O " normfgcol"
     98 defines the normal foreground color.
     99 .TP
    100 .BI \-t " selbgcol"
    101 defines the selected background color.
    102 .TP
    103 .BI \-T " selfgbcol"
    104 defines the selected foreground color.
    105 .TP
    106 .BI \-u " urgbgcol"
    107 defines the urgent background color.
    108 .TP
    109 .BI \-U " urgfgbcol"
    110 defines the urgent foreground color.
    111 .TP
    112 .B \-v
    113 prints version information to stderr, then exits.
    114 .SH USAGE
    115 .TP
    116 .B Ctrl\-Shift\-Return
    117 open new tab
    118 .TP
    119 .B Ctrl\-Shift\-h
    120 previous tab
    121 .TP
    122 .B Ctrl\-Shift\-l
    123 next tab
    124 .TP
    125 .B Ctrl\-Shift\-j
    126 move selected tab one to the left
    127 .TP
    128 .B Ctrl\-Shift\-k
    129 move selected tab one to the right
    130 .TP
    131 .B Ctrl\-Shift\-u
    132 toggle autofocus of urgent tabs
    133 .TP
    134 .B Ctrl\-Tab
    135 toggle between the selected and last selected tab
    136 .TP
    137 .B Ctrl\-`
    138 open dmenu to either create a new tab appending the entered string or select
    139 an already existing tab.
    140 .TP
    141 .B Ctrl\-q
    142 close tab
    143 .TP
    144 .B Ctrl\-u
    145 focus next urgent tab
    146 .TP
    147 .B Ctrl\-[0..9]
    148 jumps to nth tab
    149 .TP
    150 .B F11
    151 Toggle fullscreen mode.
    152 .SH EXAMPLES
    153 $ tabbed surf -e
    154 .TP
    155 $ tabbed urxvt -embed
    156 .TP
    157 $ tabbed xterm -into
    158 .TP
    159 $ $(tabbed -d >/tmp/tabbed.xid); urxvt -embed $(</tmp/tabbed.xid);
    160 .TP
    161 $ tabbed -r 2 st -w '' -e tmux
    162 .SH CUSTOMIZATION
    163 .B tabbed
    164 can be customized by creating a custom config.h and (re)compiling the source
    165 code. This keeps it fast, secure and simple.
    166 .SH AUTHORS
    167 See the LICENSE file for the authors.
    168 .SH LICENSE
    169 See the LICENSE file for the terms of redistribution.
    170 .SH SEE ALSO
    171 .BR st (1),
    172 .BR xembed (1)
    173 .SH BUGS
    174 Please report them.