wiki/pages/_en-US/twilightmenu/custom-unlaunch-backgrounds.md
triangle b9ab9fe6d4
Various changes (#28)
* Small adjustments and others

Small adjustments:
- Corrects capitalization of `Acekard` and `SD card`
- Corrects to American English
Also adds detail about nds-bootstrap screenshots, and redirects nds-bootstrap compatibility question to its FAQ, for consistency's sake.

* Compatibility and nds-bootstrap vs flashcard changes

Compatibility question changes:
- Merges troubleshooting and "Why do I get a white screen" because of redundancy
- Removes mention of changing sound quality, as far as I know this has never been an issue anywhere
- Adds mention of Async card read (using Async for the sake of consistency, unless that's to be changed as well)
- Links to GitHub issues page
-Small detail change on adding to the compatibility list
nds-bootstrap vs flashcard changes:
- Corrects `cartridges` to `Game Cards`
- Adds detail about screenshots and RAM editing

* Add detail about TWiLight Menu++ cheats menu

Also removes a period from a bullet

* Small changes

- Corrects capitalization of `Game Card`
- Corrects `3DS/2DS` to just `3DS`

* Add screenshot/frame advance details

Also
- Adds details on faster/fastest scroll in nds-bootstrap RAM viewer
- Adds detail on changing the in-game menu button combination

* Add detail about custom text color palettes

I think this is also worth adding, even though it's stared under the restrictions

* Decapitalize "custom firmware"

* Add detail about 3D/2D elements

Also corrects capitalization of `GBAtemp`

* Add screenshot controls

Also adds details about screenshots.tar

* Add specific spelling for 3DS as a family of systems

* Update controls.md

* Add Up/Down for cycling screenshot VRAM bank

* Correct frame step button

* Add pressing B to return to the in-game menu from Screenshot

Co-authored-by: RocketRobz <bobesh8@gmail.com>
2021-08-14 17:58:31 -06:00

54 lines
4.0 KiB
Markdown

---
lang: en-US
layout: wiki
section: twilightmenu
category: customization
title: Custom Unlaunch Backgrounds
description: How to make custom Unlaunch backgrounds and install them using TWiLight Menu++
---
You can find premade Unlaunch backgrounds on the [TWiLight Menu++ skins site](https://skins.ds-homebrew.com/unlaunch/).
{:.alert .alert-info}
Using TWiLight Menu++ you can patch the Unlaunch installer to have a custom background image and text color palette. This needs to be a 256 x 192 GIF, with a few restrictions:
- Only the first frame will be shown, no animated backgrounds
- The file must be less than or equal to 15,472 bytes
- GIFs with more than 31 colors require specially made palettes to prevent breaking the text
### Installing
1. Copy the GIF file to `sd:/_nds/TWiLightMenu/unlaunch/backgrounds`
1. Download the [latest Unlaunch installer](https://problemkaputt.de/unlaunch.zip) and extract `UNLAUNCH.DSI` to your SD card
1. Open TWiLight Menu++ Settings, switch to the `Unlaunch settings` page, and click on `Background`, then select the one you want
1. Exit settings and launch `Unlaunch DSi Installer`
- It should use your custom image, if it does not then turn off your console and make sure your GIF conforms with the requirements above
1. Choose `Install Now`
### Using GIFs with more than 31 colors
As the GIF's palette is loaded to the same area of VRAM as the text palettes it will overwrite them if the palette gets too large, however this can be worked around by including the text palettes in the GIF's palettes. Using this with different colors would also let you have different text colors, should you want that. These instructions will be for [GIMP](https://gimp.org), but any image editor capable of rearranging the palette of an image will work.
1. Open your image in GIMP and make sure it's 256 x 192 pixels
1. In the menu bar at the top, select `Image` -> `Mode` -> `Indexed...`
1. Select `Generate optimum palette` and set the maximum colors to anything up to 226 colors
1. Select a dithering pattern from the `Color dithering` dropdown
- Images without dithering generally compress best, but with it will generally look better, try and see which looks best for the size
1. Click `Convert`
1. In the menu bar at the top, select `File` -> `Export As...`, give it a name with the extension `.gif`, and click `Export`
- If it gives any warnings, click the accept button
1. In the next popup, disable the `GIF comment` and click `Export`
1. Check the size of the exported file, if it's 15,472 bytes or less, then skip to step 13
1. If your GIF is too large, then using either [gifsicle](http://www.lcdf.org/gifsicle/) or [ezgif.com](https://ezgif.com/optimize) you can try optimizing it
- These instructions will use ezgif as its simpler, being a website
1. Open https://ezgif.com/optimize, and upload your GIF
1. Try different compression levels until you find the best one under 15,472 bytes (15.11 KiB), ideally a bit under as GIMP may increase the size a bit
1. Save the optimized GIF and open it in GIMP
1. In the menu bar at the top, select `Windows` -> `Dockable Dialogs` -> `Colormap`
1. Change your current `Foreground color` to #080808 and add 14 new colors with the `+` button
- If your image doesn't have at least 133 colors you will need to keep adding colors until the last is index 146
1. Right click a color in the Colormap and select `Rearrange Colormap...`
1. Arrange your new colors so they match the ones outlined in red: (The 2nd and 3rd columns starting on the 4th row)<br>
![Palette with correct text colors](/assets/images/custom-unlaunch-bg/unlaunch-palette.png)
1. Use the color picker to make your new colors match those in the above image
1. In the menu bar at the top, select `File` -> `Export As...`, give it a name with the extension `.gif`, and click `Export`
1. In the next popup, make sure `GIF comment` is off and click `Export`
1. Ensure the image is still under 15,472 bytes, if it's gotten too big then repeat from step 10 using a higher compression level
1. You're done! Follow the [installing](#installing) section above to use your image!