Skip to content

Reporting Bugs

Jump to bottom
laqieer edited this page Jul 6, 2026 · 3 revisions

Reporting Bugs

The fastest, most reliable way to report a bug is straight from the app — it gathers your version/ROM info and a screenshot for you, then opens a pre-filled GitHub issue form.

Patch Manager shows an error / an empty patch list? That's usually the fresh‑install state, not a bug — the patch database (config/patch2/) is fetched on first use. See Patch Database (patch2) Setup & Updates before reporting.

The fastest way: the in-app Report a Bug tool

  • Avalonia GUI (Windows / Linux / macOS): open Help → Report a Bug…
  • WinForms GUI (Windows): open File → Problem Report Tool, then click Report a Bug on GitHub

The tool then:

  1. gathers your app version, ROM version (FE6 / FE7J / FE7U / FE8J / FE8U), the editor/screen you're on, and your platform;
  2. captures a screenshot of the current window — Avalonia saves it to your temp folder and reveals it in your file browser; WinForms copies it to the clipboard;
  3. opens a pre-filled GitHub issue form in your browser.

Then just attach the screenshot (drag-and-drop in Avalonia, or Ctrl+V in WinForms), describe what went wrong, and submit.

Manual: the issue form

No app handy, or a crash before the GUI loads? Go to Issues → New issue → "GUI bug (Avalonia / WinForms)":

https://github.com/laqieer/FEBuilderGBA/issues/new/choose

…and fill it in. There's also a lighter "Bug (CLI / Core / other)" form for non-GUI issues.

Please

  • One bug per issue — don't bundle many bugs into one Google Doc or thread; separate, focused issues get fixed far faster.
  • Attach the screenshot to GitHub (drag-and-drop), not an external Doc/Imgur link — external images expire and can't always be viewed by maintainers.
  • Never attach your ROM (.gba). If you need to share diagnostics, use File → Problem Report Tool to create a report.7z — it contains your version + CRC32, not the ROM — and attach that.

Mobile preview (Android / iOS)

The native Android and iOS builds of the Avalonia GUI are experimental previews, and they each have a dedicated discussion for collecting real-device bug reports and feedback:

When reporting a mobile bug, include your device + OS version, the release (ver_*) you installed, how you installed it (for iOS: AltStore / Sideloadly / Apple Configurator), the ROM version if relevant, clear steps to reproduce, and a screenshot / screen recording.

Questions vs. bugs

Clone this wiki locally