Customizing

LED Controls🔗

Device support

NextUI's LED Controls currently only support the TrimUI Brick.

Support for the TrimUI Smart Pro will be addressed in a future update.

A comment on color reproduction

The TrimUI Brick is a budget device with budget LEDs. Don't expect the colors to display accurately.

LED Control App🔗

On home screen, select Tools, then select LedControl.

The app provides the following options.

LED Selection🔗

The TrimUI Brick has the following configurable LEDs.

Two LEDs on the front of the device for each function button (F1 & F2)
Two LEDs under the triggers (one under L1 & L2 the other under R1 & R2)
One LED bar on the top of the device

When in the LED Control App you can use Left Trigger and Right Trigger to cycle between these LEDs.

Effects🔗

Each LED can be configured with the following effects.

Effect Name	Description
Static	Keep the LED(s) on and static
Blink 1	Quickly blink 1 time
Blink 2	Quickly blinks 2 times
Linear	Slowly increase the brightness and then fall back to off
Breathe	Slowly increase the brightness and slowly decrease the brightness
Interval Breathe	Slowly increase the brightness and slowly decrease the brightness, with a longer pause between "breaths"

Color🔗

The color of LEDs. Use Left and Right on the D-Pad to cycle through the colors.

Speed🔗

The speed of breathing effect in milliseconds.

Brightness🔗

The brightness level of the LEDs. Setting this to 0 will turn the LED off.

Info Brightness🔗

The brightness of LED when informing you about something.

Currently, this is only supported by:

Power Button turning red alerting for low battery
Front Function Button LED blinking when entering sleep

Setting brightness to 0 will turn the LED off.

Ambient Mode🔗

Only supported By certain emulator cores

Ambient light effects are only supported by the built in Libretro cores.

Ambient light mode makes your LEDs change color to match the dominant color on screen during gameplay.

To enable ambient mode (in a supported emulator) follow these steps:

While in game, press the Menu button
Select Options
Select Frontend
Scroll down to the Ambient Mode line and turn it on. You can select to use all LEDs or just a specific one.

Ambient mode sets the LED Brightness to Maximum

We found that lower brightness levels will result in displaying an incorrect color.

Emulator Overlays🔗

Overlays are only supported by libretro emulators

Standalone emulators installed via Paks do not support NextUI overlays.

NextUI looks for accompanying media for each emulator under the /Overlays/[System] folder. The System corresponds to the name of the Emu Pak specified in your Emulator folder name within parenthesis. In this folder you can add 5 overlay PNG files, named overlay1.png to overlay5.png.

For example:

# For /Roms/Game Boy Advance (GBA)
/Overlays/GBA/overlay1.png
/Overlays/GBA/overlay2.png
/Overlays/GBA/overlay3.png
/Overlays/GBA/overlay4.png
/Overlays/GBA/overlay5.png

# For /Roms/Super Nintendo Entertainment System (SFC)
/Overlays/SFC/overlay1.png
/Overlays/SFC/overlay2.png
/Overlays/SFC/overlay3.png
/Overlays/SFC/overlay4.png
/Overlays/SFC/overlay5.png

When in game, hit the Menu button and navigate to Options -> Frontend. This will display an overlay setting to choose between overlay 1 to 5 or none.

Adding Emulator Icons🔗

Create a .media directory under the corresponding folder to create icons for Emulators, Collections and Tools.

Emulator Icon Directory Structure🔗

Example System Used: Game Boy Advance (MGBA)
Example Rom Used:    My Awesome Game.gba
Example Pak Used:    Artwork Scraper.pak


