About This File
Hello everyone, I'm proud to present a new RomM server plugin for LaunchBox. Currently, it offers a complete solution, both synchronizing your server and updating it with LaunchBox data, as well as functions to install and uninstall games. Please take advantage of it and provide your feedback.
https://github.com/phscezario/launchbox-romm-plugin
## ๐ v1.0.0 โ First Stable Release!
After a lot of work, the plugin now reliably syncs metadata, cover art, and keeps your LaunchBox library in sync with your RomM server. ๐
---
## ๐ฎ LaunchBox RomM Plugin โ Release Notes
### ๐ What's New
#### ๐ Metadata Sync (RomM โ LaunchBox)
Sync now auto-fills LaunchBox game metadata from the RomM server:
- Release date, max players, play mode
- Video (YouTube), Wikipedia, ESRB
- Community rating and votes
- Synopsis / notes
- Genres, companies, game modes
- LaunchBox ID (LaunchBoxDbId)
Priority: **LaunchBoxMetadata > ScreenScraper > IGDB > RomM Metadata**.
#### ๐ผ๏ธ Automatic Cover Art Download
- Box - Front cover art is downloaded automatically from the RomM server
- Only downloads if the game has no existing cover in LaunchBox
- `ForceReload` runs after sync so images appear immediately
#### ๐งน Orphan Image Cleanup
- When a game is removed from the RomM server, the sync removes the game from LaunchBox and deletes its associated images
- Cleanup happens **after** the full sync completes, preventing partial deletions on failure
#### โ๏ธ KeepLocalData Flag
New setting that controls overwrite behavior:
- `KeepLocalData = true` โ only fills empty fields, preserves existing data
- `KeepLocalData = false` โ overwrites all fields
#### ๐ Cover Art Upload (Update RomM Metadata)
`Update RomM Metadata` now also sends the Box - Front cover from LaunchBox back to the RomM server.
### ๐ Fixes
- Fixed cover download failing due to unencoded spaces in RomM's timestamp parameter (`?ts=...`)
- Fixed image path by using LaunchBox's `GetNextAvailableImageFilePath` instead of hardcoded paths
### โก Improvements
- `dataManager.ForceReload()` runs automatically after sync โ no more restarting LaunchBox to see images
- Detailed logging of downloaded image paths for easier debugging
---
### How to Update
1. Replace the `RomM LaunchBox Integration` folder in your LaunchBox Plugins directory
2. Launch LaunchBox and configure `KeepLocalData` in plugin settings if desired
3. Run `RomM: Sync roms list from server`
ย
Edited by ByakkoKa
What's New in Version 0.2.1 See changelog
Released
๐ Fixes
- fix: Some null problems in launchbox_metadata and read only servers (#22)
This release resolves an issue when updating RomM data using LaunchBox. If you are experiencing any problems due to the previous version, please contact me and I will help you fix it directly in the RomM database.