NZXTSharp 2.0.0-preview1

.NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
This is a prerelease version of NZXTSharp.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package NZXTSharp --version 2.0.0-preview1                

                    
                

            
NuGet\Install-Package NZXTSharp -Version 2.0.0-preview1
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="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                

                    
                

            
#r "nuget: NZXTSharp, 2.0.0-preview1"
#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. 
// Install NZXTSharp as a Cake Addin
#addin nuget:?package=NZXTSharp&version=2.0.0-preview1&prerelease

// Install NZXTSharp as a Cake Tool
#tool nuget:?package=NZXTSharp&version=2.0.0-preview1&prerelease

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
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos 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
2.1.3 1,071 10/24/2019
2.1.2 730 6/7/2019
2.1.1 628 5/1/2019
2.1.0 657 3/31/2019
2.0.0 611 3/18/2019
2.0.0-preview3 511 2/28/2019
2.0.0-preview2 642 2/23/2019
2.0.0-preview1 581 2/8/2019
1.2.0 411 1/30/2019
1.1.0 385 1/30/2019
1.0.3-beta 351 1/27/2019
1.0.2-beta 354 1/24/2019
1.0.1.2-beta 362 1/22/2019
1.0.1.1-beta 407 1/14/2019
1.0.1-beta 384 1/6/2019
1.0.0.3-beta 431 1/2/2019
1.0.0.2-alpha 379 1/1/2019
1.0.0.1-alpha 366 12/29/2018
1.0.0-alpha 368 12/29/2018

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