imgstat 1.0.0

package/imagestat

@@ -0,0 +1,81 @@
+#!/bin/bash
+
+# Function to display usage
+usage() {
+    echo "Usage: imagestat [-u|--url <url>] [directory]"
+    echo "  -u, --url <url>   URL to download images from"
+    echo "  directory         Directory to scan (default: current directory)"
+    exit 1
+}
+
+# Parse arguments
+URL=""
+TARGET_DIR="."
+
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        -u|--url) URL="$2"; shift ;;
+        -*) echo "Unknown parameter passed: $1"; usage ;;
+        *) TARGET_DIR="$1" ;;
+    esac
+    shift
+done
+
+# Create target directory if it doesn't exist
+if [ ! -d "$TARGET_DIR" ]; then
+    mkdir -p "$TARGET_DIR"
+fi
+
+# Download images if URL is provided
+if [ -n "$URL" ]; then
+    echo "Downloading images from $URL to $TARGET_DIR..."
+    wget -nd -r -P "$TARGET_DIR" -A jpeg,jpg,bmp,gif,png,webp,svg "$URL" 2>/dev/null
+    echo "Download complete."
+fi
+
+# Export function so xargs can use it
+process_image() {
+    IMG="$1"
+    
+    # Get dimensions
+    DIMENSIONS=$(identify -format "%wx%h" "$IMG" 2>/dev/null)
+    
+    if [ -z "$DIMENSIONS" ]; then
+        echo "Skipping (not an image or identify failed): $IMG"
+        return
+    fi
+    
+    DIRNAME=$(dirname "$IMG")
+    BASENAME=$(basename "$IMG")
+    EXTENSION="${BASENAME##*.}"
+    FILENAME="${BASENAME%.*}"
+    
+    # Normalize filename: lowercase, replace spaces/underscores with hyphens
+    NEW_FILENAME=$(echo "$FILENAME" | tr '[:upper:]' '[:lower:]' | sed 's/[ _]/-/g' | sed 's/-\{2,\}/-/g')
+    
+    # Check if dimensions are already in the filename
+    if [[ "$NEW_FILENAME" != *"$DIMENSIONS"* ]]; then
+        NEW_FILENAME="${NEW_FILENAME}-${DIMENSIONS}"
+    fi
+    
+    NEW_BASENAME="${NEW_FILENAME}.${EXTENSION}"
+    NEW_PATH="$DIRNAME/$NEW_BASENAME"
+    
+    if [ "$IMG" != "$NEW_PATH" ]; then
+        mv "$IMG" "$NEW_PATH"
+        echo "Renamed: $IMG -> $NEW_PATH"
+    else
+        echo "No change: $IMG"
+    fi
+}
+
+export -f process_image
+
+# Find and process images
+echo "Scanning for images in $TARGET_DIR..."
+# Prune standard ignored directories
+find "$TARGET_DIR" \
+    \( -type d -name ".git" -o -name "node_modules" -o -name "dist" -o -name "build" -o -name "vendor" -o -name ".next" -o -name "coverage" \) -prune \
+    -o -type f \( -iname "*.jpg" -o -iname "*.jpeg" -o -iname "*.png" -o -iname "*.gif" -o -iname "*.webp" -o -iname "*.svg" \) -print0 | xargs -0 -P 4 -I {} bash -c 'process_image "$@"' _ {}
+
+echo "Done."

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "imgstat",
+  "version": "1.0.0",
+  "description": "Recursive image dimensions scanner and renamer",
+  "bin": {
+    "imagestat": "./imagestat"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isaac0yen/imgstat.git"
+  },
+  "keywords": [
+    "image",
+    "resize",
+    "rename",
+    "dimensions",
+    "cli",
+    "bash"
+  ],
+  "author": "Isaac",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/isaac0yen/imgstat/issues"
+  },
+  "homepage": "https://github.com/isaac0yen/imgstat#readme",
+  "files": [
+    "imagestat"
+  ]
+}

package/readme.md

@@ -0,0 +1,55 @@
+# imagestat
+
+**imagestat** is a powerful bash utility that recursively scans directories for images, downloads them, and automatically renames them to include their dimensions (e.g., `image-1920x1080.jpg`).
+
+## Features
+
+- **Recursive Scanning**: Finds images deep within subdirectories.
+- **Smart Renaming**: `My Photo.jpg` -> `my-photo-800x600.jpg`
+- **Smart Ignores**: Skips `node_modules`, `.git`, `dist`, etc.
+- **URL Download**: Optionally download images first.
+
+## Installation
+
+### Option 1: NPM (Node.js)
+The easiest way if you have Node.js installed:
+```bash
+npm install -g imgstat
+```
+*Note: Requires a bash environment (Linux, macOS, WSL, or Git Bash).*
+
+### Option 2: Universal Install Script (Linux/macOS)
+One-line install from your terminal:
+```bash
+curl -fsSL https://raw.githubusercontent.com/isaac0yen/imgstat/main/install.sh | sudo bash
+```
+
+### Option 3: Debian/Ubuntu (.deb)
+If you prefer a package manager:
+1. Download the latest `.deb` from the [Releases page](https://github.com/isaac0yen/imgstat/releases).
+2. Install it:
+   ```bash
+   sudo apt install ./imagestat_1.0_all.deb
+   ```
+
+### Option 4: Manual
+```bash
+git clone https://github.com/isaac0yen/imgstat.git
+cd imgstat
+sudo ./install.sh
+```
+
+### Windows
+1.  **Recommended**: Use **WSL** (Ubuntu) and follow "Option 2".
+2.  **Git Bash**: Clone the repo and run `./imagestat` directly.
+
+## Usage
+
+```bash
+imagestat [directory]
+```
+
+**Download and process:**
+```bash
+imagestat -u https://example.com/images my-folder
+```