Update README.md

This commit is contained in:
Serge
2023-03-15 12:45:49 +01:00
committed by GitHub
parent 8d19b5f89c
commit c029df357a

View File

@@ -1,45 +1,44 @@
# G-Helper / GHelper # G-Helper | GHelper
## Open source Armory Crate alternative for Asus ROG Zephyrus G14, G15, Flow X13, Flow X16, and other models ## Open source Armory Crate alternative for Asus ROG Zephyrus G14, G15, Flow X13, Flow X16, and other models
A small utility that allows you to do almost everything you could do with Armory Crate but without extra bloat and unnecessary services. A small utility that allows you to do almost everything you could do with Armory Crate but without extra bloat and unnecessary services.
## Advantages ## Main advantages
1. Seamless and automatic GPU switching (without asking you to close all apps, etc) 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) 2. All performance modes can be fully customized (with fan curves and PPTs)
3. Very lightweight and consumes almost no resources 3. Very lightweight and consumes almost no resources, doesn't install any services. Just a single exe to run
## [Download latest release](https://github.com/seerge/g-helper/releases) ## [Download latest release](https://github.com/seerge/g-helper/releases)
![Screenshot](https://raw.githubusercontent.com/seerge/g-helper/main/screenshot.png) ![Screenshot](https://raw.githubusercontent.com/seerge/g-helper/main/screenshot.png)
## NEW (and experimental) features
1. Set Power limits (PPT) for Total (APU + dGPU) and CPU.
2. Anime matrix control thanks to [Starlight](https://github.com/vddCore/Starlight) + some tweaks from my side
## Main features ## Main features
1. Switch between built-in system **Performance modes** Silent / Balanced / Turbo and apply default fan curves 1. Built-in **Performance modes**: Silent - Balanced - Turbo (with default fan curves)
2. Switch between Eco / Standard or Ultimate **GPU modes** 2. **GPU modes**: Eco -Standard - Ultimate
3. Change laptop screen refresh rate - 60hz or your maximum (120hz, 144hz, etc depending on the model) with display overdrive (OD) 3. Laptop screen refresh rate 60hz or 120hz (144hz, etc depending on the model) with display overdrive (OD)
4. View default fan profiles for every mode and **auto apply** custom ones 4. Default and custom fan profiles for every performance mode
5. Control keyboard backlit animation and colors 5. Power limits (PPT) for every performance mode
6. Set battery charge limit to preserve battery health 6. CPU urbo boost mode
7. Monitor CPU temperature, fan speeds and battery discharge rate 7. Keyboard backlit animation and colors
8. **Automatically switch to Eco(iGPU)/60hz on battery** and back to Standard(GPU)/120hz modes when plugged 8. Anime matrix control thanks to [Starlight](https://github.com/vddCore/Starlight) + some tweaks from my side (including animated GIFs)
9. Support for FN+F5 to cycle through performance modes (with OSD notification) and FN+F4 to cycle through keyboard animation modes 9. FN+F5 to cycle through performance modes (with OSD notification) and FN+F4 to cycle through keyboard animation modes
10. Basic keybindings for M3 and M4 keys 10. Keybindings for M3 and M4 keys
11. Turn cpu turbo boost on/off with one checkbox to keep temps cooler 11. Battery charge limit to preserve battery health
12. Monitor CPU / GPU temperature, fan speeds and battery discharge rate
Designed and developed for Asus Zephyrus G14 2022 (with AMD Radeon iGPU and dGPU). But could and should potentially work for G14 of 2021 and 2020, G15, X FLOW, and other ROG models for relevant and supported features. ## Automatic switching of modes when on battery or plugged in
- Performance modes
- GPU modes
- Screen refresh rate
To keep auto switching and hotkeys working the app needs to stay in running in the tray. It doesn't consume any resources. To keep auto switching and hotkeys working the app needs to stay in running in the tray. It doesn't consume any resources.
## Performance Profile switching ## Performance Modes
Profiles are **same** as in Armory Crate (as they are stored in bios), including default fan curves Modes are **same** as in Armory 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 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 2. Balanced (balanced fans, 100W PPT total, up to 45W PPT to CPU) + Balanced setting in windows
@@ -59,18 +58,24 @@ PPTs are shown for G14 2022, for other models PPTs will be different as they are
2. Unzip to a folder of your choice 2. Unzip to a folder of your choice
3. Run **GHelper.exe** 3. Run **GHelper.exe**
App requires [.NET7](https://dotnet.microsoft.com/en-us/download) to be installed. Most probably you already have it. Otherwise you can [download it](https://dotnet.microsoft.com/en-us/download). ### Dependencies
I recommend to keep "Asus Optimization Service" running, as it keeps basic laptop hotkeys such as screen or keyboard brightness adjustment working. If you have (or had) MyASUS app installed, that service is most probably still up an running even after MyASUS uninstall. It's part of [Asus System Control Interface](https://www.asus.com/support/FAQ/1047338/). You can install it, and later disable / remove unnecessarily services by running [this bat file](https://raw.githubusercontent.com/seerge/g-helper/main/stop-asus-sv.bat) as admin. - App requires [.NET7](https://dotnet.microsoft.com/en-us/download) to be installed. Most probably you already have it. Otherwise you can [download it](https://dotnet.microsoft.com/en-us/download).
Note: Uses low level ASUS ACPI commands and doesn't require Armory Crate to be installed at all! Doesn't need administrator privileges to run! - I recommend keeping "Asus Optimization Service" running, as it keeps basic laptop hotkeys such as screen or keyboard brightness adjustment working. If you have (or had) MyASUS app installed, that service is most probably still up and running even after MyASUS uninstalls. It's part of [Asus System Control Interface](https://www.asus.com/support/FAQ/1047338/). You can install it, and later disable / remove unnecessary services by running [this bat file](https://raw.githubusercontent.com/seerge/g-helper/main/stop-asus-sv.bat) as admin.
- It's not recommended to use an app in combination with Armory Crate, cause they adjust the same settings. You can [uninstall it using it's own uninstall tool](https://dlcdnets.asus.com/pub/ASUS/mb/14Utilities/Armoury_Crate_Uninstall_Tool.zip?model=armoury%20crate). Just in case, you can always install it back later.
Note: Doesn't need administrator privileges to run!
-------------------------------
Designed and developed for Asus Zephyrus G14 2022 (with AMD Radeon iGPU and dGPU). But 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 project by yourself using Visual Studio :) 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 project by yourself using Visual Studio :)
Settings file is stored at %AppData%\GHelper Settings file is stored at %AppData%\GHelper
P.S.: It's not recommended to use an app in combination with Armory Crate, cause they adjust the same settings.
------------------ ------------------
Debloating helps to save your battery and keep laptop a bit cooler Debloating helps to save your battery and keep laptop a bit cooler