CortexUSB 26.9.14

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package CortexUSB --version 26.9.14
                    


                    

                
NuGet\Install-Package CortexUSB -Version 26.9.14
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="CortexUSB" Version="26.9.14" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CortexUSB" Version="26.9.14" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CortexUSB" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add CortexUSB --version 26.9.14
                    


                    

                
#r "nuget: CortexUSB, 26.9.14"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package CortexUSB@26.9.14
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=CortexUSB&version=26.9.14
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CortexUSB&version=26.9.14
                    


                            Install as a Cake Tool

CortexUSB

A .NET client library for the Neural DSP Quad Cortex's USB HID protocol — device discovery, the crypto handshake, chunked/compressed protobuf framing, and a clean high-level API for presets, scenes, and signal-chain grid editing.

QuadCortex is the intended entry point — it wraps the lower-level ProtocolClient (wire framing, crypto, chunking) and ProtocolService (state caching, preset library, grid editing) and exposes only clean domain types. No protobuf, wire, or HID types leak out of it.

Architecture

  • Client/ — transport (ITransport, UsbHidTransport, ReplayTransport for tests), the protocol handshake and framing (ProtocolClient, WireParser), and crypto (Client/Encryption, XXTEA + AES-GCM).
  • Protocol/ — protobuf message building, gzip/zlib decompression, and the device's model catalog.
  • Models/ — plain domain types (DeviceState, PresetLocation, UsbDeviceInfo).
  • QuadCortex.cs / ProtocolService.cs — the high-level facade and the state/preset/grid logic behind it.

Samples

samples/ListPresets and samples/QueryPreset are minimal console apps demonstrating the library against a connected device:

dotnet run --project samples/ListPresets/ListPresets.csproj
dotnet run --project samples/QueryPreset/QueryPreset.csproj

Device quirks worth knowing

  • SET_REPORT always STALLs on this device but still processes the data successfully — this is expected, not an error.
  • USB access is not exclusive across processes; multiple clients can open the device concurrently.
  • Writes wait for the device's own confirming echo before reporting success, since the hardware can silently refuse a write.
  • Grid state echoes from the device are sparse deltas — never replace a cached grid wholesale from one.

Acknowledgements

Special thanks to Simone Margaritelli (a.k.a. EvilSocket) for the initial research that started all of this and pointing me in the right directions. Also Jonathan Stokes for an incredible reference with the pyquadcortex project. Also shoutout to the community over at OpenCortex.

License

MIT — see LICENSE.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
26.9.14 127 9/1/2026
26.9.13 88 9/1/2026
26.9.10 86 9/1/2026