Skip to content
Zipic Docs

Troubleshooting

If you encounter issues with Zipic, this guide will help you collect diagnostic information and resolve common problems.

Debug Mode

Zipic includes a built-in Debug Mode that enables detailed runtime logging. This is essential for diagnosing compression issues, unexpected behavior, or crashes.

Activating Debug Mode

  1. Open Settings (press ⌘ + ,) and navigate to the License tab.
  2. Tap the Zipic app icon in the License view 5 times to activate Debug Mode.
  3. Once activated, a debug indicator will appear and runtime logs will be recorded.

Exporting Logs

After activating Debug Mode and reproducing the issue, you can export the runtime logs for troubleshooting or to share with our support team.

Common Issues

Dependency Installation Failed

If external tools fail to install, try again from Settings -> Dependency. Version 1.9.0 uses an in-app guided installation window with automatic retry. Check your network connection if the issue persists.

Compression Not Starting

Ensure the file format is supported. If files are being skipped, Smart Skip may have detected them as already compressed — try changing compression settings to trigger re-compression.

Encrypted PDF Error

Zipic automatically detects encrypted PDFs and displays a friendly prompt. You’ll need to decrypt the PDF before compression. Ensure Ghostscript is installed in Settings -> Dependency.

NotchDrop Not Appearing

Make sure “Drag to Notch for compression” is enabled in Settings -> Workflow. Version 1.9.0 fixes several issues with NotchDrop in full-screen apps, after display changes, and with non-drag gestures.

Submitting Feedback

If you’ve collected debug logs and need further assistance, please reach out to our support team:

Send Email with Logs 📮
Submit Feedback 📋