an assortment of utilities and scripts too small to warrent their own repositories
bacchus can now generate launchers from start menu
add lstart and runstart options to bacchus



You can also use your local clone with git send-email.


Inactive: I haven't been finding myself keeping up with these tools. Development on this project has halted. Ongoing improvements to the tools I still use will happen in my dotfiles repository here.



This is a collection of tools and utilities I have written which are large enough to warrant packaging properly and writing man pages for, but not large enough to make a dedicated project/repository/package worthwhile.

A reasonable effort is made to polish, test, and document these tools, but some edge cases may not be handled gracefully, and portability to arbitrary platforms is not guaranteed, although release are compiled as static executable as much as possible to improve portability.

Note that the charles-util release number does not used semantic versioning - this is because each tool is versioned individually (a changelog is recorded in each tool's manpage). A charles-util release is simply a collection of the constant tools at specific versions.

#Future Plans

  • Testing methodology for individual tools where possible.




BSD 3-clause, See LICENSE.

#Release History

Each sub-section lists tools that have changed version since the previous release, along with the version current as of the given release.

#charels-util R1

  • abs2rel: 0.0.1
  • bacchus: 0.0.1
  • colortool: 0.0.1
  • disavow: 0.0.1
  • fieldify: 0.0.1
  • get-ip: 0.0.1
  • get-token: 0.0.1
  • nios2-search: 0.0.1
  • nios2-sh: 0.0.1
  • pdfutil-combine: 0.0.1
  • pdfutil-from-office: 0.0.1
  • pdfutil-optimize: 0.0.1
  • pdfutil-scrub: 0.0.1
  • query-webpage: 0.0.1
  • rtspman: 0.0.1
  • swizzle: 0.0.2
  • tagdump: 0.0.1
  • tagsearch: 0.0.1

#charles-util R2

  • get-token: 0.0.2
#Other Changes:
  • Builds for pyinstaller-ed python programs now use virtualenv.
  • Releases no longer include src/ to reduce size.
  • Release tarballs now include charles-util as a directory, rather than placing all included files under the top level.

#charles-util R3

  • colortool: 1.0.0
  • bytesh: 0.0.1
  • fieldify: 0.1.0
  • picobar: 0.0.1
#Other Changes:
  • python3 -m virtualenv is now used instead of virtualenv throughout the build system, to support versions of virtualenv installed via OS package managers.

#charles-util R4

#Other Changes
  • Fixed build-related issues relating to picobar which caused the ip block not to work in the compiled version. This happened sufficiently far into the R3 release that R3 could not be revised.

  • Updated INSTALL document with perl dependencies.

#charles-util R5

  • colortool: 1.0.1
#Other Changes
  • Deprecate pyinstaller / perlpacker binary generation, to reduce complexity

  • Migrate to a single shared src/bin/man directory, to reduce complexity

  • Top-level Makefile is now BSD-make compatible

  • Deprecate pdfutil due to poor code quality

  • Deprecate bacchus, as I no longer have a use case for it and am thus not interested in maintaining it

  • Deprecate picobar, as I no longer have a use case for it. There are also better alternatives already available in the wild.

  • Deprecate rtspman due to code quality concerns and lack of use. openRTSP is suggested as an alternative.