Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,16 +11,16 @@ It will scan your system for *OpenCL Installable Client Driver (ICD)* files by A
- amdocl64.dll
- versioned variants (e.g. amdocl_\*.dll, amdocl64_\*.dll)

The scripts ensure proper detection and registration of the drivers, including handling SysWOW64, scanning the PATH safely, registering versioned DLLs and avoiding duplicate entries.
The PowerShell version additionally verifies DLL signatures, detects 32/64-bit bitness more reliably, safely cleans up or moves invalid entries, handles DriverStore and versioned DLLs intelligently and provides more detailed error reporting and status output.
The scripts ensure proper detection and registration of AMD OpenCL drivers, handling SysWOW64, scanning the PATH safely, providing clear status output, supporting versioned and custom ICD DLLs, avoiding duplicate registry entries, and modifies the registry only if automatic backups are detected or enabled.<br>
The PowerShell version adds signature verification, more precise 32/64-bit detection, safe cleanup or relocation of invalid entries, intelligent handling of DriverStore and versioned DLLs, more detailed output, and an option to enable registry backups automatically.

## Usage
## Batch script
### Batch script
1. Make sure to have the latest [AMD drivers](https://www.amd.com/en/support) installed
2. Download and execute `amdocl.bat`
3. Run the file as **Administrator** (Right click file and select `Run as Administrator`)

## PowerShell script
### PowerShell script
1. Download `amdocl-fix.ps1` and place it in a folder of your choice.
2. Make sure to run it as **Administrator**:
- Right‑click the file → **Run with PowerShell** → confirm the UAC prompt.
Expand All @@ -29,7 +29,11 @@ The PowerShell version additionally verifies DLL signatures, detects 32/64-bit b
cd "C:\path\to\folder"
.\amdocl-fix.ps1
```

3. (Optional) By default, unsigned DLLs are allowed to preserve valid but unusual ICDs. To restrict registration to signed DLLs only, run:
```powershell
.\amdocl-fix.ps1 -AllowUnsigned:$false
```

## Compatibility
- Windows 10, 11: fully supported
- Windows 7, 8, 8.1: batch script fully supported; PowerShell script (`amdocl-fix.ps1`) requires PowerShell 5.1 or newer
Expand All @@ -41,4 +45,4 @@ Inspired by StackOverflow https://stackoverflow.com/a/28407851
---

© 2023 [Patrick Trumpis](https://github.com/ptrumpis)
© 2025 [TantalusDrive](https://github.com/TantalusDrive) (Additional improvements and PowerShell version)
© 2025 [TantalusDrive](https://github.com/TantalusDrive) (Improvements and PowerShell version)
Loading