search

GerbilSoft / rom-properties

ROM Properties Page shell extension
GNU General Public License v2.0
495 stars 36 forks source link
3ds amiibo dreamcast gameboy mega-drive n64 nds nes nintendo-3ds nintendo-ds playstation rom shell-extension snes texture virtualboy vmu wii wiiu xbox

readme

ROM Properties Page shell extension

This shell extension adds a few nice features to file browsers for managing video game ROM and disc images.

License: GPL v2 AppVeyor Build status
Coverity Scan Build Status Crowdin
CodeQL CodeFactor codecov

v2.4

Thunar showing Wii U packages.

Major changes in v2.4 include:

Translators wanted; if you can translate rom-properties from English to another language, check out the Crowdin project. (If you would like to translate to a language not currently listed on the Crowdin project page, file an issue here on GitHub with the requested language.)

See NEWS.md for a full list of changes in v2.4.

Feedback

This is a work in progress; feedback is encouraged. To leave feedback, you can file an issue on GitHub, or visit the Gens/GS IRC channel: irc://irc.badnik.zone/GensGS

Or use the Mibbit Web IRC client: http://mibbit.com/?server=irc.badnik.zone&channel=#GensGS

Installation

Currently, the ROM Properties Page shell extension is compatible with the following platforms:

The following platforms are still compatible, but may not receive as much support:

On Windows Vista and later, you will need the MSVC 2015-2022 runtime:

On Windows XP/2003 and earlier, you will need the MSVC 2015-2017 runtime:

For instructions on compiling from source, see doc/COMPILING.md.

Linux

Install the relevant .deb package, depending on what desktop environment you are using and what your CPU is.

After installing, the plugin needs to be enabled in the Dolphin file browser:

If installed correctly, thumbnails should be generated for the supported file type. You can also right-click a file, select Properties, then click the "ROM Properties" tab to view more information about the ROM image.

Windows

Extract the ZIP archive to a directory, then run install.exe. The installer requires administrator access, so click "Yes" if requested. In the installer, click the "Install" button to register the ROM Properties Page DLL.

Note that this will hard-code the location of the DLL files in the registry, so you may want to place the DLLs in a common location.

To uninstall the plugin, run install.exe again, then click the "Uninstall" button.

Current File Support Level

Game Consoles

System Properties Tab Metadata Internal Images External Images
ColecoVision Yes Yes N/A No
Commodore 64/128 .CRT Yes Yes N/A Title
Intellivision Yes Yes N/A No
iQue Player ticket files Yes Yes Icon, Banner No
Microsoft Xbox (XBE) Yes Yes Icon No
Microsoft Xbox 360 (XEX) Yes Yes Icon No
Microsoft Xbox 360 (STFS) Yes Yes Icon No
Microsoft Xbox Game Discs Yes Yes Icon No
NES Yes No N/A No
Super NES Yes Yes N/A Title
Nintendo 64 Yes Yes N/A No
Nintendo GameCube Discs Yes Yes Banner Disc, Covers
Nintendo GameCube Banners Yes Yes Banner No
Nintendo GameCube Saves Yes Yes Icon N/A
Nintendo Wii Banners Yes Yes No No
Nintendo Wii Discs Yes Yes No Disc, Covers
Nintendo Wii WADs Yes Yes Yes* Title, Covers
Nintendo Wii Saves Yes Yes Yes N/A
Nintendo Wii U (Disc) Yes No No Disc, Covers
Nintendo Wii U (NUS) Yes Yes Icon Disc, Covers
Sega 8-bit (SMS, GG) Yes Yes N/A No
Sega Mega Drive Yes Yes N/A Title
Sega Dreamcast Yes Yes Media No
Sega Dreamcast Saves Yes Yes Icon, Banner No
Sega Saturn Yes Yes N/A No
Sony PlayStation Discs Yes No N/A Covers
Sony PlayStation EXEs Yes No N/A N/A
Sony PlayStation Saves Yes Yes Icon N/A
Sony PlayStation 2 Discs Yes Yes N/A Covers

* Internal images are only present in Wii DLC WADs.
* Sega Mega Drive includes Sega CD, 32X, and Pico.

Handhelds

System Properties Tab Metadata Internal Images External Images
Atari Lynx Yes Yes N/A No
Bandai WonderSwan (Color) Yes Yes N/A Title
Neo Geo Pocket (Color) Yes Yes N/A Title
Nintendo Game Boy (Color) Yes Yes N/A Title
Nintendo Virtual Boy Yes Yes N/A No
Nintendo Game Boy Advance Yes Yes N/A Title
Nintendo DS(i) Yes Yes Icon Covers, Box
Nintendo DSi TADs* Partial No No No
Nintendo 3DS Yes Yes Icon Covers, Box
Palm OS Yes Yes Icon N/A
Pokémon Mini Yes Yes N/A No
Sony PlayStation Portable Yes Yes Icon, Banner No
Tiger game.com Yes Yes Icon No

* The Nintendo DSi TAD parser supports development TADs that are normally imported using DSi Nmenu. It does not currently support DSi exports from retail systems.
* The PSP parser supports both PSP game and UMD video discs, as well as several compressed disc formats: CISOv1, CISOv2, ZISO, JISO, and DAX.

