diff --git a/_articles/faq/file-damaged-on-macos.md b/_articles/faq/file-damaged-on-macos.md new file mode 100644 index 00000000..6a6055b2 --- /dev/null +++ b/_articles/faq/file-damaged-on-macos.md @@ -0,0 +1,46 @@ +--- +layout: default-layout +noTitleIndex: true +needAutoGenerateSidebar: true +title: Why Do I Get a "File is Damaged and Can’t Be Opened" Error When Using the Dynamic Web TWAIN on macOS? +keywords: Dynamic Web TWAIN, macos, Damaged, can't be opened +breadcrumbText: Why Do I Get a "File is Damaged and Can’t Be Opened" Error When Using the Dynamic Web TWAIN on macOS? +description: Why Do I Get a "File is Damaged and Can’t Be Opened" Error When Using the Dynamic Web TWAIN on macOS? +date: 2025-12-08 07:56:47 +0800 +last_modified: 2025-12-08 07:56:47 +0800 +--- + +# Why Do I Get a "File is Damaged and Can’t Be Opened" Error When Using the Dynamic Web TWAIN on macOS? + +### Symptom + +When attempt to use the scanner on macOS, an error message states “ is damaged and can’t be opened”. + +![ds-is-damaged](/assets/imgs/ds-is-damaged.png) + +### Reason + +This issue is caused by macOS Gatekeeper, a security feature that blocks applications that are unsigned or not notarized when the file carries a quarantine attribute. The file itself is not damaged but Gatekeeper prevents it from running. + +The error message may also show an outdated download time, for example “Safari downloaded this file on `June 18, 2019`”, even on a new computer. This happens because macOS preserves the quarantine metadata when the file has been copied from sources such as: + +- An old computer +- A USB drive +- A company server +- A backup (e.g., Time Machine restore) + +### Resolution + +This issue is not related to our product but stems from the unsigned driver. + +- Temporary Fix: Click “OK” on the error dialog. The driver often works normally afterward. + +- Permanent Fix (if error persists): Remove the “quarantine” attribute via Terminal: + - Open Terminal (/Applications/Utilities). + - Run this command: + ```bash + sudo xattr -rd com.apple.quarantine /Applications/{YourDriver}.app + ``` + +
+> Only disable checks for trusted files. Verify the driver’s source is safe before proceeding. \ No newline at end of file diff --git a/_articles/faq/index.md b/_articles/faq/index.md index 335ece91..da56eb2b 100644 --- a/_articles/faq/index.md +++ b/_articles/faq/index.md @@ -208,6 +208,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ 31. [Dynamic Web TWAIN prompts the .deb installer for Windows](/_articles/faq/incorrect-installer-for-windowsARM64.md) 32. [Why am I unable to load the TIFF file into Dynamic Web TWAIN?](/_articles/faq/unable-to-load-4-bit-tiff.md) 33. [Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later](/_articles/faq/chromium-142-local-network-access-issue.md) +34. [Error message - File is Damaged and Can’t Be Opened in macOS](/_articles/faq/file-damaged-on-macos.md) ## Licensing and Purchase diff --git a/assets/imgs/ds-is-damaged.png b/assets/imgs/ds-is-damaged.png new file mode 100644 index 00000000..97e9041d Binary files /dev/null and b/assets/imgs/ds-is-damaged.png differ