MinUI Menu for ES-DE

This is a tranlation of the MinUI menu interface (originally designed & created by Shaun Inman) for ES-DE.

My work focused on tranlating the layout so that it could be buildable in the theme engine for ES-DE. Please refer to the Changes Made section below for additional details.

The original version of the UI can be found as part of the awesome MinUI custom firmware here.

Changes Made

Used MinUI screenshots to approximate the components that would be used build a theme compatible with ES-DE.
Changed the helpsystem to ES-DE's native component and created a layout that tries to evoke the original helpsystem design (sadly it can't be a 1:1 translation due to differences in the theme engines)
Added icons and badges specific to ES-DE functionality
Added a framework for adding additional color schemes and added Light and Dark options to start
Added Bold and Non-Bold font options

Preview

Configuration Options

The theme has a simple set of options that can be changed directly from the UI Settings menu of ES-DE

Variants:

Theme Variant - sets the color scheme that is used for the overall theme on all views.
- List - The default color variant. A simple list in the style of MinUI
- List + Boxart - Adds the display of boxart to the list
- List + Cover - Adds the display of screenshots to the list

List	List + Boxart	List + Screenshot

Color Schemes:

Theme Color Scheme - sets the color scheme that is used for the overall theme on all views.
- Dark - The default color scheme.
- Light - A light version of the above color scheme.

Dark	Light

You can also create your own custom color scheme by following the instructions under "Creating your own color scheme"

Font Sizes:

Theme Font Size - sets the size that text will render at. This can be helpful when using the theme on small screens.
- Supported Font Sizes:
- Medium - Default size, good for small handheld screens under 6 inches in size.
- Large - Good for small handheld screens under 4 inches in size.
- Small - Smaller size, good for larger screens.
- Extra Large - Good for small handheld screens under 4 inches in size.
- Extra Small - Smaller size, good for larger screens.

Aspect Ratios:

Theme Aspect Ratio - sets the aspect ratio to match your display. This should happen automatically but can also be set manually if needed.
- Supported Aspect Ratios:
- 4:3
- 16:9
- 16:10
- 3:2
- 19.5:9
- 1:1

Additional Notes

Creating your own color scheme:

In the resources folder you will find a template file called colors-custom.xml
Make a folder named theme-customizations and place a copy of the colors-custom.xml file inside that folder. The folder structure should look like this when you are done:
```
/ES-DE/themes/minui-menu-es-de/theme-customizations/colors-custom.xml
```
Note: This structure should allow you to continue to get updates for the theme from the theme downloader while also retaining your customizations.
Edit the properites in colors-custom.xml to create your custom color scheme:
- Here is a definition of each property:
  - backgroundPath-{aspect ratio} - Sets the path to an image to use for the background.
    - If you want the background to be a solid color then you can populate this property with a value of ${spacerImage} and then set the value for backgroundColor to the color you prefer.
    - If you want to set this to a fullscreen image then add your image into the theme-customizations folder and set the value for this property to the path to your image. For example; if your image was named background.png then the value you would set for this would be ./theme-customizations/background.png.
    - You can choose to define a specific background image for each aspect ratio by defining a specific path for each. You can also use the same image for all aspect ratios by defining this value the same for each.
  - backgroundCropPos-{aspect ratio} - Define how the background image should be positioned.
  - backgroundTile - Sets if the background image should be repeated (aka tiled) or not. Allowed values are true or false
  - backgroundColor - Sets the color to be used for the background on all screens. If you are using a fullscreen image its best to set this to ffffff so that the original image's colors will display.
  - textlistFont - The font that will be used for the system and game list.
    - If you want to use ES-DE's default font then you can set this value to default
    - If you want to use the MinUI font then you can set this value to ./_inc/fonts/BPreplayBold.otf
    - If you want to use your own font then add your font file into the theme-customizations folder and set the value for this property to the path to your font. For example; if your font was named font.ttf then the value you would set for this would be ./theme-customizations/font.ttf.
  - textlistSelectedColor - Sets the text color for the selected item in the list
  - textlistSelectedBackgroundColor - Sets the highlight color for the selected item in the list
  - textlistSelectedBackgroundCornerRadius - Sets how round the corners of the selector should be. 0 will remove the rounded edges, 0.05 will make a pill shaped selector. You can try different values inbetween for different effects.
  - textlistUnselectedColor - Sets the text color for unselected items in the list
  - helpsystemFont - The font that will be used to display text in the included help system.
    - If you want to use ES-DE's default font then you can set this value to default
    - If you want to use the MinUI font then you can set this value to ./_inc/fonts/BPreplayBold.otf
    - If you want to use your own font then add your font file into the theme-customizations folder and set the value for this property to the path to your font. For example; if your font was named font.ttf then the value you would set for this would be ./theme-customizations/font.ttf.
  - gameArtColor - Applies a color shift to the game art. For example, an all-white image with FF0000 applied would become completely red. You can also control the transparency of the image by setting the value to for example FFFFFFAA. This keeps all pixels at their normal color and only affects the alpha channel. This property is applied after saturation so by setting that property to 0 it's possible to colorize rather than color shift.
  - gameArtSaturation - Controls the level of color saturation for the game art. Minimum value is 0 (grayscale) and maximum value is 1 (original file saturation).
  - gameArtBrightness - Controls the relative level of brightness for the game art. This is intended primarily for fine adjustments, for example if a color shift has been applied which may have lowered the overall brightness of the image.
  - gameArtCornerRadius - Sets how round the corners of the game art should be. 0 will remove the rounded edges.
  - helpsystemLetterCase - Sets the lettercase that is used for text in the included help system. Allowed values are lowercase, uppercase or capitalize
  - helpsystemIconColor - Sets the icon color for items in the included help system
  - helpsystemTextColor - Sets the text color for items in the included help system
  - badgeIconColor - Sets the icon color for badges (Favorite, Completed, Collections, etc.) displayed on the gamelist view.
Set the Theme Color Scheme in ES-DE's UI Settings menu to Custom and you should see your custom color scheme display. If you see an error check that the paths discussed above are correct and then check that the values you added for each property are correct and well formatted.

Examples:

Changing the values for each property should allow you to create any number of color schemes. Here are a few examples that have been made using the same properties:

"Pocket Micro"	"Pocket DMG"

"Fallout"	"Cyberpunk"

If you make a custom color scheme and are comfortable with sharing I would love to check it out 😊

Please feel free to create an issue in this repo called Custom Color Scheme: [Name of your Color Scheme]
Include the values you used for the properties above (xml is preferred), the background image and fonts you added (if any) and a screenshot of what it looks like.

Credits:

The original MinUI was created & designed by Shaun Inman
The included font is called "BPreplay" and was created by George Triantafyllakos
The icons used to create the badges were sourced from FontAwesome
User Created Color Schemes:
- Fallout - Created and provided by RobZombie9043

anthonycaccese / minui-menu-es-de