Giter Club home page Giter Club logo

g-helper's Introduction

G-Helper - Lightweight control tool for Asus laptops

United24

GitHub release Github all releases GitHub stars Language: English | [ไธญๆ–‡]

Lightweight Armoury Crate alternative for Asus laptops. A small utility that allows you to do almost everything you could do with Armoury Crate but without extra bloat and unnecessary services. Works on all popular models, such as ROG Zephyrus G14, G15, G16, M16, Flow X13, Flow X16, TUF, Strix, Scar, ProArt and many more! Feel free to try :)

Gihhub

๐ŸŽ Main advantages

  1. Seamless and automatic GPU switching (without asking you to close all apps, etc.)
  2. All performance modes can be fully customized (with fan curves and PPTs)
  3. Very lightweight, consumes almost no resources, and doesn't install any services. Just a single exe to run
  4. Simple and clean native UI with easy access to all settings
  5. FN-Lock
  6. Doesn't need administrator privileges to run (*)

โšก Features

  1. Performance modes: Silent - Balanced - Turbo (built-in, with default fan curves)
  2. GPU modes: Eco - Standard - Ultimate - Optimized
  3. Laptop screen refresh rate 60hz or 120hz (144hz, etc.) with display overdrive (OD) and mini-led multi-zone switch
  4. Custom fan curve editor, power limits (PPT) and turbo boost selection for every performance mode
  5. Anime matrix control thanks to Starlight + some tweaks from my side, including animated GIFs, clock and audio visualizer
  6. Keyboard backlit animation and colours (including sleep animation and support for TUF models)
  7. All basic and custom Keyboard hotkeys (M-keys, FN+X keys)
  8. Monitor CPU / GPU temperature, fan speeds and battery discharge rate
  9. Battery charge limit to preserve battery health
  10. NVidia GPU overclocking
  11. XG Mobile Control
  12. AMD CPU Undervolting

Screenshot 2023-04-13 190951

โš™๏ธ Automatic switching when on battery or plugged in

  • The app remembers the last Mode used on the battery or when plugged
  • Optimized GPU mode - disables dGPU on battery and enables when plugged
  • Auto Screen refresh rate (60hz on battery, max hz when plugged)
  • Keyboard backlight timeout on battery or when plugged

To keep auto-switching and hotkeys working, the app needs to stay running in the tray. It doesn't consume any resources.

๐Ÿš€ Performance Modes

Modes are same as in Armoury Crate as they are stored in bios, including default fan curves

  1. Silent (minimal or no fans, 70W PPT total, up to 45W PPT to CPU) + Best power efficiency setting in windows
  2. Balanced (balanced fans, 100W PPT total, up to 45W PPT to CPU) + Balanced setting in windows
  3. Turbo (intense fans, 125W PPT total, up to 80W PPT to CPU) + Best performance setting in windows

PPTs are shown for G14 2022; for other models, PPTs will differ as they are set in bios.

๐ŸŽฎ GPU Modes

  1. Eco : only low power integrated GPU enabled, iGPU drives built-in display
  2. Standard (MS Hybrid): iGPU and dGPU enabled, iGPU drives built-in display
  3. Ultimate: iGPU and dGPU enabled, but dGPU drives built-in display (supported on 2022+ models)
  4. Optimized: disables dGPU on battery (Eco) and enables when plugged (Standard)

Screenshot 2023-08-03 193646

โ“ FAQ

How do I stop the Armory Crate install popup from appearing whenever I press the M4 / Rog key?

Stop the ArmouryCrateControlInterface service under the Windows Services app, or stop all Asus services altogether from Extra -> Stop services.

Why is Ultimate GPU mode not available on my laptop?

Ultimate mode is supported (by hardware) only on 2022+ models.

I don't see the GPU modes section

Some older models (for example, G14 2020) don't support disabling GPU on the hardware level; therefore GPU section makes no sense for them and will be hidden.

Should I apply custom power limits (PPT) and fan profiles?

You don't have to, and it's purely optional. From my experience, built-in (in bios) performance modes work well. Limit your power or apply custom fan curves only if you have issues. When you click Apply in the fan + power section, bios will consider the fan profile as "custom"! (no matter if you modified it or not)

How does G-helper control my fan speeds?

It doesn't. Your bios does (same as in the case with armoury). What G-helper can do - is (optionally) set a custom fan profile to the current performance mode consisting of 8 pairs of temperature + fan speed % via the same endpoint Armoury seem to use.

How do I change fan % to fan RPM?

Click on them

I don't see a GPU temperature in G-helper

Most probably, either you are using Eco / Optimized mode and your dGPU is simply off, or your windows has put the dGPU into sleep (to preserve power). In this situation, G-helper won't be able to reach your GPU and get readings.

I don't see the app after starting it

