bling/docs/module/scratch.md

🍃 Scratchpad

An easy way to create multiple scratchpads.

A... what?

You can think about a scratchpad as a window whose visibility can be toggled, but still runs in the background without being visible (or minimized) most of the time. Many people use it to have one terminal in which to perform minor tasks, but it is the most useful for windows which only need a couple seconds in between your actual activity, such as music players or chat applications.

Usage

To initalize a scratchpad you can do something like the following:

local bling = require("bling")

local term_scratch = bling.module.scratchpad:new { 
    command = "wezterm start --class spad",           -- How to spawn the scratchpad
    rule = { instance = "spad" },                     -- The rule that the scratchpad will be searched by
    sticky = true,                                    -- Whether the scratchpad should be sticky
    autoclose = true,                                 -- Whether it should hide itself when losing focus
    floating = true,                                  -- Whether it should be floating
    geometry = {x=360, y=90, height=900, width=1200}, -- The geometry in a floating state
    reapply = false,                                  -- Whether all those properties should be reapplied on every new opening of the scratchpad
    dont_focus_before_close  = false,                 -- When set to true, the scratchpad will be closed by the toggle function regardless of whether its focused or not. When set to false, the toggle function will first bring the scratchpad into focus and only close it on a second call
}

Once initalized, you can use the object (which in this case is named term_scratch) like this:

term_scratch:toggle()   -- toggles the scratchpads visibility
term_scratch:turn_on()  -- turns the scratchpads visibility on
term_scratch:turn_off() -- turns the scratchpads visibility off