OmniConsole v4.2.0.0

v4.2.0.0: Nekomata's Familiar Kindles the Flame

🌐 Official Website — documentation, features overview, and installation guide.
🐱 Teach Nekomata your language — she's all ears, so teach her a new language, or help her say it more naturally.
See the live translation status for the latest.
🕹️ Share your custom platform — export a platform you have set up and open a pull request, so everyone else can add it with a single click.

I'd love to introduce you to a new charm in Nekomata's house this time: PhantomIgnis. What it tends is the layer that floats above your games: how large the numbers sit, whether the frames are held back, and what you see while you play. All of that can be adjusted from inside OmniConsole now, and the widget carries the same controls, so they stay within reach while you're playing. There's a small story behind it, actually. It was Father's Day in Taiwan, the eighth of August, and I'd gone back to my parents' place; I sat curled up on their couch, working on the test machine back home over Remote Desktop, and nothing I did would call it up. It took me rather a while to see it: the familiar who runs her errands, PhantomSigil, kept asking who was sitting in front of the screen, and just then there was nobody sitting in front of it at all, when I was still on their couch. It wasn't broken. It was simply asking the wrong question. So from this version on, whether you're at the console yourself or connected from somewhere else, she comes up on the side you're actually on.

Then there's the ROG Ally family. Those consoles ship with a gamepad mapping of their own, and Nekomata has always deferred to it. I've always believed that a good tool should already be right when you open it, so by default I stand with what the manufacturer set up and stay out of its way. Still, among the people who use OmniConsole there are always a few who've already tuned Nekomata to their liking on a desktop and would love the same on a handheld, and Pro hands that choice back to you. Turn it on, follow the note on screen to adjust the control mode, and the Nekomata on your handheld is the one you tuned on your desktop.

From the very beginning, writing this software has been my way of raising a tiny living thing. Her name is Nekomata, a creature out of Japanese folklore: a cat who's lived long enough for her tail to split in two, and who's said, rather wonderfully, to command a phantom fire. That's why she wears the colors of that very flame, and why everything around her carries a phantom's name. I fed her one line at a time, and raised her to where she is today. Those Pro options dotted here and there are simply how I keep this going; to put it plainly, it's that support that lets me keep putting my time here. There's a Pro page in the settings, and it'd be lovely if you took a look. As for what she grows into next, I'm honestly more curious than anyone~

✨ New Features (v4.2.0.0)

