Support

Need help with ImageChunker? You’re in the right place. Find answers below or reach out through our support channels.

---

Quick Support Options

Documentation

Browse our comprehensive guides and reference materials.

• Quick Start Guide
• Keyboard Shortcuts
• Configuration Options

GitHub Issues

Report bugs or request features on our GitHub repository.

• Open an Issue
• View Known Issues

Community

Connect with other ImageChunker users.

• GitHub Discussions
• Twitter @imagechunker

---

Frequently Asked Questions

General

What image formats does ImageChunker support?

ImageChunker supports all common image formats:

• Input: PNG, JPEG, HEIC, TIFF, BMP, GIF, WebP
• Output: PNG (lossless), JPEG (configurable quality), HEIC (Apple format)

For best results, use high-resolution source images.

What's the difference between Smart and Regular chunking?

Smart Chunking uses AI-powered content analysis to find optimal split points that avoid cutting through faces, text, or important visual elements.

Regular Chunking divides images into uniform grid squares regardless of content. Best for images with consistent patterns or when you need exact dimensions.

What are the system requirements?

• macOS: 15.0 (Sequoia) or later
• Processor: Apple Silicon (M1/M2/M3) or Intel
• RAM: 4GB minimum, 8GB+ recommended for large images
• Disk: ~50MB for app, plus space for exported chunks

Is ImageChunker free?

ImageChunker is a free, open-source application. You can download it from our GitHub releases or the Mac App Store.

Processing & Export

What's the optimal chunk size for Instagram?

Instagram supports images up to 1080×1350 pixels. For square posts and carousels:

• Square: 1080×1080px (recommended)
• Portrait: 1080×1350px
• Landscape: 1080×566px

Use the Instagram Preset in ImageChunker for automatic optimal settings.

How do I process multiple images at once?

1. Open File → Batch Processing (⌘B)
2. Drag multiple images or select a folder
3. Configure chunking settings (applied to all)
4. Click Process All
5. Export chunks maintain source image naming

See our Batch Processing guide for advanced options.

Can I adjust chunk boundaries after processing?

Yes! After processing:

1. Select any chunk in the preview
2. Drag the boundary handles to adjust
3. Hold Shift to constrain proportions
4. Press Enter to confirm changes

Why are my exported chunks different sizes than expected?

Common causes:

• Source image smaller than chunk size: Chunks can’t be larger than the source
• Overlap enabled: Overlapping pixels add to effective size
• Final chunk: The last chunk may be smaller if the image doesn’t divide evenly

Check View → Show Dimensions to see exact sizes during preview.

Finder Extension

The Finder extension doesn't appear in the context menu

Try these steps:

1. Open System Settings → Privacy & Security → Extensions
2. Find Finder Extensions and enable ImageChunker
3. Restart Finder: hold Option and right-click Finder icon, select Relaunch

If still missing, run in Terminal:

pluginkit -e use -i com.griffin.ImageChunker.FinderExtension

How do I chunk images directly from Finder?

Once the extension is enabled:

1. Right-click any image in Finder
2. Select Quick Actions → Chunk with ImageChunker
3. ImageChunker opens with the image loaded
4. Configure and export as usual

Performance

ImageChunker is slow with large images

For images larger than 10,000px:

1. Enable Preferences → Performance → GPU Acceleration
2. Close other memory-intensive apps
3. Consider processing in smaller batches
4. Use JPEG input (faster than RAW/TIFF)

The status bar shows memory usage during processing.

The app uses a lot of memory

ImageChunker optimizes memory usage, but large images require significant RAM:

• 50MP image: ~1.5GB RAM during processing
• Memory is released after export completes
• Enable Streaming Mode in Preferences for very large files

---

Troubleshooting

App Won’t Launch

1. Check macOS version: Requires macOS 15.0 or later
2. Security prompt: First launch may require approval in System Settings → Privacy
3. Corrupted download: Re-download from official source
4. Reset app: Delete ~/Library/Application Support/ImageChunker/ and relaunch

Export Failures

1. Disk space: Ensure sufficient space for output
2. Permissions: Check write access to destination folder
3. File in use: Close any apps using the same files
4. Try different format: If HEIC fails, try PNG/JPEG

Image Won’t Load

1. Format check: Verify file is a supported image type
2. File corruption: Try opening in Preview.app first
3. File size: Images over 100MP may require High Performance mode
4. Reset: Restart ImageChunker and try again

Finder Extension Issues

# Reset Finder extension registration
pluginkit -r /Applications/ImageChunker.app/Contents/PlugIns/ImageChunkerFinderExtension.appex

# Re-enable extension
pluginkit -e use -i com.griffin.ImageChunker.FinderExtension

# Restart Finder
killall Finder

---

Contact Us

Report a Bug

Found something not working right? Open a Bug Report on GitHub

Include:

• macOS version
• ImageChunker version (Help → About)
• Steps to reproduce
• Sample image (if possible)

Request a Feature

Have an idea to make ImageChunker better? Submit a Feature Request

General Questions

For questions not covered here:

• GitHub Discussions
• Twitter @imagechunker

---

Version History

See our GitHub Releases for full changelog.

Version	Date	Highlights
1.0.0	Dec 2025	Initial release