Git Product home page Git Product logo

hyperx-cloud-2-battery-monitor's Introduction

HyperX Cloud II Wireless Headset Battery Monitor for Windows(x64)

The aim of the project is simple, to create a somewhat customizable battery monitor for the Cloud II wireless headset. The main feature of the app is a system tray icon displaying the current battery percentage.

Supported headsets

Kingston HyperX Cloud II Wireless

HP HyperX Cloud II Wireless

HP HyperX Cloud II Core Wireless

HP HyperX Cloud Alpha Wireless

If you would like a different Cloud Wireless headset supported, feel free to create an issue here on Github but beware that I will ask you for assistance (eg. Wireshark USB traffic recordings).

How to install

You can download release v1.5 here or select the latest release on the right side of this Github repository and download the zip. After the download is complete, extract the zip and run "Cloud2BatteryMonitorUI.exe".

No installation is necessary.

About the app

The app consists of two forms/screens and a system tray icon.

Example battery icon:

icon_example

Main screen:

main_screen

Settings screen:

settings_form

Default settings

Setting Default value Type Explanation
autostart false bool (true/false) Adds app to start at boot registry
colorHigh -16776961 (darkish blue) int (int of color argb) System tray icon background (50-100% battery)
colorHighText -1 (white) int (int of color argb) System tray icon text (50-100% battery)
colorMed -8388480 (dark magenta) int (int of color argb) System tray icon background (20-49% battery)
colorMedText -1 (white) int (int of color argb) System tray icon text (20-49% battery)
colorLow -3801088 (dark red) int (int of color argb) System tray icon background (0-19% battery)
colorLowText -1 (white) int (int of color argb) System tray icon text (0-19%) battery
refreshMinutes 5 positive int System tray icon refresh timer length

If you accidentally delete the settings file then just download the one in this repository (settings.xml) and place it in the folder which contains your exe.

FAQ

Q: The app won't automatically start at boot.

A: Try running the exe as Administrator and make sure the exe is located at the same location as it was when you enabled auto start in the options.

Q: Why did you choose this language/framework?

A: I am mostly familiar with Java/Python but I wanted to try something new and since this was always a Windows-only project, I just downloaded Visual Studio Community 2022, installed all the add-ons and chose a random template. The end result is this frankensteinian mess of C# and C++ and while it is a bit wonky, it works and I had fun making it.

Q: How did you do it?

A: Basically I used wireshark to find the data and responses which had the battery level in it and then just reproduced them using HID API. I'll add a longer tutorial/walkthrough at some point in the future.

Tested on

Manufacturer Product name Release(s) OS(s)
Kingston HyperX Cloud II Wireless v1.0+ Windows 10
HP HyperX Cloud II Wireless v1.4+ Windows 10, Windows 11
HP HyperX Cloud II Core Wireless v1.4+ Windows 10
HP HyperX Cloud Alpha Wireless v1.5+ Unknown

Special thanks

libusb/hidapi

zeux/pugixml

ArthurGamerHD

License

MIT license. See the file LICENSE.txt for more information.

About

This program is hosted by Github and maintained by me (auto94).

hyperx-cloud-2-battery-monitor's People

Contributors

arthurgamerhd avatar auto94 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

arthurgamerhd

hyperx-cloud-2-battery-monitor's Issues

[Req] Cloud Alpha Wireless

Not sure what's needed to identify them with the application, but was wondering if it were possible for the 300hr Wireless version to be added?

Show the name of the headset on the Tooltip

With the addition of more supported headset models, this app is not more just about the Cloud 2,
so, a nice addition would be displaying the actual Name of the headset on the tooltip,
since you don't really know what this number on your taskbar represents without open the tooltip,
and after opening the tooltip, you don't actually know what exactly is with that amount of battery until opening the full app and reading the name of the headset

i have an example image:

image

Headset found but not active

The Headset is detected and working but shown as "found but not active"

The Headset is a Cloud II Wireless from HyperX but the HP version.

Is the Problem related to the manufacture?

Screenshot 2023-12-16 215333

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.