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