Toolbox

        .                       oooo   .o8
      .o8                       `888  "888
    .o888oo  .ooooo.   .ooooo.   888   888oooo.   .ooooo.  oooo    ooo
      888   d88' `88b d88' `88b  888   d88' `88b d88' `88b  `88b..8P'
      888   888   888 888   888  888   888   888 888   888    Y888'
      888 . 888   888 888   888  888   888   888 888   888  .o8"'88b
      "888" `Y8bod8P' `Y8bod8P' o888o  `Y8bod8P' `Y8bod8P' o88'   888o

• About
• Install
• Test
• License

About

The toolbox comprises a collection of Unix shell utilities designed for regular use. Each utility adheres to POSIX (Portable Operating System Interface for Unix) and operates within the Unix shell framework shellbase:

• bak wraps rdiff-backup to create incremental backups.

• chowner changes the owner and permissions on a directory.

• copyright updates years in copyright notices.

• flactomp3 converts audio files to mp3 with tags.

• ival validates image files. ival stands for Image Validation.

• myip continuously displays the external IP address, uses dig.

• pingo adds timestamps to the ping command output.

• reel converts a video clip to a vertical (1080×1920) social media reel with a blurred background using ffmpeg. Accepts -f for input file, -o for output file, -s for start time, and -u for duration.

• speed continuously displays download and upload internet speeds, uses speedtest.

• tru stands for Transmission Remote Updater. It removes a torrent and its content, then adds it again. It can be run by cron to increase a ratio.

• ydata wraps yt-dlp: downloads, converts, renames, and stores safely. It can be run by cron.

Install

Ensure that you have added the directory /usr/local/bin to your PATH.

git clone git@github.com:rdavid/toolbox.git &&
  ./toolbox/app/install

Test

The project uses Daniel J. Bernstein’s build system redo. You can install Sergey Matveev’s goredo implementation. redo lint applies the following linters to the source files: actionlint, reuse, shellcheck, shfmt, typos, vale, yamllint.

License

toolbox is copyright David Rabkin and available under a Zero-Clause BSD license.