🛠️ Zhiro QuickTools

A bunch of lightweight .bat scripts to handle mundane, repetitive media tasks (conversions, trimming, captioning, etc.) with a single click.

Intended to be added to your explorer's context menu (iMA Menu, Nilesoft Shell, Easy Context Menu) or the native Windows SendTo folder. No heavy GUIs, just drag, drop, and done.

---

📢 What's New (v2.0.0)

• 3 New Tools Added: Introduced COLLAGE4ALL (multi-image grid collages), COLOR4PIC (color grading, tone correction, and palette adjustments), and FLIP4ALL (spatial mirroring/rotation and temporal video/animation speed & reversal).
• Media Downloader: PASTE2FILE.bat now downloads copied video and audio URLs (YouTube, X/Twitter, TikTok, Reddit, Instagram, SoundCloud, etc.) directly to the selected path.
• Consolidated & Upgraded Engines: Merged VID2GIFWEBP directly into CONV4VID; added bidirectional processing FRAMES4ALL (frames to vid and vid to frames); and replaced legacy PowerShell wrappers in JOINVERT with a native bat.
• Updater 2.0: Native self-updater now integrates Windows Package Manager (winget) and a safe Recycled_Files/ archive for deprecated scripts.
• Native iMA Menu & Nilesoft Shell Integration: Ships with an out-of-the-box ZhiroQuickTools.nss configuration for categorized submenus, custom icons, and multi-file selection.
• Filename Hardening & Windows 11 24H2 Compatibility: Enforced global UTF-8 encoding across all scripts with escaping for complex path characters (#, &, (), ', [], ", %, @, \). Also added a new hybrid timestamp generator replacing the deprecated standalone wmic.

(More detailed changelog in the releases page).

---

✨ Features

Note

How It Works: Add the scripts to your context menu and right-click media in Windows Explorer or drag and drop a file or folder directly onto any script. Source files remain untouched, and outputs are saved with timestamps in the same folder as the input.

📼 General Media Tools

• CAPTION4ALL.bat: Adds captions, top headers, or clean subtitle overlays to images and videos. [docs]
• CROP4ALL.bat: Smart aspect ratio cropping and canvas padding (1:1 Square, 16:9 Landscape, 9:16 Portrait) for photos and videos. [docs]
• FLIP4ALL.bat 🆕 NEW: Mirrors, rotates, inverts media orientation, or adjusts playback speed and temporal direction (reverse/slowdown/speedup) across images and videos. [docs]
• TRIM4ALL.bat: Cutter for audio and video media, with both frame-accurate re-encoding and instant lossless stream copy. [docs]

🎬 Video & Animation Tools

• CONV4VID.bat: Video converter to MP4 (H.264/AAC) or WebM (VP9/Opus) with resolution scaling and GIF/WebP animation generation. [docs]
• FRAMES4ALL.bat: Extract video and animation frames into a folder, or assemble numbered image sequences back into a video. [docs]
• HARDSUB4VID.bat: Burn external (.srt, .ass) or embedded subtitles into video. [docs]
• VID2x264.bat ⚡ SILENT: Instantly converts files into a highly compatible H.264/AAC MP4 file. [docs]
• VIDEMUX.bat: Lossless stream demuxer and remuxer for MKV/MP4 containers, separating or merging raw video, audio tracks, subtitles, and embedded fonts without re-encoding. [docs]

🎵 Audio Tools

• CONV4AUDIO.bat: Audio converter supporting MP3, Opus, and lossless FLAC encoding with bitrate selection. [docs]
• EXTRACT320.bat ⚡ SILENT: Instant extractor, converts any file or container directly into 320 kbps MP3. [docs]
• GAIN4SONG.bat: Applies ReplayGain loudness adjustments directly to the audio stream for legacy hardware and playback systems. [docs]
• SONG2VID.bat: Generates shareable MP4 video from audio tracks using embedded album art, local cover artwork, animated GIFs/WebPs, or bundled fallback visuals. [docs]

🖼️ Image & Graphics Tools

• COLLAGE4ALL.bat 🆕 NEW: Creates collages and grid layouts from multiple images or entire image folders with automatic aspect ratio scaling. [docs]
• COLOR4PIC.bat 🆕 NEW: Performs color tweaks on pictures, such as grading, grayscale, background removal, brightness and contrast, among several more. [docs]
• JOINVERT.bat: Image stitcher that seamlessly aligns multiple images vertically or horizontally. [docs]
• PIC2ALL.bat: Universal image converter for PNG, WebP, multisize Windows ICO, and JPG formats. [docs]

📄 Documents & System Tools

• COMIC2PDF.bat: Bidirectional comic archive converter, translating CBZ, CBR, CB7, ZIP, RAR, and 7z packages into standardized PDF documents and vice versa. [docs]
• OCRPDF.bat: Injects a searchable, selectable optical text layer into scanned PDF documents via OCR. [docs]
• PASTE2FILE.bat ⚡ SILENT: Universal clipboard interceptor that pastes its contents in the selected path, either text, pictures or downloads video links. [docs]
• UPDATER.bat: Updater and dependency manager. Checks GitHub releases, performs self-updates, cleans obsolete files safely, and audits CLI tool availability. [docs]

(For menu options and usage details, check DOCS.md. For workflow insights and behind-the-scenes notes, visit my blog).

---

📦 Requirements

Zhiro QuickTools relies on standard command-line utilities. These can be in your system PATH or placed inside the Scripts\ folder:

• FFmpeg & FFprobe: Core for audio and video operations.
• ImageMagick: Core engine for image operations.
• yt-dlp: Used by PASTE2FILE.bat to download video URLs from the clipboard.
• 7-Zip: Required by COMIC2PDF.bat for comic archive extraction.
• Python + ocrmypdf: Required exclusively by OCRPDF.bat (pip install ocrmypdf).
• MediaInfo: Recommended for precise animation framerate detection.

Tip

You don't have to install dependencies manually: run UPDATER.bat --deps to run an automated audit and install missing tools via Windows Package Manager (winget).

---

📥 Installation & Updating

Download the latest release ZIP from GitHub Releases and extract it to your preferred location.

Method 1: iMA Menu (Recommended — Native Plugin)

1. Extract the release folder into your iMA Menu\plugins\ directory and ensure it is named QuickTools (e.g. ...\iMA Menu\plugins\QuickTools\).
2. Open iMA Menu > Settings (Right-click taskbar > iMA Menu > Settings).
3. In the Plugins view, switch to the Local tab and click Enable on QuickTools

Method 2: Nilesoft Shell

Copy the suite into ...\Shell\plugins\QuickTools\ and register the module by adding this line to your shell.nss:

import 'plugins/QuickTools/ZhiroQuickTools.nss'

Method 3: Easy Context Menu

1. Open Easy Context Menu and click the List Editor (mouse icon).
2. Drag and drop your preferred .bat files into the desired menu category.
3. Assign custom icons from the included icons\ folder.
4. Save changes.

Method 4: Windows "SendTo" Folder

1. Press Win + R, type shell:sendto, and press Enter.
2. Create shortcuts to your preferred .bat files inside that folder.
3. Usage: Right-click any file > Send to > Select the desired tool.

🔄 Keeping the Suite Updated

• Automatic: Double-click UPDATER.bat. The script compares your local version.txt against GitHub, downloads updates, safely moves superseded scripts to Recycled_Files/, and runs a dependency health check.
• Manual: Download the newest release package from GitHub Releases and extract it over your existing folder.

Important

Keep version.txt in the root folder alongside UPDATER.bat; the updater reads this file to determine when a new release is available.

---

🗺️ Roadmap

• Append Videos: A tool to join multiple video clips sequentially into a single file.
• Custom Typography Profiles: Configuration presets for user-defined subtitle fonts and color palettes in CAPTION4ALL and HARDSUB4VID.

---

🤖 LLM Disclaimer

Zhiro QuickTools is mostly handmade. I used LLM assistance for the following: standardizing legacy variable headers, modularizing the updater, and updating deprecated Windows APIs.

---

Made for personal use, shared for convenience. · Zhiro Minoda