FirmMux v1.0.4-beta8

TL;DR

• This release focuses on UI/theme stability, safer theme asset rendering, and cleanup of several long-running visual regressions.
• Theme fonts were removed. Sorry to anyone using custom font-based themes, but the layout drift and per-theme text metric mismatches were causing too many alignment and clipping problems. Stability and consistent UI behavior were prioritized here.
• Theme-controlled line spacing, list item height, status bar height, and background visibility were also removed as live layout controls. Older theme keys remain safe and are ignored.
• Theme image asset support has been restored with a safer texture upload path. That includes wallpapers, row textures, preview frames, help strips, and status strips.
• RetroArch cover previews remain at readable 92x92 sizing with the corrected upload behavior that fixed the old clipped/cutoff preview issue.

Since v1.0.4-beta7

• Commits included in this release:
  • Fix theme debug toggle selection
  • Document theme asset sizes
  • Update theme asset documentation
  • Restore theme asset support
  • Tighten row text alignment
  • Simplify theme opacity controls
  • Stabilize theme text settings and fix NDS preview wrapping
  • Show date in status bar
  • Fix 92x92 cover preview upload
  • Wire RetroArch fork as submodule source
  • Track RetroArch source tree and update build flow

Notable Changes

• Fixed clipped 92x92 cover previews while keeping them readable.
• Added date display to the status bar.
• Fixed NDS title-data wrapping/newline overlap.
• Fixed row text vertical alignment for tabs and lists.
• Simplified theme opacity behavior so background visibility no longer globally washes out the UI.
• Backgrounds now render at full opacity.
• Added per-element alpha controls for theme tuning.
• Restored theme asset support and documented the supported asset keys, formats, and recommended sizes.
• Added a repo-side themes/test_assets reference theme for asset testing.
• Fixed theme debug menu toggle selection.
• Switched RetroArch source maintenance to the tracked fork workflow.

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.4-beta7

TL;DR

• Add FirmMux updater app and docs updates
• ui: confirm cache clear and harden toast wrapping/centering
• pathfile: add per-system toggle and model-aware defaults
• perf: memoize cover preview selection without stack-heavy key buffer

Since v1.0.4-beta6

• Commits included in this release:
  • Add FirmMux updater app and docs updates
  • ui: confirm cache clear and harden toast wrapping/centering
  • pathfile: add per-system toggle and model-aware defaults
  • perf: memoize cover preview selection without stack-heavy key buffer
  • fix: guard option/menu indices during rapid state changes
  • fix: tighten shutdown cleanup for audio and transient buffers
  • harden: validate path formatting and reject truncation in launch flows
  • fix: harden runtime/cover flow failure handling

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.4-beta6

TL;DR

• Harden service init/exit lifecycle and cleanup flow
• Harden state/theme/emulator/rules file loading safely
• Fix icon texture leak on allocation failure
• Fix cover preview crash when browsing emulator tabs

Since v1.0.3-beta5

• Commits included in this release:
  • Harden service init/exit lifecycle and cleanup flow
  • Harden state/theme/emulator/rules file loading safely
  • Fix icon texture leak on allocation failure
  • Fix cover preview crash when browsing emulator tabs
  • Reduce runtime cache memory footprint with 3-slot LRU
  • Add external themes with custom fonts and update bundled theme YAMLs
  • Fix NDS launch on autoboot by requiring HOME init first
  • Fix cover preview stability and expand boxart sync system coverage

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.3-beta5

TL;DR

• Remove duplicate CIA toolchain links from README
• Refine CIA setup-helper flow, update docs, and remove boot B-skip logic
• Ignore bundled BGM credit sidecar file
• Ignore Windows ADS Zone.Identifier sidecar files

Since v1.0.0-beta3

• Commits included in this release:
  • Remove duplicate CIA toolchain links from README
  • Refine CIA setup-helper flow, update docs, and remove boot B-skip logic
  • Ignore bundled BGM credit sidecar file
  • Ignore Windows ADS Zone.Identifier sidecar files
  • Add CIA build pipeline and update FirmMux banner/BGM assets
  • Fix 3DS HOME init flow and system menu behavior
  • Stage standalone pathfile package in PC setup and document it
  • Add standalone pathfile routing and New 3DS-only heavy system gating

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.0-beta5

TL;DR

• Ignore bundled BGM credit sidecar file
• Ignore Windows ADS Zone.Identifier sidecar files
• Add CIA build pipeline and update FirmMux banner/BGM assets
• Fix 3DS HOME init flow and system menu behavior

Since v1.0.0-beta3

