Releases: mileswolfallen2/OmniEmu2.0
Release list
OmniEmu v0.3.2 Release Notes
OmniEmu v0.3.2 Release Notes
All your games. One place.
What's New
Cloud Sync
Sync your game saves between devices using Syncthing — free, open-source, and fully local. No third-party accounts needed.
- Install Syncthing directly from the app (one-click download)
- Toggle on/off from Settings > Experimental > Cloud Sync
- Host your device or pair with another to share saves
- Manage shared folders and paired devices from the Cloud Sync tab
- Web UI access for advanced configuration
Save Manager
Browse, back up, and delete game saves across all your emulators.
- Dual view: By Game (fuzzy-matched titles) or By Emulator
- RetroArch saves with recursive core-directory scanning
- Custom save directories per emulator
- Backup saves before deleting
New Emulators
Five new emulators added to the library:
| Emulator | System | Platforms |
|---|---|---|
| Cemu | Wii U | Windows, macOS, Linux |
| xemu | Original Xbox | Windows, macOS, Linux |
| Vita3K | PS Vita | Windows, macOS, Linux |
| Azahar | Nintendo 3DS | Windows, macOS, Linux |
| Mednafen | Multi-system | Windows, macOS, Linux |
Frontend Support
Launch alternative frontends directly from OmniEmu — toggle on in Settings > Experimental > Frontend Support:
- ES-DE — full integration with auto-configuration, scraping, themes, and more
- NeoStation — Flutter-based frontend with built-in ScreenScraper integration
- Pegasus — automatic collection file generation from your ROM library
- EmuBuddy — available to all users (not behind the toggle)
Decompilations
Native PC ports built from reverse-engineered source code — toggle on in Settings > Experimental > Decomp Projects:
- Ship of Harkinian (OoT), 2 Ship 2 Harkinian (MM), SoH Demo — Zelda
- Portal 64, Banana Mania PC — additional ports
- Auto-download from GitHub releases, built-in ROM management
- Supported titles include N64, NDS, GBA, DS, Wii, GameCube, and more
Settings > Experimental
Individual toggles for each beta feature — enable only what you want:
- Frontend Support — ES-DE, NeoStation, Pegasus, EmuBuddy
- Beta Emulators — additional experimental emulator support
- Decomp Projects — native PC ports from reverse-engineered source
- Remote Presets — fetch recommended config presets from a remote URL
- Cloud Sync — sync saves between devices via Syncthing
Settings > Appearance
Visual theme picker with live color swatches:
- Light, Dark, System (auto)
- Midnight — deep navy
- Ember — warm dark
- Lavender — soft purple
- Jade — cool teal
EmulatorsPage Tabs
Organized emulator list with filter tabs:
- All — every emulator, frontend, and decomp
- Emulators — core emulators only (Dolphin, PCSX2, RetroArch, etc.)
- Frontends — ES-DE, NeoStation, Pegasus, EmuBuddy
- Decomps — native PC ports (visible when Decomp Projects is on)
SteamGridDB Cover Art
Search and set custom cover art from SteamGridDB's free API.
- Search covers from the game detail modal
- Thumbnails downloaded locally for instant display
- Rate-limit aware with automatic retry
- "Reset Cover" button to clear custom art
Horizontal Navigation
Redesigned top-bar navigation with full gamepad/controller support:
- Spatial D-pad navigation (up/down/left/right between elements)
- A to select, B to close modals
- LB/RB to switch tabs
- Auto-focus on page change
Bug Fixes
- Emulator launch command injection — replaced
exec()withspawn()for all emulator and game launches, preventing shell argument injection - RetroAchievements password — encrypted on disk using Electron safeStorage
- Single-instance lock — bypass fix prevents second instance from ignoring the lock
- Sandbox flags —
--no-sandboxand--disable-gpu-sandboxnow only applied on Steam Deck - Controller detection — fixed Xbox L2/R2 axis mapping (axes +4/+5), fixed button/axis comparison including both arrays
- RetroArch presets — removed hardcoded
audio_driver = "pulseaudio"from both presets - Save file extension — fixed
.SVS→.svscase sensitivity in save detection - URL scraper —
urlExists()now follows 301/302 redirects (up to 5 deep) - Game detail modal — fixed prop mutation on
coverUrl(now uses local state) - UtilitiesPage — fixed
window.omni.emu→window.omni.emulators - Error boundaries — all 8 pages wrapped with ErrorBoundary for graceful crash recovery
- RetroArch save detection — now finds saves in core subdirectories and supports portable installs
- Syncthing install — fixed macOS extraction from nested zip directory, updated to v2.1.2
- Syncthing blue screen — fixed IPC handler crashes, pipe buffer deadlock, null device ID crash
- Cloud Sync poll leak — start polling now cleans up on unmount
- Cemu macOS — removed x64-only filter so it installs via Rosetta on ARM Macs
- Vita3K macOS — added ARM64 DMG variant alongside x64
- RetroArch cores 404 — removed broken download (use RetroArch's Online Updater instead)
- BIOS folder scan —
scanRoms()now skips BIOS directories - CSS accent colors — replaced hardcoded colors with
color-mix()using theme variables - Duplicate CSS — renamed
.platform-tagconflict to.platform-tag-accent
System Requirements
- OS: Windows 10+, macOS 11+, Ubuntu 20.04+
- Disk: ~200 MB for app + emulators vary
- RAM: 4 GB minimum
Supported Emulators (20 total)
RetroArch, Dolphin, RPCS3, Cemu, xemu, Vita3K, Azahar, Eden, PPSSPP, DuckStation, PCSX2, Flycast, Yuzu (legacy), mGBA, MelonDS, Mednafen, ES-DE, NeoStation, Pegasus, EmuBuddy, and more.
🙏 Thank You!
Thanks for using OmniEmu! Every star on GitHub, every bug report, and every feature request helps us make this app better for everyone. If you run into any issues, please open an issue on GitHub — we're always happy to help.
Happy gaming! 🎮✨
OmniEmu v0.3.1
OmniEmu v0.3.1 Release Notes
All your games. One place.
What's New
Cloud Sync (Beta)
Sync your game saves between devices using Syncthing — free, open-source, and fully local. No third-party accounts needed.
- Install Syncthing directly from the app (one-click download)
- Auto-starts on launch once configured
- Host your device or pair with another to share saves
- Manage shared folders and paired devices from the Cloud Sync tab
- Web UI access for advanced configuration
Save Manager
Browse, back up, and delete game saves across all your emulators.
- Dual view: By Game (fuzzy-matched titles) or By Emulator
- RetroArch saves with recursive core-directory scanning
- Custom save directories per emulator
- Backup saves before deleting
New Emulators
Four new emulators added to the library:
| Emulator | System | Platforms |
|---|---|---|
| Cemu | Wii U | Windows, macOS, Linux |
| xemu | Original Xbox | Windows, macOS, Linux |
| Vita3K | PS Vita | Windows, macOS, Linux |
| Azahar | Nintendo 3DS | Windows, macOS, Linux |
Frontend Support (Beta)
Launch alternative frontends directly from OmniEmu:
- ES-DE — full integration with auto-configuration
- NeoStation — Flutter-based frontend with ScreenScraper integration
- Pegasus — automatic collection file generation from your ROM library
- EmuBuddy — available to all users (not behind beta toggle)
Decompilations (Beta)
Native PC ports built from reverse-engineered source code — bring your own ROM:
- Ship of Harkinian (OoT), 2 Ship 2 Harkinian (MM), SoH Demo — Zelda
- Portal 64, Banana Mania PC — additional ports
- Auto-download from GitHub releases, built-in ROM management
- Supported titles include N64, NDS, GBA, DS, Wii, GameCube, and more
Enable frontends and decompilations under Settings > Experimental > Beta Features.
SteamGridDB Cover Art
Search and set custom cover art from SteamGridDB's free API.
- Search covers from the game detail modal
- Thumbnails downloaded locally for instant display
- Rate-limit aware with automatic retry
- "Reset Cover" button to clear custom art
Themes
Seven themes available in Settings:
- Light, Dark, System (auto)
- Midnight — deep navy
- Ember — warm dark
- Lavender — soft purple
- Jade — cool teal
Horizontal Navigation
Redesigned top-bar navigation with full gamepad/controller support:
- Spatial D-pad navigation (up/down/left/right between elements)
- A to select, B to close modals
- LB/RB to switch tabs
- Auto-focus on page change
Bug Fixes
- RetroArch save detection — now finds saves in core subdirectories (
saves/Snes9x/file.srm) and supports portable installs (~/Documents/RetroArch/saves/) - Syncthing install — fixed macOS extraction from nested zip directory, updated to v2.1.2
- Syncthing blue screen — fixed IPC handler crashes, pipe buffer deadlock (
stdio: 'pipe'→stdio: 'ignore'), null device ID crash in API response parsing - Cloud Sync poll leak — start polling now cleans up on unmount, loading state stays visible during startup
- Cemu macOS — removed x64-only filter so it installs via Rosetta on ARM Macs
- Vita3K macOS — added ARM64 DMG variant alongside x64
- RetroArch cores 404 — removed broken
RetroArch_cores.7zdownload (use RetroArch's Online Updater instead) - BIOS folder scan —
scanRoms()now skips BIOS directories - CSS accent colors — replaced hardcoded colors with
color-mix()using theme variables - Duplicate CSS — renamed
.platform-tagconflict to.platform-tag-accent - Unused imports — cleaned up
require()calls, dead imports, staletypes.d.ts
System Requirements
- OS: Windows 10+, macOS 11+, Ubuntu 20.04+
- Disk: ~200 MB for app + emulators vary
- RAM: 4 GB minimum
Supported Emulators (18 total)
RetroArch, Dolphin, RPCS3, Cemu, xemu, Vita3K, Azahar, Eden, PPSSPP, DuckStation, PCSX2, Flycast, Dolphin (trio), Yuzu (legacy), mGBA, MelonDS, and more.
🙏 Thank You!
Thanks for using OmniEmu! Every star on GitHub, every bug report, and every feature request helps us make this app better for everyone. If you run into any issues, please open an issue on GitHub — we're always happy to help.
Happy gaming! 🎮✨
Built with Electron, React, and TypeScript.
OmniEmu v0.2.0 fith prereleases
🎮 OmniEmu v0.3.0
✨ All your games. One place. ✨
Hey everyone! We're super excited to bring you v0.3.0 — this is a big one. We've been working hard on a bunch of features you've been asking for, squashed a ton of bugs, and made the whole experience feel a lot more polished. Let's dive in! 🚀
🗂️ Save Manager
Ever lost a save file because you forgot which folder it was in? Yeah, us too. That's why we built the Save Manager!
Open the new 💾 Saves tab in the top bar and you'll see all of your emulator save files and save states, neatly organised by game. Here's what you can do:
- Browse — saves are automatically scanned from your RetroArch, Dolphin, RPCS3, PCSX2, DuckStation, Flycast, PPSSPP, and Eden directories
- Fuzzy matching — OmniEmu intelligently matches save files to the games in your library, even if the filenames don't line up perfectly
- Back up — one-click backup of any save file so you never lose progress
- Delete — clean up old or unwanted saves right from the app
- Custom directories — point each emulator at a custom save folder if your setup is a little different
It's like a file manager, but actually enjoyable to use. 😄
🖥️ Frontend Options
OmniEmu now supports four emulation frontends! Whether you want a plug-and-play experience or full customisation, there's something for you.
EmuBuddy
Available on all platforms — no toggles needed. EmuBuddy gives you one-click setup, built-in game downloading, and full controller support. Just install and go!
ES-DE (Beta)
The beloved EmulationStation Desktop Edition is here. It's a gorgeous multi-system launcher with tons of community themes. Enable Beta Features in Settings to unlock it.
🍎 macOS note: ES-DE requires a manual install via DMG because of license acceptance requirements — we'll show you exactly what to do!
NeoStation (Beta)
A modern Flutter-based frontend with built-in ScreenScraper integration for automatic game art and metadata. Also behind the Beta Features toggle.
🍎 macOS note: Same deal as ES-DE — manual DMG install, but we walk you through it.
Pegasus Frontend (Beta)
Love customisation? Pegasus is a fully themeable launcher that puts you in control. And the best part? OmniEmu automatically generates collection files for Pegasus — just scan your ROMs and everything shows up. We write metadata.pegasus.txt files into each ROM subdirectory and a central settings.txt so Pegasus knows exactly where to look.
🎨 SteamGridDB Cover Art
Your game library deserves to look good! 🖼️
OmniEmu now integrates with SteamGridDB for high-quality cover art. Here's how it works:
- Grab a free API key from steamgriddb.com and pop it into Settings
- When viewing a game, hit "Change Cover" and search SteamGridDB right from inside the app
- Pick the cover you like and it's saved locally — works offline too!
- Don't like it? Hit "Reset Cover" to clear it and fall back to free art sources
All images are downloaded through the main process, cached locally as file:// paths, and rate-limit retries are built in so we don't get blocked. No more broken cover art! 🎉
🎨 Four Brand-New Themes
We've gone from 3 themes to 7! 🌈
| Theme | Vibe |
|---|---|
| Midnight | Deep dark blues and purples — easy on the eyes for those late-night gaming sessions |
| Ember | Warm oranges and reds — cozy and inviting |
| Lavender | Soft purples and pastels — calm and elegant |
| Jade | Cool greens and teals — fresh and modern |
| Dark | Classic dark mode |
| Light | Clean and bright |
| System | Follows your OS preference |
You'll find them all in Settings → Appearance → Theme.
🕹️ Horizontal Navigation & Gamepad Support
The old sidebar is gone — say hello to the new top bar navigation! 🎉
- Tabs run horizontally across the top: Home, Emulators, Library, Saves, Controller, Utilities, Settings
- Full gamepad navigation — D-pad left/right switches tabs, A selects, B closes modals
- Smart auto-focus — when you switch tabs, the first interactive element lights up automatically
- The "Launch Game" button in the game detail modal auto-focuses so you can hit A and start playing immediately
The whole UI feels snappier and more controller-friendly than ever. 🎯
⬆️ Improvements
Here's everything else we've improved since v0.2.0:
- 🗂️ BIOS folder skip — the ROM scanner now automatically skips folders named "bios" so your BIOS files don't get mixed in with your games
- Controller auto-focus — the game detail modal now auto-focuses the "Launch Game" button for controller users
- Reset Cover — clear a downloaded cover and fall back to the free art sources (libretro thumbnails, MobyGames)
- macOS RetroArch — removed the broken cores download (it was 404). Cores must be downloaded from within RetroArch's Online Updater after installation
- Gamepad resilience — improved error handling in the controller navigation polling loop so one bad frame doesn't break your whole session
🐛 Bug Fixes
We squashed quite a few bugs this release:
- SteamGridDB 404 fixed — the search API endpoint was wrong (
/search/game/→/search/autocomplete/). Cover art search works again! - Cover images not loading — Electron's renderer can't load remote images due to CORS. We now download thumbnails through the main process and serve them as local
file://paths - Theme colours broken — hardcoded accent colours (
rgba(0, 212, 255, ...)andrgba(124, 58, 237, ...)) were causing glow effects to look wrong on non-default themes. All glow effects now use CSScolor-mix()withvar(--accent)so they adapt to every theme - Duplicate
.platform-tagCSS — the muted tag style on emulator cards was being overridden by the accent variant in the game detail modal. Renamed the accent variant to.platform-tag-accent - Stale
types.d.ts— removed an outdated type declaration file that could shadow the realtypes.tsdefinitions - Inline
require()calls — replaced 7 instances ofrequire('fs')andrequire('os')in the emulator registry with proper ES module imports - Duplicate
require('electron')— removed a redundant inline require in the save manager IPC handler (it was already imported at the top) - Unused imports — cleaned up
isLinuxfrom emulators.ts andEmulatorConfigfrom SettingsPage
📋 Supported Emulators
We now support 14 emulators and 4 frontends! 🎉
🎮 Emulators
| Emulator | What it plays | Windows | macOS | Linux |
|---|---|---|---|---|
| RetroArch | NES, SNES, N64, GB, GBC, GBA, PS1, PCE, Sega MD, Sega Saturn, and more | ✅ | ✅ | ✅ |
| Dolphin | GameCube & Wii | ✅ | ✅ | ✅ |
| RPCS3 | PlayStation 3 | ✅ | ✅ | ✅ |
| PCSX2 | PlayStation 2 | ✅ | ✅ | ✅ |
| DuckStation | PlayStation 1 | ✅ | ✅ | ✅ |
| PPSSPP | PlayStation Portable | ✅ | ✅ | ✅ |
| melonDS | Nintendo DS | ✅ | ✅ | ✅ |
| Flycast | Dreamcast & NAOMI | ✅ | ✅ | ✅ |
| MAME | Arcade | ✅ | ✅ | ✅ |
| Eden | Nintendo Switch | ✅ | ✅ | ✅ |
| Cemu | Wii U | ✅ | ✅ | ✅ |
| xemu | Original Xbox | ✅ | ✅ | ✅ |
| Vita3K | PlayStation Vita | ✅ | ✅ | ✅ |
| Azahar | Nintendo 3DS | ✅ | ✅ | ✅ |
🖥️ Frontends
| Frontend | What it does | Availability |
|---|---|---|
| EmuBuddy | One-click launcher with game downloading | All platforms |
| ES-DE | Multi-system launcher with community themes | All platforms (macOS: manual install) — Beta |
| NeoStation | Modern launcher with ScreenScraper integration | All platforms (macOS: manual install) — Beta |
| Pegasus | Fully customisable themeable launcher | All platforms — Beta |
💻 System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| OS | Windows 10+ | Windows 11 |
| macOS | macOS 13 Ventura+ | Latest |
| Linux | Ubuntu 20.04+ | Latest LTS |
| RAM | 4 GB | 8 GB+ |
| Storage | 500 MB (OmniEmu only) | Depends on your ROM & save collection |
| Display | 1280×720 | 1920×1080+ |
📝 Good to Know
A few handy tips for this release:
- Beta Features — ES-DE, NeoStation, and Pegasus are in beta. Head to Settings → Experimental → Beta Features to enable them.
- SteamGridDB — Cover art search needs a free API key. Sign up at steamgriddb.com and enter it in Settings.
- macOS frontends — ES-DE and NeoStation require a manual DMG install because of license acceptance requirements. We'll show you a handy guide right in the app!
- RetroArch cores on macOS — After installing RetroArch, open it and use the Online Updater to download cores. OmniEmu handles everything else.
- Azahar — This is the successor to Lime3DS (which was itself the successor to Citra). If you used Citra before, this is the one you want.
🙏 Thank You!
Thanks for using OmniEmu! Every star on GitHub, every bug report, and every feature request helps us make this app better for everyone. If you run into any issues, please open an issue on GitHub — we're always happy to help.
Happy gaming! 🎮✨
OmniEmu v0.1.3 — Fourth Pre-Release
🎮 OmniEmu v0.1.3 — Fourth Pre-Release
Cross-platform emulator manager, game launcher, and ROM library manager.
Thank you to everyone testing OmniEmu! This release introduces frontend support, automatic ROM detection, improved emulator discovery, and plenty of quality-of-life improvements.
✨ What's New
🖥️ Frontend Support
OmniEmu now supports installing and configuring multiple emulation frontends alongside your emulators.
ES-DE (EmulationStation Desktop Edition) (Beta)
A polished multi-system frontend for browsing and launching your game library.
- Automatic configuration with your ROM library
- Detects installed emulators automatically
- Supports all 20+ systems available in OmniEmu
- macOS: Manual installation required (OmniEmu walks you through the process)
NeoStation (Beta)
A modern Flutter-based frontend focused on simplicity and ease of use.
- ScreenScraper integration
- Automatic emulator and ROM detection
- Built-in RetroAchievements support
- macOS: Manual installation required (guided by OmniEmu)
EmuBuddy
An easy-to-use frontend focused on getting you playing quickly.
- Automated setup
- One-click controller configuration
- Automatic game downloading
- Supports 14 systems
- Available on Windows, macOS, and Linux
Pegasus Frontend (Beta)
A lightweight, highly customizable frontend with extensive theme support.
OmniEmu automatically:
- Generates
metadata.pegasus.txtcollection files - Configures Pegasus to use your ROM library
- Creates launch commands for supported emulators
- Keeps collections organized automatically
🧪 Experimental Features
A new Settings → Experimental page lets you enable beta functionality.
Turning on Beta Features unlocks:
- ES-DE
- NeoStation
- Pegasus Frontend
EmuBuddy is available by default and does not require the beta toggle.
📚 Automatic ROM Library Scanning
The Library page is now ready as soon as OmniEmu starts.
If your ROM directory is configured (default: ~/Documents/roms), your games will appear automatically—no manual folder selection required.
📝 Pegasus Collection Generation
When Pegasus is configured (or when OmniEmu starts with Beta Features enabled), collection files are automatically generated inside each ROM folder.
Example:
roms/
└── nes/
└── metadata.pegasus.txt
Each generated collection includes:
- Collection name
- Short name
- Supported file extensions
- Launch commands
- Individual game entries
No manual configuration required.
🛠️ Improvements & Bug Fixes
🍎 Better macOS Frontend Installation
Because ES-DE and NeoStation require manual installation on macOS, OmniEmu now provides a guided installation experience.
It can:
- Detect downloaded DMG files
- Open the installer automatically
- Detect when installation is complete
- Continue setup without extra configuration
Prefer to install it yourself?
A new Install Manually button lets you skip the guided process at any time.
🔍 Improved Emulator Detection
Finding existing emulator installations is now much more reliable.
Improvements include:
- Homebrew support
- Snap support
- Flatpak support
- Common installation directories
- Recursive binary scanning
📂 Smarter ROM Detection
ROM scanning has been significantly improved.
Highlights:
- ROMs are automatically organized into their correct system folders
- Better platform detection
- For example,
.isofiles inside aps2/folder are now correctly identified as PlayStation 2 instead of PlayStation
- For example,
- Added support for:
.cdi(Dreamcast).pbp(PSP).chd(multiple systems)
🎮 Supported Emulators
| Emulator | Systems | Platforms |
|---|---|---|
| Dolphin | GameCube, Wii | Windows • macOS • Linux |
| RPCS3 | PlayStation 3 | Windows • Linux |
| Eden | Nintendo Switch | Windows • macOS • Linux |
| PCSX2 | PlayStation 2 | Windows • macOS • Linux |
| MAME | Arcade | Windows • Linux |
| DuckStation | PlayStation | Windows • macOS • Linux |
| RetroArch | NES, SNES, N64, GB, GBC, GBA, PS1, PC Engine, Mega Drive, Saturn, Dreamcast | Windows • macOS • Linux |
| PPSSPP | PlayStation Portable | Windows • macOS • Linux |
| melonDS | Nintendo DS | Windows • macOS • Linux |
| Flycast | Dreamcast, Naomi, Naomi 2, Atomiswave | Windows • macOS • Linux |
🖥️ Supported Frontends
| Frontend | Status | Platforms |
|---|---|---|
| ES-DE | Beta | Windows • macOS • Linux |
| NeoStation | Beta | Windows • macOS • Linux |
| Pegasus | Beta | Windows • macOS • Linux |
| EmuBuddy | Stable | Windows • macOS • Linux |
🔄 Auto-Updates
If you're downloading OmniEmu directly from GitHub, you can safely ignore the .yml files included with each release.
They're used internally by OmniEmu's automatic updater and are not needed for manual installation.
Simply download the installer for your platform and you're ready to go.
📦 Installation
🍎 macOS
Download:
OmniEmu-0.2.0-mac-universal.dmg
Install:
- Drag OmniEmu into Applications
- Right-click OmniEmu
- Choose Open the first time you launch it
If macOS prevents the app from opening:
sudo xattr -rd com.apple.quarantine /Applications/OmniEmu.app🪟 Windows
Download:
OmniEmu-0.2.0-win-x64.exe(Intel / AMD)OmniEmu-0.2.0-win-arm64.exe(ARM64)
Portable ZIP builds are also available.
If Windows SmartScreen appears:
More info → Run anyway
🐧 Linux
Download:
OmniEmu-0.2.0-linux-x86_64.AppImageOmniEmu-0.2.0-linux-arm64.AppImage
Make it executable:
chmod +x OmniEmu*.AppImage
./OmniEmu*.AppImageIf the AppImage doesn't start, install libfuse2 using your distribution's package manager.
❤️ Thanks for Testing!
OmniEmu is still in pre-release, and every bug report, feature request, and suggestion helps make it better.
Thank you for being an early tester and helping shape the future of OmniEmu.
Happy gaming! 🎮
OmniEmu v0.1.2 — Third Pre-Release
🎉 OmniEmu v0.1.2 — Third Pre-Release
Cross-platform emulator manager, game launcher, and ROM manager.
✨ What’s New
🎮 New Emulator
Flycast has been added to the one-click installer.
Supported systems:
- Sega Dreamcast
- Sega Naomi
- Sega Naomi 2
- Sega Atomiswave
🏆 RetroAchievements Integration
OmniEmu can now automatically configure RetroAchievements across supported emulators.
Open Utilities → RetroAchievements, then enter:
- Your RetroAchievements username
- Your Web API Key (available from https://retroachievements.org/settings)
OmniEmu will automatically enable RetroAchievements for:
- ✅ RetroArch
- ✅ Dolphin
- ✅ PCSX2
- ✅ DuckStation
- ✅ Flycast
Configure it once, then start earning achievements everywhere.
🐞 Bug Fixes & Improvements
📂 Dreamcast ROM Detection
- Added support for
.cdi(DiscJuggler) images. - Dreamcast
.gdiand.cdifiles now launch with Flycast by default. - Added Dreamcast to Settings → Emulator Assignments.
- Choose either Flycast or RetroArch for Dreamcast games.
🕹️ Supported Emulators
Emulator | Systems -- | -- Dolphin | Nintendo GameCube, Wii RPCS3 | PlayStation 3 Eden | Nintendo Switch PCSX2 | PlayStation 2 MAME | Arcade DuckStation | PlayStation RetroArch | NES, SNES, Nintendo 64, Game Boy, Game Boy Color, Game Boy Advance, PlayStation, PC Engine, Sega Mega Drive / Genesis, Sega Saturn, Dreamcast PPSSPP | PlayStation Portable (PSP) melonDS | Nintendo DS Flycast | Dreamcast, Naomi, Naomi 2, Atomiswave
ℹ️ Auto-Update
If you’re downloading OmniEmu from GitHub, you can safely ignore the .yml files included with each release.
These are used internally by OmniEmu’s built-in updater and are not required for manual installation.
Simply download the installer for your platform.
📥 Installation
🍎 macOS
Download:
OmniEmu-0.1.2-mac-universal.dmg
Install:
- Drag OmniEmu into Applications.
- Right-click OmniEmu → Open on first launch.
If macOS blocks the app, run:
sudo xattr -rd com.apple.quarantine /Applications/OmniEmu.app🪟 Windows
Download:
OmniEmu-0.1.2-win-x64.exe(Intel / AMD)OmniEmu-0.1.2-win-arm64.exe(ARM64)
Portable ZIP builds are also available.
If Windows SmartScreen appears:
More info → Run anyway
🐧 Linux
Download:
OmniEmu-0.1.2-linux-x86_64.AppImageOmniEmu-0.1.2-linux-arm64.AppImage
Make it executable:
chmod +x OmniEmu*.AppImage
./OmniEmu*.AppImageIf the AppImage doesn’t launch, install libfuse2.
❤️ Thanks for Testing!
OmniEmu is still in pre-release, so bug reports, feature requests, and feedback are greatly appreciated.
Thank you for helping improve OmniEmu, and enjoy the update! 🚀
OmniEmu v0.1.1 — Second Pre-Release
OmniEmu v0.1.1 — Second Pre-Release
Cross-platform emulator manager, game launcher, and ROM manager.
✨ What's New
🎮 2 New Emulators
Added to the one-click installer:
- PPSSPP — PlayStation Portable (PSP)
- melonDS — Nintendo DS
🔄 Auto-Update
Settings → Updates
OmniEmu now checks for new releases automatically and can:
- Notify you when an update is available
- Download the update
- Install it with a single click
No more manually downloading new releases.
🌗 Light Mode
The theme selector now works correctly.
Choose between:
- Dark
- Light
- System
🎯 Pick Your Emulator
Systems with multiple supported emulators can now choose which emulator launches games.
Examples:
- PlayStation 1
- Nintendo DS
- Dreamcast
- (More coming later)
📂 Smarter ROM Scanning
Simply drop ROMs into:
~/Documents/roms/
OmniEmu now automatically sorts them into the correct system folders.
Example:
game.iso → PSP
instead of every .iso being incorrectly detected as a PS1 game.
🖼️ Better Game Artwork
The artwork scraper is now much smarter.
Improvements include:
- Falls back to MobyGames when artwork isn't found
- Searches more sources for every game
- Better overall cover detection
🍎 macOS Polish
- Proper Dock icon
- Proper menu bar icon
- Better native macOS integration
🐞 Bug Fixes
🎮 Controller Navigation
- D-pad no longer forces focus back to the sidebar
- Sidebar only cycles when it is already focused
- B / Circle now behaves like Escape, removing focus instead of jumping back to the sidebar
🔗 Fixed Emulator Downloads
All five broken emulator download links have been repaired.
Every one-click installer now works correctly.
📦 Built-in 7z Extraction
7z archives now extract out of the box.
No external 7-Zip installation is required on any platform.
🍺 Better MAME Installation (macOS)
If a direct download isn't available, OmniEmu now installs MAME automatically using Homebrew.
💿 Correct ISO Detection
ISO files are now detected by their folder instead of just their extension.
Example:
roms/psp/game.iso
is correctly detected as a PSP game instead of PlayStation 1.
🕹️ Supported Emulators
| Emulator | Systems |
|---|---|
| Dolphin | GameCube, Wii |
| RPCS3 | PlayStation 3 |
| Eden | Nintendo Switch |
| PCSX2 | PlayStation 2 |
| MAME | Arcade |
| DuckStation | PlayStation 1 |
| RetroArch | NES, SNES, Nintendo 64, Game Boy, Game Boy Color, Game Boy Advance, PlayStation 1, PC Engine, Sega Mega Drive, Sega Saturn, Dreamcast |
| PPSSPP | PlayStation Portable (PSP) |
| melonDS | Nintendo DS |
| Flycas | Dreamcast, Naomi, Naomi 2 |
ℹ️ Auto-Update Note
When downloading releases from GitHub, you can safely ignore the .yml files.
These files are metadata used internally by OmniEmu's built-in updater.
Simply download the installer for your platform.
📥 Installation
🍎 macOS
Download:
OmniEmu-0.1.1-mac-universal.dmg
Installation:
- Drag OmniEmu into Applications
- Right-click → Open on first launch (unsigned app)
- Run:
sudo xattr -rd com.apple.quarantine /Applications/OmniEmu.app🪟 Windows
Download:
OmniEmu-0.1.1-win-x64.exe(Intel / AMD)OmniEmu-0.1.1-win-arm64.exe(ARM64)
Portable ZIP versions are also available.
If Windows SmartScreen appears:
More Info → Run anyway
🐧 Linux
Download:
OmniEmu-0.1.1-linux-x86_64.AppImageOmniEmu-0.1.1-linux-arm64.AppImage
Make it executable:
chmod +x OmniEmu*.AppImage
./OmniEmu*.AppImageIf it won't launch, install:
libfuse2
❤️ Thanks for Testing!
This is still a pre-release, so bug reports and feedback are greatly appreciated.
Enjoy!
First Pre-Release
OmniEmu v0.1.0-pre — First Pre-Release
Cross-platform emulator manager, game launcher and ROM manager.
Features
- Install & Auto-Configure — One-click install for 7 emulators (Dolphin, RPCS3, Eden, PCSX2, MAME, RetroArch, DuckStation) with optimized presets applied automatically
- ROM Scanning — Scans ROMs by platform, scrapes game art from thegamesdb.net with caching
- Controller Support — Gamepad API polling, per-vendor button labels (PlayStation, Xbox, Switch), PS-specific button configs per emulator
- Controller Navigation — DPad/stick driven UI navigation
- BIOS Manager — Scans directories for 11 known BIOS families, updates RetroArch system_directory
- Dashboard — Quick access with "Resume Games" for recently played titles
- Cross-Platform — Built for macOS (universal), Windows (arm64 + x64), Linux (arm64 + x64)
Install Guide
macOS — OmniEmu-0.1.0-mac-universal.dmg: Drag to Applications. Right-click → Open on first launch (unsigned).
then
sudo xattr -rd com.apple.quarantine /Applications/OmniEmu.appWindows — OmniEmu-0.1.0-win-x64.exe (Intel/AMD) or OmniEmu-0.1.0-win-arm64.exe (ARM). SmartScreen → More info → Run anyway. Portable .zip versions also available.
Linux — OmniEmu-0.1.0-linux-x86_64.AppImage or OmniEmu-0.1.0-linux-arm64.AppImage: chmod +x then ./OmniEmu*.AppImage. Install libfuse2 if needed.
Supported Emulators
| Emulator | Systems |
|---|---|
| Dolphin | GameCube, Wii |
| RPCS3 | PlayStation 3 |
| Eden | Nintendo Switch |
| PCSX2 | PlayStation 2 |
| MAME | Arcade |
| DuckStation | PlayStation 1 |
| RetroArch | NES, SNES, N64, GB/GBA, PS1, PC Engine, Sega MD/Saturn/DC |
First-Time Setup
- Library tab → Install an emulator
- Settings → Set ROMs directory → Scan
- Settings → BIOS → Scan BIOS files, update RetroArch path
- Connect a controller (auto-detected on Controller page)
This is a pre-release. Report bugs at https://github.com/mileswolfallen2/OmniEmu2.0/issues