Hakamiq CsoKit is a Windows x64 toolkit for PSP ISO and CSO files. Use the desktop app for normal work, or the CLI when you want scripting and exact control.
Grab the latest Windows x64 package from the Releases page:
hakamiq-csokit-*-win-x64.zip
Extract it anywhere. Keep Hakamiq.Cso.Native.dll next to the executables.
Desktop app:
.\Hakamiq.Cso.App.exe
CLI help:
.\hakamiq-cso.exe --help
Version:
.\hakamiq-cso.exe --version
Show CSO information:
.\hakamiq-cso.exe info ".\game.cso"
Verify a CSO file:
.\hakamiq-cso.exe verify ".\game.cso"
Deep-verify and calculate SHA256:
.\hakamiq-cso.exe verify ".\game.cso" --deep --sha256
Detect an input format:
.\hakamiq-cso.exe detect ".\game.iso"
Analyze a PSP ISO:
.\hakamiq-cso.exe analyze ".\game.iso" --psp
Compress ISO to CSO:
.\hakamiq-cso.exe compress ".\game.iso"
Use the fast profile:
.\hakamiq-cso.exe compress ".\game.iso" --profile fast
Decompress CSO to ISO:
.\hakamiq-cso.exe decompress ".\game.cso"
Repair or normalize readable input into CSO1:
.\hakamiq-cso.exe repair ".\game.cso" -o ".\fixed.cso" --profile game-safe --deep-verify
Profiles: game-safe default, compat, fast, smallest, archive-smallest.
Full CLI reference: docs/CLI.md.
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General failure |
| 2 | Invalid command or missing argument |
| 10 | Input file not found |
| 11 | Invalid CSO file header |
| 12 | Unsupported CSO file |
| 13 | Corrupt CSO index table |
| 14 | Output file already exists |
| 15 | Cannot write output file |
| 16 | Not enough disk space |
| 20 | Decompression failed |
| 21 | Compression failed |
| 130 | Operation canceled by user |
Hakamiq CsoKit focuses on PSP ISO/CSO workflows. ZSO, DAX, and CSO2 are readable input containers; CSO1 is the default output format. Verification checks file structure, not emulator or device compatibility.