• Commits included in this release:
  • Ignore bundled BGM credit sidecar file
  • Ignore Windows ADS Zone.Identifier sidecar files
  • Add CIA build pipeline and update FirmMux banner/BGM assets
  • Fix 3DS HOME init flow and system menu behavior
  • Stage standalone pathfile package in PC setup and document it
  • Add standalone pathfile routing and New 3DS-only heavy system gating

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.0-beta4

TL;DR

• Stage standalone pathfile package in PC setup and document it
• Add standalone pathfile routing and New 3DS-only heavy system gating

Since v1.0.0-beta3

• Commits included in this release:
  • Stage standalone pathfile package in PC setup and document it
  • Add standalone pathfile routing and New 3DS-only heavy system gating

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.0-beta3

TL;DR

• Set default emulator tabs and update docs
• Docs: sync SD layout, RetroArch staging, and persistence behavior
• Stabilize state persistence, remove boot debug, and update ROM/docs layout
• Add GBA system support and ship gba ROM folder

Since v1.0.0-beta2

• Commits included in this release:
  • Set default emulator tabs and update docs
  • Docs: sync SD layout, RetroArch staging, and persistence behavior
  • Stabilize state persistence, remove boot debug, and update ROM/docs layout
  • Add GBA system support and ship gba ROM folder
  • Move setup flow to PC installer and align health checks
  • covers: add SD boxart sync tool and emulator preview cache rendering
  • tools: unify release flow with canonical SD asset publish
  • Document NDS dependency links (NTR Forwarder, NTR Launcher, YANBF)
  • Remove release_notes.md
  • Fix target ID parsing and harden config reload stability

Included Assets

• FirmMux-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.0-beta2

TL;DR

• Fixed a crash when using Reload config in Settings.
• Improved stability around config/emulator target rebuild paths.
• Added a new docs page for large-ROM organization with PowerShell scripts.
• Updated README docs links and ROM organizer guidance.
• Refreshed included SD build files (FirmMux.3dsx / FirmMux.smdh).

Since v1.0.0-beta1

• UI/theme pipeline polish and stability fixes.
• RetroArch backend flow and options improvements.
• NDS options/cheat flow iteration and docs updates.
• Additional quality-of-life fixes (toasts, list behavior, theme fallback/background handling).

Included Asset

• FirmMux-v1.0.0-beta2-SD.zip (contents of SD/ for end-user copy)

FirmMux v1.0.0-beta1

Highlights

• Pure RetroArch 3DSX backend integration with firm handoff (sd:/3ds/emulators/launch.json) and core resolution.
• Custom FirmMux RetroArch build that boots directly into the selected core + ROM.
• Emulator system tabs with enable/disable, folder mapping, and robust missing/empty folder handling.
• Background picker (top/bottom) + background visibility control.
• Updated SD layout and documentation for RetroArch dependencies and build steps.

RetroArch Requirements

• Custom RetroArch 3DSX: sd:/3ds/FirmMux/emulators/retroarch.3dsx
• RetroArch data bundle (3DSX build) from:
  https://buildbot.libretro.com/stable/
• Dependency folders on SD:
  • sd:/retroarch/cores/
  • sd:/retroarch/system/

SD Layout (Core Paths)

• FirmMux: sd:/3ds/FirmMux.3dsx
• FirmMux assets: sd:/3ds/FirmMux/
• RetroArch backend configs: sd:/3ds/emulators/

Notes

• This is a beta release; expect iterative updates as new systems and refinements land.

FirmMux v0.1.0-alpha2

This update focuses on theming, launcher selection updates, and UI polish for the alpha.

Highlights

• Theme system with a theme picker (Options → Themes...) and per-theme layout/spacing.
• New color themes: default, amber, cobalt, ember, epoxy_resin, glacier, graphite, sage.
• Epoxy Resin theme includes asset-based backgrounds and sprite icon.
• NDS launcher auto-select uses product code CTR-P-FMBP (Select NDS launcher).
• System info panel and status bar refinements.

SD layout

• FirmMux app: sd:/3ds/FirmMux.3dsx and sd:/3ds/FirmMux.smdh
• Themes: sd:/3ds/FirmMux/themes//theme.yaml
• NDS launcher handoff: sd:/_nds/firmux/launch.txt

NDS launching

• Install FirmMuxBootstrapLauncher (CTR-P-FMBP).
• FirmMux writes sd:/_nds/firmux/launch.txt and then launches the CIA.
• FirmMux Bootstrap Launcher releases: https://github.com/nextcode4u/firmux-bootstrap-prep/releases
• YANBF releases: https://github.com/YANBForwarder/YANBF/releases (FirmMux Bootstrap depends on bootstrap.cia).
• NTR Launcher is used for Slot-1 cards: https://github.com/ApacheThunder/NTR_Launcher/releases
• NTR Forwarder pack (includes nds-bootstrap): https://github.com/RocketRobz/NTR_Forwarder/releases