Please check the system tray for a (G) icon. By default, windows are keen to hide all icons, so you may need to click ^ to see them all. I would advise you to right-click on Taskbar, select TaskBar Settings -> Other System Tray icons -> Mark G-Helper to be always ON.

App crashes or doesn't work correctly; What should I do?

Open "Event Viewer" from the start menu, go to Windows Logs -> Application and check for recent Errors mentioning G-Helper. If you see one - please post a new issue with all details from this error.

Battery charge limiter is not working

It could be that Asus services are overwriting this limit after. You may want to stop them by clicking "Stop" in the Asus Services section (under Extra).

Can I use the MyASUS app along with G-Helper?

You can, and the only problem is that MyASUS may override the battery charge limit you set before. My advice in such a situation would be to set the same limit (i.e. 80%) in both MyASUS and G-Helper.

How do I set Mute Microphone to M3?

If you have the Asus Optimization Service running, it's controlled by that service (therefore, G-helper doesn't interfere with or touch this function). Alternatively, you can stop that service and bind M3 to anything you want.

How do I set different "Visual styles"?

Personally, I'm not a big fan of them, as they make colours very inaccurate. But if you want so - you can adjust display colours using either the Nvidia Control panel or AMD Adrenaline (appropriate display sections). If you really want, you can also use own ASUS utility from MS Store

Can I overclock the Nvidia GPU core/memory?

Make sure that your dGPU is enabled (i.e. it's not in Eco mode). Open the Fans + Power section and adjust core/memory clock offsets. They work the same as in the armoury's manual mode. Please remember that (unfortunately) you need admin permissions for that, and the app will ask you for them. (*)

Windows Defender marks app downloads as malware/virus

False positives from Windows Defender (or any other similar system that uses machine learning for detection) are possible as the application is not digitally signed with a certificate. You can always download a version below or compile the app by yourself. All application sources are open and can be monitored from A to Z :)

Where can I find app settings or logs?

You can find them under the %AppData%\GHelper folder. Please include them when posting a new bug report or issue.

App refuses to run on startup/runs without an icon in the tray on startup

Open the app, uncheck and check again "run on startup". If it still doesn't help (for some reason), you can try to manually edit the "GHelper" task in Windows Task Scheduler and add a couple of seconds of delay to start.

How do I uninstall G-helper?

G-helper is a single exe, and it doesn't install anything in the system. To remove it - you can simply delete exe :) If you have applied any custom fan profiles or PPTs - before removing I would recommend selecting your favourite performance mode (for example, balanced) and clicking "Factory defaults" under Fans + Power.

Can I undervolt my CPU ?

Currently, you can undervolt AMD CPUs. If your model supports that - you will see an undervolting slider under Fans+Power -> Advanced. If you don't see a slider there, it means your CPU doesn't support undervolting. Complete list of models that support that can be found here

I have G14 2023, and my GPU refuses to disable/enable

It seems to be an issue in older BIOS versions. As users report - latest BIOS 312 (installable via MyASUS or G-Helper -> Updates) resolves all issues :) So please update.

I have G15 2022, and my GPU refuses to disable/enable it, or my fans misbehave

G15 2022 is known to have a notoriously bugged BIOS (last one 313). Multiple users have reported that problems can be solved by rolling back to a previous BIOS 311 from the Asus Support website.

I have uninstalled Armoury, and my GPU performance is lower than it was

Check your NVidia Experience settings and make sure that you have Whisper Mode set to OFF. Also, you can go to reset all settings Nvidia Control panel -> Manage 3D Settings -> Reset to defaults

How do I do a hardware reset on a laptop?

All Asus laptops have the option to do a hardware reset, which can be handy sometimes. It doesn't touch your data but resets all main hardware-related things (enables your dGPU, wakes up wifi/bt adapter if it hangs for some reason, etc.). Turn OFF the laptop. Press and hold the "power" button for 30-40 seconds. Then boot normally (it will take a bit longer to boot)

What is G-helper?

G-Helper is a lightweight Armoury Crate alternative for Asus laptops. A small utility that allows you to do almost everything you could do with Armoury Crate but without extra bloat and unnecessary services.


๐Ÿ’ถ Support Project

If you like the app, you can make a Donation

Paypal in EUR Paypal in USD
QR Code QR Code

