Mujaca/RomM-Desktop
0
0
Fork 0
Code Issues Pull requests Projects Releases 8 Packages Wiki Activity Actions
No description
88 commits 1 branch 8 tags 1.4 MiB
  • TypeScript 84.1%
  • Vue 15.4%
  • CSS 0.3%
  • JavaScript 0.1%
Find a file
Exact
Jean-Michel c76b182698
All checks were successful
Release / Build (linux) (push) Successful in 1m44s
Details
Release / Build (windows) (push) Successful in 3m1s
Details
Release / Forgejo Release (push) Successful in 32s
Details
Release / Build (macos) (push) Successful in 15m42s
Details
feat(emulators): Game Boy, Game Boy Color and Game Boy Advance support with mGBA 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 19:32:00 +02:00
.forgejo/workflows ci: attach macOS assets directly from the build job 2026-09-27 15:16:16 +02:00
build chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
docs feat(emulators): Game Boy, Game Boy Color and Game Boy Advance support with mGBA 2026-09-27 19:32:00 +02:00
openapi feat(api): generate typed RomM client from OpenAPI spec 2026-09-25 11:35:22 +02:00
resources chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
scripts feat(api): generate typed RomM client from OpenAPI spec 2026-09-25 11:35:22 +02:00
src feat(emulators): Game Boy, Game Boy Color and Game Boy Advance support with mGBA 2026-09-27 19:32:00 +02:00
.env chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
.env.example chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
.gitignore chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
CLAUDE.md chore: release v0.2.0 2026-09-27 15:31:19 +02:00
electron-builder.yml feat(emulators): Nintendo Wii and GameCube support with Dolphin 2026-09-27 15:46:44 +02:00
electron.vite.config.ts chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
package-lock.json feat(emulators): Game Boy, Game Boy Color and Game Boy Advance support with mGBA 2026-09-27 19:32:00 +02:00
package.json feat(emulators): Game Boy, Game Boy Color and Game Boy Advance support with mGBA 2026-09-27 19:32:00 +02:00
README.md feat(emulators): Game Boy, Game Boy Color and Game Boy Advance support with mGBA 2026-09-27 19:32:00 +02:00
tsconfig.json chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
tsconfig.node.json chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00
tsconfig.web.json feat(media): media tab with manual, walkthrough, screenshots, artwork and soundtrack 2026-09-27 17:10:52 +02:00
vitest.config.ts chore: scaffold Electron + Vue project 2026-09-25 11:35:22 +02:00

README.md

RomM Desktop

Desktop-Client für RomM. Er bringt deine RomM-Bibliothek als eigene Anwendung auf Windows, macOS und Linux:

  • Bibliothek durchsuchen und Spiele mit einem Klick auf Spielen starten
  • ROMs und Emulatoren werden bei Bedarf automatisch heruntergeladen
  • Spielstände werden vor und nach dem Spielen mit RomM synchronisiert, inklusive lokaler Backups
  • Spielzeit wird an RomM gemeldet
  • Medien wie in RomM: Handbuch und Walkthrough (auch von GameFAQs) direkt in der App lesen, Screenshots, Artwork und Soundtrack mit Player; Hochladen per Drag & Drop
  • Die App läuft im Tray weiter, damit Downloads und Sync auch bei geschlossenem Fenster fertig werden

Unterstützte Emulatoren

Plattform Emulator
Nintendo DS melonDS
Nintendo 3DS Azahar (entschlüsselte .3ds/.cci/.cxi, kein CIA; nicht für Windows/Linux arm64)
Nintendo Switch Eden (.nsp/.xci; Keys und Firmware aus dem Firmware-Bereich von RomM; macOS nur Apple Silicon, experimentell)
Nintendo Wii, GameCube Dolphin (.iso/.gcm/.rvz/.wia/.wbfs/.gcz)
Game Boy, Game Boy Color, Game Boy Advance mGBA (.gb/.gbc/.gba)

Weitere Plattformen folgen. Wie ein Emulator eingebaut wird, steht in docs/emulators.

Schnellstart

Voraussetzung: Node.js ≥ 22.12

npm install
npm run dev

Beim ersten Start meldest du dich mit Benutzername/Passwort an oder koppelst das Gerät per Code über die RomM-Weboberfläche.

Befehle

Befehl Beschreibung
npm run dev App mit Hot Reload starten
npm test Unit-Tests
npm run typecheck Typprüfung (Main + Renderer)
npm run gen:api API-Client aus der OpenAPI-Spec des Servers neu erzeugen
npm run dist:mac / dist:win / dist:linux Installationspaket bauen

Server festlegen

Die RomM-Instanz wird beim Build festgelegt (Standard: https://player.jreupsch.dev):

MAIN_VITE_ROMM_URL=https://romm.example.com npm run dist

Tech-Stack

Electron · Vue 3 · vue-router · Pinia · vue-i18n · Tailwind CSS · @hey-api/openapi-ts

Dokumentation

Technische Details zu Architektur, Anmeldung, Sync und Emulatoren liegen unter docs/.