simui's Introduction

About SimUI

SimUI is a theme for SimpleMenu inspired by Shaun Inman's MinUI (a custom launcher for the Trimui Model S, aka PowKiddy A66).

Having enjoyed MinUI's intuitive and minimalistic design and SimpleMenu's ease of customization, I decided to get acquainted with SimpleMenu's theming engine by recreating MinUI as closely as possible hoping the end product won't be an insult to Shaun's excellent creation 🙂

The goal was to transfer ideas that make MinUI, well, "min" to a more robust platform without sacrificing it's more advanced features. One example of sacrifices that had to be made is the removal of thumbnails from the game list (note: you can still see them in the fullscreen mode), though they can be turned back on, but their use is highly discouraged as they don't fit the aesthetic very much, especially on smaller screens.

One other notable example: while SimpleMenu supports multiple controls / key combinations (please read this wiki page to learn more or visit Settings > Help in the app) I simply did not find a good place to put hints for all of them so I chose only the essential ones fot the bottom bar.

Compatibility

The latest release of SimUI is optimised for and has been tested on SimpleMenu version 10.3.1 and should work with all devices that are currently supported by SimpleMenu (original Bittboy, PocketGo and it's clones, devices running RetroFW and OpenDingux). There are two separate versions of the theme directed at different screen resolutions: 320x240 and 640x480. Please use the one corresponding to your device's resolution and put it in the appropriate folder within SimpleMenu. If you encounter any problems on your device, please let me know.

Installation

Download the latest release appropriate for your device's screen resolution
Extract it to /.simplemenu/themes/320x240/ or /.simplemenu/themes/640x480/ (whichever applies)
Choose the theme in SimpleMenu settings

Thumbnails

Although I would encourage you to keep thumbnails on the game list turned off as it fits the theme's aesthetic much better, they are still supported and can be turned back on. All you have to do is open theme.ini and change show_art = 0 to show_art = 1. This setting is independent from the fullscreen mode which is always available.

Design source files

You can find design source files in this location and edit them in Gravit Designer if you ever so desire.

SimpleMenu button configuration

Right now, in order for SimpleMenu to work properly on Bittboy PocketGo, PowKiddy V90/Q90/Q20 Mini, you have to change the button configuration in /.simplemenu/config.ini to this:

[CONTROLS]
A = 308
B = 306
X = 304
Y = 32
L1 = 9
R1 = 8
UP = 273
DOWN = 274
LEFT = 276
RIGHT = 275
START = 13
SELECT = 27
R = 305

Otherwise some keys won't be mapped correctly.

simui's People

Contributors

Stargazers

Watchers

simui's Issues

Original BittBoy

I couldn't get it to work on my BittBoy 3.5. It's not PocketGo, it's the original BittBoy. I downloaded the files and extracted them into the gmenu2x/skins folder (I didn't find a folder with the name you put in the instructions, so I tried the folder that seemed most obvious to me). I went to the console configuration menu and chose the option, but nothing happens, it assumes the default theme. Sure it works on the original BittBoy? I'm using the newest Triforce X firmware, CFW 1.3.3.

CPS1 and CPS2 resources missing

Request for enhancement:

As RetroArch support cores for CPS1 and CPS2 I would like to use them in SimpleMenu in combination with SimUI.

Currently there are no sections in theme.ini and no related resources/logo.png for CPS1 and CPS2.
Thx in advance!

dkodr / simui Goto Github PK