summary refs log tree commit diff
path: root/bin/README
blob: 0ea3970aaf10a7c69834855296b0da6d7147a002 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

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

                                 modem

PTY wrapper with a fixed baud rate of 19.2 kbps.

                           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