Initial Release

2026-05-23 17:16:14 -07:00
commit 1c6dfc880d
16 changed files with 1415 additions and 0 deletions
@@ -0,0 +1,93 @@
+<!-- omit from toc -->
+# `>_` clitools
+
+A collection of simple CLI tools which I use ocasionally.  
+They're really simple, mostly single-file, and should theoretically "just work" across platforms.
+
+- [`(imageconvert)` Mass Image Converter using ImageMagick](#imageconvert-mass-image-converter-using-imagemagick)
+- [`(mediaconvert)` Mass Media Converter using FFMPEG](#mediaconvert-mass-media-converter-using-ffmpeg)
+- [`(crunchy)` Turn Image into a Crunchy JPEG](#crunchy-turn-image-into-a-crunchy-jpeg)
+- [`(mangapub)` Converts CBZs into EPUBs](#mangapub-converts-cbzs-into-epubs)
+
+<br>
+
+## `(imageconvert)` Mass Image Converter using ImageMagick 
+Ever have a directory full of images in different formats? Use this tool to
+quickly convert them to a normal extension. Outputs to a `convert` folder
+in the current working directory. 
+
+> **Requires:** ImageMagick
+
+```
+imageconvert
+    --skip-errors   - Skip on conversion error
+    --skip-resume   - Skip Resume Checking
+    --multithread   - Use Multiple Threads
+    --recursive     - Scan Directories Recursively
+    <From>          - File Extension(s) to convert from, delimited with comma
+    <To>            - File Extension to convert into
+    [Arguments]     - Arguments to pass onto ImageMagick
+```
+
+<br>
+
+## `(mediaconvert)` Mass Media Converter using FFMPEG 
+Ever have a directory full of videos in different formats? Use this tool to
+quickly convert them to a normal extension. Outputs to a `convert` folder
+in the current working directory. 
+
+> **Requires:** FFMPEG
+
+```
+mediaconvert
+    --skip-resume   - Skip Resume Checking
+    --multithread	- Use Multiple Threads
+    --recursive     - Scan Directories Recursively
+    <From>          - File Extension(s) to convert from, delimited with comma
+    <To>            - File Extension to convert into
+    [Arguments]     - Arguments to pass onto FFMPEG
+Templates:
+    {filename}       - Full Filename    (e.g. myfile.txt)
+    {basename}       - Base Filename    (e.g. myfile
+    {directory}      - Source Directory (e.g. /path/to/file)
+```
+
+<br>
+
+## `(crunchy)` Turn Image into a Crunchy JPEG
+Applies random noise and rounding errors to the colorspace to make an image look **"crunchy"**
+
+```
+crunchy
+	--noise=<value>       - Noise Level  (Default: 25, Range: 0-100)
+	--quality=<value>	  - JPEG Quality (Default: 0,  Range: 0-100)
+    --generations=<count> - Iterations   (Default: 5)
+    <Filename>            - Input Filename
+```
+
+<p align="center">
+    <img src="crunchy/example.png">
+    <p align="center">Another satisfied customer!</p>
+</p>
+
+<br>
+
+## `(mangapub)` Converts CBZs into EPUBs
+Converts a directory of CBZ files into EPUBs, designed for copying mass amounts 
+of manga onto a Kindle 8th gen. It's default settings are very crunchy!
+
+**Note:** This doesn't properly split large images into two, and it will never, 
+because it doesn't bother me :P
+
+```
+mangapub
+    --extract             - Extract Images to Directory
+    --recursive           - Scan Directories Recursively
+    --height=<value>      - Image Height (Default: 800)
+    --width=<value>       - Image Width (Default: 600)
+	--quality=<value>	  - JPEG Quality (Default: 25, Range: 0-100)
+```
+
+> Highly modified version of this repo: https://github.com/DimazzzZ/cbz2epub
+
+<br>