sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (1730B)


      1 visualbell - Deluxe Edition
      2 ===========================
      3 
      4 Description
      5 -----------
      6 Briefly renders a configurable visual indication on terminal bell event.
      7 
      8 Notes
      9 -----
     10 * There are two variants available for download: basic and enhanced.
     11 * The enhanced version file already includes the basic version in it, and
     12   supports the basic options too.
     13 * Both variants can be applied with either `git am <patch-file>` or ` patch -p1
     14   < <patch-file>`.
     15 * Visual bell is disabled by default, and can be enabled/configured via
     16   `config.h`. If you already have this file, you'll need to add the visual-bell
     17   values by copying them from `config.def.h` - which also includes their docs.
     18 
     19 ### The basic variant supports:
     20 * Invert the whole screen (default).
     21 * Invert only the outer (border) cells for a less jarring effect.
     22 * Configuring the flash duration (default: 100ms).
     23 
     24 ### The enhanced variant:
     25 This version experiments with a more graphical indication, by adding support
     26 for rendering a filled circle (needs to be chosen at `config.h`), which can be
     27 configured for:
     28 
     29 * Position: any corner/edge, center of the screen, or anything in between.
     30 * Size: relative to the window width or to the cell width.
     31 * Colors: base and outline.
     32 
     33 The enhanced variant allows, for instance, to render what looks like a LED
     34 indicator at a tmux status bar, with correct cell height, and can be positioned
     35 at the side/middle of a top/bottom bar, etc.
     36 
     37 Download
     38 --------
     39 * [st-visualbell2-basic-2018-10-16-30ec9a3.diff](st-visualbell2-basic-2018-10-16-30ec9a3.diff)
     40 * [st-visualbell2-enhanced-2018-10-16-30ec9a3.diff](st-visualbell2-enhanced-2018-10-16-30ec9a3.diff)
     41 
     42 Author
     43 ------
     44 * Avi Halachmi (:avih) - [https://github.com/avih](https://github.com/avih)