A ROM download client for NextUI

Supports RomM and Megathread

Art Downloads powered by the Libretro Thumbnail Project

Download this in Pak Store!

---

mortar_preview.mp4

---

How do I setup Mortar?

1. Own a TrimUI Brick or Smart Pro and have a SD Card with NextUI.
2. Connect your device to a Wi-Fi network.
3. Download the latest Mortar release from this repo or install it using Pak Store.
   • If downloading manually, unzip the release before continuing.
4. Edit one of the templates found here.
5. Save the edited template as config.yml.
   • Pak Store Users: upload config.yml to SD_ROOT/Tools/tg5040/Mortar.pak.
   • Manual Installers: upload the Mortar.pak directory that came in the releases zip and place config.yml inside.
6. Launch Mortar from the Tools menu and enjoy!

Configuration Reference

hosts:
  - display_name: "Display Name"
    host_type: ROMM # Valid Choices: ROMM | MEGATHREAD
    root_uri: "https://domain.tld" # This can be the start of a URL with protocol (e.g. https://), a host name or an IP Address

    port: 445 # Optional otherwise unless using non-standard ports

    username: "GUEST" # Used by RomM
    password: "hunter2" # Used by RomM

    platforms: # One or more mappings of the host directory to the local filesystem
      - platform_name: "Game Boy" # Name it whatever you want
        system_tag: "GB" # Must match the tag in the `SDCARD_ROOT/Roms` directories
        local_directory: "/mnt/SDCARD/Roms/Game Boy (GB)/" # Explicitly set the path. This will be overwritten if `system_tag` is set
        host_subdirectory: "/files/No-Intro/Nintendo%20-%20Game%20Boy/" # The subdirectory on the host, not used by RomM
        romm_platform_id: "1" # Used by RomM in place of `host_subdirectory`

        # Define more sections if desired

    filters:
      inclusive_filters: # Inclusive filters are applied first. If the ROM filename contains any of these, it will be included
        - "USA"
        - "En,"
      exclusive_filters: # Exclusive filters are applied second. If the ROM filename contains any of these, it will be excluded
        - "(Proto"
        - "(Demo)"
        - "(Beta)"
        - "(Aftermarket"
        - "4-in-1"
        - "4 in 1"
        - "(Europe)"
        - "(Japan)"

  # Define more hosts if desired

download_art: true # If true, Mortar will attempt to find box art. If found, it will display it and let you indicate if you want it
art_download_type: "BOX_ART" # Optional, defaults to BOX_ART. Does not impact art downloads from RoMM. Valid Choices: BOX_ART | TITLE_SCREEN | LOGOS | SCREENSHOTS
log_level: "ERROR" # Optional, defaults to error. Handy when shit breaks

Sample configuration files can be found here.

---

Enjoying Mortar?

You might be interested in my other NextUI Paks!

Pak Store - install, update and manage the amazing work from the community right on device

Game Manager - manage your ROM library right on device

---

Be a friend, tell a friend something nice; it might change their life!

I've spent a good chunk of time building Mortar.

If you feel inclined to pay it forward, go do something nice for someone! ❤️

✌🏻