NZXTSharp 1.1.0

There is a newer version of this package available.
See the version list below for details.
Install-Package NZXTSharp -Version 1.1.0
dotnet add package NZXTSharp --version 1.1.0
<PackageReference Include="NZXTSharp" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NZXTSharp --version 1.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: NZXTSharp, 1.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install NZXTSharp as a Cake Addin
#addin nuget:?package=NZXTSharp&version=1.1.0

// Install NZXTSharp as a Cake Tool
#tool nuget:?package=NZXTSharp&version=1.1.0
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. If you are adding through Visual Studio, please be sure to check Include Prereleases.

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: Right now, I am working on support for the Hue+. Once that is complete, I plan to move into the Krakens and 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

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
2.1.3 508 10/24/2019
2.1.2 410 6/7/2019
2.1.1 318 5/1/2019
2.1.0 335 3/31/2019
2.0.0 321 3/18/2019
2.0.0-preview3 333 2/28/2019
2.0.0-preview2 395 2/23/2019
2.0.0-preview1 390 2/8/2019
1.2.0 257 1/30/2019
1.1.0 238 1/30/2019
1.0.3-beta 234 1/27/2019
1.0.2-beta 246 1/24/2019
1.0.1.2-beta 251 1/22/2019
1.0.1.1-beta 273 1/14/2019
1.0.1-beta 260 1/6/2019
1.0.0.3-beta 318 1/2/2019
1.0.0.2-alpha 260 1/1/2019
1.0.0.1-alpha 250 12/29/2018
1.0.0-alpha 248 12/29/2018

(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.