Troubleshooting

This page collects common problems for NueZip on macOS and how to resolve them.

Application won't start or crashes on launch

Symptoms: NueZip does not open, crashes immediately, or shows an unexpected error.

Steps to try:

1. Ensure your macOS version meets the minimum requirements (macOS 14 Sonoma+).
2. Quit and relaunch the app.
3. Reboot your Mac.
4. If the app was downloaded from GitHub Releases, try downloading the latest build or the notarized version.
5. If problems persist, collect logs (see below) and open an issue.

Cannot open a RAR archive

Symptoms: NueZip fails to open a .rar file, or shows an error.

Checklist:

1. Ensure the RAR file is not corrupted. Try opening it with another tool like The Unarchiver.
2. Multi-volume RAR archives must have all parts present (.part1.rar, .part2.rar, etc.).
3. Password-protected RAR archives require the correct password.
4. RAR5 format is supported. If you have an older RAR format, please report it.

Extraction fails with password error

Symptoms: Extraction fails with "Wrong password" or decryption error.

Checklist:

1. Verify the password is correct — passwords are case-sensitive.
2. Ensure the correct encryption type is supported (AES-256 for ZIP).
3. Try re-entering the password from the password manager.

Finder Extension not showing

Symptoms: Right-clicking an archive in Finder shows no NueZip options.

Checklist:

1. Enable the extension: System Settings → Privacy & Security → Extensions → Finder Extensions → Enable NueZip.
2. Restart Finder: Right-click Finder in Activity Monitor → Relaunch, or run killall Finder in Terminal.
3. Reinstall the app if the extension still doesn't appear.

License / purchase not showing

Symptoms: You purchased NueZip but it still shows as trial.

Checklist:

1. Ensure you are signed in to the same Apple ID used for the purchase.
2. Restore purchases: NueZip → Settings → License → Restore Purchases.
3. Contact support if the issue persists.

How to collect debug logs

To help diagnose issues, collect debug logs from NueZip:

# Copy logs to Desktop for sharing
cp ~/Library/Containers/com.w3cub.nuezip/Data/Library/Logs/NueZip/nuezip.log ~/Desktop/NueZip-Logs

Then open an issue on GitHub Issues and attach the logs.

Permission-related issues

If a feature prompts for permission but doesn't work after granting it:

1. Quit the app and reopen it after granting the permission.
2. If needed, reset the permission prompt with tccutil (see the Permissions guide).

Performance issues

If the app is slow or unresponsive:

1. Close other heavy applications.
2. Try extracting a smaller archive to isolate the issue.
3. Restart the app if performance degrades over time.

View logs

To troubleshoot crashes or issues, application logs are the most useful artifact. In sandboxed (App Store) builds, check:

~/Library/Containers/com.w3cub.nuezip/Data/Library/Logs/NueZip/nuezip.log

Resetting the app

To reset settings and clear local data:

1. Quit NueZip
2. Remove the container (be careful—this deletes all settings):

rm -rf ~/Library/Containers/com.w3cub.nuezip

3. Reopen NueZip and reconfigure.

Report an issue

When opening an issue, include:

• macOS version (Apple menu → About This Mac)
• NueZip version (NueZip → About)
• Steps to reproduce
• Logs (see View logs section for how to collect them)

This helps maintainers identify and fix the problem faster.