GopherProxy

	index.md - sites - public wiki contents of suckless.org
	git clone git://git.suckless.org/sites
	Log
	Files
	Refs
	---
	index.md (6431B)
	---
	1 tab
	2 ===
	3
	4 Description
	5 -----------
	6 Transforms the monocle layout into a ''tabbed'' layout if more than one …
	7 is present on the monocle view. Navigating from window to window is done…
	8 clicking on the window tabs or using the usual Mod1-j, Mod1-k keys. The …
	9 are arranged in a bar on top or at bottom of the screen, which can also …
	10 displayed in the other layouts than monocle. Three display modes can be
	11 selected at run time, auto display, permanent display and no display. In
	12 permanent mode the tab bar is always display independently of the layout…
	13 in the auto mode it is displayed only with the monocle layout and in pre…
	14 of several windows.
	15
	16 This patch can be used as an alternative to the
	17 [tabbed](//tools.suckless.org/tabbed/) tool. It differs in two ways: the
	18 ''tab'' feature is limited to the monocle mode; it works with any applic…
	19 without requiring to support the XEmbed protocol nor to define in advanc…
	20 set of applications to be supported.
	21
	22 Usage
	23 -----
	24 With the default configuration, use the key combination Mod1-w to toggle…
	25 tab bar display. Switch focus to a window with a mouse left-click on its…
	26 by using the usual Mod1-j, Mod1-k commands. Usage is also documented in …
	27 man page once the patch is applied.
	28
	29 The selected view (''tag'') is reminded at the right corner of the tab b…
	30 This feature is mainly meant to be used when the standard status bar is
	31 disabled. In case of a multi-tag view three dots are displayed without
	32 additional details.
	33
	34 Configuration and Installation
	35 ------------------------------
	36
	37 ### Quick installation
	38
	39 #### Using the default configuration file
	40
	41 * Make sure the directory where you build dwm does not contain a config.…
	42 * Apply the patch;
	43 * Run make and make install.
	44
	45 The bar is displayed only with monocle layout when the view contains mor…
	46 one window. The section "More Options" explains how to add more display
	47 options.
	48
	49 #### Using an existing customised configuration file
	50
	51 * Apply the patch;
	52 * Add the following lines to your config.h dwm configuration file:
	53
	54 /* Display modes of the tab bar: never shown, always shown, sho…
	55 /* monocle mode in presence of several windows. …
	56 /* A mode can be disabled by moving it after the showtab_nmodes…
	57 enum showtab_modes { showtab_never, showtab_auto, showtab_nmodes,…
	58 static const int showtab = showtab_auto; /* Default ta…
	59 static const Bool toptab = True; /* Fa…
	60
	61 If you use the combined pertag+tab patch, include also (adapt the number…
	62 to your `tags` array configuration):
	63
	64 /* default layout per tags */
	65 /* The first element is for all-tag view, following i-th element…
	66 /* tags[i]. Layout is referred using the layouts array index.*/
	67 static int def_layouts[1 + LENGTH(tags)] = { 0, 0, 0, 0, 0, 0, …
	68 * Run make and make install.
	69
	70 The tab bar is displayed only with the monocle layout when the view cont…
	71 more than one window. The Mod1-w key and the mouse support are not inclu…
	72 this configuration. Activation of these options is explained in the next
	73 section.
	74
	75 ### More Options
	76
	77 Pressing the key Mod1-w will cycle over the display modes of the tab bar
	78 described below with the following element added to the `keys` array:
	79
	80 { MODKEY, XK_w, tabmode, {-1} }
	81
	82 Selection of a window by a mouse left-click on its tab is enabled by add…
	83 following element to the `buttons` array:
	84
	85 { ClkTabBar, 0, Button1, focuswin, {0} },
	86
	87 An example on how to insert these lines can be found in the default conf…
	88 template, config.def.h.
	89
	90 The tab bar includes three display options: always, never, auto. In auto…
	91 the tab bar is displayed only with the monocle layout and when the view
	92 contains more than one window. The modes available at run time can be se…
	93 by changing the order of the elements in the `showtab_mode` enum of the
	94 config.h configuration file: the modes before `showtab_nmodes` are enabl…
	95 ones after are disabled. The default mode is specified in the `showtab`
	96 variable, it must be one of the enabled modes.
	97
	98 Note: keyboard shortcuts to switch to a given display mode can be define…
	99 using the `tabmode` function like in the definition of the `Mod1-w` key
	100 provided above and passing as argument the display mode (`showtab_never`,
	101 `showtab_always`, `showtab_auto`) instead of -1.
	102
	103 The tab bar can be displayed on top or at bottom of the screen, which is
	104 controlled by the 'toptab' variable. If the tab bar is displayed at bott…
	105 then it is recommended to set the variable `resizehints` of the config.h…
	106 to False. This setting prevents possible gap between the windows and the…
	107 bar. You can find more details about this variable and gap between windo…
	108 the dwm FAQ.
	109
	110 Download
	111 --------
	112 * Tab patch alone
	113 * For dwm 6.1: [dwm-6.1-tab-v2b.diff](dwm-6.1-tab-v2b.diff)
	114 * For dwm from the git master branch: [dwm-tab-v2b-20210810-7162335.di…
	115 * For dwm 6.2: [dwm-6.2-tab-v2b.diff](dwm-6.2-tab-v2b.diff)
	116 * i3 like tabs for dwm master branch: [dwm-tab-i3like-20211121-a786211…
	117 * Combined patch of tab and the [pertag](../pertag/) patch from Jan Chri…
	118 Ebersbach.
	119 * Follow the [link](../pertag/) for the description of this patch and …
	120 credits. The possibility to define the default layout per view has b…
	121 * For dwm 6.1: [dwm-6.1-pertag-tab-v2b.diff](dwm-6.1-pertag-tab-v2b.di…
	122 * For dwm from the git master branch:
	123 [dwm-tab-v2b-pertab-56a31dc.diff](dwm-tab-v2b-pertab-56a31dc.diff)
	124
	125 Change log
	126 ----------
	127 * Add i3 like tabs that cover whole screen width
	128 * Fixed the standalone tab patch not applying to the current git master.
	129 * v2b Fixed in the pertag-tab patch the support for per-tag default …
	130 specification. No change in the tab only patch.
	131 * v2a Typo corrected in the man page. For the combined pertag-tab pa…
	132 specification of a default layout per-tag layout was added in the conf…
	133 configuration file, but it was not taken into account properly. The ve…
	134 fixed this issue.
	135 * v2 First public version.
	136
	137 Authors
	138 -------
	139 * Philippe Gras - `<philippe dot gras at free dot fr>`
	140 * Varun Iyer (6.2 ver) - `<[email protected]>`
	141 * howoz - `<[email protected]>`