SD_CARD
├─ bg.png                                      *Default Menu Background
├─ .media/
│  ├─ Collections.png                          *Collections List Icon in Main Menu
│  ├─ Recently Played.png                      *Recently Played List Icon In Main Menu
├─ Collections/
│  ├─ .media/
│  │  ├─ bg.png                                *Collections List Background
│  │  ├─ Collection 1.png                      *Collection Icon In Collections List
│  │  ├─ Collection 2.png                      *Collection Icon In Collections List
├─ Overlays/
│  ├─ MGBA/
│  │  ├─ overlay1.png                          *MGBA System Overlay #1
│  │  ├─ overlay2.png                          *MGBA System Overlay #2
│  │  ├─ overlay3.png                          *MGBA System Overlay #3
│  │  ├─ overlay4.png                          *MGBA System Overlay #4
│  │  ├─ overlay5.png                          *MGBA System Overlay #5
├─ Recently Played/
│  ├─ .media/
│  │  ├─ bg.png                                *Recently Played List Menu Background
├─ Roms/
│  ├─ .media/
│  │  ├─ Game Boy Advance (MGBA).png          *Main Menu Console Icon
│  ├─ Game Boy Advance (MGBA)/
│  │  ├─ .media/
│  │  │  ├─ bg.png                             *MGBA Rom List Background
│  │  │  ├─ My Awesome Game.png                *Box Art / In-game Preview
│  │  ├─ My Awesome Game.gba                   *Rom Location
├─ Screenshots/
│  ├─ screenshot.png                           *Screenshot Monitor Pak PNG Output Location
├─ Tools/
│  ├─ .media/
│  │  ├─ tg5040.png                            *Tools list Icon in Main Menu
│  ├─ tg5040/
│  │  ├─ .media/
│  │  │  ├─ bg.png                             *Tools List Main Menu Background
│  │  │  ├─ Artwork Scraper.png                *Individual Tool Icon in Tools List

Game Artwork🔗

NextUI looks for accompanying media for each emulator under /Roms/[Emulator]/.media.

To add artwork:

Create the .media folder if it does not exist.
In the .media folder, add an image in PNG format with the exact same name as the ROM file (NextUI will automatically scale the artwork).

Here's an example:

# With an SFC game located at:
# /Roms/SFC/My Awesome Game.smc
# the box art or in-game preview is located at:

/Roms/SFC/.media/My Awesome Game.png

The Artwork Scraper pak can also be used to automatically download artwork for your device.

Custom Categories🔗

