Giters

coetzeer / JRomManager

Java Rom Manager

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

JRomManager

A Rom Manager entirely written in Java and released under GPL-2

Screenshots

Licensing

Technical

Minimal development requirements:

  • Eclipse Oxygen for Java with WindowBuilder feature and Gradle Buildship
  • Java 8
  • Gradle dependencies (via Maven repositories)
    • Apache Commons Codec 1.13
    • Apache Commons IO 2.6
    • Apache Commons Lang3 3.9
    • Apache Commons Text 1.8
    • Apache Commons Compress 1.19 (used solely to list 7zip content)
    • StreamEx 0.6.8
    • SevenZipJBinding 16.02-2.01 (faster than using 7z cmd line)
  • Git submodules dependencies

Minimal usage requirements:

  • 1GB Free Ram (2GB or more with Software Lists, MultiCore feature, 7z ultra compression, ...)
  • Any OS with at least Java 8 runtime (64 bits version required to get more than 1GB)
  • (optional) 7zip or p7zip cmdline program if you need 7z format and only if SevenZipJBinding doesn't work on your platform
  • (optional) trrntzip cmdline program if you want to torrentzip your files (now integrated with Jtrrntzip)

Behavior compared to other Rom managers

  • By default, Split mode may differ from ClrMamePro, it's because JRomManager is by default using "explicit merging" and so will split only according the merge attribute presence (as preconized in logiqx faq), whereas ClrMamePro will split as soon as a rom in parent set as same CRC even if no merge attribute as been set! The difference is especially visible for Software Lists where merge flag does not exist at all in the DTD, so in this case "Split Merged" mode will be the same as using "Non Merged" mode for JRomManager. RomCenter is also known to be respectful of the merge attribute. To reproduce the ClrMamePro behavior you will have to select "implicit merge" option in profile settings

Minimal instructions for cmdline compilation:

If you just want to recompile sources without using an IDE (Eclipse), here are the steps to follow...

  • First, you need Java JDK 8 installed from your system package manager or from the official installer, or at least take care that all java jdk binaries are accessible from your current $PATH or %PATH%
    • [Required] If your are on Windows, you'll also need Visual C++ 2017 installed which is needed to build the JLauncher executable (gradle native plugin will detect Visual C++ installed and build/link using the VC++ compiler)
    • [Optional] If your are on Windows, and you want to build the MSI installer, you'll need the latest WIX Toolset to be installed and its bin/ folder added in your %PATH%
  • Download and unarchive https://github.com/optyfr/JRomManager/releases/download/<version>/JRomManager-<version>-src.tgz (use sevenzip for Windows); Do not download Source Code (zip) or Source Code (tar.gz), those ones are automatically built by github and unfortunately does not contains required submodules
  • cd JRomManager-<version>
  • run
    • Unix: sh ./gradlew build
    • Windows: .\gradlew.bat build
  • This is the included gradle-wrapper, it will download the right gradle binaries package version, then compile and package all (see build subdirs)

