Troubleshooting

This section provides solutions to common issues you might encounter when using OCRR.

OCR Recognition Problems

Poor Text Recognition Accuracy

Problem

OCR fails to accurately recognize text in your document.

Solutions

  1. Enable "Enhanced OCR" mode in OCR Settings for more thorough processing.
  2. Disable "Fast Recognition Mode" for better accuracy.
  3. Check that you've selected the correct language(s) for your document.
  4. For specialized terminology, create a domain and add these terms to the word list.
  5. Adjust the document scan if possible (higher resolution, better contrast).
  6. For very small text, set the Minimum Text Height to 0% in OCR Settings.

Missing Text or Incomplete Recognition

Problem

OCR misses blocks of text in your document.

Solutions

  1. Enable "Enhanced OCR" mode to catch more text blocks.
  2. Use "Drawing Mode" to manually add text areas that were missed.
  3. Ensure the document has good contrast between text and background.
  4. Set Minimum Text Height to 0% to capture text of all sizes.
  5. Check if text is in a supported language.

Incorrect Text Layout

Problem

Text blocks are recognized but in the wrong order or with incorrect line breaks.

Solutions

  1. Use "Show Boxes" in Overlay Settings to see how text is being detected.
  2. Edit text blocks manually to correct layout issues.
  3. Disable Fast Recognition Mode for more accurate layout detection.

File Operations Issues

Cannot Open File

Problem

OCRR fails to open a PDF or image file.

Solutions

  1. Verify the file is not corrupted by opening it in another application.
  2. Check if the file is password-protected or encrypted.
  3. Confirm the file is in a supported format (PDF, PNG, JPEG, TIFF).
  4. Try creating a copy of the file and opening the copy.
  5. Restart OCRR and try opening the file again.

Cannot Save Processed PDF

Problem

Error occurs when trying to save a processed PDF file.

Solutions

  1. Ensure you have write permissions for the selected save location.
  2. Try saving to a different location, such as your Documents folder.
  3. Check if there's enough disk space available.
  4. Make sure the filename doesn't contain special characters.
  5. If processing many pages, try saving with fewer pages at a time.

Batch Processing Errors

Problem

Batch processing fails or stops with errors.

Solutions

  1. Check the status message for specific error information.
  2. Verify all files in the batch are supported formats and not corrupted.
  3. Ensure you have access permissions for the output directory.
  4. Process problematic files individually to identify specific issues.
  5. Try processing with smaller batches if memory issues are occurring.

Performance Issues

Slow OCR Processing

Problem

OCR processing takes an unusually long time.

Solutions

  1. Enable "Fast Recognition Mode" in OCR Settings for quicker processing (at the cost of some accuracy).
  2. Disable "Enhanced OCR" mode if it's not needed for your documents.
  3. Process smaller documents or fewer pages at a time.
  4. Close other demanding applications to free up system resources.
  5. Restart OCRR if you've been processing many documents in a session.

Application Becomes Unresponsive

Problem

OCRR becomes slow or unresponsive during operation.

Solutions

  1. Wait for current processing to complete if possible.
  2. For large documents, try processing fewer pages at a time.
  3. Close other applications to free up system memory.
  4. Restart OCRR after processing many documents.
  5. Check Activity Monitor to see if your system is running low on memory.

Subscription and Licensing Issues

Subscription Not Recognized

Problem

You've subscribed to OCRR but it still shows as trial or prompts you to subscribe.

Solutions

  1. Click "Restore Subscription" in the subscription overlay.
  2. Ensure you're signed in with the same Apple ID used for the subscription.
  3. Check your internet connection, as subscription verification requires online access.
  4. Restart OCRR and check again.
  5. Restart your computer and try again.
  6. Verify your subscription is active in the App Store → Account → Subscriptions.
  7. Contact customer support if the issue persists.

Trial Period Issues

Problem

Problems with the trial period or trial banner display.

Solutions

  1. Restart OCRR to refresh the trial status.
  2. Check the date and time settings on your Mac are correct.
  3. Ensure you have an active internet connection for trial verification.

Cancelling a Subscription

Problem

You want to cancel your subscription or free trial before being billed.

Solutions

  1. Open the App Store and click on your account.
  2. Select "Account Settings" and sign in if prompted.
  3. Scroll to "Subscriptions" and click "Manage".
  4. Find OCRR in your list of subscriptions and click "Edit".
  5. Select "Cancel Subscription" and confirm.
  6. Important: To avoid being charged, you must cancel before the 7-day trial period ends.
  7. You will continue to have access until the end of your current billing period or trial.

File Access and Permissions

Cannot Access Previously Processed Files

Problem

OCRR cannot access files or locations you've used before.

Solutions

  1. When prompted, grant OCRR permission to access the required files or folders.
  2. Check System Preferences → Security & Privacy → Files and Folders to ensure OCRR has necessary permissions.
  3. Try moving files to a more accessible location, like your Documents folder.
  4. For files on external drives, ensure the drive is connected and mounted.

Common Error Messages

Error Message Possible Cause Solution
"Failed to open file" File is corrupted, encrypted, or in an unsupported format Check file format and try opening in another application first
"Failed to process PDF" Issues with PDF structure or encoding Try saving a copy of the PDF in another application and reopen
"Failed to access output directory" Permission issues with selected save location Select a different output location or check folder permissions
"OCR processing failed" Issues during text recognition Try with different OCR settings or process fewer pages
"Application requires subscription" Trial expired or subscription not recognized Restore subscription or complete subscription process

Contacting Support

If you encounter issues not covered in this troubleshooting guide, please contact our support team:

  • Email: support@ocrr.app
  • Website: https://www.ocrr.app/support

When contacting support, please include:

  • A detailed description of the problem
  • Steps to reproduce the issue
  • Screenshots or error messages if available
  • Your macOS version and OCRR app version

Navigation

Navigation