Texture Formats

Texture Format Properties Tab Metadata Internal Images External Scans
ASTC container Yes Yes Image N/A
Godot 3,4 .stex Yes Yes Image N/A
Leapster Didj .tex Yes Yes Image N/A
Khronos KTX Yes Yes Image N/A
Khronos KTX2 Yes Yes Image N/A
Microsoft DirectDraw DDS Yes Yes Image N/A
Microsoft Xbox XPR Yes Yes Image N/A
PowerVR 3.0.0 Yes Yes Image N/A
Sega PVR/GVR/SVR Yes Yes Image N/A
TrueVision TGA Yes Yes Image N/A
Valve VTF Yes Yes Image N/A
Valve VTF3 (PS3) Yes Yes Image N/A

Texture Codecs

Audio Formats

System Properties Tab Metadata Internal Images External Scans
Atari 8-bit SAP audio Yes Yes N/A N/A
Atari ST SNDH audio Yes Yes N/A N/A
CRI ADX ADPCM Yes Yes N/A N/A
Commodore 64 SID Music Yes Yes N/A N/A
Game Boy Sound System Yes Yes N/A N/A
Game Boy Ripped Yes N/A N/A N/A
Nintendo 3DS BCSTM and BCWAV Yes Yes N/A N/A
Nintendo Sound Format Yes Yes N/A N/A
Nintendo Wii BRSTM Yes Yes N/A N/A
Nintendo Wii U BFSTM Yes Yes N/A N/A
Portable Sound Format Yes Yes N/A N/A
Super NES SPC Format Yes Yes N/A N/A
Video Game Music Yes Yes N/A N/A

Media Formats

System Properties Tab Metadata Internal Images External Scans
Commodore DOS Disk Images Yes Yes GEOS* N/A
ISO-9660 Disc Images Yes Yes No N/A
Windows Image (.wim) Yes No N/A N/A

Notes:

Other

System Properties Tab Metadata Internal Images External Scans
Executable and Linkable Format Yes No N/A N/A
PUC Lua binaries Yes No N/A N/A
Mach-O Binaries Yes No N/A N/A
Nintendo amiibo Yes No N/A Media
Nintendo Badge Arcade Yes Yes Image N/A
Windows/DOS Executables Yes Yes No N/A

Notes:

A configuration program, rp-config, is available to configure rom-properties using a graphical interface. This program allows you to configure which images will be used for thumbnails on each system, as well as other functionality.

External Media Downloads

Certain parsers support the use of external media scans through an online database, e.g. GameTDB.com. This is enabled by default, but you can customize which scans are downloaded for which systems by running the configuration program, rp-config.exe.

Downloaded images are cached to the following directory:

The directory structure matches the source site, so e.g. a disc image of Super Smash Bros. Brawl would be downloaded to ~/.cache/rom-properties/wii/disc/US/RSBE01.png. Note that if the download fails for any reason, a 0-byte dummy file will be placed in the cache, which tells the shell extension not to attempt to download the file again. [FIXME: If the download fails due to no network connectivity, it shouldn't do this.]

If you have an offline copy of the GameTDB image database, you can copy it to the ROM Properties Page cache directory to allow the extension to use the pre-downloaded version instead of downloading images as needed.

Decryption Keys

Some newer formats, including Wii disc images, have encrypted sections. The shell extension includes decryption code for handling these images, but the keys are not included. To install the keys, create a text file called keys.conf in the rom-properties configuration directory:

The keys.conf file uses INI format. An example file, keys.conf.example, is included with the shell extension. This file has a list of all supported keys, with placeholders instead of the actual key data. For example, a keys.conf file with the supported keys for Wii looks like this:

[Keys]
rvl-common=[Wii common key]
rvl-korean=[Wii Korean key]

Replace the key placeholders with hexadecimal strings representing the key. In this example, both keys are AES-128, so the hexadecimal strings should be 32 characters long.

NOTE: If a key is incorrect, any properties dialog that uses the key to decrypt data will show an error message instead of the data in question.

Nintendo DS Secure Area

To encrypt or decrypt the Nintendo DS Secure Area, the Blowfish key must be named nds-blowfish.bin and placed in the same directory as keys.conf.

MD5sum: c08c5afd9c6d9530817cd2033e3864d7

Unsupported File?

If you have a file that you believe should be supported by ROM Propeties, or would like to see support added for a new type, file an issue on GitHub: https://github.com/GerbilSoft/rom-properties/issues

License

ROM Properties is licensed under the GNU General Public License v2. Some bundled components have other licenses:

GCR_CMake is only used at build time, and is only necessary for the GTK builds, so I believe it does not make the entire program GPL-3 licensed.

unice68 is linked in during compile time, but can be disabled. All builds with unice68 are therefore GPL-3+. unice68 is only used for Atari ST SNDH files, so this can be disabled if a GPL-2+ build is desired: -DENABLE_UNICE68=OFF

On Windows, the following bundled components are also used:

While the use of gettext can be disabled with -DENABLE_NLS=OFF, libwin32darkmode is currently always enabled, so Windows builds are always GPL-3+ at the moment.

Credits

Developers

Translators

Other Contributions

[This list is incomplete; if you think you should be listed here, file an issue.]

Websites