Current Features

  • Mame and Logiqx Dat formats
  • Import from Mame executable
  • Dat manager with stats and mame update check (if imported from mame)
  • Zip support
  • Split Scan/Fix/Rebuild
  • Non-Merged Scan/Fix/Rebuild
  • Merged Scan/Fix/Rebuild (with choice in case of name collision)
  • Full SHA1 scan or on-need SHA1 scan in case of suspicious CRC32
  • Retain SHA1 in cache until zip file change
  • CHD support
  • Software List support
  • Per profile settings (what to fix, how to scan, ...)
  • MultiThreading support (at least for archive manipulation and checksum calculation, fast disks required)
  • MD5 support (for old dats)
  • 7z support via SevenZipJBinding + 7z command line as functional backup
  • TorrentZip support using Jtrrntzip
  • Samples support (with separate Dest dir that may be eventually a subdir of Roms dir)
  • Multiple Source Dir
  • Dat parsing caching via Java Serialization
  • Optimized to permit scan over shared network
  • Dir scan caching via Java Serialization based on FileMDate+FileSize, one cache file per romdir, reusable between different Dat Scans if same dir is used
  • Enhanced Gui with Report
  • Translated to English and French (volunteers needed for other languages)
  • Filtering functionalities (clone, CHDs, systems list, display mode, cabinet type, driver status, ...)
  • Optional Separate Dest dir between Roms, CHDs, Software Roms, Software CHDs
  • Drag&Drop on src/dest dirs controls
  • Double click on game name in profile viewer will launch game if (Mame is linked with profile and item is green)
  • Double click on software name in profile viewer will launch software with a valid machine (if Mame is linked with profile and item is green)
  • Double click on cloneof or romof item in profile viewer will jump to that item definition
  • Advanced filtering functionalities when a nplayers.ini and catver.ini is associated with a mame profile
  • Popup menu in profile viewer to export as dat (dat2dat)... selection mode : all or selected, filtering mode : filtered or unfiltered, format : logiqx/mame/softwarelist/softwarelists (according selection and/or profile context)
  • One-click easy updater (can be manually disabled at launch)
  • Jar installer
  • Extra merging and collision modes to generate PleasureDome compatible Mame sets, as of v0.198 :
    • ROMs split => 100% torrent joining
    • ROMs merged => 99.89% torrent joining (64MB missed)
    • ROMs non-merged => 100% torrent joining
    • BIOS-Devices => 90.60% torrent joining (12MB missed)
    • SoftwareList Machine-BIOS-Devices => 70% torrent joining (10MB missed) since some machines exist with no SoftwareList available
    • SoftwareList ROMs => not tested since it contains some non-supported software lists
  • An advanced progression window taking into account multi-threading operations
  • Backup option (per profile)
  • (De)select Game or Software individually, or upon keywords selection (keywords are terms between parenthesis in description), similar to 1G1R mode
  • Launch mode for multiuser environment and for Linux packaging readiness (see %HOMEPATH%\.jrommanager or $HOME/.jrommanager for working path)
  • Available as installation package for Gentoo Linux JRomManager Overlay, Arch Linux, as .deb for Debian / UBuntu, as RPM for Centos / Fedora / Redhat, as MSI for Windows
  • .exe bootstrap for windows version (with MSI installer) that search for available JRE in the system and adjust right memory parameters according 32 or 64 bits jre, can also work with a possible bundled jre
  • Documented source and javadoc available
  • Dir2Dat
  • Batch Tools
    • Dir Updater : to update many dats files to many dirs. Accept dirs of dats as source (software list mode)
    • Torrent checker : to check many torrent to many dirs. From file name mode to sha1 mode. Include detail viewer to see what is missing and what is wrong (tree view by piece for SHA1 mode)
    • Compressor : to compress many files at a time from any format to Zip, TrntZip, or 7ZIP
  • Server mode + Web Client (EXPERIMENTAL).
    • JRomManager can listen to a defined port and serve a web interface instead of the classical Swing gui
    • The initial purpose of the server mode is to run JRomManager on headless server and directly on NAS
    • The Web interface is full feature complete, and very powerful, thanks to SmartGWT from isomorphic
    • This feature is experimental, it means that :
      • It has not been tested over the internet => the purpose is to access from intranet
      • It's a simple web server with basic websockets support => proxies may not work, no encrypted connection (https/wss), no protection against DDOS, no connection limitations, ...
      • There is currently no multiuser support nor access control implemented => you can break your server easily if you don't know what you're doing
  • Install as a service (Server mode)
  • RAR4 and RAR5 decompression
  • Multi-volume decompression (RAR and 7Zip)
  • Command Line Mode with access to all functionalities and environment variable support

Short Term Planned Features

  • Mode to keep existing container archive format
  • Use jetty instead of nanoHttpd for a more robust http server (Server mode)
  • Multi User and access rights (Server mode with jetty)
  • Encrypted connections (Server mode with jetty)

Middle Term Planned Features

  • Alternative to WebSockets (Server mode)
  • More Translations
  • Headered roms support
  • Auto update option (and show Changes log after auto-update)

Long Term Planned Features and Ideas

  • Emulator-friendly format converter?
  • Interoperability with other managers?
  • Torrent7Z support ?

Not planned features

  • Inverted/complemented CRC: obsolete replaced by "status" attribute since Mame 0.68
  • Old ClrMamePro non-xml format: even considered as deprecated by ClrMamePro
  • CHD verification: data won't be verified, only header is read to get md5/sha1, maybe the data size will be verified later but no hashing nor chdman
  • Rom resizing

Known issues

  • Never ever launch multiple instances of JRomManager, because 7zJBinding does have problem with this , and also because you may get stranges other things (Prevented app to launch twice)
  • JRomManager is still in early developpement stage, do not complain if it broke your romset and you didn't make any copy or backup
  • Zip integrated in java can leave useless directory entries in zip central directory, it is by design, and this implementation is the fastest available, this will not disturb Mame or any emulator, but clrmamepro will complain about useless dirs, and trrntzip will remove those entries as expected 😉

About

Java Rom Manager

License:GNU General Public License v2.0

Languages

Language:Java 100.0%