NZXTSharp 2.0.0-preview1

The one-stop C# sdk that facilitates interaction with NZXT devices.

This is a prerelease version of NZXTSharp.
There is a newer version of this package available.
See the version list below for details.
Install-Package NZXTSharp -Version 2.0.0-preview1
dotnet add package NZXTSharp --version 2.0.0-preview1
<PackageReference Include="NZXTSharp" Version="2.0.0-preview1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NZXTSharp --version 2.0.0-preview1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

NZXTSharp

Documentation Status
Nuget
Discord

NZXTSharp is a C# package that allows interaction with NZXT's Hue+. Support for other devices will be coming.

You can find NZXTSharp on NuGet here.

I am looking for people to help NZXTSharp grow by integrating NZXTSharp with ProjectAurora and/ or RGB.NET. If you are interested, please contact me on Discord, or by email.

Please keep in mind that NZXTSharp is in development, and will have breaking changes in the future.

Documentation can be found at NZXTSharp's readthedocs.io page. Docs are built from the docs branch.

Syntax

NZXTSharp's syntax is lightweight, only taking a few lines to get started.

using NZXTSharp;
using NZXTSharp.Devices;
using NZXTSharp.Effects;

HuePlus hue = new HuePlus(); // Create device
Fixed effect = new Fixed(new Color(255, 255, 255)); // Make fixed effect
hue.ApplyEffect(hue.Both, effect); // Apply effect

FAQ

Q: Are there any plans to make an SDK in XX language?
A: As of yet, no. I am focusing on support for the .NET framework. Python is most likely next.

Q: Is XX device supported?
A: Next up on the list are KrakenX devices, after that is most likely the Hue 2.

Disclaimer

NZXTSharp is provided under the GNU GPLv3 license, but I want to re-iterate these stipulations:

  • This software is provided as is.
  • This software is provided with no warranty.
  • Neither I, nor any of NZXTSharp's collaborators hold any liability for any broken or not working hardware resulting from using this package. Please use your best judgement.

A big thank you to Pet0203 for his help in reverse engineering the protocols and building NZXTSharp.

</> With ♥ by Ari Madian

NZXTSharp

Documentation Status
Nuget
Discord

NZXTSharp is a C# package that allows interaction with NZXT's Hue+. Support for other devices will be coming.

You can find NZXTSharp on NuGet here.

I am looking for people to help NZXTSharp grow by integrating NZXTSharp with ProjectAurora and/ or RGB.NET. If you are interested, please contact me on Discord, or by email.

Please keep in mind that NZXTSharp is in development, and will have breaking changes in the future.

Documentation can be found at NZXTSharp's readthedocs.io page. Docs are built from the docs branch.

Syntax

NZXTSharp's syntax is lightweight, only taking a few lines to get started.

using NZXTSharp;
using NZXTSharp.Devices;
using NZXTSharp.Effects;

HuePlus hue = new HuePlus(); // Create device
Fixed effect = new Fixed(new Color(255, 255, 255)); // Make fixed effect
hue.ApplyEffect(hue.Both, effect); // Apply effect

FAQ

Q: Are there any plans to make an SDK in XX language?
A: As of yet, no. I am focusing on support for the .NET framework. Python is most likely next.

Q: Is XX device supported?
A: Next up on the list are KrakenX devices, after that is most likely the Hue 2.

Disclaimer

NZXTSharp is provided under the GNU GPLv3 license, but I want to re-iterate these stipulations:

  • This software is provided as is.
  • This software is provided with no warranty.
  • Neither I, nor any of NZXTSharp's collaborators hold any liability for any broken or not working hardware resulting from using this package. Please use your best judgement.

A big thank you to Pet0203 for his help in reverse engineering the protocols and building NZXTSharp.

</> With ♥ by Ari Madian

Release Notes

(2.0.0-preview1)
Partial Kraken Support
- Get Pump, Fan Speeds, Liquid Temp, Firmware Version
- Set Pump, Fan Speeds
- Some effects working, some partially working, some not implemented/ not working.

Major breaking changes because of a total refactor, docs will be updated with the release of v2.0.0

(1.2)
Added ability to create Fixed effect with custom RGB values for all LEDs.
This feature offers great versatility for allowing users to create their own effects.

No breaking changes, docs will be updated soon.

(1.1)
All systems are working! This release is actually v1.0, but because of the way NuGet handles versions, it is 1.1.

This update includes full support for the Hue+ controller.

There are no breaking changes in this update.
New Things!
- Bug fixes
- Input validation on more constructors
- The addition of XML docs to all methods, properties, constructors, and classes
- Little things here and there; cleanup, bits of refactoring, some performance improvements

(1.0.3-beta)
All effects are now working! Subdevices should also be working.

- Breaking Changes - N/A

(1.0.2-beta)
- Breaking Changes
   - Renamed HexColor.cs to Color.cs

- New Features
   - Subdevices: Individually control fans, strips, and their individual leds! Documentation and getting started examples        coming soon.

- Behind the Scenes
   - Addition of COM system, will make it easier to add support for more devices.
   - Refactoring, moved some files around, cleanup.

Most effects still not working.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
2.1.2 215 6/7/2019
2.1.1 130 5/1/2019
2.1.0 158 3/31/2019
2.0.0 137 3/18/2019
2.0.0-preview3 143 2/28/2019
2.0.0-preview2 170 2/23/2019
2.0.0-preview1 144 2/8/2019
1.2.0 75 1/30/2019
1.1.0 56 1/30/2019
1.0.3-beta 58 1/27/2019
1.0.2-beta 61 1/24/2019
1.0.1.2-beta 65 1/22/2019
1.0.1.1-beta 88 1/14/2019
1.0.1-beta 71 1/6/2019
1.0.0.3-beta 130 1/2/2019
1.0.0.2-alpha 69 1/1/2019
1.0.0.1-alpha 65 12/29/2018
1.0.0-alpha 61 12/29/2018
Show less