.Dd 2026-07-14
.de oit
.It
\\$*
..
.de obi
.Bl -\\$1 -compact
.shift
.oit \\$*
..
.de obe
.obi \\$*
.El
..
.de obd
.Bd -literal -compact
\\$*
..
.de obc
.Bl -column \\$*
..
.Dt TABBED oh
.Os Linux OpenBSD |
.Nm tabbed 
.Nd suckless tabbed interface - usage and patches
.Sh COMPILE
.Bd -literal -compact
git clone https://git.suckless.org/tabbed
make
.Ed
.Sh PATCHES
.Ss KeyRelease
This patch is necessary to use the patch hidetabs.
.Bl -enum -compact
.It
.Lk https://tools.suckless.org/tabbed/patches/keyrelease/ Key Release
.It
.Li patch -p1 < tabbed-keyrelease-20191216-b5f9ec6.diff
.El
.Ss hidetabs
This patch hides tabs, and will only show them as needed for any tab action.
.Bl -enum -compact
.It
.Lk https://tools.suckless.org/tabbed/patches/hidetabs/ hidetabs
.It
.Li patch -p1 < tabbed-hidetabs-0.9.diff
.El
This patch can conflict with some programs.
Eg.: on surf, the keybinding Ctrl-m is effectively disabled and the style can not be toggled.
.Sh OPTIONS
Command line options
.obc _p_s___
.It Ctrl-Shift-[j|k] Ta : move selected tab to the left/right.
.It -c Ta : close tabbed when the last tab is closed.
.It -p[s{+-}]N Ta : position for new tabs. s implies a relative position to the current tab.
.It Ta \ \ +- specify positions from the beginning/end respectively.
.It -rN Ta : replace arg N with window id instead of sending it at the end.
.It -d Ta : detach tabbed from terminal and print window id to stdout.
.El
.Sh KEYBINDINGS
.obc ctrl_shift_ret
.It Ctrl-Shift-Return Ta : new tab
.It Ctrl-Shift-h Ta : previous tab
.It Ctrl-Shift-l Ta : next tab
.It Ctrl-` Ta : open dmenu to open a new tab or filter existing tabs.
.It Ctrl-q Ta : close tab.
.It Ctrl-[N] Ta : go to tab N (0-9).
.It F11 Ta : fullscreen.
.Sh EXAMPLES
Some programs have options to embed the window into another program.
.obc zath
.It surf Ta : -e
.It zathura Ta : -e
.It urxvt Ta : -embed
.It st Ta : -w
.El
The -r option can be used for these cases if the window id needs to be sent in a different position.
.Ss surf
Run surf opening new tabs after the current tab and closes tabbed after closing the last tab.
.Dl tabbed -ps1 -c surf -e
Same example disabling scrollbars to show the use of -r.
.Dl tabbed -ps1 -c -r2 surf -e '' -b
.Sh CAVEATS
.Ss keybindings
.obc
.It Ctrl-Shift-[j|k] Ta : conflicts with surf zoom.
.El
.Sh TODO
.obc
.It - Translate to Spanish.
.It - See if there is a way to open background tabs.
.El
.Sh SEE ALSO
.obc
.It
.Xr suckless oh ,
.Xr st oh ,
.Xr surf oh ,
.Xr zathura oh
.It VoidLinux manpages:
.Xr tabbed 1
.It links
.It - Lk https://suckless.org/ Suckless.org
.It - Lk https://tools.suckless.org/tabbed/ tabbed - suckless tabbed interface
.It - Lk https://tools.suckless.org/tabbed/patches/ tabbed patches
.It - Lk https://tools.suckless.org/tabbed/patches/keyrelease/ tabbed patch - Key Release
.It - Lk https://tools.suckless.org/tabbed/patches/hidetabs/ tabbed patch - Hide Tabs
.El
.Sh HISTORY
.obc _______
.It 2026-07-14 Ta : added missing options and fixed examples.
.It 2026-07-06 Ta : Created.
.El
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com