A modular Zsh toolkit for batch image processing and artistic filters, powered by ImageMagick 7 and optional rembg. Outputs go to ./processed/ by default.

English | 繁體中文

• Parallel batches with concurrency tuned from installed RAM (overridable via environment variables).
• Resource guardrails: Magick thread/memory limits, low priority (nice), and a watchdog that tries to stop jobs when free RAM is critically low.
• Consistent CLI: all art filters use img-artify <style>[:substyle]; omitting :substyle uses each module’s documented [default].
• Optional AI cutout: img-ai-rembg runs local rembg (one image at a time, sequentially).

• ImageMagick 7+

  brew install imagemagick

• rembg (only for AI cutout)

  pip install rembg

git clone https://github.com/<you>/HImageTools.git
cd HImageTools
source ./loader.sh

Add source /path/to/HImageTools/loader.sh to ~/.zshrc if you want it permanently.

Input extensions (case-insensitive): jpg, jpeg, png, webp, tiff.

Our most powerful feature. Automatically applies 100+ artistic styles to all images in a directory and generates a professional interactive gallery.

• Command: img-artify-all [directory] (defaults to ./)
• Output: Creates an artify_gallery/ folder with subdirectories for each source image.
• Gallery: Master-Detail sidebar navigation, grid layout, lightbox, and resume support.

Designed for environment verification or development debugging. Runs all filters on the built-in system logo.

• Command: img-artify-test
• Output: Generates a style_test_report/ folder with a PASS/FAIL report.
• Benefit: Quickly identify which filters are working correctly in your current setup.

HImageTools now features a fully automated Plugin-based Architecture. Features, routes, and menu items are dynamically discovered at runtime.

1. Auto-Discovery: loader.sh automatically scans and sources all .zsh files in the styles/ directory.
2. Metadata Tags: Any .zsh file can register itself into the interactive menu using # @menu: tags.
3. Dynamic Routing: Commands like img-artify <style> are automatically routed to a function named _img_artify_<style>.

1. Create a file: Add styles/my_style.zsh.
2. Add Metadata: Add menu tags at the top:

   # @menu: my_id | cat_classic | My New Style | Cool description | cmd:img-artify my_style

3. Define the function:

   _img_artify_my_style() {
       local f=$1 output=$2 style=$3
       magick "$f" -sepia-tone 80% "$output"
   }

No other files need to be modified. The style will automatically appear in img-menu and be accessible via img-artify.

All write under ./processed/ (created if missing).

[default] = substyle used when you pass only the main style (e.g. img-artify oil). Aliases can replace the substyle keyword. Full command cells are copy-paste ready (after source loader.sh, from a directory that contains images).

Comics & Outlines — cartoon

Hand-Painted — handpaint (Ink outlines with color fills)

Marker Illustration — marker (Simulated 56-color markers)

Oil — oil

Watercolor — watercolor / illust

Sketch — sketch (no substyle = standard)

Charcoal — charcoal (no substyle = standard)

Vintage watercolor + torn edge — vin-wc (no substyle = default mix)

Vintage — vintage

Sepia — sepia (no substyle = standard sepia)

Single-style presets (no substyle)

Night — night (no substyle = generic night darkening)

Single-effect styles (no substyle)

Pop art — popart

Abstract (top-level) — abstract

Pixelate — pixelate

Mosaic — mosaic

Duotone — duotone

Tritone — tritone

A powerful interactive TUI navigation engine is built-in, allowing users to browse and apply 100+ styles without memorizing commands.

• Navigation Engine (interactive_menu.zsh): Supports full keyboard navigation (↑/↓ to scroll, Enter to select, ESC to go back) with hierarchical breadcrumbs.
• Menu Manifest (menu_manifest.zsh): A structured data list managing nodes, icons, descriptions, and their underlying CLI command mappings.
• Quick Launch: Simply type img-menu or run img-artify without arguments to enter the menu.

Notable variables (you may override before sourcing):

• Magick limits: MAGICK_THREAD_LIMIT, MAGICK_MEMORY_LIMIT, MAGICK_MAP_LIMIT, MAGICK_AREA_LIMIT
• IMAGE_SAFE_RAM_LIMIT — abort threshold based on free-RAM percentage (default ~3%).
• IMAGE_MAX_JOBS — manual concurrency; if unset, chosen from total RAM (conservative on ≤8 GB).

HImageTools/
  loader.sh
  config.zsh
  basic.zsh
  rembg.zsh
  styles/*.zsh

The on-disk help from img-artify (no args) should match this file; if anything diverges, treat styles/artify_main.zsh as the source of truth for the embedded list.

MIT License

Copyright © 2026 HImageTools contributors

• ImageMagick
• rembg
• Google Gemini CLI - Assistance with architecture optimization and style evolution.