From c9a13446bf585602595b753583ffa8bf32a5a685 Mon Sep 17 00:00:00 2001 From: laz Date: Sat, 28 Dec 2024 14:24:13 +0100 Subject: [PATCH] added manual image guide --- wiki-rtd/docs/wiki_faq/faq-scraping.md | 64 +++++++++++++++++++++++++- 1 file changed, 63 insertions(+), 1 deletion(-) diff --git a/wiki-rtd/docs/wiki_faq/faq-scraping.md b/wiki-rtd/docs/wiki_faq/faq-scraping.md index 804cd88..783475f 100644 --- a/wiki-rtd/docs/wiki_faq/faq-scraping.md +++ b/wiki-rtd/docs/wiki_faq/faq-scraping.md @@ -8,7 +8,69 @@ In: `~/retrodeck/ES-DE/downloaded_media` folder. ## 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///` + +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!