/stabbed

Very simple script invoking suckless tabbed with st, resulting in a terminal with tabs support built-in.

Primary LanguageMakefileMIT LicenseMIT

stabbed Screenshot

stabbed is a very simple script invoking suckless tabbed with st, resulting in a terminal with tabs support built-in.
Patches and custom configuration are provided to achieve the desired behavior.

Requirements

In order to build both tabbed and st, you need the Xlib header files.
Alpha patch(opacity) requires an X composite manager (e.g. xcompmgr, picom).

Patches

tabbed

A custom patch has been created, to work with latest master, combining the following patches:

  1. alpha
  2. drag

st

A custom patch has been created, to work with latest master, combining the following patches:

  1. alpha
  2. blinking cursor
  3. bold is not bright
  4. scrollback
  5. scrollback-ringbuffer
  6. scrollback-mouse
  7. scrollback-mouse-altscreen
  8. simple-plumb
  9. universcroll

Build

On first pull, we have to also pull suckless repos, so execute:

% git submodule update --init

Then, you can build everything using the provided makefile:

% make

This will first apply all patches and then build tabbed, st and stabbed inside project folder.

Execution

To run stabbed, you have to first give the corresponding permissions to the script, and then execute it:

% chmod a+x stabbed
% ./stabbed

Installation

To install the script into your system, simply execute:

% make install

If you also want to generate and install a .desktop file for the script, execute:

% make desktop

Or in a single command:

% make install desktop

These commands will NOT install tabbed or st in your system, as the script uses the patched ones from the project folder.

Usage

Stabbed is configured to use zsh as default shell.
You can use a different shell using SHELL={shell} make flag.
To configure opacity, use OPACITY={value} make flag.
This is our custom key bindings configuration for stabbed:

Key Action
Ctrl+Shift+t Spawn new tab
Ctrl+PageUp Go to previous tab
Ctrl+PageDown Go to next tab
Ctrl+Shift+PageUp Move tab to previous position
Ctrl+Shift+PageDown Move tab to next position
Shift+PageUp Scroll up
Shift+PageDown Scroll down
Ctrl+Minus Zoom out
Ctrl+Shift+Plus Zoom in

Plumber

A custom plumber script is provided, which is invoked using mouse Button3(right click) for highlighted selection.
Sofrware used by the plumber:

  1. feh
  2. mpv
  3. hurl (requires lbtls-devel)
  4. imagemagick
  5. sacc (requires lbtls-devel)
  6. firefox or any of its forks

You can configure the script to use different software and/or expand its capabilities.

Credits

Massive thanks to the suckless team for making software that sucks less.
Original plumber script was kindly provided by parazyd.
Stabbed custom icon uses a vector kindly provided from List Heist.