OmniConsole v3.1.0.0

v3.1.0.0: Community Languages & Refined Dialog Experience

🌐 Official Website — documentation, features overview, and installation guide.

🐱 Teach Nekomata your language — She's all ears, nya~ Teach her a new language, or help her say it more naturally.

✨ New Features (v3.1.0.0)

• Choose your display language: a new language setting on the Advanced page lets you pick the interface language — English, Traditional Chinese, or Simplified Chinese — or follow your system language. The language change takes effect after a quick restart.
• Community language packs: OmniConsole can speak more languages, thanks to translations contributed by the community. A new Community Languages manager (Advanced page) lets you browse available languages, then download, update, or remove them — for both OmniConsole and the OmniCharm widget at once. Community languages appear in the language list, with their translator credited in both the list and the manager. Once installed, your languages stay fresh automatically: they're kept in step whenever you update OmniConsole, and refreshed when translators publish revisions.
• Nekomata's two-column key picker: when Nekomata helps you remap a button, choosing a key uses a two-column layout (like the file picker) — categories on the left (letters, numbers, function keys, modifiers, and more), the matching keys on the right — so keys are quick to find.
• Filter Nekomata's copy-from-another-app list: when Nekomata copies a gamepad mapping from another app for you, it keeps the familiar pick-from-a-list flow and also lets you type to filter, so you can quickly find the app you want to copy from.

🔧 Improvements (v3.1.0.0)

• Cleaner cursor on dropdowns and filter boxes: opening a dropdown or a type-to-filter box now keeps the mouse cursor as a normal arrow instead of a busy spinner — whether you open it with the gamepad or the mouse — working around a long-standing WinUI bug that Microsoft has yet to fix.
• Navigation sounds in filter boxes: browsing, selecting, or closing a filter box's suggestion list with the gamepad now plays navigation sounds, consistent with the rest of the app.
• Steadier dialog sizes: the change-key picker, the file picker, and the "copy from another app" picker now keep a steady size as you browse.
• Bigger preview and a wider file list: when picking a card background image in the file picker, the preview is now bigger and clearer, and the file list is wider too, so longer file names are less likely to be cut off.
• File picker sidebar highlights your location: while browsing files, the shortcuts and drives sidebar on the left highlights where you currently are.
• More accurate focus when going up: going up a level in the file picker now places the focus more accurately on the folder you just came out of.
• Adaptive gamepad navigation on the About page: gamepad navigation on the About page now adapts to the wide and narrow window layouts.
• Back to where you started after certificate details: opening the certificate details with the gamepad and closing it now takes you straight back to the button you opened it from.
• Back to the right card after editing a custom platform: after you save or cancel the add/edit-platform dialog with the gamepad, the gamepad highlight now returns to the platform card you were working on, just as it already did after deleting one.
• Clearer delete confirmation: when you reset an app's custom keys back to the built-in layout, the confirmation now names the app — so you know exactly which one you're clearing.

🎮 Gamepad Mouse 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

• Three states: Off (disabled) · Auto (Edge, Chrome, Firefox, Opera, Brave, Epic Games Store, File Explorer, Steam, Discord) · Force On (all apps).
• Toggleable via the OmniCharm Game Bar widget.
• Gamepad Mouse Mode is auto-disabled on ROG Ally family — devices with built-in gamepad mapping.

🎮 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

---

v3.1.0.0：社群語言上線，對話方塊體驗改進

🌐 前往官方網站：完整文件、功能介紹與安裝指南。

🐱 教貓又說你的語言：貓又豎起耳朵聽著喵～教她一種新語言，或幫她說得更自然。

✨ 新功能 (v3.1.0.0)

