8bit2qubit/OmniConsole v3.9.0.0

OmniConsole v3.9.0.0

on GitHub

v3.9.0.0: Joy Shared Is a Joy Doubled

🌐 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.

✨ New Features (v3.9.0.0)

• Community Platforms: a new Community button next to Import on the user platforms tab opens a browser of platform definitions shared by the community on GitHub. Search by name or submitter, sort by date or name, preview each platform's cover and launch details, then add it with one click. Want yours in the list? Export your platform and open a pull request at OmniConsolePlatforms.
• Paths that travel: exported platform JSON now writes per-user install paths as environment variables (e.g., %LocalAppData%\…) instead of a full path with your Windows account name, and import expands them back. A platform you share with a friend or submit to the community works on their console.

🔧 Improvements (v3.9.0.0)

• The Windows file picker works in Nekomata Mode out of the box: the Windows dialog you open or save files with is now mapped like File Explorer, so you can browse it with your gamepad without setting up a custom profile first.
• Playnite Desktop works in Nekomata Mode out of the box: the Playnite desktop app now uses built-in mapping like the other launchers, so you can browse its library and menus with your gamepad without setting up a custom profile first.
• Windows Installer works in Nekomata Mode out of the box: the installer dialogs that walk you through setting up or repairing an app now use built-in mapping, so you can step through them with your gamepad without setting up a custom profile first.

🎮 Nekomata Mode Cheat Sheet

• 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, Playnite Desktop, File Explorer, Windows File Picker, Windows Installer, Steam, Discord.
• Toggleable via the OmniCharm Game Bar widget.
• Nekomata Mode is auto-disabled on ROG Ally family — consoles with the manufacturer's built-in gamepad mapping.

🎮 Gamepad Steam Shortcuts

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

v3.9.0.0：獨樂樂不如眾樂樂

🌐 前往官方網站：完整文件、功能介紹與安裝指南。
🐱 教貓又說你的語言：貓又正洗耳恭聽！教她一種新語言，或幫她說得更自然。
最新進度請見即時翻譯狀態。

✨ 新功能 (v3.9.0.0)

• 社群平台：使用者平台索引標籤的匯入鈕旁新增了社群按鈕，開啟社群在 GitHub 上分享的平台瀏覽器。可依名稱或提交者搜尋、依時間或名稱排序，逐一檢視封面與啟動資訊後一鍵新增。想讓你的平台也上榜？把它匯出，到 OmniConsolePlatforms 開個 pull request 吧。
• 跨主機通用的路徑：匯出的平台 JSON 現在會把使用者層級的安裝路徑寫成環境變數形式（如 %LocalAppData%\…），不再帶有你的 Windows 帳號名稱，匯入時自動展開。分享給朋友或提交給社群的平台，在別人的主機上都能直接使用。

🔧 改進 (v3.9.0.0)

• Windows 檔案選擇器開箱即用支援貓又模式：開啟或儲存檔案時跳出的 Windows 對話方塊，現在與檔案總管套用同一套映射，不必再自訂設定檔，就能用手把瀏覽。
• Playnite 桌面版開箱即用支援貓又模式：Playnite 的桌面版現在與其他啟動器一樣套用內建映射，不必再自訂設定檔，就能用手把瀏覽遊戲庫與選單。
• Windows Installer 開箱即用支援貓又模式：引導你安裝或修復程式的安裝精靈對話方塊現在套用內建映射，不必再自訂設定檔，就能用手把操作。

🎮 貓又模式速查表

• 開啟／關閉切換。開啟時，你自訂的設定檔會接手，下列程式則套用內建映射（同樣可自訂）：Edge、Chrome、Firefox、Opera、Brave、Epic Games Store、Playnite 桌面版、檔案總管、Windows 檔案選擇器、Windows Installer、Steam、Discord。
• 可於 OmniCharm Game Bar 小工具切換。
• ROG Ally 家族自動停用貓又模式，因主機具備廠商內建的手把映射。

🎮 手把 Steam 快捷鍵

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

🛠️ 安裝說明

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

方式 A：Install.bat（建議）

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

方式 B：手動安裝

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

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

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

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

⚠️ 升級時請透過「應用程式內更新」或 Install.bat（解壓 OmniConsole_3.9.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, 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_3.9.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.