Configuration Reference

Configuration Reference

Complete reference for all ImageChunker settings and configuration options.

Application Settings

Access via ImageChunker → Settings (⌘,)

General

Setting	Options	Default	Description
Theme	System, Light, Dark	System	Application appearance
Show in Dock	On, Off	On	Show Dock icon
Show in Menu Bar	On, Off	Off	Show menu bar icon
Launch at Login	On, Off	Off	Start with macOS
Check for Updates	On, Off	On	Automatic update checks

Processing

Setting	Options	Default	Description
Default Mode	Smart, Regular	Smart	Processing mode for new images
GPU Acceleration	On, Off	On	Use Metal for processing
Memory Limit	Auto, 2GB, 4GB, 8GB	Auto	Maximum memory usage
Parallel Processing	1-8 threads	Auto	Concurrent batch processing
Cancel on Error	On, Off	Off	Stop batch on first error

Smart Chunking

Setting	Range	Default	Description
Sensitivity	Low, Medium, High	Medium	Boundary detection aggressiveness
Min Chunk Height	50-2000px	200px	Minimum height per chunk
Text Detection	On, Off	On	Avoid splitting text
Face Detection	On, Off	On	Keep faces intact
Edge Threshold	0.1-0.9	0.5	Edge detection sensitivity

Export

Setting	Options	Default	Description
Default Format	PNG, JPEG, HEIC	PNG	Output format
JPEG Quality	1-100%	90%	Compression level
HEIC Quality	1-100%	85%	Compression level
Color Profile	Preserve, sRGB, Remove	Preserve	Color management
Include Metadata	All, Strip GPS, None	Strip GPS	Metadata handling
Default Location	Same folder, Subfolder, Ask	Subfolder	Where to save
Naming Pattern	Custom	{original}_{num}	File naming

Finder Extension

Setting	Options	Default	Description
Quick Process	On, Off	Off	Process without opening app
Output Location	Same, Subfolder, Ask	Ask	Where to save chunks
Auto-Launch	Always, If Closed, Never	If Closed	When to open app
Show Badge	On, Off	On	Finder badge on source files

Configuration File

ImageChunker stores settings in:

~/Library/Preferences/com.griffin.ImageChunker.plist

Viewing Settings

# View all settings
defaults read com.griffin.ImageChunker

# View specific setting
defaults read com.griffin.ImageChunker defaultMode

Modifying Settings

# Set default mode
defaults write com.griffin.ImageChunker defaultMode -string "smart"

# Set JPEG quality
defaults write com.griffin.ImageChunker jpegQuality -int 90

# Enable GPU acceleration
defaults write com.griffin.ImageChunker gpuAcceleration -bool true

Resetting Settings

# Reset all settings to defaults
defaults delete com.griffin.ImageChunker

Environment Variables

ImageChunker respects these environment variables:

Variable	Purpose	Example
IMAGECHUNKER_DEBUG	Enable debug logging	1
IMAGECHUNKER_NO_GPU	Disable GPU acceleration	1
IMAGECHUNKER_MEMORY_LIMIT	Override memory limit	4096 (MB)

Command Line Arguments

Launch ImageChunker with arguments:

# Open with specific file
open -a ImageChunker ~/image.png

# Open with multiple files (batch)
open -a ImageChunker ~/images/*.png

# Process and quit
open -a ImageChunker --args --process --quit ~/image.png

Available Arguments

Argument	Description
--process	Process immediately
--quit	Quit after processing
--output DIR	Set output directory
--mode smart|regular	Set chunking mode
--format png|jpeg|heic	Set output format
--quality N	Set quality (1-100)

Presets

Creating Presets

1. Configure all settings
2. File → Save Preset (⌘⇧S)
3. Enter preset name
4. Preset saved to:

   ~/Library/Application Support/ImageChunker/Presets/

Preset File Format

{
  "name": "Instagram Square",
  "version": 1,
  "settings": {
    "mode": "regular",
    "chunkWidth": 1080,
    "chunkHeight": 1080,
    "format": "jpeg",
    "quality": 90,
    "colorProfile": "srgb"
  }
}

Importing Presets

1. File → Import Preset
2. Select .imagechunkerpreset file
3. Preset appears in presets menu

Exporting Presets

1. File → Export Preset
2. Choose preset to export
3. Save .imagechunkerpreset file

URL Schemes

ImageChunker responds to URL schemes:

imagechunker://open?file=/path/to/image.png
imagechunker://process?file=/path/to/image.png&mode=smart
imagechunker://batch?folder=/path/to/images

Parameters

Parameter	Description	Values
file	File path	URL-encoded path
folder	Folder path	URL-encoded path
mode	Processing mode	smart, regular
format	Output format	png, jpeg, heic
quality	Quality	1-100
output	Output path	URL-encoded path

Security Settings

Sandbox Permissions

ImageChunker runs in macOS App Sandbox with:

• User-selected files: Read/Write access
• Downloads folder: Read/Write access
• Pictures folder: Read access
• Network: None (privacy)

Granting Permissions

If permission dialogs appear:

1. Click Allow for file access
2. Settings persist in:

   ~/Library/Containers/com.griffin.ImageChunker/Data/Library/Preferences/

Security-Scoped Bookmarks

For remembered folder access:

• Stored encrypted by macOS
• Re-validated on each launch
• Can be revoked in System Settings

Logging

Enable Debug Logging

# Set environment variable
export IMAGECHUNKER_DEBUG=1

# Or use defaults
defaults write com.griffin.ImageChunker debugLogging -bool true

Log Location

~/Library/Logs/ImageChunker/
├── imagechunker.log
├── processing.log
└── finder-extension.log

Viewing Logs

# Real-time log viewing
log stream --predicate 'subsystem == "com.griffin.ImageChunker"'

# Historical logs
log show --predicate 'subsystem == "com.griffin.ImageChunker"' --last 1h

Cache

Cache Location

~/Library/Caches/com.griffin.ImageChunker/

Clearing Cache

In App: Settings → Advanced → Clear Cache

Command Line:

rm -rf ~/Library/Caches/com.griffin.ImageChunker/

Cache Size Limit

Configure maximum cache size:

defaults write com.griffin.ImageChunker cacheLimit -int 500  # MB