Aesthetic Media Engineering

The macOS Terminal Toolbox for Media Hacking.

Zero GUI bloat. Pure UNIX stream speed. Concatenate or crossfade videos, apply cinematic color grading & optical FX with videoeffects, generate VHS/datamosh glitches, cut on the BPM or strip vlog silence, normalize audio to broadcast LUFS, and convert images to WebPβ€”all with live fzf previews and non-destructive defaults.

⚑ Lossless Stream Copy & xfade 🎬 Cinematic Color & Optics (vidfx) πŸ‘Ύ 11 Glitch Presets & Audio Crush βœ‚οΈ BPM, Freeze & Silence Cuts πŸ§™ Interactive Wizards + Live Preview
zsh β€” mytools terminal simulator
❯
Run sample:
Performance

Stream-Copy Zero Loss

When videos share codecs and frame rates, vidglue and videoWithoutAudio bypass re-encoding entirely. Merging multiple gigabytes finishes in hundreds of milliseconds without generational degradation.

Safety First

Non-Destructive Defaults

No tool will ever overwrite an existing destination file unless you pass the explicit --force flag. Preview batch commands safely anytime with --dry-run.

Acoustic Precision

DSP & Audio Lab

Native DSP manipulation: pitch-preserving tempo sync via aubio, -14 LUFS broadcast normalization, semitone pitch shifting, and sample-accurate fade envelopes to eliminate boundary clicks.

Terminal Ergonomics

Interactive fzf Cockpit & Wizards

Run mytools or <tool> -i for guided wizards with live ffprobe file metadata previews, Tab multi-select checklists, Equivalent Command generation, and direct macOS clipboard (pbcopy) export.

Interactive Command Studio

Construct exact, production-ready terminal commands visually with live effect reference previews. Browse visual presets, toggle flags, adjust parameters, and copy instantly.

❯ img2webp -q 85 --width 1200 photo.jpg
⚠️ COMMON GOTCHA
Why didn't mytools img2web -a work? Two quick reasons:
  1. No mytools prefix needed for individual tools: mytools opens the interactive menu launcher, while each tool (img2webp, vidglue, vid2webm, wav2mp3, etc.) is run directly by its own name. (Note: mytools <tool> [flags] now also forwards automatically as a convenience!)
  2. The image tool ends with a p: It is named img2webp (for WebP), not img2web.
STEP 01
Go to Your Files Folder

Open Terminal and move into the folder with your media. Tip: Type cd with a space, drag-and-drop your folder from Finder into Terminal, and press Enter.

❯cd ~/Pictures/MyPhotos
STEP 02
Run the Tool Directly with Flags

Combine custom flags before -a (all files in current folder) or before filenames. Add -n (--dry-run) anytime to preview safely without changing files.

❯img2webp --width 1200 -q 90 -a
STEP 03
Or Use Wizard Mode (-i) & Code Sheets

Don't want to memorize flags? Run <tool> -i for a step-by-step wizard that prints the exact Equivalent command, or run mytools cs for instant terminal code sheets!

❯mytools cs

Short Code Sheets & One-Liner Recipes

Copy-ready terminal one-liners and multi-step pipelines. Filter by task, click COPY to grab any recipe, or click STUDIO to customize its parameters visually. (In Terminal, run mytools cs anytime!)

UNIVERSAL FLAGS: -i Guided Wizard -n Dry-Run Preview -f Force Overwrite -o <dir> Output Folder -m / --mp3 Direct MP3 Output (all wav* tools) -b <kbps> MP3 Bitrate (192 / 256 / 320) -a All Images in Folder (img2webp)
mytools Short Code Sheets and One-Liner Terminal Recipes
Tool Task / Recipe Goal Short Code One-Liner Actions

⚑ vidglitch Visual Simulator

Live preview of video shader filters applied by vidglitch via FFmpeg filter graphs.

MYTOOLS_CORE PRESET: RGB-SPLIT [FFMPEG ACTIVE]

🎚️ DSP Audio Waveform Lab

Real-time canvas visualizer illustrating how wavfade, wavtrim, and wavpitch shape waveforms.

Complete Technical Catalog

27 purpose-built CLI commands. Every option, format, and example documented with mathematical precision.

Installation & Dependency Health

Zero-friction setup. Pure Bash symlinks in ~/.local/bin and automatic Zsh completion integration in ~/.zfunc.

01
Clone Repository

Clone the repository to your preferred coding directory on macOS.

❯git clone https://github.com/cocreating/mytools.git
02
Run Install Script

Links all commands to ~/.local/bin and registers completion functions in ~/.zshrc.

❯cd mytools && ./install.sh
03
Run Doctor Healthcheck

Verifies all dependencies and installs any missing Homebrew packages automatically.

❯mytools doctor --install
DEPENDENCY AUDIT MATRIX MANAGED VIA HOMEBREW
ffmpeg / ffprobe brew install ffmpeg
cwebp brew install webp
aubio brew install aubio
yt-dlp brew install yt-dlp
fzf brew install fzf
setWeblocThumb brew install setweblocthumb

macOS Finder Quick Actions

Convert files directly from Finder's right-click context menu. Ready-to-paste AppleScript templates included in quick-actions/.

πŸ“Έ
Convert to WebP
Batch encodes selected Finder images into WebP with macOS native completion notifications.
❯convert-to-webp.applescript
🌐
Convert to WebM
Encodes video selection into VP9/Opus WebM with zero terminal typing required.
❯convert-to-webm.applescript
πŸ‘Ύ
Convert to GIF
Generates palette-optimized animated GIFs from right-clicked Finder videos.
❯convert-to-gif.applescript
🎧
Convert to MP3
Instantly compresses uncompressed WAV files into 192kbps MP3s from Finder.
❯convert-to-mp3.applescript
πŸ”Š
Extract Audio
Rips audio track directly from movie clips into uncompressed PCM WAV.
❯extract-audio.applescript