added manual image guide

This commit is contained in:
laz 2024-12-28 14:24:13 +01:00
parent a919e0325e
commit c9a13446bf

View file

@ -8,7 +8,69 @@ In: `~/retrodeck/ES-DE/downloaded_media` folder.
## Can I add my own images, manuals, or other media? ## Can I add my own images, manuals, or other media?
The ES-DE Wiki has [instructions](https://gitlab.com/es-de/emulationstation-de/-/blob/master/USERGUIDE.md?ref_type=heads#manually-copying-game-media-files) on adding your own media. The ES-DE Wiki has [Instructions: Manually copying game media files](https://gitlab.com/es-de/emulationstation-de/-/blob/master/USERGUIDE.md?ref_type=heads#manually-copying-game-media-files) on adding your own media.
There's a handy spreadsheet that explains each media type:
[Spreadsheet: Media Types in ES-DE](https://docs.google.com/spreadsheets/d/18VJAL44aNxsFOd4pVAONmdWwa7srCSzr2Z2SJEiNKnE/edit?gid=1812680930#gid=1812680930)
### Manually copying game media files
If you already have a library of game media (images, videos and PDF manuals) you can manually copy these files into RetroDECK (ES-DE).
Requirements:
- Remember that on Linux filenames are case sensitive.
- The file extensions must be in lower case in ES-DE (`.png` instead of `.PNG` / `.Png`).
- The media files names must correspond exactly to the game files name.
- For directories interpreted as files games (like ScummVM) you will need to add the folder file extension to the media file name example: `dig.scummvm.png`.
- Supported image file extensions are: `.jpg` and `.png`.
- Supported video file extensions are: `.avi` , `.mkv` , `.mov` , `.mp4` and `.wmv`.
The default media directory is: `~/retrodeck/ES-DE/downloaded_media/<system name>/<media type>/<files goes here>`
The following media type directories are supported:
- 3dboxes
- backcovers
- covers
- custom
- fanart
- manuals
- marquees
- miximages (The miximages are generated by ES-DE)
- physicalmedia
- screenshots
- titlescreens
- videos
### Example adding media files to games
**A multi-disk game or a single game:**
You want to add a screenshot and a video to the game:
`~/retrodeck/roms/c64/Multidisk/Last Ninja 2/Last Ninja 2.m3u`
Then the media files structure needs to be the following:
`~/retrodeck/ES-DE/downloaded_media/c64/screenshots/Multidisk/Last Ninja 2/Last Ninja 2.jpg`
`~/retrodeck/ES-DE/downloaded_media/c64/videos/Multidisk/Last Ninja 2/Last Ninja 2.mp4`
**A Directories interpreted as files game:**
You want to add a screenshot and a video to the game:
`~/retrodeck/roms/scummvm/dig.scummvm`
The media files for this directory which is interpreted as a file will be:
`~/retrodeck/ES-DE/downloaded_media/scummvm/screenshots/dig.scummvm.png`
`~/retrodeck/ES-DE/downloaded_media/scummvm/videos/dig.scummvm.mp4`
## I got some weird error message about quota after scraping! ## I got some weird error message about quota after scraping!