LCD-Game-Shrinker is a program that shrinks MAME high-resolution artwork and graphics for portable devices running LCD-Game-Emulator. You can read more on the projects GitHub page: https://github.com/bzhxx/LCD-Game-Shrinker
When creating this guide for LCD-Game-Shrinker I used the FREE Oracle VM VirtualBox with Ubuntu 20.0.4.2 LTS running under Windows 10. This is a great way to get a build environment set up quickly.
Speaking of which, I've made a script called lcdsetup.sh that automates upto and including Step 6 of this guide if you prefer, which you can download from my github page. download here
SKIP TO STEP 7 after using lcdsetup.sh linked above.
Before we continue it's important that you make sure Ubuntu is updated or you'll be installing old outdated packages and get errors.
Open a Terminal window in Ubuntu (Linux) and type, or copy and paste the following line, then press Enter.
sudo apt-get update
Enter your password when/if asked.
Do the same for the following line as well.
sudo apt-get upgrade
Press [Y] when/if prompted and then press Enter to complete the upgrade.
Now you should be up to date and can proceed with the following guide.
STEP 1
Before you can set up the build environment, you'll need to install git in order to clone the required repositories. If you're not sure whether you have git installed you can check by typing git --version in a Terminal window (It does not come pre-installed with Ubuntu 20.04.2 LTS). If it shows something like git version 2.25.1 you can skip ahead to step 2 as it's already installed. If not, continue on with step 1...
Open a Terminal window and type, or copy and paste the following line, then press Enter.
sudo apt install git
Enter your password when asked and press "Y" when prompted and move onto step 2.
STEP 2
For this example, I've created a folder on my desktop and named it lcd-games, this is where all of our related files and folders are going to be placed. You can name yours whatever you like.
Open a Terminal window and navigate to the directory you just created.
STEP 3
Now let's clone in the LCD-Game-Shrinker GitHub repo..
In the Terminal window type or copy and paste the following line and press enter.
git clone https://github.com/bzhxx/LCD-Game-Shrinker
STEP 4
Ubuntu comes with the required lz4 and Python3 installed which means less work for you, at least Ubuntu 20.0.4.2 LTS does. That said, you'll still need to install pip in Ubuntu. So, once again open a Terminal window and type or copy and paste the following line, and press enter.
sudo apt install python3-pip
Enter your password when asked and press "Y" when prompted. This will install pip and any required dependencies.
STEP 5
Change into the LCD-Game-Shrinker directory by typing or copying and paste the following line into the Terminal window and press enter.
cd LCD-Game-Shrinker
Once inside the LCD-Game-Shrinker directory copy and paste the following line into the Terminal window and press enter to install the required files to run the python scripts.
python3 -m pip install -r requirements.txt
STEP 6
Finally, before we can use LCD-Game-Shrinker we need to install a free Vector Graphics Editor called Inkscape. You can download this via the Ubuntu Software app or you can use the sequence of Linux terminal commands below to install Inkscape version 1.1.
It will likely be at the top of the page when you launch the app. Just click on the Inkscape logo, then the Install button, and provide your password when prompted to install it. If you have issues later and get the error returned non-zero exit status 1. try re-installing Inkscape to solve the issue, this worked for someone who got this error. Inkscape should be version 1.1 (Confirmed to work, other versions may have graphical errors).
sudo add-apt-repository ppa:inkscape.dev/stable-1.1
sudo apt-get update
sudo apt install inkscape
STEP 7
Now we'll need the zipped ROM and its Artwork to see if we have everything set up right. You'll have to source these MAME ROM files yourself by searching Google. You will also need the separate art packs created by Hydef or DarthMarino (You only need one of these art packs). For best results I recomend you use the MAME 0.229 romset. That said others will work, but may require additional efforts. Please do not ask others for the ROM files! - Ask Google instead ;)
Both the zipped ROM and the zipped Artwork must be placed into their respective folders. .mgw files will NOT work with LCD-Game-Shrinker! You MUST find the correct MAME 0.229 ROM set in .zip format which will contain the ROM file along with other files such as .svg or audio files (.melody) (Do not unpack the zip file!)
lcd-games/LCD-Game-Shrinker/input/artwork/
lcd-games/LCD-Game-Shrinker/input/rom/
STEP 8 Now that you have the ROM and the artwork in the correct folders, let's see if all that work paid off!
From the Terminal window and within the LCD-Game-Shrinker directory run python3 shrink_it.py to process all files or python3 shrink_it.py input/rom/gnw_mygame_zip to process a single file. Make sure to change the roms filename ;P
If all went well you should see the word COMPLETE next to each games progress bar. Every game must have its properly named artwork or you'll get errors. The most common errors you'll encounter are due to missing artwork or wrong filenames. You can either rename the artwork as needed or edit the games .py script in LCD-Game-Shrinker/custom/ should you encounter any of these errors.
Finally copy all of the outputed .gw files (These are your Game & Watch ROM files) located in LCD-Game-Shrinker/output/ to game-and-watch-retro-go/roms/gw. That's it! You're now ready to follow the game-and-watch-retro-go readme and flash the games to your G&W.
For any and all issues, feel free to join us on Discord or on r/GameAndWatchMods. You're also encouraged to post feedback here if you have any issues when using this guide or lcdsetup.sh.
Thanks to @Fuzion9#6018 from the Discord who followed this portion of the guide and confirmed it works with the same setup. A complete guide is in the works and will be made available soon.
Cheers! - DNA64 aka (viral_dna)
So cool, I couldn't figure out how to get the .mgw Game and Watch ROMs to work with the new Zelda G&W unit. Thanks! :)