explaingit

gibbonheart/gamelist-visual-editor

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A tool that fixes box art covering game titles on Miyoo handheld consoles by resizing artwork, adjusting opacity, or shrinking the font.

Mindmap

mindmap
  root((repo))
    What it does
      Live preview of art fixes
      Batch processes Roms folder
      Edits font size safely
    Tech stack
      Python
      Tkinter GUI
      PyInstaller build
    Use cases
      Fix overlapping box art
      Adjust theme fonts
      Support four Miyoo devices
    Audience
      Miyoo handheld owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Stop box art from overlapping game titles on a Miyoo Mini, Mini Plus, Flip, or Mini Flip handheld.

USE CASE 2

Batch process an entire Roms folder of game cover images in one run.

USE CASE 3

Preview artwork and font size changes live before applying them to real files.

USE CASE 4

Shrink the game list font size in a theme's config.json with an automatic backup.

What is it built with?

PythonTkinterPyInstaller

How does it compare?

gibbonheart/gamelist-visual-editor0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity2/54/51/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Windows .exe needs no Python, running from source needs Python installed with the bundled Tkinter GUI library.

Public domain: anyone can use, modify, or distribute this software for any purpose with no restrictions.

In plain English

GameList Visual Editor fixes an annoying cosmetic problem on Miyoo handheld gaming devices, which run a custom interface called Onion OS. When you install a themed box art pack, such as the popular Done Set 3, the game cover art image is a fixed size and can end up overlapping or hiding the game's title text on the screen. There is no built in setting inside Onion OS to fix this, since the interface that renders it is closed source, so this tool works around the problem from the outside by editing the artwork and font size instead. The tool gives a live preview that updates instantly as you shrink the artwork, adjust its transparency, or resize the game list font, using measurements taken directly from Onion's own theme files rather than guesswork. It supports the different screen sizes used across the Mini, Mini Plus, Flip, and Mini Flip handheld models through a device selector. You can preview against a sample image or one of your own real game covers. Once you are happy with the settings, it can batch process your entire game library at once: point it at your Roms folder and it automatically works through every game system's images inside it. It can also edit your theme's config.json file to change the game list font size, automatically making a backup first so you can restore it if needed. The README is careful to warn that processing images directly into your existing Roms folder, rather than a separate output folder, does not automatically back up those images, so anyone unsure of their settings should test on a separate folder first. You can either download a ready-made Windows executable from the Releases page, or run the Python script yourself if you would rather see and trust the exact code being run. Running from source only needs Python installed, since the graphical interface library it relies on already comes bundled with Python. The project is released into the public domain under the Unlicense, meaning anyone can use it for any purpose without restriction.

Copy-paste prompts

Prompt 1
Walk me through downloading and running GameList Visual Editor on Windows.
Prompt 2
Show me how to run this from Python source instead of the .exe release.
Prompt 3
Explain the difference between processing my Roms folder in place versus using a separate output folder.
Prompt 4
Help me build the .exe myself using build_exe.bat.

Frequently asked questions

What is gamelist-visual-editor?

A tool that fixes box art covering game titles on Miyoo handheld consoles by resizing artwork, adjusting opacity, or shrinking the font.

What language is gamelist-visual-editor written in?

Mainly Python. The stack also includes Python, Tkinter, PyInstaller.

What license does gamelist-visual-editor use?

Public domain: anyone can use, modify, or distribute this software for any purpose with no restrictions.

How hard is gamelist-visual-editor to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is gamelist-visual-editor for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.