Skip to content

Releases: mileswolfallen2/OmniEmu2.0

OmniEmu v0.3.2 Release Notes

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 16 Jul 09:58

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() with spawn() 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-sandbox and --disable-gpu-sandbox now 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.svs case sensitivity in save detection
  • URL scraperurlExists() 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.emuwindow.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 scanscanRoms() now skips BIOS directories
  • CSS accent colors — replaced hardcoded colors with color-mix() using theme variables
  • Duplicate CSS — renamed .platform-tag conflict 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 Pre-release
Pre-release

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 14 Jul 22:08

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.7z download (use RetroArch's Online Updater instead)
  • BIOS folder scanscanRoms() now skips BIOS directories
  • CSS accent colors — replaced hardcoded colors with color-mix() using theme variables
  • Duplicate CSS — renamed .platform-tag conflict to .platform-tag-accent
  • Unused imports — cleaned up require() calls, dead imports, stale types.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

Pre-release

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 14 Jul 05:51

🎮 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:

  1. Grab a free API key from steamgriddb.com and pop it into Settings
  2. When viewing a game, hit "Change Cover" and search SteamGridDB right from inside the app
  3. Pick the cover you like and it's saved locally — works offline too!
  4. 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, ...) and rgba(124, 58, 237, ...)) were causing glow effects to look wrong on non-default themes. All glow effects now use CSS color-mix() with var(--accent) so they adapt to every theme
  • Duplicate .platform-tag CSS — 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 real types.ts definitions
  • Inline require() calls — replaced 7 instances of require('fs') and require('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 isLinux from emulators.ts and EmulatorConfig from 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

Pre-release

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 13 Jul 06:43

🎮 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.txt collection 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, .iso files inside a ps2/ folder are now correctly identified as PlayStation 2 instead of PlayStation
  • 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:

  1. Drag OmniEmu into Applications
  2. Right-click OmniEmu
  3. 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.AppImage
  • OmniEmu-0.2.0-linux-arm64.AppImage

Make it executable:

chmod +x OmniEmu*.AppImage
./OmniEmu*.AppImage

If 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

Pre-release

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 10 Jul 19:18

🎉 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:

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 .gdi and .cdi files 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:

  1. Drag OmniEmu into Applications.
  2. Right-click OmniEmuOpen 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.AppImage
  • OmniEmu-0.1.2-linux-arm64.AppImage

Make it executable:

chmod +x OmniEmu*.AppImage
./OmniEmu*.AppImage

If 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

Pre-release

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 10 Jul 07:14
7cbde65

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:

  1. Drag OmniEmu into Applications
  2. Right-click → Open on first launch (unsigned app)
  3. 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.AppImage
  • OmniEmu-0.1.1-linux-arm64.AppImage

Make it executable:

chmod +x OmniEmu*.AppImage
./OmniEmu*.AppImage

If 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

First Pre-Release Pre-release
Pre-release

Choose a tag to compare

@mileswolfallen2 mileswolfallen2 released this 10 Jul 03:04

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

macOSOmniEmu-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.app

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

LinuxOmniEmu-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

  1. Library tab → Install an emulator
  2. Settings → Set ROMs directory → Scan
  3. Settings → BIOS → Scan BIOS files, update RetroArch path
  4. Connect a controller (auto-detected on Controller page)

This is a pre-release. Report bugs at https://github.com/mileswolfallen2/OmniEmu2.0/issues