## File: docs/README.ja-JP.md

# G-Helper - Asus ノートパソコン用の軽量コントロールツール

Asus ノートパソコン向けの小型・軽量な Armoury Crate 代替ツールで、はるかに小さなフットプリントでほぼ同じ機能を提供します。ROG Zephyrus G14、G15、G16、M16、Flow X13、Flow X16、Flow Z13、DUO、TUF シリーズ、Strix / Scar シリーズ、ProArt、Vivobook、Zenbook、Expertbook、ROG Ally / Ally X など、すべての人気モデルで動作します！

[](https://GitHub.com/seerge/g-helper/releases/)
[](https://GitHub.com/seerge/g-helper/releases/)
[](https://github.com/seerge/g-helper/attestations)
[](https://github.com/seerge/g-helper#readme)
[](https://github.com/seerge/g-helper/blob/main/docs/README.zh-CN.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.cs-CZ.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.es-ES.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.ko-KR.md)
[](https://github.com/seerge/g-helper/releases/latest/download/GHelper.exe)


[](https://github.com/seerge/g-helper/releases/latest/download/GHelper.exe) &nbsp; [](https://g-helper.com/support)

**⭐ アプリが気に入ったら、ぜひ広めてください。**

- [よくある質問 (FAQ)](https://g-helper.com/ja/faq/)
- [セットアップと要件](https://g-helper.com/ja/requirements/)
- [トラブルシューティング](https://g-helper.com/ja/troubleshooting/)
- [パワーユーザー設定](https://g-helper.com/ja/power-user-settings/)


[](https://u24.gov.ua/)

## :loudspeaker: YouTube レビューとガイド
| [](https://www.youtube.com/watch?v=hqe-PjuE-K8) | [](https://www.youtube.com/watch?v=5XUIMUzgHU0) | [](https://www.youtube.com/watch?v=6aVdwJKZSSc) |
| ----------------- | ---------------- | ---------------- | 
| [Josh Cravey](https://www.youtube.com/watch?v=hqe-PjuE-K8) | [Crimson Tech](https://www.youtube.com/watch?v=5XUIMUzgHU0) | [cbutters Tech](https://www.youtube.com/watch?v=6aVdwJKZSSc) | 

## 📰 記事
1. [Digital Trends](https://www.digitaltrends.com/computing/g-helper-armoury-crate-alternative/)
2. [BinaryFork](https://binaryfork.com/ghelper-armoury-crate-alternative-10216/)
3. [Ultrabookreview](https://www.ultrabookreview.com/71392-optimized-quiet-gaming-5080-5090/)
4. [Notebookcheck](https://www.notebookcheck.net/Unbloated-G-Helper-The-best-open-source-alternative-to-Asus-Armoury-Crate-Part-2.1213486.0.html)
5. [Les Numériques](https://www.lesnumeriques.com/appli-logiciel/marre-des-lenteurs-d-armoury-crate-sur-votre-pc-portable-asus-decouvrez-g-helper-l-alternative-ultra-legere-n240111.html)

## :gift: 利点 

1. シームレスで自動的な GPU 切り替え
2. すべてのパフォーマンスモードを電力制限とファンカーブで完全にカスタマイズ可能
3. 軽量。実行するのは単一の exe ファイルだけ。システムには何もインストールしません。
4. シンプルでクリーンなネイティブ UI で、すべての設定に簡単アクセス
5. FN ロックとカスタムホットキー



### :zap: 機能

1. パフォーマンスモード：サイレント - バランス - ターボ（内蔵、デフォルトのファンカーブ付き）
2. GPU モード：エコ - スタンダード - アルティメット - オプティマイズド
3. ディスプレイオーバードライブ対応の画面リフレッシュレート制御
4. 各パフォーマンスモードごとのカスタムファンカーブエディタ、電力制限、ターボブースト選択
5. アニメマトリックスまたはスラッシュライティングの制御（アニメーション GIF、時計、オーディオビジュアライザーを含む）
6. RGB バックライトのアニメーションモードとカラー
7. ホットキーの処理
8. CPU / GPU 温度、ファン回転数、バッテリー状態の監視
9. バッテリーの健康を保つための充電上限
10. Nvidia GPU のオーバークロックとアンダーボルト
11. XG Mobile の制御
12. AMD CPU のアンダーボルトと温度制限
13. BIOS とドライバの更新
14. Asus マウスの制御
15. Mini-LED マルチゾーン切り替え
16. フリッカーフリー調光とビジュアルモード

### :gear: 自動化
- バッテリー駆動時 / 電源接続時のパフォーマンスモード切り替え
- オプティマイズド GPU モード - バッテリー駆動時は dGPU を無効化し、電源接続時に有効化
- 自動画面リフレッシュレート（バッテリー駆動時は 60Hz、電源接続時は最大 Hz）
- バッテリー駆動時 / 電源接続時のキーボードバックライトのタイムアウト

### :rocket: パフォーマンスモード
>[!NOTE]
>すべてのモードは、デフォルトのファンカーブと電力制限とともに **BIOS に組み込まれて** おり、Armoury Crate のものと **まったく同じ** です。

各デフォルトの BIOS モードは、対応する [Windows 電源モード](https://support.microsoft.com/en-us/windows/change-the-power-mode-for-your-windows-pc-c2aff038-22c9-f46d-5ca0-78696fdf2de8) とペアになっています。この設定は ``ファン + 電源`` で調整できます。

1. BIOS の `サイレント` + `最も電力効率が良い` 電源モード
2. BIOS の `バランス`（AC 接続時は Performance）+ `バランス` 電源モード
3. BIOS の `ターボ` + `最も高いパフォーマンス` 電源モード



### :video_game: GPU チューニング

各モードで、コアクロック / メモリクロックのオフセット、GPU 電力、Dynamic Boost、温度制限など、専用 GPU を用途に合わせて調整できます。


### 💻 GPU モード

1. **エコ**：低電力の内蔵 GPU のみ有効。iGPU が内蔵ディスプレイを駆動します
2. **スタンダード**（MS Hybrid）：iGPU と dGPU が有効。iGPU が内蔵ディスプレイを駆動します
3. **アルティメット**：iGPU と dGPU が有効で、dGPU が内蔵ディスプレイを駆動します（2022 年以降のモデルで対応）
4. **オプティマイズド**：バッテリー駆動時は dGPU を無効化（エコ）、電源接続時に有効化（スタンダード）



### 💿 ドライバ更新
本アプリには、お使いのモデル向けに Asus 公式サイトから直接取得する BIOS / ドライバの自動更新チェッカーが含まれており、新しいダウンロードが利用可能になるとハイライト表示します。`Updates` セクションのすべてのリンクは Asus 公式のダウンロードを指しています。


### 🎮 メトリクスオーバーレイ
ゲーム画面の上に **FPS、CPU / GPU の温度・使用率・電力** をリアルタイムで表示する内蔵のゲーム内オーバーレイ（OSD）です。追加ツールは不要です。DX10 以降のゲームに対応します。排他的フルスクリーンを使用する古いタイトルでは表示されない場合があるため、ゲームをウィンドウ / ボーダーレスフルスクリーンモードに設定してください。

- ``Ctrl + Shift + Alt + O`` - ゲーム内オーバーレイの ON / OFF を切り替え
- ``Ctrl + Shift + Alt + マウスドラッグ`` - オーバーレイを移動
- ``Ctrl + Shift + Alt + マウスクリック`` - モード切り替え（ライト / デフォルト / フル）
- ``Ctrl + Shift + Alt + ホイール`` - オーバーレイのサイズ変更
- ``Ctrl + Shift + Alt + ホイールクリック`` - オーバーレイのサイズをリセット




### :mouse: Asus マウスおよびその他の周辺機器のサポート


[現在サポートされているモデル](https://github.com/seerge/g-helper/discussions/900)（クリックで展開）

- ROG Chakram X
- ROG Chakram Core
- ROG Gladius II and Gladius II Origin
- ROG Gladius II Wireless
- ROG Gladius III
- ROG Gladius III Wireless
- ROG Harpe Ace Extreme
- ROG Harpe Ace Aim Lab Edition
- ROG Harpe Ace Mini
- ROG Harpe II Ace
- ROG Keris Wireless
- ROG Keris II Ace
- ROG Keris Wireless Aimpoint
- ROG Strix Carry
- ROG Strix III Gladius III Aimpoint Wireless
- ROG Strix Impact III
- ROG Strix Impact III Wireless
- ROG Spatha X
- ROG Strix Impact II Wireless
- ROG Pugio
- ROG Pugio II
- TUF Gaming M4 Wireless
- TUF Gaming M3
- TUF Gaming M3 Gen II
- TUF Gaming M4 AIR
- TUF Gaming M5
- TX Gaming Mini



貢献と研究をしてくださった [@IceStormNG](https://github.com/IceStormNG) 👑 に深く感謝します（！）。



### ⌨️ キーバインド

- ``Fn + F5 / Fn + Shift + F5`` - パフォーマンスモードを前へ / 後ろへ切り替え
- ``Ctrl + Shift + F5 / Ctrl + Shift + Alt + F5`` - パフォーマンスモードを前へ / 後ろへ切り替え
- ``Ctrl + Shift + F12`` - G-Helper ウィンドウを開く
- ``Ctrl + M1 / M2`` - 画面の明るさ ダウン / アップ
- ``Shift + M1 / M2`` - バックライトの明るさ ダウン / アップ
- ``Fn + V`` - ビジュアルモード
- ``Fn + C`` / ``Fn + Esc`` - Fn ロック
- ``Fn + Ctrl +  F7 / F8`` / ``Ctrl + Shift + Alt +  F7 / F8`` - フリッカーフリー調光 ダウン / アップ
- ``Fn + Shift + F7 / F8`` - マトリックス / スラッシュライティングの明るさ ダウン / アップ
- ``Fn + Shift + F7 / F8`` / ``Ctrl + Shift + Alt +  F7 / F8`` - スクリーンパッドの明るさ ダウン / アップ
- ``Ctrl + Shift + F20`` - マイクをミュート
- ``Ctrl + Shift + Alt + F13`` - ディスプレイのリフレッシュレートを切り替え
- ``Ctrl + Shift + Alt + F14`` - エコ GPU モード
- ``Ctrl + Shift + Alt + F15`` - スタンダード GPU モード
- ``Ctrl + Shift + Alt + F16`` - サイレント
- ``Ctrl + Shift + Alt + F17`` - バランス
- ``Ctrl + Shift + Alt + F18`` - ターボ
- ``Ctrl + Shift + Alt + F19`` - カスタム 1（存在する場合）
- ``Ctrl + Shift + Alt + F20`` - カスタム 2（存在する場合）
- [カスタムキーバインド / ホットキー](https://g-helper.com/ja/power-user-settings/)

### 🎮 ROG Ally のキー割り当て
- ``M + DPad Left / Right`` - 画面の明るさ
- ``M + DPad Up`` - タッチキーボード
- ``M + DPad Down`` - デスクトップを表示
- ``M + Y`` - AMD オーバーレイを切り替え
- ``M + X`` - スクリーンショット
- ``M + Right Stick Click`` - コントローラーモード

------------------

> [!NOTE]
> ### 🔖 重要なお知らせ
> G-Helper はオペレーティングシステム、ファームウェア、ドライバの **いずれでもありません**。お使いのハードウェアをリアルタイムで「動作」させることは **一切ありません**。
> 
> これは、メーカーが作成し（BIOS に保存されている）あらかじめ定義された動作モードの 1 つを選択し、オプションで（！）お使いのデバイスに既に存在する設定を行うためのアプリにすぎません。Armoury Crate と同じ仕組みです。Armoury Crate が使用しているのと同じ Asus System Control Interface「ドライバ」を使って、これらを実現します。
> 
> Armoury Crate と同じモード / 設定を使用する場合、デバイスのパフォーマンスや動作に違いはありません。
> 
> ノートパソコンにおける G-Helper の役割は、テレビにおけるリモコンの役割に似ています。

### 使用ライブラリとプロジェクト
- [Linux Kernel](https://github.com/torvalds/linux/blob/master/include/linux/platform_data/x86/asus-wmi.h) - ASUS ACPI/WMI インターフェースの基本的なエンドポイント
- [NvAPIWrapper](https://github.com/falahati/NvAPIWrapper) - Nvidia API へのアクセス
- [Starlight](https://github.com/vddCore/Starlight) - アニメマトリックスの通信プロトコル
- [UXTU](https://github.com/JamesCJ60/Universal-x86-Tuning-Utility) - Ryzen SMU を使用したアンダーボルト用エンドポイント
- [PawnIO](https://github.com/namazso/PawnIO) - RyzenSMU へのアクセス
- [AsusCtl](https://gitlab.com/asus-linux/asusctl) - インスピレーションと一部のリバースエンジニアリング

### コード署名ポリシー
無料のコード署名は [SignPath.io](https://about.signpath.io/) により、証明書は [SignPath Foundation](https://signpath.org/) により提供されています

### プライバシーポリシー
このプログラムは、ネットワーク上の他のシステムへ一切の情報を送信しません

### 免責事項
「Asus」「ROG」「TUF」「Armoury Crate」は AsusTek Computer, Inc. の商標であり、同社に帰属します。これらおよび AsusTek Computer に帰属するいかなる資産についても、私は一切の権利を主張せず、純粋に情報提供のみを目的として使用しています。

本ソフトウェアは「現状のまま」提供され、商品性、特定目的への適合性、非侵害の保証を含むがこれらに限定されない、明示・黙示を問わずいかなる種類の保証もありません。本ソフトウェアの誤用は、システムの不安定や誤動作を引き起こす可能性があります。

_※ 以下の **Disclaimers** 英語原文が正式なものです。本翻訳は読みやすさのためのものであり、専門的な翻訳ではなく、誤りや最新版との差異が含まれる場合があります。本文は法的効力を持たず、紛争時の判断の根拠にもなりません。_

**Disclaimers**
"Asus", "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” AND 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.

---

## File: docs/README.md

# G-Helper - Lightweight control tool for Asus laptops

Small and lightweight Armoury Crate alternative for Asus laptops offering almost same functionality with a much smaller footprint. Works with all popular models, such as ROG Zephyrus G14, G15, G16, M16, X13, X16, Z13, DUO, TUF Series, Strix or Scar Series, ProArt, Vivobook, Zenbook, Expertbook, ROG Ally or Ally X and many more!

[](https://GitHub.com/seerge/g-helper/releases/)
[](https://GitHub.com/seerge/g-helper/releases/)
[](https://github.com/seerge/g-helper/attestations)
[](https://github.com/seerge/g-helper/blob/main/docs/README.zh-CN.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.ja-JP.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.cs-CZ.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.es-ES.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.ko-KR.md)
[](https://github.com/seerge/g-helper/releases/latest/download/GHelper.exe)


[](https://github.com/seerge/g-helper/releases/latest/download/GHelper.exe) &nbsp; [](https://g-helper.com/support)

**⭐ Like the app? Help spread the word.**

- [FAQ](https://github.com/seerge/g-helper/wiki/FAQ)
- [Setup and Requirements](https://github.com/seerge/g-helper/wiki/Requirements)
- [Troubleshooting](https://github.com/seerge/g-helper/wiki/Troubleshooting)
- [Power User Settings](https://github.com/seerge/g-helper/wiki/Power-user-settings)

[](https://release-monitor.com/#/seerge/g-helper)

[](https://u24.gov.ua/)

## :loudspeaker: YouTube Reviews and Guides
| [](https://www.youtube.com/watch?v=hqe-PjuE-K8) | [](https://www.youtube.com/watch?v=5XUIMUzgHU0) | [](https://www.youtube.com/watch?v=6aVdwJKZSSc) |
| ----------------- | ---------------- | ---------------- | 
| [Josh Cravey](https://www.youtube.com/watch?v=hqe-PjuE-K8) | [Crimson Tech](https://www.youtube.com/watch?v=5XUIMUzgHU0) | [cbutters Tech](https://www.youtube.com/watch?v=6aVdwJKZSSc) | 

## 📰 Articles
1. [Digital Trends](https://www.digitaltrends.com/computing/g-helper-armoury-crate-alternative/)
2. [BinaryFork](https://binaryfork.com/ghelper-armoury-crate-alternative-10216/)
3. [Ultrabookreview](https://www.ultrabookreview.com/71392-optimized-quiet-gaming-5080-5090/)
4. [Notebookcheck](https://www.notebookcheck.net/Unbloated-G-Helper-The-best-open-source-alternative-to-Asus-Armoury-Crate-Part-2.1213486.0.html)
5. [Les Numériques](https://www.lesnumeriques.com/appli-logiciel/marre-des-lenteurs-d-armoury-crate-sur-votre-pc-portable-asus-decouvrez-g-helper-l-alternative-ultra-legere-n240111.html)

## :gift: Advantages 

1. Seamless and automatic GPU switching
2. All performance modes can be fully customized with power limits and fan curves
3. Lightweight. Just a single exe to run. Doesn't install anything in your system. 
4. Simple and clean native UI with easy access to all settings
5. FN-Lock and custom hotkeys



### :zap: Features

1. Performance modes: Silent - Balanced - Turbo (built-in, with default fan curves)
2. GPU modes: Eco - Standard - Ultimate - Optimized
3. Screen refresh rate control with display overdrive
4. Custom fan curve editor, power limits and turbo boost selection for every performance mode
5. Anime Matrix or Slash Lighting control including animated GIFs, clock and Audio visualizer
6. RGB Backlight animation modes and colors 
7. Hotkey handling
8. Monitor CPU and GPU temperature, fan speeds and battery status
9. Battery charge limit to preserve battery health
10. NVidia GPU overclocking and undervolting
11. XG Mobile Control
12. AMD CPU Undervolting and temp limits
13. BIOS and Driver Updates
14. Asus Mice controls
15. Mini-led multi-zone switch
16. Flicker-free dimming and Visual Modes

### :gear: Automation
- Performance Mode switching when on battery or plugged in
- Optimized GPU mode - disables dGPU on battery and enables when plugged in
- Auto Screen refresh rate (60Hz on battery and max Hz when plugged)
- Keyboard backlight timeout on battery or when plugged in

### :rocket: Performance Modes
>[!NOTE]
>All Modes are **baked into BIOS** along with default fan curves and power limits. And and they are the **same thing** as in the Armoury Crate.

Each default BIOS mode is paired with matching [Windows Power Mode](https://support.microsoft.com/en-us/windows/change-the-power-mode-for-your-windows-pc-c2aff038-22c9-f46d-5ca0-78696fdf2de8). You can adjust this setting under ``Fans + Power``

1. `Silent` in BIOS + `Best power efficiency` power mode
2. `Balanced` (Performance in AC) in BIOS  + `Balanced` power mode
3. `Turbo` in BIOS + `Best performance` power mode



### :video_game: GPU Tweaking

In each mode dedicated GPU can be tweaked to specific needs, including Core and Memory Clock offsets, GPU power, Dynamic Boost, Temperature Limit etc


### 💻 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 in (Standard)



### 💿Driver Updates
The app includes an automatic BIOS and driver update checker that pulls directly from the official Asus website for your specific model, highlighting new downloads as they become available. All links in the `Updates` section point to official Asus downloads.


### 🎮 Metrics Overlay
A built-in in-game overlay (OSD) that shows live **FPS, CPU / GPU temperatures, usage and power** right on top of your game - no extra tools needed. Works in DX10+ games. May not be visible over old titles that use exclusive full-screen mode, so set the game to windowed / borderless full-screen mode.

- ``Ctrl + Shift + Alt + O`` - Toggle in-game overlay ON / OFF
- ``Ctrl + Shift + Alt + Mouse Drag`` - Move overlay
- ``Ctrl + Shift + Alt + Mouse Click`` - Switch mode (Light / Default / Full / Complete)
- ``Ctrl + Shift + Alt + Wheel`` - Resize overlay
- ``Ctrl + Shift + Alt + Wheel Click`` - Reset overlay size




### :mouse: Asus Mouse and other peripherals support


[Currently supported models](https://github.com/seerge/g-helper/discussions/900) (click to expand)

- ROG Chakram
- ROG Chakram X
- ROG Chakram Core
- ROG Gladius II and Gladius II Origin (+ PNK LTD / COD editions)
- ROG Gladius II Wireless
- ROG Gladius III
- ROG Gladius III Wireless
- ROG Gladius III Aimpoint Wireless (+ EVA-02 Edition)
- ROG Harpe Ace Extreme
- ROG Harpe Ace Aim Lab Edition
- ROG Harpe Ace Mini
- ROG Harpe II Ace
- ROG Harpe II Extreme Edition 20
- ROG Keris and Keris Wireless (+ EVA Edition)
- ROG Keris Wireless Aimpoint
- ROG Keris II Ace
- ROG Keris II Origin (+ KJP edition)
- ROG Pugio
- ROG Pugio II
- ROG Spatha X
- ROG Strix Carry
- ROG Strix Evolve
- ROG Strix Impact
- ROG Strix Impact II (+ Electro Punk / Moonlight White editions)
- ROG Strix Impact II Wireless
- ROG Strix Impact III
- ROG Strix Impact III Wireless
- TUF Gaming M3
- TUF Gaming M3 Gen II
- TUF Gaming M4 Wireless
- TUF Gaming M4 AIR
- TUF Gaming M5
- TUF Gaming Mini Miku Edition
- TX Gaming Mouse
- TX Gaming Mouse Mini
- ASUS MD200



Huge thanks to [@IceStormNG](https://github.com/IceStormNG) 👑 for contribution and research (!).



### :keyboard: Asus Keyboards support


[Currently supported models](https://github.com/seerge/g-helper/discussions/5710) (click to expand)

- ROG Azoth
- ROG Azoth Extreme
- ROG Azoth X
- ROG Claymore II
- ROG Falchion
- ROG Falchion Ace
- ROG Falchion Ace HFX
- ROG Falchion RX
- ROG Falchion RX Low Profile
- ROG Strix Flare
- ROG Strix Flare II
- ROG Strix Flare II Animate
- ROG Strix Scope II
- ROG Strix Scope II RX
- ROG Strix Scope II 96
- ROG Strix Scope II 96 RX
- ROG Strix Scope RX
- ROG Strix Scope RX TKL
- TUF Gaming K1
- TUF Gaming K3
- TUF Gaming K3 Gen II





### ⌨️ Keybindings

- ``Fn + F5 / Fn + Shift + F5`` - Toggle Performance Modes forwards / backwards
- ``Ctrl + Shift + F5 / Ctrl + Shift + Alt + F5`` - Toggle Performance Modes forwards / backwards
- ``Ctrl + Shift + F12`` - Open G-Helper window
- ``Ctrl + M1 / M2`` - Screen brightness Down / Up
- ``Shift + M1 / M2`` - Backlight brightness Down / Up
- ``Fn + V`` - Visual Modes
- ``Fn + C`` / ``Fn + Esc`` - Fn-Lock
- ``Fn + Ctrl +  F7 / F8`` / ``Ctrl + Shift + Alt +  F7 / F8`` - Flicker-free dimming Down / Up
- ``Fn + Shift + F7 / F8`` - Matrix / Slash Lighting brightness Down / Up
- ``Fn + Shift + F7 / F8`` / ``Ctrl + Shift + Alt +  F7 / F8`` - Screenpad brightness Down / Up
- ``Ctrl + Shift + F20`` - Mute Microphone
- ``Ctrl + Shift + Alt + F13`` - Toggle Display Refresh Rate
- ``Ctrl + Shift + Alt + F14`` - Eco GPU Mode
- ``Ctrl + Shift + Alt + F15`` - Standard GPU Mode
- ``Ctrl + Shift + Alt + F16`` - Silent
- ``Ctrl + Shift + Alt + F17`` - Balanced
- ``Ctrl + Shift + Alt + F18`` - Turbo
- ``Ctrl + Shift + Alt + F19`` - Custom 1 (if exists)
- ``Ctrl + Shift + Alt + F20`` - Custom 2 (if exists)
- [Custom keybindings / hotkeys](https://github.com/seerge/g-helper/wiki/Power-user-settings#custom-hotkey-actions)

### 🎮ROG Ally Bindings
- ``M + DPad Left / Right`` - Display Brightness
- ``M + DPad Up`` - Touch keyboard
- ``M + DPad Down`` - Show desktop
- ``M + Y`` - Toggle AMD overay
- ``M + X`` - Screenshot
- ``M + Right Stick Click`` - Controller Mode

------------------

> [!NOTE]
> ### 🔖 Important Notice
> G-Helper is **NOT** an operating system, firmware, or driver. It **DOES NOT** "run" your hardware in real-time anyhow.
> 
> It's an app that lets you select one of the predefined operating modes created by manufacturer (and stored in BIOS) and optionally(!) set some settings that already exist on your device same as Armoury Crate can. It does it by using the Asus System Control Interface "driver" that Armoury uses for it.
> 
> If you use equivalent mode/settings as in Armoury Crate - the performance or the behavior of your device won't be different.
> 
> The role of G-Helper for your laptop is similar to the role of a remote control for your TV.

### Libraries and projects used
- [Linux Kernel](https://github.com/torvalds/linux/blob/master/include/linux/platform_data/x86/asus-wmi.h) for some basic endpoints in ASUS ACPI/WMI interface
- [NvAPIWrapper](https://github.com/falahati/NvAPIWrapper) for accessing Nvidia API
- [Starlight](https://github.com/vddCore/Starlight) for anime matrix communication protocol
- [UXTU](https://github.com/JamesCJ60/Universal-x86-Tuning-Utility) for undervolting endpoints using Ryzen SMU
- [PawnIO](https://github.com/namazso/PawnIO) for access to RyzenSMU
- [AsusCtl](https://gitlab.com/asus-linux/asusctl) for inspiration and some reverse engineering
- [OpenRGB](https://gitlab.com/CalcProgrammer1/OpenRGB) for some RGB protocol details for external keyboards support

### Code Signing Policy
Free code signing provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/)

### Privacy Policy
This program will not transfer any information to other networked systems

### Disclaimers
"Asus", "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” AND 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.

---

## File: docs/README.zh-CN.md

# G-Helper - 华硕笔记本的轻量级控制工具

小巧轻量的 Armoury Crate（奥创控制中心）替代品，为华硕笔记本提供几乎相同的功能，却拥有小得多的资源占用。兼容所有主流型号，例如 ROG 幻14 / 幻15 / 幻16、幻X（Flow 翻转系列）、幻16 Duo 双屏、天选（飞行堡垒）系列、枪神 / 魔霸系列、ProArt 创、无畏（Vivobook）、灵耀（Zenbook）、ExpertBook、ROG Ally 与 Ally X 等众多机型！

[](https://GitHub.com/seerge/g-helper/releases/)
[](https://GitHub.com/seerge/g-helper/releases/)
[](https://github.com/seerge/g-helper/attestations)
[](https://github.com/seerge/g-helper#readme)
[](https://github.com/seerge/g-helper/blob/main/docs/README.ja-JP.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.cs-CZ.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.es-ES.md)
[](https://github.com/seerge/g-helper/blob/main/docs/README.ko-KR.md)
[](https://github.com/seerge/g-helper/releases/latest/download/GHelper.exe)


[](https://github.com/seerge/g-helper/releases/latest/download/GHelper.exe) &nbsp; [](https://g-helper.com/support)

**⭐ 喜欢这个应用？欢迎帮忙宣传推广。**

- [常见问题（FAQ）](https://g-helper.com/zh/faq/)
- [安装与要求](https://g-helper.com/zh/requirements/)
- [故障排除](https://g-helper.com/zh/troubleshooting/)
- [高级用户设置](https://g-helper.com/zh/power-user-settings/)


[](https://u24.gov.ua/)

## :loudspeaker: 视频测评与指南
| [](https://www.bilibili.com/video/BV1cQbBzPE6x/) | [](https://www.bilibili.com/video/BV15h4y127ub/) | [](https://www.bilibili.com/video/BV1uFHpeZEY4/) |
| ----------------- | ---------------- | ---------------- | 
| [测无止境](https://www.bilibili.com/video/BV1cQbBzPE6x/) | [叠甲者抗揍也](https://www.bilibili.com/video/BV15h4y127ub/) | [方氺](https://www.bilibili.com/video/BV1uFHpeZEY4/) | 

## 📰 媒体报道
1. [Digital Trends](https://www.digitaltrends.com/computing/g-helper-armoury-crate-alternative/)
2. [Notebookcheck](https://www.notebookcheck.net/Unbloated-G-Helper-The-best-open-source-alternative-to-Asus-Armoury-Crate-Part-2.1213486.0.html)
3. [知乎](https://zhuanlan.zhihu.com/p/663917638)
4. [Chiphell](https://www.chiphell.com/thread-2719738-1-1.html)

## :gift: 主要优点 

1. 无缝且自动的 GPU 切换
2. 所有性能模式均可通过功耗限制和风扇曲线完全自定义
3. 轻量化。只需运行单个 exe 文件，不会在系统中安装任何东西。
4. 简洁清爽的原生界面，可轻松访问所有设置
5. FN 锁定和自定义热键



### :zap: 功能

1. 性能模式：静音 - 平衡 - 增强（内置，附带默认风扇曲线）
2. 显卡模式：集显 - 标准 - 独显直连 - 自动优化
3. 屏幕刷新率控制，支持显示 Overdrive（屏幕过驱）
4. 为每个性能模式提供自定义风扇曲线编辑器、功耗限制和睿频（Turbo Boost）选择
5. Anime Matrix 光显矩阵或 Slash Lighting 光效控制，包括动画 GIF、时钟和音频可视化
6. RGB 背光动画模式与颜色
7. 热键处理
8. 监控 CPU 和 GPU 温度、风扇转速及电池状态
9. 电池充电上限设置，保护电池健康
10. NVIDIA GPU 超频与降压
11. XG Mobile 控制
12. AMD CPU 降压与温度限制
13. BIOS 与驱动更新
14. 华硕鼠标控制
15. Mini-LED 多区域调光开关
16. 无闪烁调光与显示风格（Visual Modes）

### :gear: 自动化
- 使用电池或接入电源时自动切换性能模式
- 自动优化 GPU 模式 - 电池供电时禁用独显，接入电源时启用
- 自动屏幕刷新率（电池供电时 60Hz，接入电源时为最高刷新率）
- 电池供电或接入电源时的键盘背光超时

### :rocket: 性能模式
>[!NOTE]
>所有模式连同默认风扇曲线和功耗限制都**内置于 BIOS** 中，并且与 Armoury Crate 中的**完全相同**。

每个默认 BIOS 模式都与对应的 [Windows 电源模式](https://support.microsoft.com/en-us/windows/change-the-power-mode-for-your-windows-pc-c2aff038-22c9-f46d-5ca0-78696fdf2de8) 配对。你可以在 ``风扇 + 电源`` 中调整该设置。

1. BIOS 中的 `静音` + `最佳能效` 电源模式
2. BIOS 中的 `平衡`（接入电源时为 Performance）+ `平衡` 电源模式
3. BIOS 中的 `增强` + `最佳性能` 电源模式



### :video_game: GPU 调校

在每个模式下，都可以根据具体需求调校独立显卡，包括核心和显存频率偏移、GPU 功耗、Dynamic Boost、温度限制等


### 💻 显卡模式

1. **集显（Eco）**：仅启用低功耗的集成显卡，由核显驱动内置屏幕
2. **标准（Standard，MS Hybrid）**：同时启用核显和独显，由核显驱动内置屏幕
3. **独显直连（Ultimate）**：同时启用核显和独显，但由独显驱动内置屏幕（2022 年及以后的机型支持）
4. **自动优化（Optimized）**：电池供电时禁用独显（集显），接入电源时启用（标准）



### 💿 驱动更新
本应用内置自动 BIOS 和驱动更新检查器，直接从华硕官网针对你的具体型号拉取更新，并在有新下载可用时予以提示。`更新` 部分中的所有链接均指向华硕官方下载。


### 🎮 性能指标叠加层（Overlay）
内置的游戏内叠加层（OSD），可在游戏画面上直接显示实时 **FPS、CPU / GPU 温度、占用率和功耗** —— 无需额外工具。支持 DX10+ 游戏。在使用独占全屏模式的旧游戏上可能不显示，请将游戏设置为窗口化 / 无边框全屏模式。

- ``Ctrl + Shift + Alt + O`` - 开启 / 关闭游戏内叠加层
- ``Ctrl + Shift + Alt + 拖动鼠标`` - 移动叠加层
- ``Ctrl + Shift + Alt + 单击鼠标`` - 切换模式（精简 / 默认 / 完整）
- ``Ctrl + Shift + Alt + 滚轮`` - 调整叠加层大小
- ``Ctrl + Shift + Alt + 滚轮单击`` - 重置叠加层大小




### :mouse: 华硕鼠标及其他外设支持


[目前支持的型号](https://github.com/seerge/g-helper/discussions/900)（点击展开）

- ROG Chakram X
- ROG Chakram Core
- ROG Gladius II and Gladius II Origin
- ROG Gladius II Wireless
- ROG Gladius III
- ROG Gladius III Wireless
- ROG Harpe Ace Extreme
- ROG Harpe Ace Aim Lab Edition
- ROG Harpe Ace Mini
- ROG Harpe II Ace
- ROG Keris Wireless
- ROG Keris II Ace
- ROG Keris Wireless Aimpoint
- ROG Strix Carry
- ROG Strix III Gladius III Aimpoint Wireless
- ROG Strix Impact III
- ROG Strix Impact III Wireless
- ROG Spatha X
- ROG Strix Impact II Wireless
- ROG Pugio
- ROG Pugio II
- TUF Gaming M4 Wireless
- TUF Gaming M3
- TUF Gaming M3 Gen II
- TUF Gaming M4 AIR
- TUF Gaming M5
- TX Gaming Mini



特别感谢 [@IceStormNG](https://github.com/IceStormNG) 👑 的贡献与研究（！）。



### ⌨️ 按键绑定

- ``Fn + F5 / Fn + Shift + F5`` - 向前 / 向后切换性能模式
- ``Ctrl + Shift + F5 / Ctrl + Shift + Alt + F5`` - 向前 / 向后切换性能模式
- ``Ctrl + Shift + F12`` - 打开 G-Helper 窗口
- ``Ctrl + M1 / M2`` - 屏幕亮度 调低 / 调高
- ``Shift + M1 / M2`` - 背光亮度 调低 / 调高
- ``Fn + V`` - 显示风格（Visual Modes）
- ``Fn + C`` / ``Fn + Esc`` - Fn 锁定
- ``Fn + Ctrl +  F7 / F8`` / ``Ctrl + Shift + Alt +  F7 / F8`` - 无闪烁调光 调低 / 调高
- ``Fn + Shift + F7 / F8`` - 光显矩阵 / Slash 光效亮度 调低 / 调高
- ``Fn + Shift + F7 / F8`` / ``Ctrl + Shift + Alt +  F7 / F8`` - 触控屏（Screenpad）亮度 调低 / 调高
- ``Ctrl + Shift + F20`` - 麦克风静音
- ``Ctrl + Shift + Alt + F13`` - 切换屏幕刷新率
- ``Ctrl + Shift + Alt + F14`` - 集显模式
- ``Ctrl + Shift + Alt + F15`` - 标准模式
- ``Ctrl + Shift + Alt + F16`` - 静音
- ``Ctrl + Shift + Alt + F17`` - 平衡
- ``Ctrl + Shift + Alt + F18`` - 增强
- ``Ctrl + Shift + Alt + F19`` - 自定义 1（如果存在）
- ``Ctrl + Shift + Alt + F20`` - 自定义 2（如果存在）
- [自定义键位 / 热键](https://g-helper.com/zh/power-user-settings/)

### 🎮 ROG Ally 按键
- ``M + DPad Left / Right`` - 显示亮度
- ``M + DPad Up`` - 触摸键盘
- ``M + DPad Down`` - 显示桌面
- ``M + Y`` - 切换 AMD 叠加层
- ``M + X`` - 截屏
- ``M + Right Stick Click`` - 手柄模式

------------------

> [!NOTE]
> ### 🔖 重要提示
> G-Helper **不是**操作系统、固件或驱动程序。它**不会**以任何方式实时“运行”你的硬件。
> 
> 它只是一个应用程序，让你选择制造商预先创建（并存储在 BIOS 中）的某个运行模式，并可选地（！）设置一些你设备上本就存在的设置，这与 Armoury Crate 的做法相同。它通过使用 Armoury Crate 所用的华硕系统控制接口（Asus System Control Interface）“驱动”来实现这一切。
> 
> 如果你使用与 Armoury Crate 相同的模式 / 设置 —— 你设备的性能或行为不会有任何差异。
> 
> G-Helper 对你笔记本的作用，类似于遥控器对你电视的作用。

### 使用的库与项目
- [Linux Kernel](https://github.com/torvalds/linux/blob/master/include/linux/platform_data/x86/asus-wmi.h) 用于华硕 ACPI/WMI 接口中的一些基础端点
- [NvAPIWrapper](https://github.com/falahati/NvAPIWrapper) 用于访问 Nvidia API
- [Starlight](https://github.com/vddCore/Starlight) 用于光显矩阵通信协议
- [UXTU](https://github.com/JamesCJ60/Universal-x86-Tuning-Utility) 用于使用 Ryzen SMU 进行降压的端点
- [PawnIO](https://github.com/namazso/PawnIO) 用于访问 RyzenSMU
- [AsusCtl](https://gitlab.com/asus-linux/asusctl) 提供灵感与部分逆向工程

### 代码签名政策
免费的代码签名由 [SignPath.io](https://about.signpath.io/) 提供，证书由 [SignPath Foundation](https://signpath.org/) 提供

### 隐私政策
本程序不会向任何其他联网系统传输任何信息

### 免责声明
“Asus”、“ROG”、“TUF” 和 “Armoury Crate” 是 AsusTek Computer, Inc. 的注册商标，归其所有。我对这些以及任何属于 AsusTek Computer 的资产不主张任何权利，仅出于信息传递目的使用它们。

本软件按“现状”提供，不附带任何形式的明示或暗示保证，包括但不限于对适销性、特定用途适用性和非侵权的保证。滥用本软件可能导致系统不稳定或故障。

_注：请务必以下方 **Disclaimers** 英文原文为准，以避免或减小因错误或不恰当之翻译引起的负面影响。翻译仅为便于阅读之目的，并非专业翻译，可能存在错误，亦可能与最新版本有所差异。本文不具有法律效力，亦不作为发生争端时处理之依据。_

**Disclaimers**
"Asus", "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” AND 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.