Improvements

2025-11-27 04:22:46 +00:00
parent dba00da901
commit 97ba5eac6a
7 changed files with 141 additions and 10 deletions
@@ -0,0 +1,110 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This repository contains bash scripts for image processing operations, specifically for:
+- Resizing large JPEG images using ImageMagick
+- Converting RAR archives to ZIP format
+- Processing images inside ZIP archives
+- Recursive directory operations
+
+## Architecture
+
+### Script Organization
+
+The scripts follow a modular pattern with three tiers:
+
+1. **Core scripts** - Perform operations in current directory only:
+   - `images_resize.sh` - Resizes JPEGs in current directory
+   - `rar2zip.sh` - Converts RAR to ZIP (takes file arguments)
+   - `zip_images_resize.sh` - Resizes JPEGs inside ZIP files (takes file arguments)
+
+2. **Recursive scripts** - Traverse directories and call core scripts:
+   - `images_resize_recursive.sh` - Calls `~/images_resize.sh` in each subdirectory
+   - `zip_images_resize_recursive.sh` - Finds all ZIPs and calls `zip_images_resize.sh`
+   - `zip_images_recursive.sh` - Recursively creates ZIPs from JPEGs in directory trees
+
+3. **Wrapper scripts** - Execute core scripts on specific paths:
+   - `rar2zip_images.sh` - Runs `rar2zip.sh` on `/media/rewt/media/images/`
+   - `rar2zip_incomplete.sh` - Runs `rar2zip.sh` on `/media/rewt/media/incomplete/`
+
+### Key Design Patterns
+
+**Script Path Resolution**: Recursive and wrapper scripts reference scripts using relative paths with `SCRIPT_DIR`:
+```bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+"$SCRIPT_DIR/images_resize.sh"
+```
+
+**ImageMagick Path**: Uses custom ImageMagick installation at `~/Applications/magick`
+
+**Temporary Storage**: Uses RAM disk (`/dev/shm/`) for temporary file operations to improve performance
+
+**Cleanup Handling**: Scripts implement trap-based cleanup functions to remove temp directories on exit/error
+
+**File Safety Checks**: Before deleting originals, scripts verify output files exist and are non-empty
+
+## Common Commands
+
+### Resize Images
+
+In current directory:
+```bash
+./images_resize.sh
+```
+
+Recursively through subdirectories:
+```bash
+./images_resize_recursive.sh
+```
+
+Image resize parameters: `-resize 8000000@@\>` (max 8MP), `-quality 85%`, `-sampling-factor 4:2:0`
+
+### Convert RAR to ZIP
+
+Single/multiple files:
+```bash
+./rar2zip.sh file1.rar file2.rar
+```
+
+All RARs in specific paths:
+```bash
+./rar2zip_images.sh        # /media/rewt/media/images/
+./rar2zip_incomplete.sh    # /media/rewt/media/incomplete/
+```
+
+Compression: Uses 7z with `-mx=9` (maximum compression)
+
+### Process ZIP Archives
+
+Resize images inside ZIP files:
+```bash
+./zip_images_resize.sh archive1.zip archive2.zip
+```
+
+Recursively process all ZIPs:
+```bash
+./zip_images_resize_recursive.sh
+```
+
+Create ZIPs from directory structure (preserves hierarchy in filename):
+```bash
+./zip_images_recursive.sh
+```
+
+## Dependencies
+
+- ImageMagick (`~/Applications/magick`) - For image resizing
+- `7z` - For ZIP compression
+- `unrar` or `rar` - For RAR extraction
+- `numfmt` - For human-readable file size output
+- `/dev/shm/` - RAM disk for temporary storage
+
+## Important Notes
+
+- Scripts modify files in-place (originals are deleted after successful processing)
+- File modification times are preserved using `touch -r`
+- Scripts use absolute paths via `realpath` for file handling
+- Recursive scripts use `find` with `-print0` and null-delimited reading for safe filename handling