Editing Frontends & Launchers

{| class="wikitable" style="text-align: left;"
|-
! scope="col" style="text-align:left; color:white; background-color:#464646;"| Frontend/Launcher
! scope="col" style="text-align:left; color:white; background-color:#464646;"| Notes
|-
! scope="row" style="text-align:left;"| Pegasus
| Free. Fast. Immensely and overwhelmingly theme-able (can be skinned to look and behave exactly like any other frontend, given the time and effort).  Open-source and actively in development. An absolute pain to configure, and lacks built-in scraping support. Actively being developed (an official Retroid Handhelds launcher is currently being developed with this frontend). Here's a very helpful [https://basvroegop.nl/pegasus guide] to help you set it up. Dev is optimizing it for the RP2. Not available on the Play Store. Download from [https://pegasus-frontend.org/#downloads here].
|-
! scope="row" style="text-align:left;"| Dig
| Free. Slow. Theme-able. Super easy to configure, and does have built-in scraping. Development has been abandoned and the app is closed-source. Consequently, this will never be able to launch certain emulators like Flycast and the GBA build of Retroarch included on RP2. Pre-installed on the RP2. Available on the Play Store [https://play.google.com/store/apps/details?id=com.digdroid.alman.dig&hl=en_US here].
|-
! scope="row" style="text-align:left;"| RESET
| $5. Fast. Not theme-able (yet). Slick and easier than both Pegasus and Dig to configure. Built-in scraping. Actively being developed. Being optimized for the RP2 by the dev, Jav. Available on the Play Store [https://play.google.com/store/apps/details?id=com.retroloungelab.resetcollection&hl=en_US here]. 
|-
! scope="row" style="text-align:left;"| RetroX
| $12/year. Fast. Theme-able. The easiest to configure. Uses built-in emulator cores, giving you handy universal shortcuts in all of your games. Some systems might be faster in RetroX than on the RP2s pre-installed emulators, while some might be slower (currently). Emulation is less customizable than with other emulators. The subscription covers cloud saves, letting you stay synced across any device you use RetroX on, but its worth noting that internet access is required to open your games. Actively being developed, with a RP2 optimized performance version coming shortly by the dev, Franco Catrin. RetroX offers a 5 day free trial to see if its right for you. Not available on the playstore. Download from [https://RetroX.tv RetroX.TV].
|-
! scope="row" style="text-align:left;"| ClassicBoy
| $4. ClassicBoy is an all-in-one emulator that uses RetroArch cores. It has cores for PlayStation, GB, GBC, GBA, Nintendo 64, NES, SEGA, and NeoGeo. Contains standard features like audio settings, and save states. The developer hasn’t updated the app since 2014. It gives you free access to basic functions. Paying the upgrade fee is needed for it to be objectively usable. Pre-installed on the RP2. Available on the Play Store [https://play.google.com/store/apps/details?id=com.portableandroid.classicboyLite&hl=en_US here].
|}

== Pegasus Frontend ==

A full guide can be found [https://basvroegop.nl/pegasus here].

=== Installation ===

- First you need to allow non trusted APK installs. Open Settings, Security and mark "Unknown sources"

- Download the app in https://pegasus-frontend.org/#downloads and install it in your RP2

=== Configuration ===

Pegasus needs to have a file called metadata.pegasus.txt per system to specify which emulator you want to use, this can be a bit tedious but we've got you covered!

You can download config files for the RP2 emulators here: https://github.com/dragoonDorise/pegasus-rp2-metadata/

All the configs are done using the best emulators as described in this wiki, for DS you should install DraStic, all other systems are emulated with the stock emulators.

FYI: We're still working out the kinks to get N64 configured.

Again, please reference the [https://basvroegop.nl/pegasus full guide] for a more complete tutorial on Pegasus with the RP2.

=== Themes ===

You can use several themes, you would need to create a folder in your SD Card called "pegasus_frontend/themes" and put the theme files in a folder for each theme you want to use.

Here are a couple of Pegasus Themes adapted for the Retroid Pocket's Screen:

[SwitchOS RP2 Edition](https://github.com/dragoonDorise/switchOS)

[gameOS RP2 Edition](https://github.com/dragoonDorise/gameOS)

== DIG Frontend ==

=== Installation ===

Download and install from PlayStore https://play.google.com/store/apps/details?id=com.digdroid.alman.dig&hl=en_US.

=== Configuration ===

DIG runs out of the box. Allow prompt to access storage as it will need to scan your media to add ROMS.<br /><br />- The basic interface is pretty intuitive but very simple with no wallpapers.<br /><br />- Highly recommended to install different themes like the ones linked below or from the https://digdroid.com/forums/categories/themes DIG Forums.

You can also refer to the tutorial video from here.

<strong>Basic set-up tutorial for dig</strong> (with troubleshooting guide) on Retriod pocket 2:
https://youtu.be/45MW6vinmpA

=== Themes ===

Copy your desired DIG theme zip file to your device. Do not unzip it as DIG will install themes in zip format.<br /><br />Themes are installed and selected from within the DIG app in Options tab by clicking on Themes.<br /><br />- Select "Install theme" and browse the zip file.<br /><br />- Once installed select the theme from the dropdown menu by clicking "Select theme".

<br /><strong>Tutorial for installing themes for DIG on Retriod Pocket 2</strong>: https://youtu.be/xzD32TZ_ZRk<br /><br />

[<u>Wii 640x480</u> based on Riivive v1.1] (https://drive.google.com/file/d/1kz-lFvt7ErDtrpyn3Qcz97L96d3TWIrp/view?usp=sharing)

[<u>Switch 640x480</u> based on Riivive v1.1] (https://drive.google.com/file/d/1qHdXgRyIeEGwy8ZWkXT2HODcozoufmh3/view?usp=sharing)

[<u>Switch 640x480 Dark</u> based on Riivive v1.1] (https://drive.google.com/file/d/1DhE_LPv5XqXBqVpxjqblAf8w-ycr9938/view?usp=sharing)

[<u>Retro Switch</u>] (https://drive.google.com/file/d/1Vjl3ez9mW7Uk-ySXPXrVrR74jCrFeDYQ/view?usp=sharing)

[<u>Retro Switch Dark</u>] (https://drive.google.com/file/d/1KyzjO81ZC364wNPop5B7hCPB_saxqvmy/view?usp=sharing)

<!-- #######  YAY, I AM THE SOURCE EDITOR! #########-->
<p>==== <strong>Basic Tutorial for making themes for DIG frontend</strong> ====</p>
<p>Not an official tutorial or documentation about DIG frontend. The guide is a bit lengthy and may be too in depth for people familiar with console commands or who know their way around a PC in general. This is <strong>one </strong>way of approaching making themes</p>
<p><em>written by /u/CricoidRiver 2020-09-29 12:25:15 AM, 2830 words.</em></p>
<hr />
<p>===== Table of contents =====</p>
<ul>
<li><span style="text-decoration: underline;">Software you need</span></li>
<li><span style="text-decoration: underline;">Things to know</span></li>
<li><span style="text-decoration: underline;">The Config</span></li>
<li><span style="text-decoration: underline;">Backgrounds</span></li>
<li><span style="text-decoration: underline;">Foregrounds</span></li>
<li><span style="text-decoration: underline;">Toolbar</span></li>
<li><span style="text-decoration: underline;">Audio</span></li>
<li><span style="text-decoration: underline;">Text</span></li>
<li><span style="text-decoration: underline;">List Type</span></li>
<li><span style="text-decoration: underline;">Getting Started</span></li>
<li><span style="text-decoration: underline;">Using LDPlayer4 to visualize DIG themes</span></li>
<li><span style="text-decoration: underline;">Techniques and tips</span></li>
<li><span style="text-decoration: underline;">Example of a theme folder</span></li>
</ul>
<p>===== Software you need =====</p>
<hr />
<ul>
<li><strong>Notepad++ </strong>(free) https://notepad-plus-plus.org/downloads/ or any other text editor to edit the theme config.</li>
<li><strong> LDPlayer4</strong> (free) https://www.ldplayer.net/blog/ldplayer-4-review.html Android emulator for PC. Not necessary but makes it easier to preview your theme's layout without needing to transfer the file to your handheld to test it. This guide is going to be based around this emulator.</li>
<li><strong> Paint.net</strong> (free) https://www.getpaint.net/download.html but if you have Photoshop that will work too.</li>
<li><strong> GridCheckerboard plugin </strong>https://forums.getpaint.net/topic/1964-grid-maker-plugin-v30-updated-july-2-2014/ for paint.net (free) this will allow to measure elements on screen at a glance. (60 pixel is a good grid to begin with).</li>
<li>A theme you like and wish to edit and customize, put it on your desktop for easy access. Themes can be found on the <strong>DIG forums</strong> https://digdroid.com/forums/categories/themes, some on <strong>/r/retroid</strong> https://www.reddit.com/r/retroid and here in the <strong>wiki</strong>.</li>
<li>A <strong>DIG apk</strong> either extracted from your phone, RP2 or downloaded and copied to your PC.</li>
</ul>
<p>===== Things to know =====</p>
<hr />
<ul>
<li>Most DIG themes are formatted for 16:9 screens but the RP2 displays in 4:3. This will make those themes look cropped on the handheld.</li>
<li>There is a lack of documentation and tutorials on how to create themes for DIG. This translates into a lot of trial and error when editing the config and figuring out how items display on the screen. This guide is not ideal in the sense that I took the "what you see is what you get" approach since a lot of config variables are either missing from the configs I checked (like padding, spacing, size, etc.) and adding them manually not always worked nor gave the expected results.</li>
<li>Don't forget to credit the author/s of the theme your work is based on if you plan on sharing it!<hr /></li>
</ul>
<p>DIG theme consists of <strong>7 home screen menu shortcuts</strong>.</p>
<p>The images used as shortcuts are inside a Home Icons folder.</p>
<p>Home screen menu shortcuts will display in the following order:</p>
<ul>
<li>Systems (nes, snes, n64, psx, etc.)</li>
<li>Genres (2D, 3D, Action, Arcade, etc.)</li>
<li>Collections (games menu lets you create a collection)</li>
<li>Favorites (add your favorite games from games menu)</li>
<li>Recently Played</li>
<li>All Games (games sorted a-z, will fetch backgrounds from currently selected game)</li>
<li>Options (lets you customize themes, scan ROMS, fetch covers etc.)</li>
</ul>
<p>===== The Config =====</p>
<p>The Config.cfg file is edited using Notepad++. In Notepad++ select Edit, Line Operations, Sort Lines Lexiconographically Ascending for easier navigation.</p>
<p><span style="background-color: #ccffcc;">home_icons = "Home Icons" </span>would be the the config entry that tells the config where to look for home icons, namely inside the folder <span style="background-color: #ccffcc;">"Home Icons"</span> which is placed in the same root as <span style="background-color: #ccffcc;">"Background Default"</span> inside the <span style="background-color: #ccffcc;">"config.cfg"</span> file.</p>
<p><span style="background-color: #99cc00;"><span style="background-color: #ccffcc;">name = "Theme Retro" </span></span>is the name of the config and thus the theme as displayed after installation when selecting it in the dropdown menu in DIG.<span style="background-color: #99cc00;"><br /></span></p>
<p><span style="background-color: #ccffcc;">author = "Theme Author"</span><br /><span style="background-color: #ccffcc;">author_contact = "theme%40author.com"</span> personal information about the theme creator.</p>
<p><span style="background-color: #99cc00;"><span style="background-color: #ccffcc;">description = "theme theme" </span></span>Description of the theme can also contain credits to other themers or links to assets used in the creation of the theme.</p>
<p><span style="background-color: #ffcc99;">Always save the config file in the root folder of your theme</span> where you have your Background Default, Background Home, Home Icons, etc. folders.</p>
<p>===== Backgrounds =====</p>
<hr />
<p>Your DIG theme consists of one main background image and several <em>secondary (</em>just refering to them as secondary for the sake of explanation<em>)</em> background images that can be in gif, png, jpg, etc. format. PNG over JPG is prefered for transparency modifications.</p>
<p>Each home screen shortcut can have its own background image as well as the gameinfo menu which pops up just before launching a game making it <strong>8 <em>secondary</em> backgrounds</strong> you can modify. An example of Theme folder would be:</p>
<ul>
<li><em><strong>Background Default</strong></em></li>
<li><em><strong>Background Home</strong></em></li>
<li><em><strong>Background Systems</strong></em></li>
<li><em><strong>Background Collections</strong></em></li>
<li><em><strong>Background Genres</strong></em></li>
<li><em><strong>Background Favorites</strong></em></li>
<li><em><strong>Background Gameinfo</strong></em></li>
<li><em><strong>Background Options</strong></em></li>
<li>Home Icons</li>
<li><span style="background-color: #ccffcc;">config.cfg</span></li>
</ul>
<p>These secondary backgrounds will override the default background when properly linked to in the config. Hence the importance to name those png, gif, jpg images and their folders intuitively to avoid unnecessary confusion.</p>
<p>Examples:</p>
<p><span style="background-color: #ccffcc;">media_path = "Background Default/BackgroundDefault.png"</span></p>
<p>This is the config entry for the default background called <span style="background-color: #ccffcc;">"BackgroundDefault.png"</span> which will display if no other secondary background is appointed to a menu.</p>
<p><strong>Tips:</strong></p>
<blockquote>
<p>Its a good idea to keep this background very minimal by maybe adding recurring elements like navigation icons, sprites or short texts like "back", "ok" or "select" and then add details to other backgrounds. You can also clone this background to be the same for the other secondary backgrounds.</p>
<p>Consider this your master background, and as such keep an editable paint.net or Photoshop save with editable layers available to add or remove elements, add transparency or invert colors to create a dark mode.</p>
</blockquote>
<p><span style="background-color: #ccffcc;">systems_media_path = "Background Systems/BackgroundSystems.png"</span></p>
<p>This is the background which will now display instead of the default one in the menu "systems".</p>
<p>But there is more.</p>
<p><span style="background-color: #ccffcc;">systems_system_backgrounds = "Background Systems"</span></p>
<p>Is the path for a background image for each system <strong>system</strong> background you wish to personalize. Meaning you can have additional backgrounds for every system supported in DIG. gb stands hardcoded for GameBoy, snes for Super Nintendo, psx for Playstation and so forth.</p>
<p>This means an image called <span style="background-color: #ccffcc;">"psx.png"</span> inside Background Systems will be displayed if the user selects the Playstation system when browsing inside the Systems menu.</p>
<p><br /> ===== Foreground =====</p>
<hr />
<p>Allows you to add a foreground to your backgrounds usually in the way of a semi transparent .png image allowing for advanced effects like shadowing an area or blurring a background. Works very similar to background entries and Foreground images should also be saved in their own Foreground folder.</p>
<p>===== Toolbar =====</p>
<hr />
<p>Your DIG frontend supports at least five toolbar elements which are clickable when displayed inside DIG.</p>
<p><span style="background-color: #ccffcc;">tool_icons = "Toolbar"</span> tells the config to look for the the <span style="background-color: #ccffcc;">"tool_icons"</span> inside the <span style="background-color: #ccffcc;">"Toolbar"</span> folder thus replacing the default ones.</p>
<p><span style="background-color: #ccffcc;">genres_toolbar = "icons_top"</span> refers to where the toolbar icons are placed. <span style="background-color: #ccffcc;">"icons_bottom"</span> is afaik the only other option together with <span style="background-color: #ccffcc;">"default"</span> for the text based menu style toolbar and <span style="background-color: #ccffcc;">"none"</span> to disable it.</p>
<p>Since one could just use the homescreen shortcuts to navigate to options, toolbar icons are not a necessity and some themers leave them out for a cleaner look on most screens.</p>
<p><span style="background-color: #ccffcc;">icons_toolbar_scale = "15.5"</span> determines the size of the icons. A larger number means smaller icons here.</p>
<p><strong>Home</strong>, <strong>mediaplay</strong>, <strong>mediapause</strong>, <strong>pagemenu</strong>, <strong>options</strong>, <strong>systems</strong> are the<strong> 6 main toolbar icons</strong>.</p>
<p>Home, Options and Systems toolbar icons are the same as if clicked from the home screen but allow for faster navigation on touchscreens. Mediaplay and mediapause start or stop a themes audio track.</p>
<p>===== Audio =====</p>
<hr />
<p>You can put one or several audio files in the Audio folder and link them via the config entries:</p>
<p><span style="background-color: #ccffcc;">sound = "folder"</span><br /><span style="background-color: #ccffcc;">sound_path = "Audio"</span></p>
<p><span style="background-color: #ccffcc;">game_sound_path = "Audio"&nbsp;</span> Audio being your folder for sounds being played when inside the gameinfo screen.</p>
<p>or</p>
<p><span style="background-color: #ccffcc;">systems_sound = "folder"</span><br /><span style="background-color: #ccffcc;">systems_sound_path = "Audio"</span> Audio being your folder for sounds being played when inside the systems screen.</p>
<p>You could also link directly a "file" for a specific menu like for example:</p>
<p><span style="background-color: #ccffcc;">systems_sound = "file"</span></p>
<p><span style="background-color: #ccffcc;">systems_sound_path = "Audio/Systems_Menu_Sound.mp3</span></p>
<p>You can have multiple audio tracks similar to backgrounds for each menu entry but they will quickly increase your theme's size in megabytes.</p>
<p>===== Text =====</p>
<hr />
<p>You can edit text color but it has to be in 8 digit HEX format as far as I can tell.</p>
<p><span style="background-color: #ccffcc;">"ffffffff"</span> for white.</p>
<p><span style="background-color: #ccffcc;">"363636"</span> for grey will not work for example.</p>
<p>Again you can edit text color for each menu if needed. Usually there are multiple text edits available for each menu that refer to Header, description, etc.</p>
<p><span style="background-color: #ccffcc;">systems_text1 = "ffffffff"</span><br /><span style="background-color: #ccffcc;">systems_text2 = "ffffffff"</span></p>
<p>===== List type =====</p>
<hr />
<p>This will determine the way your icons are displayed. They can be displayed in a carousel, coverflow, list, linear, wheel, etc.</p>
<p>You can change this from inside DIG by clicking pagemenu icon in the toolbar or by assigning a shortcut on your gamepad via options menu then go on view options and select the list view you wish to have for the current screen.</p>
<p><span style="background-color: #ccffcc;">systems_list_type = "linear"</span></p>
<p>this determines what type of icon scrolling is used for the systems menu. Linear flow in this case. Your consoles and handhelds will flow horizontally and display in a linear motion and scroll sideways. Retro Switch theme uses the linear list type by default for all screens.</p>
<p><br /><span style="background-color: #ccffcc;">home_list_type = "grid"</span></p>
<p>determines the default flow for the home screen. In this case it puts your icons one next to each other in a grid pattern. Also adds a selection animation to the icons by enlarging them when selected. Can be seen in the Wii 640x480 theme. I think grid is only available for home screen.</p>
<p><br /><span style="background-color: #ccffcc;">home_linear_scale = "0.8"</span><br /><span style="background-color: #ccffcc;">home_linear_spacing = "1"</span></p>
<p>Scale and spacing is the size of your icons in proportion to other variables like</p>
<p><span style="background-color: #ccffcc;">systems_block_size = "140"</span></p>
<p>determines the size of your icons and images. A saved "psx.png" home icon of 100 square pixels becomes 140 square pixels by this formula without further variables.</p>
<p><span style="background-color: #ccffcc;">systems_aspect_ratio = "1.0"</span></p>
<p>determines the aspect ratio of the systems screen. This allows for interesting editing but is tricky to get it right. A lack of comprehensive padding, margin and centering rules due to lack of documentation is a big issue to succesfully edit a theme.</p>
<p><span style="background-color: #ccffcc;">"1.333334"</span> would be a default for the RP2 4:3 screen (4:3=1.333334) but not mandatory for themes that use sidescrolling flows (linear, coverflow, etc.).</p>
<p>&nbsp;</p>
<p>===== Getting started =====</p>
<hr />
<ol>
<li><strong>Have enough space </strong>on your PC desktop screen to place your theme, apk and programs you need to launch.<strong><br /></strong></li>
<li><strong>Unzip</strong> your downloaded theme <strong>inside</strong> a new folder on your desktop with the same name as the theme. <strong>Copy this folder</strong> and place it next to the original on your desktop. Always edit the copied folder only, the original helps to copy over lost images or icons or to double check or restore your config if you make a major error.</li>
<li>Grab the <strong>DIG.apk</strong> and place it on the desktop next to your copied theme folder.</li>
<li>Install and launch <strong>LDPlayer4</strong> and set display size to <span style="background-color: #ffcc99;">230 DPI and 640px width 480px</span> height in the settings like the RP2 has. This will make things you change in the config look in the same resolution as the RP2.</li>
<li>In <strong>LDPlayer4</strong>, open the small home screen folder and drag and drop the file manager on the emulators home screen.</li>
<li><strong>Install the DIG app</strong> apk by dragging and dropping it on the emulators homescreen. The DIG icon should pop up near the File Manager app.</li>
<li><strong>Run DIG</strong> then exit by closing top side tab.</li>
<li>Start <strong>Notepad++</strong>. Later when loading your config select Edit, Line Operations, Sort Lines Lexiconographically Ascending.</li>
<li>Install <strong>paint.net</strong> and install the <strong>GridCheckerboard</strong> plugin. Do this by unzipping the plugin and placing the .dll file in C:/programs/paint.net/Effects. Accessible through Effects, Render, Grid menu later on inside paint.net.</li>
<li>Have a<strong> basic "ROMS" folder ready</strong> that includes a couple unzipped gb, nes, snes, gba, n64 and psx games each in their own subfolder with the same name (gb, snes, n64, etc.) inside a main folder called <strong>"ROMS" </strong>to test out your theme and being able to access all menu screens like all games, gameinfo, favorites (after adding) collections (after adding) and so on.</li>
</ol>
<p>&nbsp;</p>
<p>===== Using LDPlayer4 to visualize DIG themes =====</p>
<hr />
<ol>
<li>Open <strong>LDPlayer4</strong>.</li>
<li>Open <strong>DIG</strong> and click on File Manager tab. Allow root access if prompted.</li>
<li>Click on the left on the <strong>3 horizontal lines</strong> (hamburger menu) then select internal shared storage.</li>
<li>Click on<strong> Pictures</strong>.</li>
<li>Drag and drop your "<strong>ROMS</strong>" folder here.&nbsp;</li>
<li>Drag and drop your "<strong>theme.zip</strong>" file here so that DIG can access and install it later on.</li>
<li><span style="text-decoration: underline;">To successfully test your modified themes you will need to delete both the "theme.zip" file located in <span style="background-color: #ffff99;">File Manager-&gt;Internal Shared Storage-&gt;Pictures</span> <span style="background-color: #ffcc99;"><strong>and</strong></span> the DIG app by dragging and dropping it to the bin icon on the homescreen <strong>after each test run</strong>, before installing the theme again.</span></li>
</ol>
<blockquote>
<p>This is to delete the DIG cache and config file it locally stores which would stop the updated version to be loaded correctly.</p>
</blockquote>
<ol>
<li>After you made and saved your edits to the theme config, <strong>create a zip archive</strong> by selecting every folder Background Default, Background Systems, Home Icons, Toolbar, etc. and the config file.</li>
<li><strong>DO not zip the theme folder holding the Background Default, Home Icons and config file</strong>, zip them by <strong>selecting them individually</strong>. DIG will not be able to install the theme otherwise. Make sure to delete the old archive first which should be in the same root directory below your config.cfg file.</li>
</ol>
<p>===== Techniques and tips =====</p>
<hr />
<ol>
<li>Do Print Screens (prt sc button on your keyboard) of your desktop with the 640x480 window of your unresized DIG screen in the emulator. This 1920x1080 or 2560x1440 image (depending on your screen) can be cropped in paint.net to 640x480 letting you measure pixel perfectly where to place elements on your backgrounds or how large icons have to be.</li>
<li>You can save the default theme background as a blank 640x480 image and add a 60px grid to it with the paint.net gridchecker board plugin or similar tool in Photoshop. This allows to have an idea where images will display in DIG allowing for adjustments in the config and resizing or cropping of the image in paint.net.</li>
<li>Use layers to stack elements on your backgrounds. Layers need to be merged to be png saveable but you can undo the steps after saving and redo with other elements like Background text.</li>
<li>You can add opacity to an image in the layer options. Make sure to save first otherwise the opacity will translate to other elements in your Layer list and merging down will apply the opacity for each layer.</li>
<li>When uninstalling the DIG app from LDPlayer4 you will need to drag and drop the apk to the homescreen to reinstall it. Its handy to have it close to your theme's zip folder as you will need it around the same time when reopening LDPlayer4 and DIG.</li>
<li>Be careful when resizing icons or images as the resizing is often of lesser quality than say the original smaller version of the same image.</li>
<li>Try to minimize your time needed to open and load a theme into DIG from the emulator by doing a lot of edits, even more general ones to the config first like:</li>
</ol>
<ul style="list-style-type: disc;">
<li>editing all text colors to either black (0) or white (ffffffff) depending on your background</li>
<li>checking all background folders are properly setup</li>
<li>checking your background images are of the correct size across all the background folders</li>
<li>keeping things coherent with spacing and scale like <span style="background-color: #ccffcc;">collections_block_size = "140.0"</span> or <span style="background-color: #99cc00;"><span style="background-color: #ccffcc;">home_block_size = "140.0"</span><br /></span></li>
<li>Leave config entries you are not sure about their function as they are or put them to<span style="background-color: #ccffcc;"> "1"</span> or <span style="background-color: #ccffcc;">"0" </span></li>
<li>You can specify wether DIG reads a file or a folder from a directory like&nbsp; <span style="background-color: #99cc00;"><span style="background-color: #ccffcc;">game_sound =</span> <span style="background-color: #ccffcc;">"folder" ; game_sound_path = "Audio" </span></span>will look up any audio file inside the Audio folder to play when entering the game menu in DIG.</li>
</ul>
<p>&nbsp;</p>
<p>===== Example of a theme folder =====</p>
<hr />
<table style="height: 717px; width: 711px;" border="1">
<tr>
<td style="width: 164.583px;">Audio</td>
<td style="width: 528.417px;">theme_music.mp3</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Default</td>
<td style="width: 528.417px;">BackgroundDefault.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Home</td>
<td style="width: 528.417px;">BackgroundHome.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Systems</td>
<td style="width: 528.417px;">BackgroundSystems.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Collections</td>
<td style="width: 528.417px;">BackgroundCollections.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Genres</td>
<td style="width: 528.417px;">BackgroundGenres.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Gameinfo</td>
<td style="width: 528.417px;">BackgroundGameinfo.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Favorites</td>
<td style="width: 528.417px;">BackgroundFavorites.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Background Options</td>
<td style="width: 528.417px;">BackgroundOptions.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Default Covers</td>
<td style="width: 528.417px;">gb.png gba.png gbc.png psx.png (these cover icons replace the default ones displayed for games that DIG did not find cover art for)</td>
</tr>
<tr>
<td style="width: 164.583px;">Home Icons</td>
<td style="width: 528.417px;">allgames.png collections.png options.png favorites.png genres.png systems.png played.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Systems Icons</td>
<td style="width: 528.417px;">gb.png gba.png gbc.png psx.png</td>
</tr>
<tr>
<td style="width: 164.583px;">Toolbar</td>
<td style="width: 528.417px;">home.png mediaplay.png mediapause.png systems.png options.png pagemenu.png</td>
</tr>
<tr>
<td style="width: 164.583px;">config.cfg</td>
<td style="width: 528.417px;">
<p><span style="background-color: #ccffcc;">sound = "folder"</span></p>
<p><span style="background-color: #ccffcc;">sound_path = "Audio"</span></p>
<p><span style="background-color: #ccffcc;">systems_sound_path = "Audio"</span></p>
<p><span style="background-color: #ccffcc;">game_sound_path = "Audio"</span></p>
<p><span style="background-color: #ccffcc;">favorites_media = "file"</span></p>
<p><span style="background-color: #ccffcc;">favorites_media_path = "Background Favorites/BackgroundFavorites.png"</span></p>
<p><span style="background-color: #ccffcc;">genres_media = "file"</span></p>
<p><span style="background-color: #ccffcc;">genres_media_path = "Background Genres/BackgroundGenres.png"</span></p>
<p><span style="background-color: #ccffcc;">home_media = "file"</span></p>
<p><span style="background-color: #ccffcc;">home_media_path = "Background Home/BackgroundHome.png"</span></p>
<p><span style="background-color: #ccffcc;">options_media = "file"</span></p>
<p><span style="background-color: #ccffcc;">options_media_path = "Background Options/BackgroundOptions.png"</span></p>
<p><em><strong>...</strong></em></p>
<p><em><strong>(</strong></em><em><strong>etc. for the backgrounds)</strong></em></p>
<p><em><strong>...</strong></em></p>
<p><span style="background-color: #ccffcc;">default_covers = "Default Covers"</span></p>
<p><span style="background-color: #ccffcc;">home_icons = "Home Icons"</span></p>
<p><span style="background-color: #ccffcc;">systems_icons = "Systems Icons"</span></p>
<p><span style="background-color: #ccffcc;">tool_icons = "Toolbar"</span></p>
</td>
</tr>
</table>
<p>&nbsp;</p>
<p><strong>This is to give an idea of how the config entries works but of course more entries are needed to make the theme work. The other files inside the folders on the other hand are "complete" and make out the totality of a basic DIG theme.</strong></p>
<hr />
<p>Guide created by CricoidRiver. Edited by CricoidRiver.</p>