If folders have the same name prior to the brackets for the emulator, they will be merged. So make one for each emulator, then create subfolders for the systems that use that emulator (note in the second pic you can still use numbers to order the consoles.

Emulator Directory Structure🔗

Example Systems Used: Game Boy (GB), Game Boy Advance (MGBA), NES (FC), Sega Genesis (MD)
Example Rom Used:    My Awesome Game.ext
Example Pak Used:    Artwork Scraper.pak


SD_CARD
├─ bg.png                                      *Default Menu Background
├─ .media/
│  ├─ Collections.png                          *Collections List Icon in Main Menu
│  ├─ Recently Played.png                      *Recently Played List Icon In Main Menu
├─ Collections/
│  ├─ .media/
│  │  ├─ bg.png                                *Collections List Background
│  │  ├─ Collection 1.png                      *Collection Icon In Collections List
│  │  ├─ Collection 2.png                      *Collection Icon In Collections List
├─ Overlays/
│  ├─ MGBA/
│  │  ├─ overlay1.png                          *MGBA System Overlay #1
│  │  ├─ overlay2.png                          *MGBA System Overlay #2
│  │  ├─ overlay3.png                          *MGBA System Overlay #3
│  │  ├─ overlay4.png                          *MGBA System Overlay #4
│  │  ├─ overlay5.png                          *MGBA System Overlay #5
├─ Recently Played/
│  ├─ .media/
│  │  ├─ bg.png                                *Recently Played List Menu Background
├─ Roms/
│  ├─ .media/
│  │  ├─ 01)Handheld (GB).png               *Main Menu Handheld Icon (match first folder in group)
│  │  ├─ 02)Console (FC).png            *Main Menu Console Icon (match first folder in group)
│  │  ├─ 03)Arcade (FBN).png            *Main Menu Console Icon
│  │
│  ├─ 01)Handheld (GB)/             *Uses (GB) to store systems using the GB emulator
│  │  ├─ .media/
│  │  │  ├─ 01)Game Boy.png         *GB system icon
│  │  │  ├─ bg.png              *Background used when highlighting Handheld in the main menu (only required for first folder in group)
│  │  │
│  │  ├─ 01)Game Boy                    *The number here sorts the systems in the Handheld screen
│  │  │  ├─ .media/
│  │  │  │  ├─ bg.png               *Background for GB that will be shown in the Handheld menu
│  │  │  │  ├─ My Awesome Game.png          *Rom boxart
│  │  │  ├─ My Awesome Game.gb          *Rom file
│  │
│  ├─ 01)Handheld (MGBA)/           *Uses (MGBA) to store systems using the MGBA emulator
│  │  ├─ .media/
│  │  │  ├─ 02)Game Boy Advance.png     *GBA system icon
│  │  │
│  │  ├─ 02)Game Boy Advance                    *The number here sorts the systems in the Handheld screen
│  │  │  ├─ .media/
│  │  │  │  ├─ bg.png               *Background for GBA that will be shown in the Handheld menu
│  │  │  │  ├─ My Awesome Game.png          *Rom boxart
│  │  │  ├─ My Awesome Game.gba         *Rom file
│  │
│  ├─ 02)Console (FC)/
│  │  ├─ .media/
│  │  │  ├─ 01)NES.png              *NES system icon
│  │  │
│  │  ├─ 01)NES                         *The number here sorts the systems in the Console screen
│  │  │  ├─ .media/
│  │  │  │  ├─ bg.png               *Background for NES shown in console menu
│  │  │  │  ├─ My Awesome Game.png          *Rom boxart
│  │  │  ├─ My Awesome Game.nes         *Rom file
│  │
│  ├─ 02)Console (MD)/
│  │  ├─ .media/
│  │  │  ├─ 01)Sega Genesis.png         *Sega Genesis system icon shown in Console menu
│  │  │  ├─ 01)Sega Master System.png       *Sega Master system icon shown in Console menu
│  │  │
│  │  ├─ 02)Sega Genesis                    *The number here sorts the systems in the Console screen
│  │  │  ├─ .media/
│  │  │  │  ├─ bg.png               *Background for Sega Genesis shown in Console menu
│  │  │  │  ├─ My Awesome Game.png          *Rom boxart
│  │  │  ├─ My Awesome Game.md          *Rom file
│  │  │
│  │  ├─ 03)Sega Master System                  *The number here sorts the systems in the Console screen
│  │  │  ├─ .media/
│  │  │  │  ├─ bg.png               *Background for Sega Master System shown in Console menu
│  │  │  │  ├─ My Awesome Game.png          *Rom boxart
│  │  │  ├─ My Awesome Game.sms         *Rom file
│  │
│  ├─ 03)Arcade(FBN)/
│  │  ├─ .media/
│  │  │  ├─ bg.png              *Background for FBN that will be shown in the Main menu
│  │  │  ├─ My Awesome Game.png             *Rom boxart
│  │  ├─ My Awesome Game.zip

Notes for Merged Folders🔗

Folders with the same name (with the exception of the brackets) will be merged. To use this functionality, create folders with matching names (ex. Handheld, Console, Nintendo, Sega, etc.) and in brackets, every emulator you will need for the systems you want sorted into here.

Think of the folders in 3 tiers SD/Roms/CategoryName(emulator)/Gamesystem/Games

In tier 2, Create folders for each system that uses the emulator listed in its parent folder ex. for Console (MD), MD can emulate Sega Genesis, Sega 32x, Sega CD & Sega Master System, so all those system folders should be placed in Console (MD)

In tier 3, place all game files. Additionally at this point subfolders can be easily made for subcategories like rom hacks, translations, etc.

Icons and background for the merged folders only need to be made for the first folder alphabetically. In the example directory structure above, the icon for Game Boy was titled 01)Handheld (GB).png and the background was placed in Roms/01)Handheld (GB)/.media/bg.png

├─ Screenshots/
│  ├─ screenshot.png                           *Screenshot Monitor Pak PNG Output Location
├─ Tools/
│  ├─ .media/
│  │  ├─ tg5040.png                            *Tools List Icon in Main Menu
│  ├─ tg5040/
│  │  ├─ .media/
│  │  │  ├─ bg.png                             *Tools List Main Menu Background
│  │  │  ├─ Artwork Scraper.png                *Individual Tool Icon in Tools List