remutils
Collection of utility scripts.
2026 Rémino Rem https://remino.net/
Tools
- addwatermark
- Compatibility command for adding an image watermark.
- cb2pdf
- Convert
.cbzand.cbrcomic book archives into PDF files. - comprose
- Create and import prose content entries.
- file2dataurl
- Convert file to base64 data URL.
- genrand
- Generate cryptographically random strings.
- imgmod
- Image modification helpers.
- litesite
- Create and publish tiny static sites.
- liverename
- Rename new files with a timestamp.
- maconf
- Get and set common macOS preferences from the command line.
- mkiso
- Create ISO files from directories.
- mkprj
- Create dated project directories from optional templates.
- mkwebalbum
- Generate a responsive HTML photo album from a directory.
- mkx
- Make new executable shell script file from template.
- osc52
- Copy and paste through a terminal emulator that supports the OSC 52 clipboard sequence.
- readme
- Open the nearest README file.
- rmnlogo
- Display the RÉMINO logo in ASCII art and ANSI colours.
- rrrr
- Reliable Recursive Redundant RSync: Create snapshot-style rsync backups over SSH.
- rsdeploy
- Deploy directory to remote server by using rsync.
- timinal
- Render the current time with any installed FIGlet font.
- urlshortcut
- Read and write Internet Shortcut (
.url) files. - vid2gif
- Convert video files into animated GIFs.
- vidmod
- Video modification helpers.
- waituntil
- Wait until a specified time and optionally execute a command.
- webshot
- Capture a webpage as an image.
Installation & Usage
See README.md for the relevant subdirectory of the script you wish to install.
Most scripts can be installed via Homebrew, simply by cloning the repo, downloading its tarball, or the script itself.
Shell-based utilities also provide make install and make uninstall from their own directories. The default prefix is /usr/local; use PREFIX for a user-local installation or DESTDIR when staging a package. The Node, Python, and Rust utilities use their documented npm, pipx, and Cargo installation flows instead:
cd remutils/mkx
make install PREFIX="$HOME/.local"
make uninstall PREFIX="$HOME/.local"Development
Every directory except bin, lib, and tests houses a script of its own, along with documentation and a test suite. For example:
helloCHANGELOG.mdMakefile: localinstallanduninstalltargets.hello: executable script named the same than its parent directory.formula.rb.mustache: Mustache template of the script's Homebrew formula.man/hello.1README.mdtests/: Bats test suite directory.
Git Hooks
Install Git hooks with:
just hooksThe pre-commit hook formats staged shell files with shfmt and staged Markdown, JSON, YAML, HTML, CSS, and JavaScript files with prettier.
Tasks
Use just for common development tasks:
just list- List tools managed by this repo.
just tests [name]- Run all tests, or one tool's test suite when
nameis provided.
- Run all tests, or one tool's test suite when
just format [name]- Format the whole repo, or one tool when
nameis provided.
- Format the whole repo, or one tool when
just lint [name]- Check formatting for the whole repo, or one tool when
nameis provided.
- Check formatting for the whole repo, or one tool when
just version [name]- Show versions for all tools, or one tool when
nameis provided.
- Show versions for all tools, or one tool when
just release <name> <initial|major|minor|patch> [--github]- Create a release commit and tag, optionally publishing to GitHub.
- Python package releases additionally build and upload a wheel alongside the existing source archive.
just clean- Remove generated release tarballs and checksum files.
Release Scripts
The just recipes call scripts in bin for lower-level release operations:
script-tests- To run the test suite of a script.
version- To update the version of a script.
version-commit- To commit versioned changes of a script to its containing git repo.
release- To create the initial commit/tag for a script or delegate later versioned releases to
version-commit. Pass--githubto also publish the GitHub release.
- To create the initial commit/tag for a script or delegate later versioned releases to
version-tarball- To generate a tarball of a versioned release of a script.
version-release- To publish a versioned release of a script to GitHub.
version-formula- To generate a Homebrew formula in a given directory.
Licence
See LICENSE.txt.