mirror of
https://github.com/mileswolfallen2/OmniEmu2.0.git
synced 2026-09-08 11:23:17 +00:00
99 lines
2.9 KiB
Markdown
99 lines
2.9 KiB
Markdown
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="assets/icon.png">
|
|
<img alt="OmniEmu" src="assets/icon.png" width="96">
|
|
</picture>
|
|
|
|
# OmniEmu
|
|
|
|
**All your games. One place.**
|
|
|
|
OmniEmu is a cross-platform emulator manager, game launcher, and ROM library for Windows, macOS, and Linux. Install emulators with one click, scan your ROMs, and launch games from a unified library — no terminal required.
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
- **One-Click Emulator Setup** — Download, install, and auto-configure 10 emulators from inside the app
|
|
- **ROM Library** — Scan your ROMs, browse by platform, and launch games directly
|
|
- **Auto-Update** — Built-in updater keeps OmniEmu current without manual downloads
|
|
- **Game Art Scraping** — Automatically fetches covers, screenshots, and titles
|
|
- **Controller Navigation** — Navigate the entire UI with a gamepad (DPad, A, B, Start)
|
|
- **BIOS Manager** — Scan your BIOS files and update RetroArch's config in one click
|
|
- **Light & Dark Mode** — Choose your theme or follow the system preference
|
|
- **Cross-Platform** — Identical experience on Windows, macOS, and Linux (x64 & ARM64)
|
|
|
|
## Supported Emulators
|
|
|
|
| Emulator | Systems | Windows | macOS | Linux |
|
|
|---|---|---|---|---|
|
|
| Dolphin | GameCube, Wii | ✅ | ✅ | ✅ |
|
|
| RPCS3 | PlayStation 3 | ✅ | ✅ | ✅ |
|
|
| Eden | Nintendo Switch | ✅ | ✅ | ✅ |
|
|
| PCSX2 | PlayStation 2 | ✅ | ✅ | ✅ |
|
|
| MAME | Arcade | ✅ | ✅ | ✅ |
|
|
| PPSSPP | PSP | ✅ | ✅ | ✅ |
|
|
| DuckStation | PlayStation 1 | ✅ | ✅ | ✅ |
|
|
| melonDS | Nintendo DS | ✅ | ✅ | ✅ |
|
|
| Flycast | Dreamcast, Naomi, Atomiswave | ✅ | ✅ | ✅ |
|
|
| RetroArch | Multi-system (NES, SNES, N64, GB/GBA, PS1, and more) | ✅ | ✅ | ✅ |
|
|
|
|
## Quick Start
|
|
|
|
1. Download the latest release for your platform
|
|
2. Launch OmniEmu and go to **Library** → install an emulator
|
|
3. Go to **Settings** → set your ROMs directory → **Scan**
|
|
4. Browse your library and launch any game
|
|
|
|
### Downloads
|
|
|
|
Download the latest build from the [releases page](https://github.com/mileswolfallen2/OmniEmu2.0/releases).
|
|
|
|
**Note:** The `.yml` files you see in releases are metadata used by the built-in auto-updater — you can ignore them.
|
|
|
|
### Install Guide
|
|
|
|
**macOS** — `OmniEmu-*.dmg`: Drag to Applications. Right-click → Open on first launch (unsigned).
|
|
```bash
|
|
sudo xattr -rd com.apple.quarantine /Applications/OmniEmu.app
|
|
```
|
|
|
|
**Windows** — `OmniEmu-*-win-*.exe`. SmartScreen → More Info → Run anyway. Portable `.zip` versions also available.
|
|
|
|
**Linux** — `OmniEmu-*-linux-*.AppImage`: `chmod +x` then `./OmniEmu*.AppImage`. Install `libfuse2` if needed.
|
|
|
|
## Building from Source
|
|
|
|
### Prerequisites
|
|
|
|
- Node.js 20+ (recommended: 22)
|
|
- npm 10+
|
|
|
|
### Setup & Run
|
|
|
|
```bash
|
|
npm install
|
|
npm run start
|
|
```
|
|
|
|
### Package for Distribution
|
|
|
|
```bash
|
|
# macOS (universal)
|
|
npm run package:mac
|
|
|
|
# Windows
|
|
npm run package:win
|
|
|
|
# Linux
|
|
npm run package:linux
|
|
|
|
# All at once
|
|
npm run package:all
|
|
```
|
|
|
|
Output goes to `./release/`.
|
|
|
|
## License
|
|
|
|
MIT
|