This directory contains the image cataloging system used to organize and manage the Pop Cart manual images.
Sign in to like and favorite skills
This directory contains the image cataloging system used to organize and manage the Pop Cart manual images.
image-catalog.jsonThe master catalog of all images for the Pop Cart manual. Contains:
process_images.pyPython script that converts and moves images based on the catalog:
image-catalog.jsonUsage:
python3 process_images.py
cleanup_catalog.pyMaintenance script for catalog cleanup:
move_source_files.pyScript to co-locate source files with their WebP versions:
Images are organized into these categories:
pop-cart/assets/ ├── overview/ - Machine photos, exterior views, key features ├── setup/ - Unpacking, installation, WiFi configuration ├── operation/ - UI screenshots, customer interface, operator screens ├── maintenance/ - Cleaning procedures, supplies, routine tasks ├── troubleshooting/ - Error screens, diagnostic displays ├── parts-service/ - Component diagrams, parts photos, internal views └── temp/ - THIS DIRECTORY (catalog and scripts)
When adding new images to the Pop Cart manual in the future, use the image-cataloger agent to automate the cataloging process.
Add new images to this temp/ directory
Invoke the agent in Claude Code:
"I have new images in pop-cart/assets/temp/ that need to be cataloged"
or
"Use the image-cataloger agent to process the new images I added"
The agent will automatically:
image-catalog.jsonAfter cataloging, run the processing script:
python3 process_images.py
This will convert images to WebP and move them to proper locations.
Co-locate source files:
python3 move_source_files.py
This moves original source files alongside their WebP versions.
process_images.py"I've added 5 new troubleshooting screenshots to temp/. Please use the image-cataloger agent to catalog them."
"Catalog these new maintenance procedure photos using the image-cataloger agent, they show the cleaning process."
"I have new UI screenshots from the latest software update. Use image-cataloger to process them for the operation section."
Each image entry in
image-catalog.json{ "original_filename": "photo_32_2025-10-22_17-06-26.jpg", "suggested_filename": "machine_full_view_front.webp", "description": "Full front view of Pop Cart popcorn vending machine...", "content_type": "photo", "suggested_category": "overview", "tags": ["full-view", "exterior", "front-view", "carnival-design"], "dimensions": "964x1280", "notes": "Complete machine view in office environment...", "processed": true, "final_location": "assets/overview/machine_full_view_front.webp" }
If you need a new category beyond the existing six:
mkdir /path/to/pop-cart/assets/new-categorycategoriesimage-catalog.jsonEdit
image-catalog.jsoncleanup_catalog.py.webp.jpg# Catalog new images (use image-cataloger agent in Claude Code) # Convert and organize images python3 process_images.py # Co-locate source files python3 move_source_files.py # View catalog statistics python3 -c "import json; c=json.load(open('image-catalog.json')); print(c['statistics'])" # List unprocessed images python3 -c "import json; c=json.load(open('image-catalog.json')); [print(i['original_filename']) for i in c['images'] if not i.get('processed')]"
Last Updated: 2025-10-30 Total Images: 74 cataloged Categories: 6 (overview, setup, operation, maintenance, troubleshooting, parts-service)