utils

README

utils

A collection of small CLI utilities written in Go.

Why

Go's tool chain is the ideal way to maintain a set of commonly used CLI utilities. They can be quickly compiled and installed whether you're in Windows, macOS, or Linux. This provides a unified and portable solution to many a scripting needs. With this setup, Go turns into a quasi-package manager for these utilities.

Utilities

• bak: Create dated backups of files or directories.
• brew-update: Update, upgrade, and clean up Homebrew packages.
• cash5: Analyze historical Cash5 draws and generate number recommendations.
• certgen: Generate self-signed TLS certificates for local testing.
• certls: Show SSL/TLS certificate details for a host and port.
• days: A CLI calendar days calculator.
• decolor: A utility that removes shell color escape codes from input stream or given file.
• dl: Download online videos using yt-dlp with a target filename.
• dos2unix: Preview or convert CRLF line endings to LF.
• fr: A simple find/replace utility.
• git-cloneall: Clone all repositories from a GitHub user or organization.
• git-pullall: Pull updates across all local Git repositories in a directory.
• git-remotev: Print each local repository with its origin remote URL.
• git-statall: Show git status across local repositories.
• jy: A lightweight JSON and YAML converter utility.
• moneycon: Financial data consolidation — reads CSV or aligned text, outputs aligned summary with totals.
• pgen: A simple generator of memorable passwords.
• pman: Run authenticated Microsoft Graph and Azure REST API requests.
• rn: A bulk file re-namer.
• rncap: Rename files by capitalizing each word in filenames.
• rnlower: Rename files by converting filenames to lowercase.
• sms: Send SMS messages using Twilio credentials from a local config file.
• tree: A lightweight directory tree printing utility.
• web: Search DuckDuckGo and open results with an interactive selector.

Quick Install

With Go installed, install all utilities at once:

go install github.com/queone/utils/cmd/...@latest

Or install a single utility:

go install github.com/queone/utils/cmd/fr@latest

Binaries are placed in $GOPATH/bin (typically ~/go/bin), which should be in your $PATH.

Getting Started

To compile the entire collection, you obviously need to have GoLang installed and properly setup in your system, with $GOPATH set up correctly (typically at $HOME/go). Also setup $GOPATH/bin/ in your $PATH, since that is where all executable binaries will be placed.

To compile for the first time do:

git clone https://github.com/queone/utils
cd utils
go mod init utils
go mod tidy
./build.sh

For subsequent compilation just:

cd utils
git pull
./build.sh

Note that you can compile individual utilities with ./build.sh rn,web, etc.

To build in Windows you have to have a BASH shell such as GitBASH. To build from a regular Windows Command Prompt, you may have to tweak the build.sh script a bit, to have it run the right go build ... command.