summary refs log tree commit diff
path: root/bin/README
diff options
context:
space:
mode:
Diffstat (limited to 'bin/README')
-rw-r--r--bin/README156
1 files changed, 156 insertions, 0 deletions
diff --git a/bin/README b/bin/README
new file mode 100644
index 00000000..c15f6f5a
--- /dev/null
+++ b/bin/README
@@ -0,0 +1,156 @@
+
+Tools primarily targetting Darwin and FreeBSD. Some don't build on Linux
+and some only build on Linux. All code licensed AGPLv3. See LICENSE.
+
+                                  bri
+
+Backlight brightness control for Linux through /sys/class/backlight.
+
+    bri 255
+    bri ---
+    bri ++
+
+                               dtch/atch
+
+Session detach and attach. Simple implementation of part of screen(1) by
+lending out the master end of a PTY over a UNIX domain socket. Detach
+with ^Q.
+
+    dtch a nvim & disown
+    atch a
+
+                                 fbatt
+
+Battery charge indicator panel for the Linux framebuffer through
+/sys/class/power_supply.
+
+                                fbclock
+
+Clock panel for the Linux framebuffer. Renders PSF2 bitmap fonts.
+
+                                  gfxx
+
+Graphics data explorer. Build with GFX={cocoa,fb,x11}. Dumps PNGs.
+
+    -c {indexed,grayscale,rgb}    set color space
+    -p PATH                       load palette
+    -e {l,b}                      set byte order
+    -E {l,b}                      set bit order
+    -b NNNN                       set pad, R, G, B bits
+    -n N                          set offset
+    -f                            flip
+    -m                            mirror
+    -w N                          set width
+    -z N                          set scale
+    -o PREFIX                     set output prefix
+
+    q      quit
+    x      dump one frame
+    X      dump each frame
+    o      print options
+    []     switch color spaces
+    p      sample palette
+    P      dump palette
+    {}     switch bits presets
+    e      swap byte order
+    E      swap bit order
+    hl     offset by byte
+    jk     offset by pixel
+    HL     offset by row
+    JK     offset by square
+    ,.     adjust width
+    <>     half/double width
+    f      flip
+    m      mirror
+    -+     zoom
+    0-9    set bits
+
+                                 glitch
+
+PNG glitcher based on pngo.
+
+    -c         write to stdout
+    -o PATH    write to file
+    -p         broken Paeth predictor
+    -f         filter when reconstructing
+    -r         reconstruct when filtering
+    -d LIST    declare pattern of comma-separated filters
+    -a LIST    apply pattern of comma-separated filters
+
+                                  hnel
+
+The tr(1) of PTYs, for remapping keys. Originally for preserving HJKL in
+alternate keyboard layouts. Toggle remapping with ^S.
+
+    hnel '[]{}' '{}[]' vi
+
+                                  klon
+
+Klondike solitaire for curses. BSD-only for arc4random_uniform.
+
+    q   quit
+    u   undo
+    ' ' draw
+    w   waste
+    a-d foundations
+    1-7 tableau
+    ^M  auto-foundation
+
+                           pbd/pbcopy/pbpaste
+
+TCP server which pipes into macOS pbcopy(1) and from pbpaste(1), and
+pbcopy and pbpaste implementations that connect to it. Used to share
+the macOS pasteboard over SSH with RemoteForward 7062 127.0.0.1:7062.
+This used to make nvim's "+ register work but they seem to have changed
+their detection.
+
+    pbd & disown
+    ssh tux.local
+    pbpaste
+
+                                  pngo
+
+PNG optimizer. Does not support interlaced PNGs.
+
+ - Discards ancillary chunks
+ - Discards unnecessary alpha channel
+ - Converts unnecessary truecolor to grayscale
+ - Indexes color if possible
+ - Reduces bit depth if possible
+ - Applies a simple filter type heuristic
+ - Applies zlib's best compression
+
+    pngo foo.png
+    pngo -o bar.png foo.png
+    pngo -c foo.png | xx
+
+                                 scheme
+
+Color scheme for terminals.
+
+    -a  generate ANSI palette
+    -t  generate Terminal.app palette
+    -x  output hex
+    -g  output PNG
+
+                                  wake
+
+Broadcasts a wake-on-LAN packet to one of my machines.
+
+                                 watch
+
+Executes a command each time files change. BSD-only for kqueue(2).
+
+    watch watch.c make
+    watch wake.c watch.c -- make wake watch
+
+                                   xx
+
+Hexdump tool.
+
+    -a          toggle ASCII
+    -c N        set columns
+    -g N        set grouping
+    -r          reverse hexdump
+    -s          toggle offsets
+    -z          skip zeros