このプロジェクトについて

MangoHudは、Linux上のアプリケーションやゲームのパフォーマンスを監視するためのオープンソースのVulkan/OpenGLオーバーレイです。FPS、フレームタイムグラフ、CPUとGPUの負荷、温度、消費電力、クロック、ファン回転数、バッテリー状態など、多数のメトリクスを実行中のアプリケーション上に直接表示します。 使い方:任意のアプリを 'mangohud /path/to/app' で実行するか、Lutrisでコマンド接頭辞に 'mangohud' を追加するか、Steamの起動オプションで 'mangohud %command%' を使用します。Vulkanアプリは MANGOHUD=1 を設定してグローバルに有効化することもできます。OpenGLゲームは dlsym フッキングを使用します(デフォルトで有効、MANGOHUD_DLSYM=0 で無効化可能)。gamescopeセッションでは、'gamescope --mangoapp' 経由で mangoapp と呼ばれる補助アプリを使用します。 設定は豊富です。オプションはグローバル設定ファイル、~/.config/MangoHud内のアプリ別設定(Wine/Protonアプリ向けの wine- 接頭辞付き設定を含む)、または MANGOHUD_CONFIG 環境変数で設定できます。サポートされるパラメータには、異方性フィルタリング、テキスト/背景の不透明度、カスタムフォントとグリフ範囲(韓国語、中国語、日本語、キリル文字、タイ語、ベトナム語を含む)、コアごとのCPU負荷と周波数表示、コアタイプ表示(Intelのパフォーマンス/高効率コア、ARMコア名)、GPUジャンクション/メモリ温度、GPU電圧と電力制限、ワイヤレスデバイスのバッテリー(ゲームパッド、マウス)、Steam DeckのファンRPM、エンジンバージョン、ディスプレイサーバー、負荷やFPSに応じてテキスト色を変えるカラーしきい値が含まれます。さらに、タイミング方法、フレーム数、ヒストグラムモード、横並びとコンパクトレイアウト、カスタムテキスト、シェルコマンドの実行とその出力をHUDに表示する機能を備えたFPSリミッターも含まれます。 FPSロギングは、パーセンタイルを設定可能なベンチマークサマリーを出力できます(デフォルトは 97,AVG,1,0.1)。ログは FlightlessMango.com でオンライン可視化するか、同梱の mangoplot ツールでローカルで可視化できます。キーバインドにより、実行中にHUDの切り替えやメトリクスのリセットが可能です。 インストールオプションは多くのディストリビューションをカバーしています:GitHubリリースからのプリビルドtarball、Arch公式パッケージ(mangohud と lib32-mangohud)、Debian 11+/Ubuntu 21.10+(apt install mangohud、Debianでは32ビットパッケージあり)、Fedora(dnf)、Solus(eopkg)、openSUSE(zypper、32ビットパッケージあり)、および flatpak override で全Steamゲームに有効化できるFlatpakランタイム(org.freedesktop.Platform.VulkanLayer.MangoHud)。ソースからのビルドは meson と ninja を使用し、Ubuntuベース、Archベース、Fedoraベース、openSUSEベースのディストリビューションで依存関係をインストールできる build.sh ヘルパースクリプトがあり、64ビットビルドと並行して32ビットビルドもサポートします。オプションのビルド機能には、NVIDIAメトリクス向けの NVML と XNVCtrl、X11/Waylandキーバインドサポート、メディアプレーヤー機能向けの D-Bus、mangoapp、mangohudctl、mangoplot が含まれます。 MangoHudを設定するためのサードパーティGUIには、GOverlay(Qt)とMangoJuice(GTK)があります。READMEには、LD_PRELOADを上書きするOpenGLゲーム用の回避策も記載されており、メトリクスサポートはGPUベンダーとドライバーによって異なることが注記されています。