• 可自選顯示語言：進階頁新增語言設定，可選擇介面語言（英文、繁體中文、簡體中文），或跟隨系統語言。切換語言後重新啟動即生效。
• 社群語言檔：透過社群貢獻的翻譯，OmniConsole 能支援更多語言。進階頁新增社群語言管理介面，可瀏覽可用語言，並下載、更新或移除（主程式與 OmniCharm 小工具一次搞定）。社群語言會出現在語言清單中，譯者名稱也會在語言清單與管理介面上顯示。安裝後便會自動保持最新：每次更新 OmniConsole 時會一併同步，譯者發布修訂時也會自動更新。
• 貓又選鍵改用雙欄版面：貓又幫你重新對應按鍵時，選鍵改用雙欄版面（類似檔案選擇器），左邊是分類（字母、數字、功能鍵、修飾鍵等），右邊是該分類的按鍵，瀏覽更快、更好找。
• 貓又讀入映射時可篩選：貓又幫你從其他程式複製手把映射時，維持原本從清單挑選的方式，還能輸入文字篩選，程式多的時候更快找到想複製的來源。

🔧 改進 (v3.1.0.0)

• 下拉選單與篩選框的游標更俐落：展開下拉選單或輸入篩選框時（無論用手把或滑鼠），滑鼠游標都會維持正常的箭頭，而不是忙碌的轉圈圖示。這原是 WinUI 長期存在、微軟至今尚未修復的問題。
• 篩選框補上手把導航音效：用手把在可篩選的搜尋框上下瀏覽建議、選取或關閉清單時，現在都會有導航音效，與 App 其他地方一致。
• 對話視窗尺寸穩定：改鍵選擇器、檔案選擇器、「從其他程式讀入」選擇器在瀏覽時都維持穩定的大小。
• 更大的圖片預覽與更寬的檔案清單：在檔案選擇器挑選卡片背景圖時，預覽圖更大、看得更清楚；檔案清單也跟著變寬，較長的檔名比較不會被截成「…」。
• 檔案選擇器側邊欄點亮目前位置：瀏覽檔案時，左側的捷徑／磁碟欄會點亮你目前所在的位置。
• 返回上層時焦點更準確回到原資料夾：在檔案選擇器按返回上層後，焦點現在會更準確地停在你剛才進入的那個資料夾上。
• 關於頁手把導航自適應版面：手把在關於頁會依寬版與窄版版面自動調整導航方式。
• 查看憑證詳細資訊後回到原處：用手把開啟憑證詳細資訊並關閉後，會直接回到你開啟它的那顆按鈕。
• 編輯自訂平台後回到原本那張卡片：用手把儲存或取消新增／編輯平台的對話後，手把的反白框現在會回到你剛才操作的那張平台卡片，就像刪除後本來就會回到原處一樣。
• 更清楚的刪除確認：要把某個程式的自訂按鍵改回內建版面時，確認對話現在會帶出那個程式的名稱，讓你刪除前清楚知道清除的是哪一個。

🎮 手把滑鼠模式速查表

按鍵	OmniNav	Classic
左搖桿	游標	滾輪
右搖桿	滾輪	游標
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、檔案總管、Steam、Discord）· 強制開啟（所有應用程式）。
• 可於 OmniCharm Game Bar 小工具切換。
• ROG Ally 家族自動停用手把滑鼠模式，因裝置具備內建手把映射。

🎮 手把 Steam 快捷鍵

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

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

---

🛠️ 安裝說明

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

方式 A：Install.bat（建議）

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

方式 B：手動安裝

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

已安裝過 OmniConsole？直接在 App 內更新：

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

⚠️ 升級請使用「App 內更新」或 Install.bat，不要直接安裝 MSIX 套件。 兩者會一併更新主程式與 OmniCharm 小工具，並妥善處理仍被執行中遊戲佔用的檔案。直接安裝 MSIX 套件可能導致更新不完整或兩套件版本不一致。

⚙️ 前置條件

• 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_3.1.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_3.1.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_3.1.0.0_x64.msix to install the main app.
5. Double-click OmniConsole.PhantomLink_3.1.0.0_x64-widget.msix to install the OmniCharm widget.

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 — no need to re-run the steps above.

⚠️ Please update via the in-app updater or Install.bat, rather than installing the MSIX packages directly. Both update the main app and the OmniCharm widget together and properly handle files still in use by a running game. Installing the MSIX packages directly may leave the update incomplete or the two packages on mismatched versions.

⚙️ 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: v2.9.0.0...v3.1.0.0