How to run

  1. Download latest release
  2. Unzip to a folder of your choice (don't run exe from zip directly, as windows will put it into temp folder and delete after)
  3. Run GHelper.exe

Requirements (mandatory)

  • Microsoft .NET7. Most probably, you already have it. Otherwise, download it from the official website.

  • Asus System Control Interface v3+. This "driver" from Asus should be installed automatically by windows update or along other Asus apps. If it's not the case for some reason - you can download and install it manually.

Recommendations (optional)

  • It's not recommended to use an app in combination with Armoury Crate services because they adjust the same settings. You can uninstall it using AC's own uninstall tool. Just in case, you can always install it back later.

  • It's not recommended to have the "ASUS Smart Display Control" app running, as it will try to change refresh rates and fight with g-helper for the same function. You can safely uninstall it.

  • You can stop/disable unnecessary services: Go to Extra in the app, and press "Stop" in the Asus Services section (former debloat.bat). To start/enable services back - click "Start" instead (former bloat.bat)

  • It is strongly recommended to run the app with Windows default "balanced" power plan Screenshot 2023-06-09 153453


Designed and developed for Asus Zephyrus G14 2022 (with AMD Radeon iGPU and dGPU). But it could and should potentially work for G14 of 2021 and 2020, G15, X FLOW, and other ROG models for relevant and supported features.

I don't have a Microsoft certificate to sign the app yet, so if you get a warning from Windows Defender on launch (Windows Protected your PC), click More Info -> Run anyway. Alternatively, you can compile and run the project by yourself using Visual Studio :)


Power-user settings

GENERAL NOTE: "Power user" settings require some config edits. Before making any changes to config.json - quit G-Helper. Make your changes. Rerun G-Helper.

Manual app language setting

By default, the app will use your Windows language setting. But you can set the language manually (if it is supported, of course)

Add the following line to %AppData%\GHelper\config.json : "language": "en" (by replacing "en" with the language of your choice)

Custom Windows power plans with each mode

In %AppData%\GHelper\config.json you can manually add a custom power plan (or power mode) GUID. It can be either a "real" power plant that can be switched or an "overlay" power plan like the one's G-helper sets by default.

Format is following : "scheme_<mode>" : "GUID" Where mode = 0 (balanced), 1 (turbo), 2 (silent)

Default behaviour is :

"scheme_0": "00000000-0000-0000-0000-000000000000",
"scheme_1": "ded574b5-45a0-4f42-8737-46345c09c238",
"scheme_2": "961cc777-2547-4f9d-8174-7d86181b8a7a",

Make sure to keep json structure (i.e. not to break it with extra or missing commas, etc.) - or the app will fail to read it and will just recreate a new config instead.

Custom hotkey actions

The app supports custom actions for M3, M4 and FN+F4 hotkeys. To set them, select "Custom" next to the appropriate hotkey and do one of the following:

  1. To run any custom application - put a full path to exe into the "action" text field, for example: C:\Program Files\EA Games\Battlefield 2042\BF2042.exe

  2. To simulate any Windows key - put the appropriate keycode into the "action" field, for example 0x2C for Print Screen. Complete list of keycodes https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes

Screenshot 2023-07-17 192155

Force Standard mode on shutdown/hibernation

In some rare cases, G14 2023 seem to have issues enabling/disabling dGPU - i.e. Eco mode. Till we wait for a fix from Asus on the BIOS level, one of the proposed solutions is to always shut down the laptop in Standard mode (then everything seems to work fine). To enable "forced" Standard mode on shutdown, add the following line to %AppData%\GHelper\config.json

"gpu_fix" : 1,

Disable OSD

You can disable the app's OSD (for performance modes, keyboard backlight, etc.) by adding the following line to %AppData%\GHelper\config.json

"disable_osd": 1,

Extra Keybindings

  • Ctrl + Shift + F5 - Toggle Performance Modes
  • Ctrl + Shift + F12 - Open G-Helper window
  • Ctrl + M1 / M2 - Screen brightness Down / Up
  • Shift + M1 / M2 - Backlight brightness Down / Up

If you don't want these bindings to work, you can add "skip_hotkeys":1, to %AppData%\GHelper\config.json

Keybinding to toggle performance modes (on external keyboards)

By default, the app will toggle performance modes with Ctr+Shift+F5. You can change this binding by adding "keybind_profile": 116 in config.json (under %AppData%\GHelper), where 116 is numerical code for desired key. Put 0 to completely disable this binding.


Libraries/projects used

  • Linux Kernel for some basic endpoints in ASUS ACPI/WMI interface
  • NvAPIWrapper for accessing Nvidia API
  • Starlight for anime matrix communication protocol
  • UXTU for undervolting using Ryzen System Management Unit

Disclaimers "ROG", "TUF", and "Armoury Crate" are trademarked by and belong to AsusTek Computer, Inc. I make no claims to these or any assets belonging to AsusTek Computer and use them purely for informational purposes only.

THE SOFTWARE IS PROVIDED โ€œAS ISโ€ WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. MISUSE OF THIS SOFTWARE COULD CAUSE SYSTEM INSTABILITY OR MALFUNCTION.

g-helper's People

Contributors

seerge avatar icestormng avatar marcelomijas avatar lswlc33 avatar tombonnot avatar unlux avatar sklynic avatar constrat avatar zimm-lostpolygon avatar jadonclegg avatar hkaancaliskan avatar weslleykawan avatar hungqbui avatar hoangdus avatar albert24gg avatar astronaut701 avatar etylix avatar ktemkin avatar mdowski avatar tbateson avatar

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.