You can simply copy this single file, drop it into your c# project, add a reference and you can start creating system health applications in a few simple steps.
Before we get started, let me introduce myself; I’m Andy, and I shall be your host for the next ten minutes. If you like, you can follow me on Twitter where I post about my journey as a technology writer and a freelance designer & developer.
You might like: Huge List of Free Overclocking Software
First up, What is HWMonitor?
To first understand the Open Hardware Monitor Libray, you first must understand what HWMonitor does. HWMonitor is a system information & system health monitoring software for Windows and Linux. This free system reporting software displays information on a wide range of your computer hardware sensors such as CPU, RAM, GPU, Fans, hard drives and even motherboard.
This application is popular amongst overclockers, gamers, computer hardware enthusiasts, professional computer technicians and, comes with several features that put it a step ahead of the competition for its reporting capabilities.
HWMonitor Key Features
- Trusted within the community
- Support for AMD, Via & Intel Processors
- Support for AMD, ATI & Nvidia GPUs
- Can report frequencies, voltages, temperature and more.
- Constantly updated with fresh hardware support
- Pro version includes additional logging capabilities, remote operation, and graphing. (Not required for this article)
At the core, HWMonitor is getting all of its data from the OpenHardwareMonitorLib.dll which is included within the directory of the downloaded files. This single file is responsible for all of the system health statistics and system information reported within the program – lucky for us, we can take the DLL and use it in our own projects.
HWMonitor is available for everyone to download from the CPUID download page with no strings attached.
What System Information can I access using OpenHardwareMonitorLib.dll?
Now that you understand HWMonitor and what its purpose is, you might be left with a question: what can you do with the Open Hardware Monitor DLL, and what information does it expose? Here is everything I could find.
|1||CPU||Bus Speed, Frequency, Usage, Temperature, Power Draw|
|2||GPU||Core Frequency, Memory Frequency, GPU Usage, Temperature|
|4||Motherboard||Vcore, DRAM voltage, System Temperature, CPU Temperature|
|5||Hard Drives||S.M.A.R.T, SSD Wear Level, Read/Write|
For this article, I will be focusing on fetching the CPU and GPU information, storing them in variables and outputting the values to the console. If you need more stats such as motherboard or ram, you can use the same methods to access any other system information you wish.
Integrating the HWMonitor DLL with Visual Studio / C#
Before you can query the DLL and start fetching information in your C# code, you need to go through some basic project set up to ensure you can access Open Hardware Monitor from within your project.
Below is an overview of the steps required.
- Download Visual Studio
- Open Visual Studio
- Start a New C# Project
- Extract OpenHardwareMonitorLib.dll
- Add DLL to Visual Studio Project
- Force your app to run in administrator mode
Shall we get started?
1. Download Visual Studio
Head over to the Visual Studio website and download the relevant version. I am using MAC for programming atm so I downloaded that one.
2. Install & Open Visual Studio
Once you have downloaded Visual Studio, go ahead and open the file to start the installation. Once complete go ahead and open the program.
3. Start a New C# Project
Before you can start writing any code or interacting with HWMonitor, you need to set up a new project.
Follow these simple steps to get started:
- Click new
- Select console project
- After, select .net framework 5.0
- Give your project a unique name
- Enable GIT if you need version control
- Click the create button
With your C# project set up and ready to go, you need to extract the required file and pull it into your project. To do this, download HWMonitor, open the zip and move OpenHardwareMonitorLib.dll into your new c# project folder.
5. Add DLL to Visual Studio Project
To start fetching the system information in our code, you need to add the DLL file reference to your visual studio c# project.
Here is what you need to do:
- Click Project > Add Reference
- Select the .net assembly tab, click Browse
- Navigate to and select the copy of OpenHardwareMonitorLib.dll that you placed in your project folder
- Hit ok
These critical steps ensure you have added the required DLL file to the project and that you can now reference it in your project’s files. To find out how to probe your system and pull essential information such as CPU frequency, load and voltage, move on to the next step below, which outlines some practical examples.
6. Force your app to run in administrator mode
To access system-level information, you need to complete one final step designed to enable administrator access at startup.
- From the project panel, right click Project > Add New and click Application Manifest File
- Press Ctrl + Shift + F and search for “requestedExecutionLevel”
- Change the tag to:
Failure to complete these final steps will result in blank data being returned from OpenHardwareMonitorLib.dll. Unfortunately, I made this mistake in my project and spent ages debugging.
Example Code: OpenHardwareMonitorLib.dll and C#
The above example will get you up and going with an actual application that grabs information about your computer’s CPU and GPU and outputs them to a simple console app. If you want, you can grab this code via the Gist.
Before you can use this example code, you will need to set up a new project which I outlined in the previous step.
Breaking down the Code
The above code is an excellent copy and paste example for experienced developers who know their way around but, for those of you with a little less programming experience, this section was made for you.
I will break down the example code and show you step by step how everything is working.
1. Include a Reference to the DLL
To start and, before you can access the hardware reports you need, you will first need to include a reference to the DLL at the top of your project main file right after the other using statements.
This line of code will enable Visual Studio to access the functionality we need in further steps. Let us move on.
2. Defining the Hardware to Report
To start grabbing pc health stats, we need to define a new computer object exposed by the Open Hardware Monitor DLL. Everything we need is held within the computer object, and it is also where we define which hardware we want pc health stats reported for.
You will notice two settings within our new computer object; GPUEnabled = true and CPUEnabled = true. These settings tell the Open Hardware Monitor library to return data for any processors or graphics cards currently connected to the system. If we don’t define them here, we won’t have any data within the loop.
In case you are wondering, here is a list of the options available to the object:
Full List of Hardware Reports Available
- GPUEnabled – Enable GPU related statistics and reports
- CPUEnabled – Enable CPU related statistics and reports
- RAMEnabled – Enable RAM related statistics and reports
- MainboardEnabled – Enable Motherboard related statistics and reports
- FanControllerEnabled – Enable Fan related statistics and reports
- HDDEnabled – Enable Hard Drive related statistics and reports
Now, considering we have defined the computer object, we need to start a connection between your code and the DLL file.
This single line will startup the DLL and enable it to start fetching pc health status.
3. The Loop
The loop is where the magic happens and is called every second by the Main method located at the bottom of the file. This loop makes a call to
ReportSystemInfo(), which goes through all the available data and returns only the information we have requested.
As you can see, methods are relatively straight forward and it’s as simple as targeting the correct Sensor Type and Sensor Name.
4. Accessing CPU Information
Inside the loop, there are two distinct sections covering CPU information and the other covering the GPU. Here we will look specifically at the CPU.
5. Accessing GPU Information
After the CPU section, you will find one more section covering system information for both Nvidia and AMD GPUs. The Open Hardware Monitor library reports information for both separately, so we need to access them in their unique way.
This has been quite a lengthy tutorial. If you followed along and managed to get everything working, pat yourself on the back.
The Open Hardware Library enables .net and c# developers to interface with system hardware and fetch key information on a range of hardware sensors. This method could pave the way for unique applications that are decoupled from the HWMonitor UI. This will enable developers such as yourself to easily create their system health monitors and pc health status monitors.