Troubleshooting

Thunderbolt 3 Unblocker is known to work on the following versions of macOS:

• macOS Catalina (all versions up to 10.15.3)
• macOS Mojave (all versions up to 10.14.6)
• macOS High Sierra (all versions up to 10.13.6)
• macOS Sierra (all versions up to 10.12.6)

If you are having issues and are running one of these versions, most likely the issue is not with Thunderbolt 3 Unblocker.

Thunderbolt 3 Unblocker's job is to unblock the system from loading the appropriate drivers for an peripheral. The peripheral will not work as expected if the system does not have a driver that supports the peripheral.

If you are referring to a Thunderbolt dock such as the Dell TB16, please review this issue. This is the most commonly reported issue.

How to tell if Thunderbolt 3 Unblocker is working

1. Start with the peripheral unplugged.
2. Load Thunderbolt 3 Unblocker if it is not yet loaded.
3. Plug the peripheral in.
4. In Terminal.app, run system_profiler SPThunderboltDataType | grep 'Unsupported' || echo 'Looks good!'

If Thunderbolt 3 Unblocker is working, you will see the text "Looks good!" appear. In this case, the issue with your device is unrelated to Thunderbolt 3 Unblocker, and cannot be fixed by this project.

I get an error when loading Thunderbolt 3 Unblocker

If the error looks like this:

Kext with invalid signatured (-67050) allowed: <OSKext 0x7f938a605a00 [0x7fffa05378e0]> { URL = "file:///Library/Extensions/Thunderbolt3Unblocker.kext/", ID = "es.govost.ryan.Thunderbolt3Unblocker" }

Read closely: it says that the operation was allowed. This is not a problem, and you do not need to file a bug report about it.

If you receive any other error message, please continue reading.

What to attach to a bug report

Please copy the following into Terminal. Enter your password when prompted.

( \
  sudo kextunload -b es.govost.ryan.Thunderbolt3Unblocker || echo 'Not loaded.'; \
  nvram t3u-incompatible || echo 'NVRAM variable not present.'; \
  csrutil status; \
  sudo kextutil /Library/Extensions/Thunderbolt3Unblocker.kext/; \
  system_profiler SPSoftwareDataType SPHardwareDataType SPThunderboltDataType; \
  ls -t /Library/Logs/DiagnosticReports/*.panic | head -n 1 | xargs cat; \
) > ~/Desktop/t3u-diagnose.txt; \
sync; \
( \
  sudo kextload /Library/Extensions/Thunderbolt3Unblocker.kext; \
  sleep 0.5; \
  sudo dmesg; \
) >> ~/Desktop/t3u-diagnose.txt; \
open -R ~/Desktop/t3u-diagnose.txt

After a moment, a file named t3u-diagnose.txt should appear on your desktop. Please attach this file to your new bug report.