A collection of short programs which I wrote and find useful, but don't need their own repository
Takes a set of numbers as input, 1 per line. Outputs the 80-20 tradeoff (20% of the numbers make up 80% of the sum).
Example:
80-20 file1.dat file2.dat
seq 1 100 | 80-20
Adds two lines of english text, mod 26 (ancient-style crypto)
Lists manually installed packages with descriptions. Both normal and AUR packages are included, but AUR packages are tagged.
Displays the webcam through ASCII graphics. Just for fun.
Displays the current battery percentage as a short string for displays
Sounds beeps, even on devices with beep turned off. Pseudo-rando beeps and says the reason.
Usage:
beepz "Pomodoro"
beepz -q "Pomodoro" # Don't use TTS, just beep
Helper for za3k only. Summarizes budget categories typed in from my logbook
(za3k only) Control my home blinds.
Example:
blinds open
blinds close
blinds privacy
blinds 0 50 50
Does or reverses a classic caesar cipher, in which each letter is shifted a set number of letters through the alphabet.
Usage: caesar cipher "QEB NRFZH YOLTK CLU GRJMP LSBO QEB IXWV ALD"
In Arch Linux, lists the config files which have been altered from the default.
Checks if a block device (or file) is zero-ed.
Example:
sudo check-if-zeros /dev/sdb
Specific to me. Copies my latest google photo to the clipboard.
See 'timer'
Usage: cryptogram.py "MIH WAIHXS TFBFL OF WHLRLTWFS QAFY WIKFIYF CLFECW MIH QTCA LFWRFJC, MIH WAIHXS FVRFJC TC."
Interactive cryptogram solver.
Strips ANSI color codes out of a stream
Usage: delink FILE
. Removes a level of symlink, moving the symlink's target in place of the symlink. Can have bad side-effects, use with caution.
See also mvln
Usage: #!/usr/bin/env deshebang
at the top of a file, makes that file self-printing.
Needs to be hand-edited. Makes a regex out of any DFA.
Converts 'Usage Report.xml' from Duke energy, to a reasonable CSV format.
Usage: duke2csv
(in same directory as "Usage Report.xml")
Make a small clock at the bottom of the screen
Sync books to a FAT filesystem, making sure to rewrite names to be valid for FAT/NTFS.
Example:
SYNC_DIR="/media/sd" BOOKS_DIR="/home/zachary/books" ebooks-sync
Create, update, fetch, or delete text files on etherpad.za3k.com (or any other etherpad-lite instance).
Usage: etherpad put [<pad>]
get <pad>
delete <pad>
Embed missing fonts into a PDF.
Usage: embed-pdf-fonts <PDF>
Downloads the latest version of Arch Linux for Raspberry Pi (aka alarmpi) as a .tar.gz file and converts it to an image file which can be copied directly to an SD card.
Usage: extract-alarmpi [SOURCE.tar.gz [TARGET.img]]
Removed. Turns out this is now in coreutils and nearly identical to my program.
Generate some D&D fantasy names. Ported from https://www.fantasynamegenerators.com/, I encourage you to use the original which is much better.
Usage: fantasy-names
Usage: cat <stream | filter --negative FILENAME
blacklists anything in FILENAME, there are options for whitelisting and dealing with repeats.
Usage: find-git-repos DIRECTORY
prints all git repositories found, one per line.
Usage: find-mersenne-primes
prints the exponents of mersenne primes (prints all N where 2^N-1 is prime). To change search limits edit the file.
Usage: fragile-treediff FOLDER1 FOLDER2
Returns a success or failure error code, depending on whether two folders are exactly identical.
Usage: gcode-bounds FILE.gcode
Returns the dimensions (in mm) of a 3d-printable gcode file.
Usage: grep-percent TERM FILE
Prints the percentage of lines that match the query (0 to 100)
Searches for something on google, opening the results page in the default browser.
Prints out a physical text-only calendar from Google Calendar
Useful only to me. Tracks whether I do things like brush my teeth once a day, shave regularly, etc.
On the left is the habit; on the right is how long since I've done that. You press a single key to say "I did this task". Colors? Red is overdue, blue is "do today", green is "done recently", and grey is "no specific goals".
Usage: habit-tracker
Reports what hours I was at the computer, based on my bash history. On linux, I instead use keystroked.
Maintains a file at /var/tmp/internet_up reading "up" or "down". Run as a daemon. Useful for status bars.
Prints the last line from bash's history
Get a slice of lines from a file: lines <start> <end> <file>
or cat <file> | lines <start> <end>
.
Usage:
log DATASET
Example:
echo "Backed up the computer." | log backups
Open email links in Roundcube. Edit the file to change the URL.
Installation (as default opener):
sudo mailto-opener --install
Usage:
mailto-opener "mailto:za3k@za3k.com"
CLI calculator. Outputs the result of simple math expressions (warning: uses 'eval'). Example:
math 2+2
Outputs:
2+2 = 4
Markov-chain input on a per-word basis
> curl http://www.ccel.org/ccel/bible/kjv.txt | ./markov # King James Bible
name resteth and can never a coffin in it; it doth also vanity unto Joseph, I live: and entered into the son of the gate was Jaziz the sons also suck the son of Jehoiada, a sign.
preserved in wait with it.
the
while they
prophets?
our God, the angel, and became a loud voice, that have said, Hearken to me.
concerning his presence; let him to those that is the
Lord of the solemn feasts, as these things in the
thou succeedest them, and buy them, Thus saith unto the tribe of
that thou hast followed
Moves a files, but leaves a symlink pointing to the new location in the old place.
See also delink
Usage is at the top of a tmux config file:
#!/usr/bin/env mux
This allows for fast startup, by executing a tmux configuration file as a program.
Play randomly-generated noise through the speakers
Send a message that gets to me.
Currently shotguns:
- irc
- voice announcement
- on-screen announcement on all my computers
- audible bell ding
- push notification
- text message (sms)
Usage:
cat tasks | xargs && notify "long list of tasks done"
Outputs the (raw) random bytes from an OneRNG hardware device
I don't use a lot of graphical programs, but xdg-open (the Linux "open this file" system) tries to open stuff anyway. This provides sane defaults for those of us that like the command line.
- open-directory opens a directory in a new xterm window (in the default shell)
- edit-text-file opens a text file in your default terminal text editor (as specified in $EDITOR, or defaulting to something sane)
Install (as default program):
# Do not run these as root, or they will only set the default program for root
make open-directory-install
make open-text-file-install
Usage:
open-directory /usr/bin
open-text-file README
For amusement, my previous system defaults:
- text files started WINE, then got opened in notepad
- directories open in the KATE text editor
Returns a random password or passphrase
Usage:
passgen [-w|--word] [LENGTH]
Prints the largest page of a PDF, so you know what size paper to print on.
Usage: pdf-bounding-box PDF
Remove the last page of a pdf in-place.
Usage:
pdf-strip-last-page PDF
Return true if the internet is up (a single ping to 8.8.8.8 returns).
Do pomodoros interactively.
Optionally requires 'playsound' from pip
Makes beep sounds to let you know your power cord is unplugged, or your battery is running low. Designed to be run as a daemon.
The main feature is a robust ability to deal with muting. It will happily play sound even if the terminal bell and X bell are off, and sound is muted.
My alarm is set to 10% and 5%, and deals with having two batteries (one of which doesn't always charge).
To use, install power-beeps.service to to /etc/systemd/system/power-beeps.service, and change the path to power-beeps accordingly.
Usage: print FILE
Only useful for me. Prints the file on my printer.
My version of 'lp' doesn't like image files, etc. This converts everything to the correct format using imagemagick.
Prints a file remotely, or prints from stdin if no file is given. Will not work in isolation, needs a remote program
Generate a bunch of pseudorandom data. Useful for data integrity tests of storage.
Usage / examples:
sudo prng test-usb BLOCKDEVICE
prng stream SEED | head -c 100 >some_file
prng stdout SEED [SIZE] | prng verify stdin SEED [SIZE]
prng file SEED [SIZE]
prng verify file SEED [SIZE]
prng files COUNT [SIZE]
sha256 -c checksums
prng verify files COUNT [SIZE]
prng checksums files COUNT [SIZE] > checksums
Record daily measurements, etc to a CSV file. Asks questions from the header row of the CSV.
Usage:
quiz QUESTIONS.csv
Print a random line out of a file
Records all interactive shells using script. To use, add the magic line given to the top of your .bashrc (record-shell works on all shells, but the invocation line may need to be changed slightly for each shell)
Note that this can record SSH sessions, sudo session etc fine. However by default it does not include input (typed passwords etc).
Records to /var/log/console-recording/$USER/$DATE.log
Retry a command 5 times or until it succeeds
Rolls D&D dice.
Usage:
roll "d6 + 4"
roll d6 + 4
roll 2d10
Output:
1d6+4 = 8
1d6+4 = 6
2d10+0 = 19
Usage:
rtmux HOST
rtmux-session HOST SESSION-NAME
Attaches to a remote tmux session, or opens one if none exists.
Read the text aloud. Requires festival
.
Print a stream of text as though in a chat client.
Usage:
sayfrom SPEAKER-NAME [ANSI COLOR CODE]
Example:
sayfrom Zachary 2 <chat-FIFO
Scans a series of pages using the LiDE scanner and 'sane'. Images are auto-cropped using imagemagick if dimensions are not given.
Usage:
scan-lide [DPI] [WIDTH HEIGHT]
Example:
scan-lide 600dpi 195 155
Command-line program for performing basic set operations on lines in files. comm
can be used for some of this on sorted files but it's a little stronger.
Gives a summary of average and standard deviation of sleep times.
Example:
sleep_summary 8h40m 5h20m 7h
Like 'ssh', except it handles quoted arguments how you might expect
Set up a static ip on linux
Adds a list of numbers, one per line.
Tag images in a directory interactively, using 'feh'. One button resizes, another tags the image using an interactive program. I use this for processing scanned images.
Kitchen timer for the command line. 'countdown' just displays a time, 'timer' additionally beeps at the end
Example:
timer 5m30s
timer "20 minutes" "next pomodoro"
timer 5m30s
Display the size of a torrent file
Example:
$ unix2date 1680474618
Sun Apr 2 06:30:18 PM EDT 2023
$ unix2date 1680474618000
Sun Apr 2 06:30:18 PM EDT 2023
Check whether videos are correctly renamed and organized. Only useful to me.
Like 'watch', but outputs to a file instead of a TTY
Usage:
watch-to-file -f FILE [-n INTERVAL] COMMAND
Example:
watch-to-file -f /var/www/public/pub/status/temp.txt "/usr/local/bin/max-hdd-temp --pretty"
Use the webcam to take a single picture. Usage: webcam-picture picture.png
Counts the number of words in a file or stream.
Runs adom in a fixed-geometry window (because window geometry affects gameplay)
Takes the bitwise xor of the given files (or infinite streams), extending all files to the longest length with zeros.
Usage:
xor [--same-size] FILE1 FILE2 [FILE3...]
--same-size, returns nonzero and prints an error message if not all files are the same length
Download a youtube file to a 'master' directory, and also to the place specified. Avoids multiple downloads by checking the 'master' directory first.
Intent is to allow changing the filename format, allowing multiple downloads etc without worrying about duplicates filling up space.
Usage:
youtube-dl-master MASTER-DIRECTORY [-t TEMPLATE] -- URLS
youtube-dl-master MASTER-DIRECTORY [-t TEMPLATE] -- --batch-file FILE
{MASTER-DIRECTORY}/cookies.txt will be used if present