• Performance Overlay Controls (Pro) (#8, #22): Game Bar comes with Microsoft's own Performance widget for watching your framerate and system usage while you play. Pro adds a separate set of controls, for adjusting RivaTuner Statistics Server's on-screen display from inside OmniConsole. Under Settings → Advanced → Performance Overlay you can turn the on-screen display on or off, show its framerate statistics, add a shadow behind the text, scale it up, and set a framerate limit. The OmniCharm widget carries the same controls on its Overlay tab, so they are within reach while a game is running. Requires Administrator App Support and RivaTuner Statistics Server.
  
• Nekomata Mode on the ROG Ally family (Pro): these consoles ship with the manufacturer's own gamepad mapping, and Nekomata has always deferred to it. Pro makes that a choice: turn it on under Settings → Advanced, then set Control Mode to Gamepad in Command Center. Everything Nekomata does on a PC she does here too, with the same layouts, the same per-app charms, and the same editor you already know. It starts out off, and asks for confirmation the first time, whether from Settings or from the OmniCharm widget.
• Complete Xbox Mode (FSE) setup: at startup, OmniConsole recognizes when this console can run Xbox Mode (FSE) with the full experience, and offers to apply the settings it needs. Choose Apply, grant administrator approval once, then restart your console and it is done. Handheld consoles are left exactly as they are.

🔧 Improvements (v4.2.0.0)

• One action, one sound: opening the custom layout editor with Edit… beside Controller Layout Preset answers with a single, clean note.
• The focus rests where you left it: opening the Pro page keeps the highlight on the navigation item you came from, in step with every other settings page.
• Every direction leads somewhere: in the Custom Layout editor, pressing down from the title always carries you into the tools below, whether or not Copy from App… is available to you.
• It works in the session you signed in to: once Administrator App Support is installed, PhantomKey and PhantomIgnis come up in the session you are actually using, whether you are sitting at the console or connected over Remote Desktop.
• Component integrity verification: OmniConsole verifies the digital signature and integrity of every component before starting it, loading it, or introducing it into a game, and keeps each file protected from the moment of verification until it is in use.
• Verified access to the performance overlay: the tuning agent identifies each caller before applying any change, so overlay settings respond only to OmniConsole itself.
• Your answer comes first: when something at startup needs your confirmation, OmniConsole waits until you have settled it before taking you into your platform.

✨ New Features (v4.1.0.0)

• OmniConsole Pro: a new Pro page in Settings. OmniConsole is a personal interest project, written and maintained by a solo developer in their own free time, and your support keeps it going. A Pro license is obtained from that page, and activating it unlocks the advanced features below. The page also shows who the license is for along with the licenses on this console.

• Administrator App Support (Pro): gamepad mappings reach apps and games that run as administrator. Install it from Settings → Advanced → Nekomata and approve the administrator prompt, and Nekomata Mode extends to those apps. The OmniCharm widget also opens the mapping editor for an app that runs as administrator.
  

• Custom Controller Layout (Pro): define your own default layout alongside OmniNav and Classic. Choose Custom under Settings → Advanced → Nekomata → Controller Layout Preset, then click Edit… to arrange the controller's inputs. Apps covered by built-in mapping pick it up right away, and every new app profile starts from it, so the bindings you like no longer have to be copied over one app at a time. The OmniCharm widget can switch to it as well.
  

• Screen keyboards from any button (Pro): Windows brings up a screen keyboard from Game Bar, under Settings → Show keyboard. Pro adds a direct route: assign one to a controller button in the mapping editor and it opens without interrupting what you are doing. Pick the Gamepad keyboard, which you type on with the controller itself, or the classic On-screen keyboard, which you point at with the cursor. The On-screen keyboard also requires Administrator App Support. The Gamepad keyboard closes with the B button, and the On-screen keyboard closes when you press the same button again.
  

🔧 Improvements (v4.1.0.0)

• Gamepad mapping support for EA Desktop: EA Desktop is one of the apps that ship in a versioned folder. A profile you set up for it now covers every version it updates to, handled the same way as apps such as GitHub Desktop. EA Desktop is also covered by the built-in keyboard-and-mouse mapping now.
• The Open with dialog works in Nekomata Mode out of the box: the dialog you pick an app from now uses built-in mapping like the Windows file picker, so you can choose an app with your gamepad without setting up a custom profile first.
• Task Manager works in Nekomata Mode (Pro): Task Manager uses built-in mapping like File Explorer, so no custom profile is needed. Task Manager runs as administrator, so this one goes together with Administrator App Support.

🎮 Nekomata Mode Cheat Sheet

Button	OmniNav	Classic
Left Stick	Cursor	Scroll
Right Stick	Scroll	Cursor
A	Left Click	Enter
B	Right Click	Esc
X	Page Down	Page Down
Y	Page Up	Page Up
LB	Ctrl+Shift+Tab	Tab
RB	Ctrl+Tab	Left Click
LT	Esc	Shift+Tab
RT	Enter	Right Click
LS	Shift+Tab	—
RS	Tab	—
D-pad	Arrow Keys	Arrow Keys

• On / Off toggle. When on, your customized profiles take over and the apps below use built-in mapping (also customizable): Edge, Chrome, Firefox, Opera, Brave, Epic Games Store, EA Desktop, Playnite Desktop, File Explorer, Windows File Picker, the Open with dialog, Windows Installer, Steam, Discord, and Task Manager (needs Administrator App Support, a Pro feature).
• Toggleable via the OmniCharm Game Bar widget.
• On the ROG Ally family, which ships with the manufacturer's built-in gamepad mapping, Nekomata Mode stays out of the way. Pro can turn it on for those consoles.

🎮 Gamepad Steam Shortcuts

Button	Action
⧉ (short press)	Open Steam menu¹
⧉ (long press)	Open Quick Access menu¹
☰ (long press)	Open Steam In-Game Overlay²˒³

¹ In Steam Big Picture　² In-game　³ Toggleable via the OmniCharm Game Bar widget

---

v4.2.0.0：貓又的使魔燃起業火

🌐 前往官方網站：完整文件、功能介紹與安裝指南。
🐱 教貓又說你的語言：貓又正洗耳恭聽！教她一種新語言，或幫她說得更自然。
最新進度請見即時翻譯狀態。
🕹️ 分享你的自訂平台：把你設定好的平台匯出並發起 pull request，其他人就能一鍵加入。

這一版，貓又家裡多了一道咒，幻影之火（PhantomIgnis）。它照看的是浮在遊戲上面的那一層：數字擺多大、要不要把幀數收著、玩的時候讓你看見什麼；這些現在都能直接在 OmniConsole 裡調，小工具上也備了同一組，遊戲進行中伸手就到。說起來，它剛做好的那陣子有個問題，是我在老家發現的。那幾天回去過八八父親節，人窩在老家的沙發上，就用遠端桌面連回家裡那台測試機接著做，結果那道咒怎麼樣都召不出來。查了好一陣子才看懂：是替她辦事的那個使魔，幻影之印，一直在問「現在坐在螢幕前面的是誰」，可那時候螢幕前面根本沒有人，我人在老家呢。它沒有壞，只是問錯了問題。所以這一版之後，不管你是坐在主機前面，還是從別的地方連進來，她都會在你真正待著的那一頭。

這一版另一件事，是 ROG Ally 家族。那類掌機出廠就帶著自己的一套手把映射，貓又一直是為它讓路的。我一直相信好用的東西應該打開就已經是對的那一種，所以預設我會站在原廠那邊，不去跟它搶。不過用 OmniConsole 的人裡，總有些人已經在桌上型電腦把貓又調得很順手，也想在掌機上用同一套，這次專業版就把這個選擇交回給你。打開它，照畫面上的提示把控制模式調一下，掌機上的她，就是你在桌上型電腦上調順的那一個。

說起來，我從一開始就把寫這套軟體當成是在養育一個小小的生命。她叫貓又，是日本傳說裡的妖怪，貓活得夠久，尾巴就會分成兩條，據說還會操弄火焰，所以她身上是鬼火的顏色，身邊的東西也都帶著「幻影」這個字。她是我一行一行餵大的，就這樣一路拉拔到今天。散落在各處的那些專業版選項，是我讓這件事能繼續做下去的方式；講白一點，有人願意贊助，我才有辦法一直把時間放在這裡。設定裡的「專業版」分頁就是那個入口，有空去看一眼也好。她之後還會長成什麼樣子，我自己也還在期待著呢~

✨ 新功能 (v4.2.0.0)

• 效能疊加層控制（專業版） (#8, #22)：Game Bar 本身就備有微軟提供的效能小工具，遊戲進行中可以看到幀率與系統使用量。專業版另備一組控制項，讓你在 OmniConsole 裡調整 RivaTuner Statistics Server 的螢幕顯示。於設定 → 進階 → 效能疊加層可開關螢幕顯示、顯示它的幀率統計、為文字加上陰影、放大顯示，以及設定幀率上限。OmniCharm 小工具的疊加層分頁備有同一組控制項，遊戲進行中也伸手可及。需搭配系統管理員程式支援與 RivaTuner Statistics Server。
  
• ROG Ally 家族主機上的貓又模式（專業版）：這類主機出廠即備有廠商自己的手把映射，貓又一向為它讓路。專業版讓這件事成為一個選擇：於設定 → 進階開啟，再到 Command Center（控制中心）把控制模式設為遊戲控制器。貓又在電腦上會的，在這裡她一樣會，同樣的版面配置、同樣的各程式咒語、同樣那個你已經熟悉的編輯器。它預設關閉，初次開啟時會請你確認一次，設定裡與 OmniCharm 小工具上都是如此。
• 完成 Xbox 模式 (FSE) 的設定：OmniConsole 會在啟動時看出這台主機可以讓 Xbox 模式 (FSE) 以完整體驗運作，並主動詢問是否為你套用所需的設定。按下套用、給予一次系統管理員授權，再重新啟動主機即可完成。掌上型主機維持原樣，不做任何更動。

🔧 改進 (v4.2.0.0)

• 一個動作，一聲回應：在控制器預設版面旁按下 編輯… 開啟自訂版面編輯器時，會得到乾淨俐落的一聲。
• 焦點停在你放下的地方：進入專業版分頁時，白框會留在你按下的導覽項目上，與其他設定分頁的節奏一致。
• 每個方向都通往某處：在自訂版面編輯器裡，從標題往下按一定會帶你進入下方的工具列，無論 從程式讀入… 當下是否可用。
• 在你登入的工作階段運作：安裝系統管理員程式支援之後，幻影之鑰（PhantomKey）與幻影之火（PhantomIgnis）會在你實際使用的工作階段裡就位，不論你人在主機前面，還是從遠端桌面連進來。
• 元件完整性驗證：OmniConsole 在啟動、載入或將任何元件帶進遊戲之前，都會驗證它的數位簽章與完整性，並自查驗起持續保護該檔案直到它投入使用。
• 效能疊加層的存取驗證：調校代理在套用任何變更前會先識別呼叫來源，疊加層設定因此僅回應 OmniConsole 本身。
• 先聽你的回答：啟動時若有需要你確認的事，OmniConsole 會等你處理完，再帶你進入平台。

✨ 新功能 (v4.1.0.0)

• OmniConsole 專業版：設定中新增專業版分頁。OmniConsole 是獨立開發者利用自己的閒暇時間撰寫與維護的個人興趣專案，你的支持能讓它繼續走下去。專業版授權可從該分頁取得，啟用後即可解鎖下列進階功能。頁面也會顯示授權對象，以及這台主機持有的授權。

• 系統管理員程式支援（專業版）：手把映射能作用於以系統管理員身分執行的程式與遊戲。在設定 → 進階 → 貓又點選安裝並通過系統管理員授權，貓又模式就會延伸到這類程式。OmniCharm 小工具也能為以系統管理員身分執行的程式開啟映射編輯器。
  

• 自訂控制器版面（專業版）：在 OmniNav 與經典之外，自己定義一套預設版面。於設定 → 進階 → 貓又 → 控制器預設版面選擇自訂，再點 編輯… 編排手把的輸入位。內建映射涵蓋的程式會立即套用，新增的程式設定檔也以它為起點，喜歡的按鍵配置不必再一個程式一個程式抄過去。OmniCharm 小工具也能切換到它。
  

• 用手把叫出螢幕鍵盤（專業版）：Windows 本身就能從 Game Bar 的設定 → 顯示鍵盤叫出螢幕鍵盤。專業版多一條直達路線：在映射編輯器裡把任一按鍵映射成叫出鍵盤，手邊的事不必中斷。可選用手把直接打字的遊戲控制器鍵盤，或以游標點按的螢幕小鍵盤。螢幕小鍵盤另需系統管理員程式支援。遊戲控制器鍵盤按 B 鍵關閉，螢幕小鍵盤再按一次同一顆鍵即關閉。
  

🔧 改進 (v4.1.0.0)

• EA Desktop 的手把映射支援：EA Desktop 屬於以版本資料夾封裝的程式，你為它自訂的手把設定檔現在通用日後所有版本，處理方式與 GitHub Desktop 等 App 相同。此外，EA Desktop 現在也在內建鍵鼠導覽的涵蓋範圍內。
• 開啟方式對話方塊開箱即用支援貓又模式：讓你挑選要用哪個程式開啟檔案的對話方塊，現在與 Windows 檔案選擇器一樣套用內建映射，不必再自訂設定檔，就能用手把挑選。
• 工作管理員支援貓又模式（專業版）：工作管理員與檔案總管一樣套用內建映射，不必自訂設定檔。工作管理員以系統管理員身分執行，因此這一項需搭配系統管理員程式支援。

🎮 貓又模式速查表

按鍵	OmniNav	經典
左搖桿	游標	滾輪
右搖桿	滾輪	游標
A	滑鼠左鍵	Enter
B	滑鼠右鍵	Esc
X	Page Down	Page Down
Y	Page Up	Page Up
LB	Ctrl+Shift+Tab	Tab
RB	Ctrl+Tab	滑鼠左鍵
LT	Esc	Shift+Tab
RT	Enter	滑鼠右鍵
LS	Shift+Tab	—
RS	Tab	—
十字鍵	方向鍵	方向鍵

• 開啟／關閉切換。開啟時，你自訂的設定檔會接手，下列程式則套用內建映射（同樣可自訂）：Edge、Chrome、Firefox、Opera、Brave、Epic Games Store、EA Desktop、Playnite 桌面版、檔案總管、Windows 檔案選擇器、開啟方式對話方塊、Windows Installer、Steam、Discord，以及工作管理員（需搭配系統管理員程式支援，屬專業版功能）。
• 可於 OmniCharm Game Bar 小工具切換。
• ROG Ally 家族具備廠商內建的手把映射，貓又模式在那裡會讓路；專業版可為這類主機開啟。

🎮 手把 Steam 快捷鍵

按鍵	動作
⧉（短按）	開啟 Steam 選單¹
⧉（長按）	開啟快速存取選單¹
☰（長按）	開啟 Steam 遊戲內嵌介面²˒³

¹ 於 Steam Big Picture 中　² 遊戲中　³ 可於 OmniCharm Game Bar 小工具切換

---

🛠️ 安裝說明

從下方 Assets 下載 OmniConsole_4.2.0.0_x64.zip 並解壓縮至任意資料夾。

方式 A：Install.bat（建議）

1. 執行 Install.bat，將自動開啟開發人員模式、安裝憑證、補齊相依框架套件，並安裝兩個 MSIX 套件。

方式 B：手動安裝

1. [重要] 前往 Windows 設定 → 系統 → 進階，啟用開發人員模式。
2. [重要] 點兩下 OmniConsole_4.2.0.0_x64.cer → 點選安裝憑證 → 存放區位置選擇本機電腦 → 將所有憑證放入以下的存放區 → 瀏覽 → 選擇受信任的人 → 完成。（若你之前已安裝過，則無需重複此步驟。）
3. （選用，僅全新／離線系統需要；連網系統會自動下載） 依序點兩下 Dependencies\ 中的檔案安裝相依框架套件（若顯示已安裝相同或更新版本可略過）。
4. 點兩下 OmniConsole_4.2.0.0_x64.msix 安裝主程式。
5. 點兩下 OmniConsole.PhantomLink_4.2.0.0_x64-widget.msix 安裝 OmniCharm 小工具。

⚙️ 前置條件

• Windows 11 24H2 (Build 26100.7019)+，且已啟用 Xbox 模式 (FSE) 功能。
• OmniConsole 需要完整掌機版的 Xbox 模式 (FSE)。Microsoft 正逐步將受限 PC 版推送至一般 PC，請使用 Xbox Full Screen Experience Tool (XFSET) 切換至完整掌機版。
• 桌機、筆電、平板及未取得完整掌機版的掌機：請先執行 XFSET。
• 原生掌機裝置（如 ROG Xbox Ally 系列）：原廠即為完整掌機版，可直接安裝 OmniConsole。
• 需要 Xbox 手把：Game Bar、Xbox 模式 (FSE) 以及所有手把功能皆需使用具備 Xbox 按鈕的 XInput 相容控制器。

---

🛠️ Installation Instructions

Download OmniConsole_4.2.0.0_x64.zip from the Assets below and extract it to any folder.

Option A: Install.bat (Recommended)

1. Run Install.bat. It will enable Developer Mode, install the certificate, install any missing framework dependencies, and install both MSIX packages automatically.

Option B: Manual Install

1. [Critical] Go to Windows Settings → System → Advanced and enable Developer Mode.
2. [Critical] Double-click OmniConsole_4.2.0.0_x64.cer → click Install Certificate → Store Location: Local Machine → Place all certificates in the following store → Browse → select Trusted People → Finish. (Skip this step if you already have the certificate installed)
3. (Optional — only needed on fresh/offline systems; online systems fetch these automatically) Double-click each file inside Dependencies\ to install the bundled framework packages (skip any that report an equal or newer version already installed).
4. Double-click OmniConsole_4.2.0.0_x64.msix to install the main app.
5. Double-click OmniConsole.PhantomLink_4.2.0.0_x64-widget.msix to install the OmniCharm widget.

⚙️ Prerequisites

• Windows 11 24H2 (Build 26100.7019)+ with Xbox Mode (FSE) enabled.
• OmniConsole requires the Full Handheld edition of Xbox Mode (FSE). Microsoft is gradually rolling out a Limited PC edition to regular PCs — use Xbox Full Screen Experience Tool (XFSET) to switch to the Full Handheld edition.
• Desktops, Laptops, Tablets & Handhelds without the Full Handheld edition: Run XFSET first.
• Native Handheld Devices (e.g., ROG Xbox Ally series): Already on the Full Handheld edition — install OmniConsole directly.
• Xbox Controller Required: Game Bar, Xbox Mode (FSE), and all gamepad features require an Xbox-compatible (XInput) controller with an Xbox button.

Full Changelog: v4.1.0.0...v4.2.0.0

---

🔄 已安裝過 OmniConsole？直接在應用程式內更新

1. 開啟 OmniConsole 設定，前往 ☰ → 進階。
2. 點選檢查更新，再點下載並安裝。OmniConsole 會自動下載新版本並完成安裝。

🔁 手把映射的遷移：若你曾為以版本資料夾封裝的程式自訂過手把映射（在 v3.7.0.0 之前為 GitHub Desktop 等程式，或在 v4.1.0.0 之前為 EA Desktop），其既有設定檔仍綁在該程式當初的版本、該程式升級後便不會生效。請開啟該程式，從 OmniCharm 小工具點選自訂此程式的手把映射…，並在編輯器中按下儲存並返回，設定檔即會重新綁定、通用日後所有版本。重新綁定後，編輯器顯示的繫結執行檔路徑會以 app-{version} 標記版本段，代表此設定檔已通用所有版本，屬正常現象。

⚠️ 升級時請透過「應用程式內更新」或 Install.bat（解壓 OmniConsole_4.2.0.0_x64.zip 後可見），不要從下方 Assets 下載安裝 MSIX 套件。 「應用程式內更新」與 Install.bat 都會妥善處理被執行中的遊戲佔用的檔案；手動安裝 MSIX 套件會導致更新不完整或兩套件版本不一致。

🔄 Already have OmniConsole installed? Update from within the app

1. Open OmniConsole Settings, then go to ☰ → Advanced.
2. Click Check for Updates, then Download & Install. OmniConsole downloads the new version and installs it for you.

🔁 Gamepad mapping migration: if you customized the gamepad mapping for an app that ships in a versioned folder (such as GitHub Desktop on a version earlier than v3.7.0.0, or EA Desktop on a version earlier than v4.1.0.0), its existing profile is still tied to the app version it was set up on and stops applying once that app updates itself. Open the app, then from the OmniCharm widget tap Customize gamepad mapping for this app… and press Save & return. The profile is rebound and now applies across all future versions. After rebinding, the bound executable path shown in the editor marks the version segment as app-{version}, indicating the profile now covers every version — this is expected.

⚠️ Please update via the in-app updater or Install.bat (found after extracting OmniConsole_4.2.0.0_x64.zip), rather than downloading the MSIX packages from the Assets below. Both the in-app updater and Install.bat properly handle files still in use by a running game; installing the MSIX packages manually will leave the update incomplete or the two packages on mismatched versions.