mirror of
https://github.com/GerbilSoft/rom-properties.git
synced 2025-06-18 19:45:41 -04:00
119 lines
4.4 KiB
Markdown
119 lines
4.4 KiB
Markdown
# Network Access Information
|
|
|
|
The ROM Properties Page Shell Extension has functions to access various
|
|
Internet databases in order to download artwork.
|
|
|
|
This functionality can be adjusted by using the `rp-config` utility, which
|
|
adjusts the following values in the configuration file:
|
|
|
|
```
|
|
[Downloads]
|
|
ExtImageDownload=true
|
|
ImgBandwidthUnmetered=HighRes
|
|
ImgBandwidthMetered=NormalRes
|
|
```
|
|
|
|
Set ExtImgDownload to false to disable all image downloads.
|
|
|
|
The ImgBandwidthUnmetered and ImgBandwidthMetered keys can be set to one
|
|
of the following values:
|
|
* None: Disable image downloading on this network type.
|
|
* NormalRes: Download normal-resolution images.
|
|
* HighRes: Download high-resolution images.
|
|
|
|
Metered network detection is supported on the following systems:
|
|
* Windows 10 v2004 or later
|
|
* Linux systems, when using NetworkManager
|
|
|
|
On other systems, rom-properties will assume the network is unmetered.
|
|
|
|
The configuration file is located at:
|
|
* Linux: `~/.config/rom-properties/rom-properties.conf`
|
|
* Windows: `%APPDATA%\rom-properties\rom-properties.conf`
|
|
|
|
Downloaded images are saved in the following directory:
|
|
* Linux: `~/.cache/rom-properties/`
|
|
* Windows XP: `%USERPROFILE%\Local Settings\Application Data\rom-properties`
|
|
* Windows Vista and later: `%USERPROFILE%\AppData\LocalLow`
|
|
|
|
NOTE: Prior to rom-properties v1.5, the Windows cache directory was
|
|
`%LOCALAPPDATA%\rom-properties`. It was moved to `LocalLow` in order
|
|
to allow `rp-download` to run as a low-integrity process. Existing
|
|
files were not migrated over, so those can either be moved manually
|
|
or deleted.
|
|
|
|
## Domains accessed:
|
|
|
|
* [https://art.gametdb.com/](https://gametdb.com/) - Box, cover, and media scans for Nintendo
|
|
GameCube, Wii, Wii U, DS, and 3DS games.
|
|
* https://amiibo.life/ - Images of Nintendo amiibo products.
|
|
* https://rpdb.gerbilsoft.com/ - External images for the following
|
|
systems:
|
|
* Commodore 64/128 (cartridges)
|
|
* Neo Geo Pocket (Color)
|
|
* Nintendo Game Boy
|
|
* Nintendo Game Boy Color
|
|
* Nintendo Game Boy Advance
|
|
* Sega Mega Drive / Genesis, Sega CD, 32X, Pico
|
|
* Sony PlayStation 1 and 2
|
|
* Super NES
|
|
* WonderSwan (Color)
|
|
|
|
The RPDB domain is also used by rp-config's update checker to determine if
|
|
a newer version of rom-properties is available.
|
|
|
|
PlayStation 1 and 2 cover art is mirrored from the following GitHub repositories:
|
|
|
|
* https://github.com/xlenore/psx-covers
|
|
* https://github.com/xlenore/ps2-covers
|
|
|
|
### ROM Information Used
|
|
|
|
The following information is used as the lookup key in order to retrieve
|
|
images from the online databases:
|
|
|
|
* Commodore 64/128 cartridges: CRC32 of up to 16 KB of ROM data, and
|
|
cartridge type.
|
|
* GameCube, Wii, Wii U: 6-character Game ID (e.g. `GALE01`) and region code.
|
|
* Game Boy, Game Boy Color: Game title (e.g. `POKEMON RED`), or game ID
|
|
(e.g. `BXTJ01`) if available. Region code and publisher ID are also used.
|
|
* Game Boy Advance: 6-character Game ID (e.g. `AXVE01`)
|
|
* Nintendo DS: 4-character Game ID (e.g. `ATRE`)
|
|
* Nintendo 3DS: Product ID (e.g. `CTR-P-AXCE`) and region code.
|
|
* amiibo: 64-bit amiibo ID (e.g. `00000000-00000002`)
|
|
* Neo Geo Pocket (Color): Game ID (e.g. `NEOP0001`). For certain games
|
|
with invalid IDs (e.g. homebrew), the game title is also used.
|
|
* PlayStation 1 and 2: Game ID (e.g. `SLUS-20718`)
|
|
* Sega Mega Drive and related: Serial number (e.g. `GM 00001009-00`)
|
|
and region code.
|
|
* Super NES: Game title and region code (e.g. `SNS-SUPER MARIOWORLD-USA`),
|
|
or 2-character or 4-character game ID if present (e.g. `SNS-YI-USA`).
|
|
* WonderSwan (Color): Game ID (e.g. `SWJ-BAN001`), plus the Mono/Color flag.
|
|
|
|
## Security features
|
|
|
|
As of rom-properties v1.5, the downloading functionality has been
|
|
isolated into a single component, `rp-download`. The `rp-download`
|
|
program uses the following security features:
|
|
|
|
* Linux: seccomp(), AppArmor
|
|
* OpenBSD: pledge()
|
|
* Windows: Low-integrity process (on Vista+)
|
|
|
|
## GameTDB.com Privacy Policy
|
|
|
|
GameTDB.com's privacy policy can be read here: https://www.gametdb.com/Main/Legal
|
|
|
|
## amiibo.life Privacy Policy
|
|
|
|
amiibo.life's privacy policy can be read here: https://amiibo.life/privacy
|
|
|
|
## rpdb.gerbilsoft.com Privacy Policy
|
|
|
|
As with most web servers, accessing rpdb.gerbilsoft.com does result in user
|
|
information, such as IP addresses, being stored in a server log file. This
|
|
log file is used for aggregate statistical purposes as well as identifying
|
|
images missing from the server so they can be added in. No personally
|
|
identifying information will ever be released, and this information will
|
|
not be sold to third-parties.
|