GameBrew - User contributions [en-gb]

UndertaleModTool Switch

2026-07-17T02:09:14Z

HydeWing: 0.9.1.2

{{Infobox Switch Homebrews
|title=UndertaleModTool
|image=undertalemodtoolnx.png
|description=The most complete tool for modding, decompiling and unpacking Undertale (and other Game Maker: Studio games).
|author=krzys-h
|lastupdated=2026/07/13
|type=Hack Utilities
|version=0.9.1.2
|license=GPL-3.0
|downloadraw=[https://github.com/krzys-h/UndertaleModTool/releases/tag/bleeding-edge Bleeding Edge] - [https://github.com/UnderminersTeam/UndertaleModTool/releases/tag/0.9.1.2 Stable Download]
|website=https://gamebanana.com/tools/6647
|source=https://github.com/krzys-h/UndertaleModTool
|donation=
}}

The most complete tool for modding, decompiling and unpacking Undertale (and other Game Maker: Studio games).

UndertaleModTool has a few different versions to choose from. The differences are as follows:
* GUI (default) - the tool has a full graphical interface, making data file viewing and manipulation convenient.
* CLI - the tool is accessible only via a command-line interface, which is useful for automation and quick tasks, but is more difficult to use.
* Single file - the tool is only one executable, with all dependencies embedded within it. This makes your folders cleaner, however it can also cause stability issues in certain cases.
* Non-single file (default) - all dependencies are not embedded within the executable, and are now located right next to it. Choose this if you don't care about finding the right executable within ~300 DLL files, or if the stability issues from the Single file build affect you.

Documentation is available on [https://github.com/krzys-h/UndertaleModTool/wiki UndertaleModTool wiki].

==Features==
* Can read every single byte from the data file for latest versions of Undertale, Deltarune, and most other GameMaker games, and then recreate a byte-for-byte exact copy from the decoded data.
* Properly handles all of the pointers in the file so that if you add/remove stuff, make things longer/shorter, move them around, etc., the file format won't break.
* An editor which lets you change (almost) every single value, including unknown ones.
* Includes a simple room/level editor.
* Allows for GML VM code editing. This means you can add any custom code to a game, either using the built-in GML compiler or GML assembly. (YYC is not supported for this.)
* High-level GML decompiler and compiler. Supports a large range of GameMaker versions, and most important GML features (still missing a few).
* Support for running scripts that automatically modify your data file (or perform other nefarious tasks). This can be used for mod distribution, aside from other methods such as file patches/project systems.
* All core functionality extracted into a library for use in external tools.
* Can generate a <code>.yydebug</code> file for the GM:S debugger so that you can edit variables live! (see [https://github.com/UnderminersTeam/UndertaleModTool/wiki/Corrections-to-GameMaker-Studio-1.4-data.win-format-and-VM-bytecode,-.yydebug-format-and-debugger-instructions#yydebug-file-format here])
* Automatic file associations for all GameMaker related data files. This is opt-in at the first boot of the tool, and can also be disabled by having a <code>dna.txt</code> file next to the executable.

==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/undertalemodtoolnx2.png

[https://gamejolt.com/games/UndertaleBnP/574044 Undertale: Bits and Pieces] 
https://dlhb.gamebrew.org/switchhomebrews/undertalemodtoolnx3.png

[https://gamejolt.com/games/ribbitmod/671888 RIBBIT - The Deltarune Mod] 
https://dlhb.gamebrew.org/switchhomebrews/undertalemodtoolnx4.png

==Changelog==
[https://github.com/krzys-h/UndertaleModTool/releases Release notes.]

== External links ==
* GitHub - https://github.com/krzys-h/UndertaleModTool
* GameBanana - https://gamebanana.com/tools/6647

Ultrahand Overlay Switch

2026-07-17T02:09:09Z

HydeWing: 2.5.2

{{Infobox Switch Homebrews
|title=Ultrahand Overlay
|image=ultrahandoverlaynx.png
|description=The fully craft-able overlay executor. Create directories, manage files, and customize configurations effortlessly using simple ini files.
|author=ppkantorski
|lastupdated=2026/07/10
|type=Overlays
|version=2.5.2
|license=Mixed
|download=https://github.com/ppkantorski/Ultrahand-Overlay/releases
|website=https://gbatemp.net/threads/ultrahand-overlay-the-fully-craft-able-overlay-executor.633560/
|source=https://github.com/ppkantorski/Ultrahand-Overlay
|donation=https://ko-fi.com/X8X3VR194
}}
Ultrahand Overlay is a fully scriptable overlay menu ecosystem for the Nintendo Switch.

Accessible instantly via hotkey from any game or application, it provides a powerful custom command language for managing files, configurations, and system settings. Built on [https://github.com/ppkantorski/libultrahand libultrahand] (an enhanced fork of [https://github.com/WerWolv/libtesla libtesla]), Ultrahand is a full drop-in replacement for Tesla Menu.

Every existing Tesla overlay (<code>.ovl</code>) works without modification.

== Features ==
=== For Users ===
* Instantly accessible from any game via hotkey or swipe gesture - no game suspension required.
* Launch and manage overlays and packages with assignable per-item key combos.
* Install and run community packages from [https://github.com/ppkantorski/Ultrahand-Packages Ultrahand Packages].
* Control volume (up to 150% via bundled audio patch), backlight, and system settings on the fly.
* Real-time progress feedback for downloads, copies, and installs.
* Full touch support - scrolling, tapping, long-tap, and swipe gestures work throughout the entire UI.
* Customizable themes, wallpapers, sound packs, and UI layout.
* Browser-based [https://ppkantorski.github.io/Ultrahand-Wallpaper/ Wallpaper Designer] - crop, adjust, and export ready-to-drop <code>.rgba</code> wallpapers (448×720).
* Toast notification system - packages and external sysmodules/apps can push notifications to the overlay via JSON <code>.notify</code> files.
* A growing ecosystem of [https://github.com/ppkantorski/libultrahand libultrahand]-based overlays is available, all launchable and manageable directly from Ultrahand:
** [https://github.com/ppkantorski/UltraGB-Overlay UltraGB] - Game Boy / GBC emulator running on top of any game.
** [https://github.com/ppkantorski/Tetris-Overlay Tetris] - Fully playable Tetris running as an overlay.
** [https://github.com/ppkantorski/sys-tune sys-tune] - Background music player.
** [https://github.com/ppkantorski/Status-Monitor-Overlay Status Monitor] - Real-time CPU/GPU/RAM, temps, battery, and frequency stats.
** [https://github.com/ppkantorski/FPSLocker FPSLocker] - Custom FPS targets and display refresh rates for retail games.
** [https://github.com/ppkantorski/sys-clk sys-clk] - Per-game CPU/GPU/memory overclocking and underclocking.
** [https://github.com/ppkantorski/ovl-sysmodules ovl-sysmodules] - Toggle system modules and monitor memory usage on the fly.
** [https://github.com/ppkantorski/QuickNTP QuickNTP] - One-tap NTP time sync.
** [https://github.com/ppkantorski/Fizeau Fizeau] - Color temperature, saturation, gamma, and contrast adjustment.
** [https://github.com/ppkantorski/NX-FanControl NX-FanControl] - Custom fan curve control.
* For a fuller list, see [https://github.com/ppkantorski#ultrahand-overlays Ultrahand Overlays].

=== For Package Devs ===
A rich INI-based GUI scripting environment with:
* '''Launch integration''' - assignable hotkey combos per package, hide/star state, and boot/exit package hooks (<code>boot_package.ini</code> / <code>exit_package.ini</code>)
* '''Overlay control''' - launch overlays, execute package sections, navigate back, exit to menu
* '''Dynamic UI''' - toggles, sliders, dropdowns, tables (drawn directly or loaded from a text file), rich toast notifications (title, duration, alignment, icon), <code>set-footer</code>, and page/theme/wallpaper <code>refresh</code>
* '''Status bar widget''' - opt-in clock, temperature, and battery overlay widget
* '''Language translations''' - package UI strings are automatically translated at render time based on the active system language
* '''Notifications''' - <code>notify</code> / <code>notify-now</code> commands push inline toast messages from scripts; dropping a <code>.notify</code> JSON file to <code>/config/ultrahand/notifications/</code> queues a persistent API notification that displays until dismissed
* '''Placeholders''' - INI, JSON, hex, list, file, and timestamp sources; hardware info (<code>{ams_version}</code>, <code>{hos_version}</code>, <code>{title_id}</code>, <code>{build_id}</code>, <code>{ram_vendor}</code>, <code>{local_ip}</code>, <code>{volume}</code>, <code>{backlight}</code>, fuse data, and more); math and string transforms
* '''Conditional logic''' - <code>try:</code> blocks, <code>path_exists</code>, <code>erista:</code>/<code>mariko:</code> hardware guards, version comparisons
* '''File operations''' - copy, move, delete, rename, mkdir, touch, mirror, compare, flag, dot-clean
* '''Download & extraction''' - download with retry, unzip; performs a one-time NTP sync to <code>pool.ntp.org</code> on first download to prevent SSL handshake failures
* '''INI editing''' - get/set values and keys, add/rename/remove sections and keys, pattern-matched bulk edits
* '''JSON editing''' - get/set values and keys
* '''Hex editing''' - edit by offset, swap, string, decimal, reversed decimal, custom pattern offset, and hex pattern replacement
* '''Mod conversion''' - <code>.pchtxt</code> to <code>.ips</code> or Atmosphere cheat format
* '''System control''' - reboot (Hekate boot/ini/UMS/payload targets), shutdown, volume, backlight, region

See the [https://github.com/ppkantorski/Ultrahand-Overlay/wiki Wiki] for full documentation.

=== For Overlay Devs ===
Overlays built on [https://github.com/ppkantorski/libultrahand libultrahand] get access to the full <code>libultra</code> utility suite plus first-class Ultrahand integration:
* '''Tesla compatibility''' - full drop-in replacement for libtesla; existing overlays work without modification
* '''Improved rendering''' - enhanced rendering performance and expanded shape primitives compared to libtesla
* '''Bug fixes''' - title ID change foreground bug, underscan bug, and screenshot transparency bug all resolved versus stock libtesla
* '''Full touch support''' - complete touch input handling with proper scrolling, tap, long-tap, and swipe gesture support (a significant improvement over libtesla's limited touch implementation)
* '''Launch integration''' - assignable combos, hide/star state, and boot/exit package hooks
* '''Per-overlay themes''' - independent theme overrides scoped to your overlay
* '''Per-overlay wallpapers''' - custom wallpaper support with automatic heap-aware fallback
* '''Status bar widget''' - opt-in clock, temperature, and battery overlay widget
* '''Language translations''' - automatic string translation at render time based on the active language
* '''Notifications''' - call <code>tsl::notification->show()</code> or <code>tsl::notification->showNow()</code> to push toast messages from overlay code, with configurable text, font size, priority, duration, alignment, and icon
* '''File & path utilities''' - copy, move, delete, mkdir, wildcard matching, and directory traversal
* '''Download & extraction''' - curl-based file downloads and zip extraction; performs a one-time NTP sync to <code>pool.ntp.org</code> on first download to prevent SSL handshake failures
* '''INI, JSON & hex utilities''' - full read/write access to INI files, JSON files, and binary hex data
* '''Mod conversion''' - <code>.pchtxt</code> to <code>.ips</code> or Atmosphere cheat format
* '''String utilities''' - trim, split, format, version parsing, placeholder resolution
* '''Audio & haptics''' - WAV sound playback with volume control and rumble feedback

See [https://github.com/ppkantorski/libultrahand libultrahand] for full documentation.

== Installation ==
Quick Install (Recommended):
* Download the latest [https://github.com/ppkantorski/Ultrahand-Overlay/releases/latest/download/sdout.zip <code>sdout.zip</code>] and extract it to the root of your SD card. It includes everything needed: <code>nx-ovlloader</code>, <code>ovlmenu.ovl</code>, language files, themes, sound packs, and the required folder structure. Boot / reboot and launch Ultrahand with the default hotkey (<code>ZL+ZR+DDOWN</code>) or any Tesla-compatible combo.

Manual Install:
* Download and install the latest [https://github.com/ppkantorski/nx-ovlloader nx-ovlloader].
* Place [https://github.com/ppkantorski/Ultrahand-Overlay/releases/latest/download/ovlmenu.ovl <code>ovlmenu.ovl</code>] at <code>/switch/.overlays/ovlmenu.ovl</code>.
* '''Warning:''' This will replace Tesla Menu if it is installed.
* Boot / reboot and launch Ultrahand with the default hotkey (<code>ZL+ZR+DDOWN</code>) or any Tesla-compatible combo.
* On first launch, Ultrahand creates <code>/config/ultrahand/</code> and generates a starter <code>package.ini</code> at <code>/switch/.packages/</code>.
* If a package does not appear in the menu, try running "Fix Bit Archive" in Hekate.

For available community packages, see [https://github.com/ppkantorski/Ultrahand-Packages Ultrahand Packages].

== Settings Overview ==
Access the Settings menu by pressing <code>PLUS</code> from the main screen.

* '''Key Combo''' - Configure the hotkey used to open Ultrahand
* '''Language''' - Select UI language (loaded from <code>/config/ultrahand/lang/</code>)
* '''Notifications''' - Toast behavior and API notification settings
** Silence notifications, set max slots, toggle startup notification
** External sysmodules/apps can push notifications via <code>.notify</code> JSON files in <code>/config/ultrahand/notifications/</code>; per-app filtering and 50×50 RGBA icons supported
** '''API Toggle Hotkey''' - hold <code>MINUS</code> ~4s to enable/disable API notifications on the fly
* '''System''' - View device info and adjust overlay memory heap size (4 / 6 / 8 MB)
* '''Software Update''' - Check for and install updates from within the overlay
* '''Theme''' - Select a theme from <code>/config/ultrahand/themes/</code>
* '''Sounds''' - Select a sound-effect pack from <code>/config/ultrahand/.sounds/</code>
* '''Wallpaper''' - Set a background wallpaper (requires 6 MB+ heap; <code>.rgba</code> format, 448×720 px)
* '''Widget''' - Toggle individual status bar elements:
** Clock, SOC temperature, PCB temperature, battery
** Backdrop, extended backdrop, border
* '''Miscellaneous''' - Granular toggles including:
** Swipe-to-open, haptic feedback, auto NTP sync
** Page recall, launch recall
** Packages menu, user guide, show/hide delete, show/hide unsupported overlays
** Overlay and package version display

Per-overlay and per-package launch combos can be assigned independently via the overlay/package settings menu (<code>Y</code>).

== Writing Packages ==
Packages live in <code>/switch/.packages/<YOUR_PACKAGE_NAME>/</code> and are configured with a <code>package.ini</code> file. A minimal example:

<pre class="language-ini">;title='My Package'
;version=1.0.0
;creator=YourName

[Copy Config]
copy /switch/.packages/package.ini /config/mypackage/

[Reboot to Hekate]
;hold=true
reboot hekate</pre>

For complete documentation on the package format, all available commands, placeholder variables, and command modes, see the [https://github.com/ppkantorski/Ultrahand-Overlay/wiki Wiki]:
* [https://github.com/ppkantorski/Ultrahand-Overlay/wiki/Package-Reference Package Reference] - Package structure, headers, pages, boot/exit hooks, and configuration
* [https://github.com/ppkantorski/Ultrahand-Overlay/wiki/Command-Reference Command Reference] - All commands, modes, source functions, and placeholder variables

For real-world package examples, see the [https://github.com/ppkantorski/Ultrahand-Overlay/tree/main/examples <code>examples/</code>] directory.

== Controls ==
A - Execute the selected command

Minus - View and run individual command lines (Script Overlay); tap to dismiss the frontmost notification

Hold Minus (~4s) - Toggle API Notifications on/off (when API Toggle Hotkey is enabled in Notification Settings)

Long-tap (touch) - Open command line view or overlay/package settings

X - Star/favorite an overlay or package

Y - Open overlay/package settings

Plus - Open Ultrahand Settings from the main menu

L/R - Jump to top / bottom of the current list

ZL/ZR - Page up / down (hold for rapid scrolling)

R during command - Abort the running operation

B during command - Dismiss the overlay without canceling

Swipe inward from edge - Open Ultrahand (alternative to key combo)

Tap notification (touch) - Dismiss that notification directly

== Screenshots ==
https://dlhb.gamebrew.org/switchhomebrews/ultrahandoverlaynx-01.png

https://dlhb.gamebrew.org/switchhomebrews/ultrahandoverlaynx-02.png

https://dlhb.gamebrew.org/switchhomebrews/ultrahandoverlaynx-03.png

== Changelog ==
'''Version 2.5.2'''
* List of Changes
** New <code>;text_color=</code> and <code>;footer_color=</code> command headers for command list items.
*** <code>;text_color=<HEX></code> and <code>;footer_color=<HEX></code> (rgb888, e.g. <code>#RRGGBB</code> or <code>RRGGBB</code>) set a custom title/value color for that specific item.
*** Applies to standard list items, toggles, and dropdown-selection items; takes priority over theme defaults but never overrides transient run-state colors (spinner/checkmark/crossmark/in-progress).
** New <code>;bg_color=</code> and <code>;border=</code> table command headers.
*** <code>;bg_color=<HEX></code> sets a custom table background color. Only the RGB channels are used (alpha is still read from the theme).
*** <code>;border=true</code>/<code>;border=false</code> toggles the table's border on or off independent of <code>Dynamic Tables</code>.
** New <code>matching_hex_val_custom <FILE_PATH> <ASCII_PATTERN> <OFFSET> <HEX_VALUE></code> conditional command (and inverse <code>!matching_hex_val_custom</code>).
*** Resolves <code><OFFSET></code> relative to the file offset of <code><ASCII_PATTERN></code> (e.g. <code>"CUST"</code>), using the same magic-scan + offset cache that hex-by-custom-offset writes use.
*** Usable standalone or with <code>;visibility_condition=</code>/<code>;toggle_state_condition=</code>, same as the other <code>matching_*</code> checks.
** New '''In-Package Titles''' toggle in Widget Settings (<code>in_package_titles</code>, on by default).
*** Separate from the existing '''Package Titles''' toggle. When off, every in-package (sub-menu) title is forced to the theme's default package title color, overriding any color a package requested via its own header (e.g. <code>;color=</code>).
** Input handling changes to prevent accidental hides while a command is running.
*** <code>X</code> now hides the overlay while a command is running (moved off <code>B</code>), so reflexively pressing <code>B</code> to "go back" no longer hides the overlay mid-command.
*** <code>B</code> is swallowed during a running command instead of hiding or popping the menu.
*** D-pad and <code>A</code> now visibly bounce the highlighted item while a command is running, instead of incorrectly triggering a click animation.
** Settings menu navigation bug fixes.
** Fixed overlay/package list titles and versions not switching to the theme's Selection Text/Value color when highlighted.
*** These now use the new base-color path internally, so highlighting behaves correctly again while still supporting the new <code>;text_color=</code>/<code>;footer_color=</code> per-item overrides.
** Slight changes to the default theme colors and settings.
*** <code>Dynamic Logo</code> now defaults to '''off''' instead of on.
*** '''Side-note:''' For color changes to be applied, users must re-apply their default theme, or install Ultrahand fresh.
** Refreshed default theme colors (click, dynamic logo, main logo, and table background), and added a new bundled <code>classic.ini</code> theme.
*** <code>classic.ini</code> preserves the exact pre-2.5.2 default color palette for anyone who prefers the previous look.
** Improved download reliability for usage with a wider range of url domains.
** Foreground related bug fixes in <code>libultrahand</code>.
** Fixed a mismatched declared size on the default key-combos array.
** [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.5.1...v2.5.2 Full Changelog: v2.5.1...v2.5.2]

Quick Update
* Foreground request related bug fixes. - 07/10/2026 02:54 AM PST
* Slight tweaks to default theme. - 07/10/2026 4:20 AM PST
* New table wrapping mode <code>auto</code> + bug fixes for notification translations / alignments. - 07/10/2026 7:35 AM PST
** <code>auto</code> utilizes character wrapping for Asian languages and word wrapping for non-Asian languages.
* New Ultrahand config.ini key <code>swipe_offset</code> (integer value; optional) for calibrating the swipe to open behavior's X-start. - 07/10/2026 7:35 AM PST
* Hard line break fix for table <code>wrapText</code> (proper handling of newlines). - 07/10/2026 08:04 AM PST
* Add translation handling in CategoryHeader constructors. -07/10/2026 8:33 AM PST
* Translations now apply to sections on divider split strings, new <code>{ovl_language}</code> placeholder for overlay language, bug fix for hard line break changes. - 07/10/2026 10:01 AM PST
** <code>{ovl_language}</code> returns values like <code>en</code>, <code>es</code>, etc based upon the selected language in the Ultrahand settings menu.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.5.2...d706cd8 Full Changelog: v2.5.2...d706cd8]

'''Version 2.5.1'''
* Ultrahand package bug fix for placeholder resolution within sourced commands.
** This bug appears to have been introduced in v2.4.5.
* No changes to <code>libultrahand v2.5.0</code>.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.5.0...v2.5.1 Full Changelog: v2.5.0...v2.5.1]

'''Version 2.5.0'''
* New <code>Switch 2 Style</code> toggle in <code>Theme Settings</code> (Misc), on by default.
** When enabled, selected list items, the cursor, trackbar handles are replaced with a more rounded, slightly wider cursor utilizing the new color-wheel effect.
** Toggles render as a sliding Switch-style pill switch instead of a plain ON/OFF glyph.
** Single-choice selection lists draw a circular radio mark in the value slot instead of a checkmark.
** Turning the toggle off preserves the classic <code>Switch 1</code> look from before v2.5.0.
** '''Side-note:''' requires <code>libultrahand v2.5.0</code> or greater; compiled overlays built against older <code>libultrahand</code> versions are unaffected.
* Radio-style selection lists.
** <code>Themes</code>, <code>Wallpapers</code>, <code>Sounds</code>, <code>Language</code>, <code>Launch Combos</code>, <code>Priority</code>, and package <code>;mode=option</code> dropdown menus now use the new circular radio mark in place of a checkmark when <code>Switch 2 Style</code> is on.
* New theme INI color keys added.
** '''Cursor'''
*** <code>s2_highlight_color_1</code>: first fixed accent in the default rotating highlight wheel (cursor/selection border).
*** <code>s2_highlight_color_2</code>: second fixed accent in the default rotating highlight wheel.
*** <code>s2_highlight_color_3</code>: bright hero color in the default wheel.
*** <code>s2_highlight_color_3_deep</code>: deep/shadow variant of <code>s2_highlight_color_3</code>.
*** <code>s2_highlight_color_4</code>: second bright hero color in the default wheel.
*** <code>s2_highlight_color_4_deep</code>: deep/shadow variant of <code>s2_highlight_color_4</code>.
*** <code>s2_alt_highlight_color_1</code>: first fixed accent in the alternate wheel (shown while locked or mid-click).
*** <code>s2_alt_highlight_color_2</code>: second fixed accent in the alternate wheel.
*** <code>s2_alt_highlight_color_3</code>: bright hero color in the alternate wheel.
*** <code>s2_alt_highlight_color_3_deep</code>: deep/shadow variant of <code>s2_alt_highlight_color_3</code>.
*** <code>s2_alt_highlight_color_4</code>: second bright hero color in the alternate wheel.
*** <code>s2_alt_highlight_color_4_deep</code>: deep/shadow variant of <code>s2_alt_highlight_color_4</code>.
** '''Table Border'''
*** <code>s2_table_border_color_1</code>: first fixed accent in the rotating table-border wheel.
*** <code>s2_table_border_color_2</code>: second fixed accent in the rotating table-border wheel.
*** <code>s2_table_border_color_3</code>: bright hero color in the table-border wheel.
*** <code>s2_table_border_color_3_deep</code>: deep/shadow variant of <code>s2_table_border_color_3</code>.
*** <code>s2_table_border_color_4</code>: second bright hero color in the table-border wheel.
*** <code>s2_table_border_color_4_deep</code>: deep/shadow variant of <code>s2_table_border_color_4</code>.
*** <code>table_border_color</code>: base color of the new table border, used when <code>Dynamic Tables</code> is off.
** '''Widget Border'''
*** <code>s2_widget_border_color_1</code>: first fixed accent in the rotating widget-border wheel.
*** <code>s2_widget_border_color_2</code>: second fixed accent in the rotating widget-border wheel.
*** <code>s2_widget_border_color_3</code>: bright hero color in the widget-border wheel.
*** <code>s2_widget_border_color_3_deep</code>: deep/shadow variant of <code>s2_widget_border_color_3</code>.
*** <code>s2_widget_border_color_4</code>: second bright hero color in the widget-border wheel.
*** <code>s2_widget_border_color_4_deep</code>: deep/shadow variant of <code>s2_widget_border_color_4</code>.
** '''Switch 2 UI Elements'''
*** <code>s2_radio_ring_color</code>: outer ring of an unselected radio mark.
*** <code>s2_radio_selected_color</code>: fill color once a radio choice is confirmed.
*** <code>s2_radio_inprogress_color</code>: fill color while a radio choice is mid-selection.
*** <code>s2_radio_inner_color</code>: small inner dot drawn inside a filled radio mark.
*** <code>s2_toggle_on_color</code>: toggle track color when the toggle is on.
*** <code>s2_toggle_off_color</code>: toggle track color when the toggle is off.
*** <code>s2_toggle_circle_color</code>: color of the toggle's sliding knob.
** Preliminary updates for the bundled <code>ultra.ini</code> and <code>ultra-blue.ini</code> themes.
** '''Side-note:''' custom themes that don't define these keys fall back to libultrahand's built-in defaults.
* Widget Settings tweaks.
** <code>Dynamic Colors</code> has been renamed to <code>Dynamic Temps</code>.
** New <code>Dynamic Border</code> toggle (animates the widget's border color according to the theme colors).
* Theme Settings: new <code>Dynamic Tables</code> toggle (default on).
** Drives the new border effect drawn around package table sections; independent of the <code>Switch 2 Style</code> toggle.
** When off, tables resort back to the <code>table_border_color</code> theme ini preset.
* Bug fix for nested placeholders.
** Placeholder resolution is now depth-aware.
** A placeholder whose inner content hasn't resolved yet is now left intact for a later pass instead of producing a premature <code>null</code>.
* Settings menu navigation bug fix.
** Added a recovery guard that re-derives the settings menu/sub-menu state if both navigation flags are unexpectedly cleared (e.g. after a rapid back-press chain or an interrupted hide/show transition), preventing the menu from getting stuck.
** Fixed a stale sub-menu flag for combo-mode entries that could cause a double-pop on the next B press.
* Various alignment corrections.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/9b965b1...v2.5.0 Full Changelog: 9b965b1...v2.5.0]

'''Version 2.4.5'''
* New conditional <code>{if_...}</code> placeholder method.
** '''<code>null</code>'''
*** <code>{if_null(<VALUE>,<TRUE_FALLBACK>,[FALSE_FALLBACK])}</code> returns <code>TRUE_FALLBACK</code> when <code>VALUE</code> resolved to <code>null</code> (the literal returned by an unresolved/missing placeholder).
** '''<code>!null</code>'''
*** <code>{if_!null(<VALUE>,<TRUE_FALLBACK>,[FALSE_FALLBACK])}</code> is the inverse.
** '''<code>==</code>, <code>!=</code>'''
*** <code>{if_==(<VALUE>,<COMPARE_VALUE>,<TRUE_FALLBACK>,[FALSE_FALLBACK])}</code> and <code>{if_!=(...)}</code> do exact string equality.
** '''<code>></code>, <code><</code>, <code>>=</code>, <code><=</code>'''
*** <code>{if_>(<VALUE>,<COMPARE_VALUE>,<TRUE_FALLBACK>,[FALSE_FALLBACK])}</code>, <code>{if_<(...)}</code>, <code>{if_>=(...)}</code>, and <code>{if_<=(...)}</code> compare numerically when both values are numbers (compared as floats), and fall back to a plain lexicographic (case-sensitive) comparison otherwise.
** '''<code>version_></code>, <code>version_<</code>, <code>version_>=</code>, <code>version_<=</code>'''
*** <code>{if_version_>(<VALUE>,<COMPARE_VALUE>,<TRUE_FALLBACK>,[FALSE_FALLBACK])}</code>, <code>{if_version_<(...)}</code>, <code>{if_version_>=(...)}</code>, and <code>{if_version_<=(...)}</code> do version-aware comparison.
*** Numeric segments compare as integers (<code>1.10.0</code> > <code>1.9.0</code>).
*** <code>-</code> suffix is treated as a pre-release and sorts lower (<code>2.0.1-rc</code> < <code>2.0.1</code>).
*** <code>+</code> suffix is treated as build metadata and sorts higher (<code>2.0.1+r23</code> > <code>2.0.1</code>).
** The <code>FALSE_FALLBACK</code> is optional in every form. When omitted, the false branch returns <code>VALUE</code> unchanged.
* New <code>{crc32(<FILE_PATH>)}</code> placeholder method.
** Returns the CRC32 of a file as 8 uppercase hex characters, or <code>null</code> if the file can't be read.
** Useful with the <code>{if_...}</code> and <code>matching_*</code> checks for verifying file contents.
* All placeholders can now be composed to define any source declaration.
** All placeholder variable declarations are fully resolved in order before being used.
** All placeholder commands (excluding <code>_source</code>) can be nested and chained to build the final <code>_source</code> declaration.
*** '''Side-note:''' No commands are executed at this stage; only placeholder expressions are evaluated.
** Non-source variable placeholders can now be redefined mid-section in sourced commands.
* New standalone conditional commands for use in packages.
** <code>path_exists <PATH></code>
** <code>ipc_exists <SERVICE_NAME></code>
** <code>module_exists <TID></code> (true when the module's content folder exists, running or not)
** <code>module_is_active <TID></code> (true only when the module is currently running)
** <code>matching_txt_line <FILE_PATH> <TEXT_LINE></code>
** <code>matching_hex_val <FILE_PATH> <OFFSET> <HEX_VALUE></code>
** <code>matching_ini_val <FILE_PATH> <SECTION> <KEY> <VALUE></code>
** Each runs as its own command and resolves to success or failure, so it can be used mid-script to force a command failure or success (handy with <code>try:</code> logic).
** Prefix any of them with <code>!</code> to invert the result (<code>!path_exists</code>, <code>!module_exists</code>, etc.).
* New <code>;visibility_condition=</code> option directive for usage with all command objects.
** <code>;visibility_condition=<MODE> <ARGS></code> draws a menu item or section only when the condition is satisfied; otherwise the item is skipped at render time.
** Accepts any of the conditional modes above (<code>path_exists</code>, <code>ipc_exists</code>, <code>module_exists</code>, <code>module_is_active</code>, <code>matching_txt_line</code>, <code>matching_hex_val</code>, <code>matching_ini_val</code>) with <code>!</code> negation, and resolves placeholders inside the condition.
** An empty condition (as well as a successful condition) shows the item; an unknown mode, missing argument (or false condition) hides it.
** Revised integration from '''PR [https://github.com/ppkantorski/Ultrahand-Overlay/pull/309 #309]'''.
* New <code>;toggle_state_condition=</code> option directive.
** Sets a toggle's initial ON/OFF state from a live condition instead of an on/off path check. Uses the same conditional modes as <code>;visibility_condition=</code>. A satisfied condition starts the toggle ON.
** Revised integration from PR [https://github.com/ppkantorski/Ultrahand-Overlay/pull/309 #309].
* New <code>;hold=true</code> directive for hold-to-activate items.
** Add <code>;hold=true</code> to a command list item or a toggle to require the user to hold the action before it fires.
** While held, the item shows the in-progress symbol; execution is deferred until the hold completes, and the action can be cancelled by releasing early.
** The hold length is set globally by the new '''Hold Duration''' trackbar (see below).
** The built-in default Reboot/Shutdown package now ships its <code>Shutdown</code> entry with <code>;hold=true</code>.
* New <code>module</code> command for starting and stopping sysmodules.
** <code>module start <TID></code> launches a sysmodule by program ID.
** <code>module stop <TID></code> stops a sysmodule, graceful-first with a force-kill fallback for dynamic modules.
** Reads the module's <code>toolbox.json</code> for its shutdown contract; static modules with no graceful contract are refused rather than risking an unsafe kill.
** <code><TID></code> accepts a bare 16-hex-character folder name or a <code>0x</code>-prefixed program ID.
* New <code>ipc-exec <SERVICE_NAME> <ENUM_CMD></code> command.
** Sends a void to void IPC command to a service; success means the dispatch was accepted.
* New <code>ntp-sync <NTP_URL></code> command.
** On-demand clock sync to the NTP host you specify.
** Checks for internet access internally before attempting the sync.
* New <code>refresh-return</code> command for sourced commands (dropdown menus).
** When returning from a sourced selection, <code>refresh-return</code> redraws the entire prior menu and lands the cursor back on the item you came from, instead of a plain back.
** Calling is optional. Without is faster, so only use <code>refresh-return</code> when the prior menu needs to be rebuilt to reflect changes (e.g. values that conditions key off of).
* New <code>refresh combos</code> command argument.
** <code>refresh combos</code> reloads the launch key combos live, so changes take effect without restarting the overlay. This joins the existing <code>refresh theme</code>, <code>refresh package</code>, and <code>refresh wallpaper</code> arguments.
* New '''Input Settings''' section added to Misc.
** Houses '''Launch Combos''', '''Swipe to Open''', '''Haptic Feedback''', and the two new input options below.
** New '''Stick Navigation''' toggle. When on, the analog stick navigates menus alongside the D-pad; when off, only the D-pad navigates. Applies to all <code>libultrahand v2.4.5+</code> overlays.
** New '''Hold Duration''' track-bar. Sets the global command hold-A length for all hold-to-activate actions, from <code>0.5s</code> to <code>5.0s</code> (default <code>3.0s</code>).
* Settings menu reorganized and renamed.
** '''Page Recall''' and '''Launch Recall''' toggles have been '''removed'''. These behaviors are now always on.
** The old '''Features''' header is now '''Feature Settings'''.
** '''Auto NTP Sync''' is renamed '''NTP Sync Downloads'''.
* The handheld / docked <code>;state=</code> directive renamed to <code>;device_state=</code>.
** '''IMPORTANT:''' Packages that used <code>;state=</code> must update to <code>;device_state=</code>.
* <code>ini_file_source</code> now supports wildcard paths.
** A wildcard <code>ini_file_source</code> path enumerates every matching <code>.ini</code> and merges their section names (empty names skipped, duplicates removed, first occurrence wins).
** Multiple <code>ini_file_source</code> lines now accumulate sections together rather than each one replacing the last.
** Revised integration from '''PR [https://github.com/ppkantorski/Ultrahand-Overlay/pull/312 #312]'''.
* The default root package now includes an <code>INI Entry</code> for <code>/bootloader/ini/*.ini</code> entries in <code>Reboot To</code>.
** '''Side-note:''' Users may want to delete <code>/switch/.packages/package.ini</code> to have this command updated.
** Revised integration from '''PR [https://github.com/ppkantorski/Ultrahand-Overlay/pull/312 #312]'''.
* <code>mirror-</code> is now accepted as an alias for <code>mirror_</code> (<code>mirror-copy</code>, <code>mirror-cp</code>).
** '''Side-note:''' This follows the loose convention where <code>-</code> are used with action commands (<code>set-ini-val</code>, <code>sync-ntp</code>, etc) and <code>_</code> are used to for check commands that simply resolve to success or failure (<code>path_exists</code>, <code>matching_ini_val</code>, etc).
* The overlay version placeholder <code>{ovl_version(<OVL_PATH>)}</code> now works with relative path resolution (i.e. <code>./</code> and <code>./../</code>).
* Cleaner dock power-down protocol on <code>reboot</code> and <code>shutdown</code> commands.
** A USB-PD teardown is now staged before any shutdown so the console signals the dock to cut its 5V rail before the PMIC powers off.
** Bug fix from '''Issue [https://github.com/ppkantorski/Ultrahand-Overlay/issues/313 #313]'''.
* New <code>Overlay does not exist!</code> notification for attempting to launch an overlay file that does not exist.
** Launching a mode whose overlay file is missing now reports the missing overlay directly instead of misreporting it as AMS-incompatible.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.4.4...v2.4.5 Full Changelog: v2.4.4...v2.4.5]

Quick Update
* <code>;device_state=</code> processing bug fix. - 06/11/2026 8:00 AM PST
* Variable placeholder definition / redefinition and resolutions bug fix. - 06/11/2026 8:00 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.4.5...9b965b1 Full Changelog: v2.4.5...9b965b1]

'''Version 2.4.4'''
* Quick bug fix for the <code>exit package</code> command.
** In the prior version triggering <code>exit package</code> was preventing the package header from being properly cached for forwarder packages until Ultrahand exits.
*** This broke things like package versions, titles, and info sections in package forwarders from being properly cached after triggering (now resolved).
* '''Side-note:''' Compiled with <code>libultrahand v2.4.3</code> (<code>v2.4.4</code> will be skipped on this release; no changes).

'''Version 2.4.3'''
* Sleep halting of the background event poller in <code>libultrahand</code> (to prevent all polling activity during shallow sleep).
** This makes the CPU load contribution from the overlay 0% during shallow sleep.

'''Version 2.4.2'''
* New package command option header <code>;ram_size_gb=</code> for conditionally drawing commands based on detected system RAM.
** <code>;ram_size_gb=4</code> will only apply on 4GB systems, <code>;ram_size_gb=8</code> on 8GB systems.
** RAM size is detected at fuse data write time and cached.
*** Older fuse files without this key are updated automatically on next startup.
* New package placeholders: <code>{ram_size_gb}</code>, <code>{hekate_version}</code>, <code>{ovlloader_version}</code>, <code>{ultrahand_version}</code>, and <code>{ovl_version(<PATH_TO_OVL>)}</code>.
** <code>{ram_size_gb}</code>: returns <code>4</code> or <code>8</code> based on detected system RAM (read from fuse data).
** <code>{hekate_version}</code>: reads from <code>sdmc:/bootloader/update.bin</code> and is cached at startup.
** <code>{ovlloader_version}</code>: reads from the running loader info and is cached at startup.
** <code>{ultrahand_version}</code>: returns the currently running Ultrahand version.
** <code>{ovl_version(<PATH_TO_OVL>)}</code>: dynamically reads the version of any overlay by path.
* Expanded <code>exit</code> command with new destination arguments.
** <code>exit package</code> instantly returns to the packages menu from anywhere in the package nav stack (including nested menus and script overlays) with the cursor positioned on the originating package.
** <code>exit overlays</code> and <code>exit packages</code> have been renamed to <code>exit to_overlays</code> and <code>exit to_packages</code>.
** <code>exit ovlloader</code> triggers a complete exit of <code>nx-ovlloader</code>.
* Expanded <code>reboot</code> command <code>reboot ovlloader</code> command using the same reload flag mechanism as <code>exit ovlloader</code>.
** Triggers an nx-ovlloader reload on demand without requiring a heap size change.
* <code>nx-ovlloader</code> version is now compared before and after a Software Update.
** If a version change is detected, Ultrahand automatically triggers a reload so the new loader takes effect immediately without a manual reboot.
* New <code>force_failure</code> command.
** Explicitly marks command execution as failed (useful for <code>try:</code> logic in packages).
* Scope fix for <code>exec</code> commands.
** <code>executeIniCommands</code> now correctly derives the package path from the ini file's actual location rather than always defaulting to the calling package's path.
* Bug fix for <code>;mode=option</code> drop-down losing the option symbol on back when no value has been set.
** Footer now correctly restores to <code>OPTION_SYMBOL</code> as the default rather than an empty/null string.
* Name split footer normalization fix for option-mode checkmark matching.
** Footers written by <code>boot_package</code> (e.g. <code>"0 - (default)"</code>) now correctly restored in <code>SelectionOverlay</code> after subsequent value changes.
* Table fixes / improvements.
** Lines beginning with <code>;</code> are now skipped (comment-out support for table rows).
** Rows where a placeholder resolves to <code>""</code> now correctly shift columns instead of rendering a blank first column (bug fix).
** The section and info columns now wrap independently to their own available widths, with rows aligned pairwise so multi-line entries in either column don't go out of sync.
** Creator field text wrapping mode corrected from <code>"none"</code> to word wrapping.
* Bug fix for <code>PROTECTED_FILES</code> (<code>atmosphere/package3</code>, <code>atmosphere/stratosphere.romfs</code>) not being correctly staged to <code>.ultra</code> during <code>copy</code>, <code>move</code>, and <code>unzip</code> operations.
** These changes fix updating AMS from Ultrahand via reboot payload in more test cases.
* IDDQ fuse calibration values now correctly scaled on write (<code>cpu_iddq</code> x4, <code>soc_iddq</code> x4, <code>gpu_iddq</code> x5) to match <code>hekate</code>.
* Scroll bar object rendering corrections in <code>libultrahand</code>.
* <code>atmosphere.rgba</code> wallpaper is now bundled in <code>sdout.zip</code>.
* New master volume IPS patch included (<code>d1e98d469...ips</code>) for latest HOS support.
* Now packaged with [https://github.com/ppkantorski/nx-ovlloader/releases/tag/v2.0.2 nx-ovlloader v2.0.2].
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/59b531c...v2.4.2 Full Changelog: 59b531c...v2.4.2]

'''Version 2.4.1'''
* Widget now has an optional border (on by default).
** New theme color <code>widget_border_color</code>.
** New toggle for <code>Border</code> in <code>Settings > Widget</code>.
** Themes <code>ultra.ini</code> and <code>ultra_blue.ini</code> have been updated.
* Improved audio event handling (for simultaneous sound effect playbacks) in <code>libultrahand</code>.
* Improved combo input isolation and button event handling.
* Home event system tick flag storing in <code>libultrahand</code> (for devs only).
* Slight alignment corrections.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.4.0...v2.4.1 Full Changelog: v2.4.0...v2.4.1]

Quick Update:
* Slight widget alignment correction for the 100% battery case. - 04/20/2026 5:02 AM PST
* <code>hide_widget_border</code> variable loading bug fix in <code>libultrahand</code>. -04/20/2026 7:45 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.4.1...59b531c Full Changelog: v2.4.1...59b531c]

'''Version 2.4.0'''
* Across the board performance optimizations to rendering methods in <code>libultrahand</code>.
** Significantly improved wallpaper rendering performance (60FPS on 612 MHz cpu under-clock).
* Across the board optimizations to all <code>libultra</code> functions in <code>libultrahand</code>.
** Now compiling back to pre-<code>Ultrahand Overlay v1.1.7</code> sizes.
* Overlay memory mode features have been expanded.
** 6MB overlay heap now supports wallpapers and higher buffer sizes (faster copy, downloads, unzip, etc).
** 4MB overlay heap now supports sound effects and slightly higher buffer sizes.
* Improved table drawing (significantly better performance + various bug fixes).
* Download commands now perform a NTP sync to <code>pool.ntp.org</code> one time after initial startup when called.
** This feature will auto-fix issues with SSL handshakes breaking due to time de-synchronization.
** New <code>Auto NTP Sync</code> toggle in the <code>Settings > Miscellaneous</code> menu for disabling this feature.
* New <code>Page Recall</code> and <code>Launch Recall</code> toggles in <code>Settings > Miscellaneous</code>.
** <code>Page Recall</code> preserves memory of what item you were on on page left / right for proper recall back to that item (on by default).
** <code>Launch Recall</code> takes you back to the exact overlay / package you used a launch combo to enter on the main menu when you click such combo again (on by default).
*** When turned off, combo returns simply return to Ultrahand cold (like before).
*** '''Side-note:''' This function only works with overlays compiled with >=<code>libultrahand v2.4.0</code>.
* Max overlay / package sort priority has been increased from 20 to 25.
* Critical bug fixes for page swapping / swapTo in <code>libultrahand</code>.
** There was an issue where rapid tapping of page left / right could trigger a broken GUI pointer (crash).
*** This issue is now resolved.
* Improvements to feedback (sound + haptics).
** Both sound and haptics now use their own threads for improved reliability with event synchronization for improved performance.
* Numerous additional tweaks and unmentioned bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/7df15c9...v2.4.0 Full Changelog: 7df15c9...v2.4.0]

'''Version 2.3.0'''
* Numerous improvements to the notifications implementation.
** Notification options have been moved to the Notifications Menu (in System Settings).
** Multiple notifications can be shown at once (up to the <code>Max Slots</code> value).
*** When using 4MB overlay memory, max slots is capped at 4, otherwise it is capped at 8. (default value 4)
** API Notifications (formerly known as <code>External Notifications</code>) are formatted as follows:
<pre> {
"text": "This is an example notification.",
"font_size": 24, #optional
"split_type": "word" #optional, word by default
"alignment": "left", #optional, center by default without a title
"duration": 4000, #optional duration in ms
"title": "Example App", #optional, allows show_time
"show_time": "true", #optional, true by default
"priority": 20, #optional (ideally not modified)
}</pre>
*** Stored in <code>/config/ultrahand/notifications/{APP_ID}-{UNIQUE_ID}.notify</code> (JSON format)
*** API Notifications can be filtered with the existence of <code>/config/ultrahand/flags/notifications/{APP_ID}.flag</code>.
** Notification icons are now supported and must be 50x50 RGBA format with <code>{APP_ID}</code> matching the notification json.
*** <code>/config/ultrahand/assets/notifications/{APP_ID}.rgba</code>
** Package command <code>notify</code> / <code>notification</code> and <code>notify-now</code> / <code>notification-now</code> has been expanded.
*** <code>notify <MESSAGE> [FONT_SIZE] [TEXT_ALIGNMENT] [SPLIT_TYPE] [DURATION_MS] [TITLE] [SHOW_TIME] [APP_NAME]</code>
**** <code><MESSAGE></code>: the main notification message text. (only 4 lines can be displayed)
**** <code>[FONT_SIZE]</code>: an integer value in range 8 to 48 (24 by default with a title, 26 without a title).
**** <code>[TEXT_ALIGNMENT]</code>: either <code>left</code>, <code>center</code>, or <code>right</code>.
***** By default, without a title it is <code>center</code> and with one it is <code>left</code>.
**** <code>[SPLIT_TYPE]</code>: either <code>word</code> or <code>char</code>.
**** <code>[DURATION_MS]</code>: the duration for the prompt in milliseconds. (500 min, 4000 by default)
***** A duration value of 0 will keep the prompt displayed indefinitely until dismissal.
**** <code>[TITLE]</code>: a title for the notification.
**** <code>[SHOW_TIME]</code>: a <code>true</code>/<code>false</code> value for showing the timestamp alongside the title. (requires a title)
**** <code>[APP_NAME]</code>: allows the notification command to use an icon (used if present)
***** To use an app name without a title, title must be an empty string (<code>""</code>).
*** <code>notify-now</code> follows the same pattern as <code>notify</code> but always displays in slot 0 with immediate priority.
*** '''Sidenote:''' All <code>[]</code> parameters are optional and are interpreted based upon their value and order.
** New notification sound effect <code>/config/ultrahand/sounds/notification.wav</code>.
*** Users may need to re-apply the default theme for this new sound effect to load.
*** The <code>Silence Notifications</code> toggle disables notification sound effects.
** Notifications can be dismissed with <code>KEY_MINUS</code> clicks, as well as via direct touch.
** API toggle hotkey (hold <code>KEY_MINUS</code> for 4s) allows disabling API Notifications on demand easily.
*** The API toggle hotkey can be enabled / disabled in the Notifications Menu.
* New theme colors <code>notification_title_color</code>, <code>notification_time_color</code>, and <code>unfocused_color</code>.
** <code>notification_title_color</code> is the color for the notification titles.
** <code>notification_time_color</code> is the color for the notification timestamps.
** <code>unfocused_color</code> is the color <code>KEY_A</code>+" OK" is displayed with at the bottom of the overlay when no items are in focus.
* New package command <code>touch</code>, called <code>touch <PATH_TO_FILE></code>.
** Command creates an empty text file according to the file path if the file does not exist.
* New <code>Packages Menu</code> toggle (in Miscellaneous) for hiding the packages menu completely.
* Timestamp placeholder <code>{timestamp()}</code> (with no formatting parameter) can now also be called as <code>{timestamp}</code>.
* <code>System RAM</code> previews now automatically change with <code>Overlay Memory</code> adjustments in the System Settings menu.
* Sound effects can now use <code>8000 Hz</code>, <code>11025 Hz</code>, <code>16000 Hz</code>, <code>22050 Hz</code>, <code>32000 Hz</code>, and <code>44100 Hz</code> 16-bit PCM wav files in addition to <code>48000 Hz</code>.
* Feedback (haptics + sound) is now processed on its own background thread for improved performance and reliability.
* Improvements to haptics in handheld mode.
* Cleanup of language json's (removal of unused / unnecessary variables).
* Bug fix for internet connection checks in download calls.
* Various list class corrections / improvements.
* Various code optimizations, bug fixes, and improvements.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/f580fd9...v2.3.0 Full Changelog: f580fd9...v2.3.0]

Quick Update:
* JSON placeholder parsing bug fix (for allowing numerical / boolean conversions to strings). - 03/12/2026 11:26 PM PST
* Script Overlay no longer removes tags from ListItem commands (bug fix). - 03/12/2026 11:26 PM PST
* Notification timestamp positioning bug fix (for notifications with no icons). - 03/12/2026 11:42 PM PST
* Separator symbol coloring for notification text. - 03/13/2026 12:01 AM PST
* Notification touch dismissal in right-side mode bug fix. - 03/13/2026 1:12 AM PST

'''Version 2.2.9'''
* Overlay freeze bug fix triggered when entering the packages menu with '''GDB debugging''' enabled in Atmosphere.
** When <code>enable_htc = u8!0x0</code> and <code>enable_standalone_gdbstub = u8!0x1</code> are present in the <code>system_settings.ini</code>, prior versions can freeze / become unresponsive when entering the packages menu (or any package in general) while within an application / game.
** This was because <code>getBuildIdAsString</code> (updated among the general placeholders) was relying on <code>dmnt:cht</code> which conflicts directly with the standalone GDB stub.
* <code>libnx</code> has been updated to latest.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/c6a9c08...v2.2.9 Full Changelog: c6a9c08...v2.2.9]

Quick update:
* Build ID value correction (was pulled from wrong index). - 02/22/2026 12:49 PM PST 
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.9...f580fd9 Full Changelog: v2.2.9...f580fd9]

'''Version 2.2.8'''
* All language font glyphs are now accessible regardless of the specified language (<code>libultrahand</code> fix).
** Special thanks to [https://github.com/tomvita @tomvita].
* Packages can now utilize language translation json's (similar to <code>libultrahand</code> overlay language translations).
** Language json's go within the <code>lang</code> folder within the package's main folder and are utilized based upon the current selected overlay language.
** Translations are based upon <code>drawString</code> calls with keys being the original text and values being the translations.
* New package command option headers.
** <code>;state=</code> works with values <code>handheld</code> or <code>docked</code> and will only draw the list item if in handheld or docked accordingly.
** <code>;hos_version=</code> works with version values or with comparison signs <code>>=</code>, <code><=</code>, <code>></code>, <code><</code> + the specified version directly after.
** <code>;ams_version=</code> works with version values or with comparison signs <code>>=</code>, <code><=</code>, <code>></code>, <code><</code> + the specified version directly after.
*** Both <code>;hos_version=</code> and <code>;ams_version=</code> will only draw the command when the conditions are met.
** '''Side-note:''' All of these new command headers can be used in combination or isolation.
* New package placeholder variables.
** <code>{package_version}</code> returns the current package version from which the command exists in (specified in the header).
** <code>{backlight}</code> returns the current handheld backlight level.
** <code>{volume}</code> returns the current master volume level.
* New command <code>!path_exists</code> (similar to <code>path_exists</code> except it returns command failure if the specified path exists).
** Called <code>!path_exists <SPECIFIED_PATH></code>.
* Changes to root package boot package behavior (<code>/switch/.packages/boot_package.ini</code>).
** The <code>on-boot</code> entry now triggers specified commands once on system startup (similar to how <code>boot</code> used to function).
** The <code>boot</code> entry now triggers once when the <code>Packages Menu</code> is entered, as well as once on the <code>Packages Menu</code> after overlay hiding has triggered.
* New <code>Sounds</code> manager for selecting overlay system sound effects (bundled in .zip's).
** Sound zip packs go in <code>/config/ultrahand/.sounds/</code> (files must be around the same size as the default sounds pack).
** The <code>Sound Effects</code> toggle has been removed from the <code>Features</code> page.
** The <code>NO_SOUND_EFFECTS_UPDATES</code> update flag has now been removed (no longer necessary).
* Update to <code>Overlay Info</code>, with info properly translated in each supported language.
** New project developer animation on the "Software Update" page.
** Languages update command in the <code>Software Update</code> menu has been removed (now unnecessary).
* Text wrapping for tables has been significantly revised to properly handle asian characters on split as well as implement hyphens for other languages when split by character.
** Indent symbols for continued lines utilizing indents now properly indent their start position based upon the indentation of the previous line (for easier viewing of code).
* Scrolling category headers now properly resume scroll state during regular <code>goBack</code> calls (<code>libultrahand</code> fix).
* Now including patches from [https://github.com/averne/MasterVolume Master Volume] for unbounded volume sliding from 100% to 150% using the <code>volume</code> command.
* Download commands now verify internet access on network connection (to prevent hanging while on a network without internet access).
* The "hold A to execute" list item behavior has been reduced from 4s to 3s to trigger.
* TrackBar unlocking / locking feedback tweaks.
* Script overlay ''freeze'' bug fix (placeholder replacement infinite loop bug fix).
* Various boundary case fixes to the <code>List</code> class in <code>libultrahand</code>.
* Bug fix for package version labels not being displayed ''clean'' with <code>Clean Versions</code> enabled.
* Improvements to image rendering (<code>libultrhaand</code>).
* Various additional bug fixes and code optimizations.

Quick update:
* Sounds preservation on update bug fix. - 02/20/2026 2:14 AM PST
* <code>sdout.zip</code> empty folder inclusion bug fix - 02/20/2026 2:52 AM PST
* Master volume patch inclusion (was accidentally removed from the <code>sdout.zip</code>). - 02/20/2026 9:12 PM PST

'''Version 2.2.7'''
* Critical bug fix for touch navigation (crash fix).
** Touch navigation redirection for direct touch on list items utilizing <code>swapTo</code> (in <code>libultrahand</code> v2.2.3 -> v2.2.5) could trigger crashes randomly (pointer still referenced after deconstruction).
* New settings toggle for startup notifications (<code>Startup Notifications</code>; on by default).
** New restart notification for <code>nx-ovlloader</code> memory settings changes.
** Proper restart vs startup condition isolations.
* Notifications toggle has been renamed to <code>External Notifications</code> and will only be applied to JSON based notifications.
* The "hold A to execute" behavior now works via touch.
** Hold duration has been reduced to 4 seconds.
* Package command <code>pchtxt2cheat</code> now accepts names for the cheats being converted (fix).
** Called <code>pchtxt2cheat <SOURCE_PATH> [CHEAT_NAME]</code>.
* Table scrolling with <code>KEY_UP</code> / <code>KEY_DOWN</code> clicks have been slightly refined.
* Touch feedback refinements.
* Socket is now initialized and exited per download.
** This should free up more working memory / reduce memory pressure for packages and Ultrahand in general.
* Software updates now automatically reload Ultrahand on exit from the update menu (rather than on exits from the settings menu).
* Multiple list corrections, focus resuming, touch related bug fixes, and more.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.6...v2.2.7 Full Changelog: v2.2.6...v2.2.7]

Quick Update:
* Table scrolling bug fix. - 1/11/2026 1:03 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.7...e6e825d Full Changelog: v2.2.7...e6e825d]

'''Version 2.2.6'''
* Sequential placeholder replacement bug fixes (for package commands).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.5...v2.2.6 Full Changelog: v2.2.5...v2.2.6]

'''Version 2.2.5'''
* Critical bug fix for crashes on the packages / package menu when '''not connected to a network'''.
* <code>unpackDeviceInfo</code> sequencing correction.
* Added <code>curl_global_cleanup</code> to <code>exitServices</code> (to cleanup curl global resources on app exit).
* Buffer initialization correction for download / unzip functions.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/f4978f0...v2.2.5 Full Changelog: f4978f0...v2.2.5]

'''Version 2.2.4'''
* OverlayFrame titles now auto-scroll when too long or covered by the widget (just like subtitles).
* Copy, move, and delete wildcard commands now support <code>-filter <PATH_TO_TXT></code> (path to a text file containing a list of files / folders to be filtered from pattern resolution).
* <code>-filter</code> now properly resolves <code>./</code> and <code>../</code> paths and no longer require hardcoded <code>sdmc:/</code> in the file / folder paths.
* Bug fix for the ScriptOverlay on track-bars (was improperly utilizing the index / value).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/8bc9e73...v2.2.4 Full Changelog: 8bc9e73...v2.2.4]

Quick update:
* Removal of <code>;mode=</code>, <code>;grouping=</code>, and <code>;system=</code> pattern values from being cached in the package <code>config.ini</code> metadata and loaded (was unnecessary). - 12/15/2025 8:21 AM PST
* Slight tweak to json placeholder replacements to, when the key does not exist, assume the key is <code>null</code>. - 12/15/2025 12:56 PM PST
* Command footer highlight loading bug fix (when defined in the <code>config.ini</code> but not the <code>package.ini</code> command). - 12/15/2025 1:35 PM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.4...f4978f0 Full Changelog: v2.2.4...f4978f0]

'''Version 2.2.3'''
* Improvements to the <code>List</code> class in <code>libultrahand</code>.
** No more pointer caching (less memory usage, faster openings / list to list transitions, more consistent behavior).
** Proper "wall" handling for initial clicks that select the first / last ListItems (no instant wrap around until subsequent clicks).
** Theme variable <code>trackbar_color</code> is now <code>scrollbar_color</code> + new color <code>scrollbar_wall_color</code> (triggered when tapping ends of the list).
*** Updates to <code>ultra.ini</code> and <code>ultra-blue.ini</code> themes (as well as <code>default</code>).
**** Themes will need to be re-applied for changes to be applied.
** Fixes to the "immediate focus" implementation introduced in v2.2.2.
* New package command header <code>;footer=</code> and <code>;footer_highlight=</code>.
** <code>;footer=</code> allows users to pre-define a default footer value for a package command (to be used, stored, and set when no footer exists in the <code>config.ini</code> for the package.
** <code>;footer_highlight=</code> is a <code>true</code> / <code>false</code> parameter that will draw the footer with the highlight color when on.
*** <code>footer_highlight</code> is also a new key to be used in the <code>config.ini</code> for manually configuring the footer highlight for the command.
* Hold mode <code>;mode=hold</code> is no longer a command mode and can now be set for <code>default</code>, <code>option</code>, and <code>slot</code> commands via <code>;hold=true</code>.
** The default generated <code>package.ini</code> now uses this command header.
*** Users may want to delete their <code>/switch/.packages/package.ini</code> and have Ultrahand re-generate it if they are still using the old <code>package.ini</code>.
** '''Side-note:''' If using <code>;mode=hold</code>, users will need to update their commands to leverage <code>;hold=true</code> instead.
* Fixes to the placeholder parsing implementation.
** Proper handling and resolution sequencing of unresolved placeholders.
** Placeholder methods before the <code>_source</code> definitions are now carried over to the rest of the commands (rather than reset).
* Touch improvements to track-bars.
* Optimizations to command menu drawings.
* Various corrections, bug fixes, and improvements.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/ec26959...v2.2.3 Full Changelog: ec26959...v2.2.3]

Quick update:
* Footer package command header bug fixes (now to allow spaces). - 12/11/2025 3:57 PM PST
** Bug fix from prior changes. - 12/11/2025 5:20 PM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.3...8bc9e73 Full Changelog: v2.2.3...8bc9e73]

'''Version 2.2.2'''
* Proper fix for default combo initializations (on fresh installs).
** Launch combo is first checked and loaded from <code>/config/tesla/config.ini</code>.
** If the Tesla combo does not exist, and no combo in <code>/config/ultrahand/config.ini</code> exists, users can use the default Tesla combo (<code>L+DDOWN+RS</code>) or the default Ultrahand combo (<code>ZL+ZR+DDOWN</code>) for initializing their default combo.
*** Once initialized, Ultrahand will assume the combo the user used until changed in the Settings menu.
* Bug fix for returning from an overlay while touch is still in progress (multiple cursors).
** If foreground is in focus and a button is clicked while touch is in progress, input will now be prevented (with button click feedback).
* Bug fix for returning to the overlay menu after using an overlay launch combo and exiting the overlay (<code>KEY_B</code> click).
** Before the <code>jumpToItem</code> implementation would kick in on the next launch of Ultrahand after closing the overlay, causing the cursor to shift unnecessarily to the last open overlay title on the overlay menu.
* Bug fix for widget settings not auto-loading on first fresh install launch.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.1...v2.2.2 Full Changelog: v2.2.1...v2.2.2]

Quick update:
* Overlay frame top/bottom synchronization bug fix (for invoking the script overlay). - 12/07/2025 4:01 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.2...ec26959 Full Changelog: v2.2.2...ec26959]

'''Version 2.2.1'''
* New command mode <code>;mode=hold</code> for triggering a "hold A to execute" type response (similar to <code>default</code>).
** The pre-generated <code>package.ini</code> now utilizes <code>;mode=hold</code> for its shutdown command.
* New commands <code>set-ini-val-matching-key</code>, <code>remove-ini-key-matching-key</code>, and <code>path_exists</code>.
** <code>set-ini-val-matching-key</code> will set an ini value to all ini sections that include the matching pattern key.
*** Called <code>set-ini-val-matching-key <FILE_PATH> <PATTERN_KEY> <DESIRED_KEY> <DESIRED_VALUE></code>.
** <code>remove-ini-key-matching-key</code> will remove all key value pairs from an ini from sections that include a matching pattern key.
*** Called <code>remove-ini-key-matching-key <FILE_PATH> <PATTERN_KEY> <DESIRED_KEY></code>.
** <code>path_exists</code> will return command success or failure based upon if the path provided exists or not.
*** Called <code>path_exists <PATH></code>.
*** Can be quite useful when chained within <code>try:</code> blocks.
* Placeholder replacement improvements for chaining with a source command.
** In addition to <code>ini_file</code> (like before), users can now use the full catalogue of placeholders and chain them with their <code>_source</code> method definition.
** Various improvements to placeholder replacements.
* Slight refinements to <code>list_file_source</code> to include newlines when chained with tables.
** Slight formatting improvements for tables on the <code>ScriptOverlay</code>.
* New package [https://github.com/ppkantorski/Memory-Kit Memory Kit] (latest revision of the old [https://github.com/ppkantorski/Ultrahand-Overlay/tree/main/examples/Memory%20Config Memory Config] package example; Ultrahand v2.2.1+ only).
** This package includes the <code>mesosphere.bin</code> [https://github.com/Craftyawesome/Atmosphere/tree/memory-hack memory hack] (<code>1.85 MB</code> + <code>stripped</code>).
*** Keep in mind that the <code>stripped</code> version will break the web browser, which will cause crashes on certain games and apps that utilize the web browser.
*** The <code>1.85 MB</code> version however should not have any issues.
** Regular users should ''not'' touch the <code>Configure Commands</code> tab as it is strictly available for development and testing of memory configurations for <code>libultrahand</code>.
* New base64 decoding placeholder.
** Called <code>{base64_decode(<ENCODED_STRING>)}</code> .
* Improvement to haptics (stronger and more consistent feedback).
* Bug fix for combos on forced <code>AMS v1.10+</code> support overlays.
** Combos were not working properly for overlays with forced support.
** Forced AMS v1.10+ support is '''not recommended''', but can still be used with manual patching overlay binaries.
*** It is highly recommended that all overlays get recompiled for proper AMS v1.10+ support.
* New unsupported warning notification displayed when trying to launch an unsupported overlay.
* All pages now get drawn with the cursor automatically set (no cursor flickering into view).
* Bug fix for sluggish table scrolling after triggering a jump / wrap to bottom.
* Bug fix for exit sound + haptics kicking in when combo launching an overlay during a notification.
* Bug fix for degrees symbol on Chinese fonts.
* Slight optimizations to <code>stbtt_FindGlyphIndex_impl</code>.
* Various additional tweaks, bug fixes and corrections.

'''Version 2.2.0'''
* New overlay heap size configurations with automatic reloads (in the <code>System Settings</code> menu).
** Default heap size for HOS 21+ is now set to 4MB (displayed as <code>nx-ovlloader-</code>).
*** Although rare, some overlays may not work properly on 4MB (without a fix implemented).
**** To fix some of these overlays, they should be using <code>socketInitialize</code> instead of <code>socketInitializeDefault</code> (if utilized).
**** Overlays should also not be utilizing a full 1280x720p framebuffer when on 4MB.
** Default heap size for HOS 20 is now set to 6MB (displayed as <code>nx-ovlloader</code>).
** Default heap size for HOS 19 and lower is now set to 8MB (displayed as <code>nx-ovlloader+</code>).
** Users can also add a 4th higher option by adding to <code>/config/ultrahand/config.ini</code> a new section <code>memory</code> with key <code>custom_overlay_memory_MB</code> and an integer value (2MB intervals greater than 8MB only).
*** After adding that entry, a 4th memory option will appear (displayed as <code>nx-ovlloader×</code>).
** If Ultrahand deems there is not enough memory (at least 5.3 MB free after potential changes), then changes will not be applied.
* Users can now completely exit the overlay system from the <code>System Settings</code> menu.
** This will recover all memory consumed by <code>nx-ovlloader</code> / <code>Ultrahand Overlay</code>.
** Users can then use <code>Ultrahand-Reload.nro</code> from homebrew launcher (now bundled with <code>nx-ovlloader</code>) to restart / reset <code>nx-ovlloader</code> without rebooting.
* Commands <code>move</code>, <code>copy</code>, <code>delete</code>, and <code>dot-clean</code> memory optimizations.
** Larger deletes, moves, and copies than <code>v2.1.8</code> are now possible (even on a 4MB heap).
** <code>dot-clean</code> now also removes all <code>.DS_Store</code> files for the specified directory (and subdirectories).
* Now bundled with [https://github.com/ppkantorski/nx-ovlloader/releases/tag/v2.0.0 nx-ovlloader v2.0.0] (which includes the new helper module [https://github.com/ppkantorski/nx-ovlreloader nx-ovlreloader]).
** <code>nx-ovlloader+</code> compilation has been discontinued (no longer necessary).
** The <code>nx-ovloader+</code> zip on <code>v2.0.0</code> is the same as <code>nx-ovlloader</code>.
*** It is provided for now during a grace period to ensure users can easily update from the system settings menu.
*** In the future after <code>nx-ovlloader v2.0.0</code>, if not on Ultrahand Overlay v2.2.0+, update methods ''might'' be broken.
** '''Side-note:''' Users no longer need the <code>/config/ultrahand/expansion/</code> folder and can safely delete it after updating.
* Software updates now have the option to download a temporary <code>update.ini</code> command file (if provided on release) for micro managing the installation / update process.
** Software updates instructions have also been slightly reworked for easier management.
* Command <code>exec</code> now can be called with any package ini file (in addition to <code>boot_package.ini</code> like before).
** Users can call this with <code>exec <ENTRY_NAME> [ULTRAHAND_INI_FILE_PATH]</code>.
*** <code>ULTRAHAND_INI_FILE_PATH</code> in this case is an optional parameter, the path to the package ini file containing the command entry.
*** When not provided, it will assume commands from <code>boot_package.ini</code> (just like before).
* Slight improvements to notifications (new <code>tsl::notification->showNow</code> implementation).
** This allows instant display of the notification without waiting for the last notification to transition.
** Packages can also use <code>showNow</code> via <code>notify-now</code> or <code>notification-now</code> (called the same way as <code>notify</code> / <code>notification</code>).
* Sound effects now work on 6MB+ overlay heap sizes (disabled on 4MB).
* Improvements to TrackBar touch.
* Improvements to touch haptics (now to trigger on touch).
* Improvements rounded rects and circles (slightly more refined AA).
* Changes to socket initialization for improved memory usage (enables downloads on 4MB and improved memory).
* Bug fix for haptics becoming disabled after sleep.
* Bug fix for <code>;display_title=</code> in packages interfering with proper returns to the last selected list item on the menu (as seen with returning from <code>Alchemist</code>).
* Various tweaks, optimizations, bug fixes, and corrections.

Update:
* Bug fix for software updates from v2.2.0 forwards. - 11/28/2025 8:36 PM PST
** New command <code>download-no-retry</code> for download commands with zero retry attempts.
** More accurate failed download detections.

'''Version 2.1.8'''
* AMS 1.10.0+ and HOS 21 support.
** Overlays not recompiled with latest <code>libnx</code> no longer work without manual force enabling (potentially dangerous).
** Unsupported overlays can now be hidden (toggle is within the settings menu).
*** '''Important:''' All homebrew on <code>AMS 1.10+</code> must to be recompiled with latest <code>libnx</code> for properly ensured support.
* Anti-aliasing is now applied to rounded rects, uniform rounded rects, bordered rounded rects, and circles.
** Overall smoother, less pixelated / jagged edges.
* Slightly improved wallpaper loading speed + menu opening speed.
* Memory expansion toggle / notification bug fix.
* Initial state bug fix for main settings menu toggles.
* Bug fix for ini file saving. (buffer was too large)
** This fixes the <code>open</code> overlay command in Ultrahand packages.
* Bug fix for ini file parsing not returning <code>null</code> on failed parsings.
* Fixed Chinese font selection to ensure all glyphs display correctly on Traditional Chinese systems.
** Special thanks to [https://github.com/BadFish-HSrui @BadFish-HSrui].
* <code>nx-ovlloader</code>/<code>nx-ovlloader+</code> has now been updated (v1.1.2) for AMS 1.10+ support.
** '''Important:''' Double check that you are on v1.1.2 BEFORE updating AMS (if you choose to).
* <code>libnx</code> has been manually recompiled with <code>-Os</code> as well as several other code generation optimizations.
* Various minor bug fixes and corrections.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.7...v2.1.8 Full Changelog: v2.1.7...v2.1.8]

Quick Update:
* Removal of pre-release status. - 11/15/2025 6:04 PM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.8...e84de59 Full Changelog: v2.1.8...e84de59]

'''Version 2.1.7'''
* Bug fix for notification text being drawn transparent when hidden (related to the global alpha limiter).
* Bug fix for toggling <code>Memory Expansion</code> preventing users from exiting the Ultrahand settings menu.
* Ini method optimizations (faster loading).
* Proper menu return to last selected overlay / package when version labels are hidden.
** A unique ID is now used to facilitate precise returns.
* Widget backdrop now utilizes the alpha limiter.
* Language config map (for the initial and repeated parsing of languages) is no longer static.
** This should free up more memory in the global heap.
* Slight improvements for haptics initializations (to prevent failed initializations that sometimes happen on first boot).
* Various minor code optimizations.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.6...v2.1.7 Full Changelog: v2.1.6...v2.1.7]

'''Version 2.1.6'''
* Proper return to the last selected item after changing settings in the main Ultrahand settings menu.
** Ultrahand settings menu can also now be entered from the hidden overlays / packages page.
* Improved shake highlight animation.
* Faster wallpaper loading.
* Various rendering optimizations.
* Global alpha limiter for glyph rendering.
** This will improve appearances when transitioning shown to hidden and vise versa.
** renderer->a is no longer needed for drawString calls in libultrahand.
* Bug fix for click animation not triggering on toggle list items.
* Various code optimizations (8kb smaller than v2.1.5).

'''Version 2.1.5'''
* New haptic feedback and sound effects options in <code>Features</code> under <code>Miscellaneous</code> in the settings menu.
** Haptic feedback is off by default.
** Sound effects are on by default, but require [https://github.com/ppkantorski/Ultrahand-Overlay/tree/main/sounds sound files] to be added to <code>/config/ultrahand/sounds/</code>.
*** Users updating to v2.1.5 must run <code>Update</code> from the <code>Software Update</code> page one more time after updating for the included sound effects to be properly installed.
*** Users can manually disable updates of the sound effect files by adding a file named <code>NO_SOUND_EFFECTS_UPDATES.flag</code> into <code>/config/ultrahand/flags/</code>.
** Sound effects are only enabled on <code>nx-ovlloader+</code>, not regular <code>nx-ovloader</code>.
** '''Sidenote:'''
*** Sounds and haptics will also be applied to every overlay compiled with <code>libultrahand v2.1.5+</code>.
*** Sound files must be relatively small to prevent memory related issues and keep latency low.
** Special thanks to [https://github.com/sskyNS @sskyNS] for help with identifying the correct audio services implementation.
* Transition bug fixes for cached <code>List</code> frames.
** These fixes ensure the overlay list changes are synchronized with the top and bottom parts of the OverlayFrame during menu transitions.
* Various refinements and bug fixes to the download file command.
** Buffer sizes have been tweaked, memory related improvements applied, and boundary case crashes resolved.
* Memory related improvements for <code>copy</code> and <code>move</code> commands running on the interpreter thread.
* The "Selection is empty!" message is now properly centered, and applied to the overlay menu when no overlays have been added.
** This ensures that translations are properly centered text instead of drawing text misaligned.
* Memory related improvements to wallpaper loading / reloading.
* Cleanup of notification processing queue.
* Cleanup of screenshots and recording layer initializations.
* Various code refinements, bug fixes, and tweaks.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.4...v2.1.5 Full Changelog: v2.1.4...v2.1.5]

Quick Update:
* Overlay exit sound to respect the disable sound effects preset. - 11/03/2025 9:37 PM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.5...3670712 Full Changelog: v2.1.5...3670712]

'''Version 2.1.4'''
* New <code>sdout.zip</code> distribution, bundled with all components and dependencies (up-to-date) for easier SD card installations.
** Installs <code>nx-ovlloader+</code> by default, but users can toggle off <code>Memory Expansion</code> after installing for regular <code>nx-ovlloader</code>.
* New build ID placeholder variable <code>{build_id}</code>.
* New system region setting command <code>set-region <REGION></code>.
** <code><REGION></code> is either <code>JPN</code>, <code>USA</code>, <code>EUR</code>, <code>AUS</code>, <code>HTK</code>, or <code>CHN</code>.
** '''Side-note:''' Reboot is required for changes to apply.
* Bug fix for <code>refresh wallpaper</code>.
* Various code optimizations and restructurings.
* Stability related bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.3...v2.1.4 Full Changelog: v2.1.3...v2.1.4]

'''Version 2.1.3'''
* Bug fixes for regular toggles (state was not being preserved in <code>config.ini</code>).
* Bug fixes for toggles in the root package (<code>/switch/.packages/package.ini</code>).
* Restoration of the <code>{index}</code> source function placeholder (was accidentally removed at some point over time).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/855f0d1...v2.1.3 Full Changelog: 855f0d1...v2.1.3]

'''Version 2.1.2'''
* Rendering bug fix for regular <code>TrackBar</code> objects / uniform rounded rects.
** Uniform rounded rects in some circumstances when drawn off screen could cause crashes.
** '''Side-note:''' Did not affect <code>StepTrackBar</code>/ <code>NamedStepTrackBar</code>.
* Left / right sensitivity fix for value transitions on regular <code>TrackBar</code> objects have been adjusted for precision.
* Various method restructurings.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/7b8de7f...v2.1.2 Full Changelog: 7b8de7f...v2.1.2]

Quick update:
* TrackBar touch highlight style improvements. - 09/30/2025 3:04 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.2...855f0d1 Full Changelog: v2.1.2...855f0d1]

'''Version 2.1.1'''
* Toggles now utilize the interpreter thread with state change only applied for successful completion.
* New true/false command option ;progress= for toggle commands to show the command in progress throbber.
* Memory related improvements to move/mv with file logging and compare.
** This fix enables base loader to properly handle large move commands with proper file logging (as seen in Alchemist's content manager).
* Bug fix for {local_ip} placeholder not returning the local IP address.
* Various minor code optimizations.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.0...v2.1.1 Full Changelog: v2.1.0...v2.1.1]

Update:
* Overlay sort priority bug fix.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.1.1...7b8de7f Full Changelog: v2.1.1...7b8de7f]

'''Version 2.1.0'''
* New system notifications implementation.
** There are 3 ways to interface with system notifications.
*** a. '''Ultrahand Package''': <code>notify <MESSAGE> [FONT_SIZE]</code> or <code>notification <MESSAGE> [FONT_SIZE]</code>
*** b. '''Direct <code>libtesla</code> calls:''' <code>tsl::notification->show(<MESSAGE>, [FONT_SIZE], [PRIORITY]);</code>
*** c. '''External json calls''': <code>{"text": <MESSAGE>, "font_size": [FONT_SIZE], "priority": [PRIORITY]}</code>
** Font size is an optional parameter, default value <code>28</code>.
** Priority is an optional, with jsons always assume priority <code>10</code> while Ultrahand packages / direct calls assume priority <code>20</code>.
** Creation time for jsons is auto prioritized for everything within the same priority level.
** For external json calls, jsons can be written to <code>/config/ultrahand/notifications/<PROGRAM_ID>-<UNIQUE_ID>.notify</code>.
*** This function allows any program, including sys modules, to interface with the notification prompts.
** New theme color for notification text: <code>notification_text_color</code>
** '''Notice:''' Overlays must be compiled with the latest <code>libultrahand</code> for system notifications within those overlays.
* New overlay / package setting option to delete an overlay / package. (Hold A to Delete)
* New <code>Miscellaneous</code> options for toggling on / off notifications and show delete.
* New notifications for startup, new version detection, and when reboot is required for changes to apply.
* New page for empty selection commands.
* New placeholder variable for returning the current local ip address, called <code>{local_ip}</code>.
* New package header option <code>;display_title=</code> for displaying an alternative in package display title.
* Category headers now auto-scroll right to left for extended text.
* Improvements to package memory usage.
** Pages are no longer held up in memory for deeper menu navigation.
* Improvements to <code>dot-clean</code>, faster file processing completion.
* Improvements package item <code>jumpToItem</code> calls.
** Full command names, including tags, are now properly utilized for specific item name isolations.
* Package settings now groups various package options into an <code>Options</code> category.
* Command file / folder paths can now properly use <code>..</code> to specify the directory above a current folder.
** i.e. './../test/' will return the folder named <code>test</code> above the current directory the package ini is currently running from.
* Settings and favorites buttons are now displayed on the menu within the <code>Packages</code> and <code>Overlays</code> category headers.
* Bug fix for wallpaper alpha when hiding overlays.
** Proper fading with alpha transitions.
* Interpreter thread bug fixes for safer rapid launches.
* Bug fixes for the command parser; proper order of operation resolution for nested placeholder replacements.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/a3a4519...v2.1.0 Full Changelog: a3a4519...v2.1.0]

'''Version 2.0.1'''
* Overlay interaction (including button combinations) is now strictly limited to handheld mode controller as well as the player 1 controller.
** In the past, when other controllers click buttons, because the overlay looked for all controller inputs the sum of all buttons being clicked could trigger the menu or launch a combo unintentionally.
** This fix was set in <code>libultrahand</code>, so all overlays compiled with it will now include this fix.
* Underscan and "right-side mode" bug fixes and adjustments.
** Users no longer need to exit the overlay for the underscan fix to correct the overlay dimensions (auto-corrections).
** Right-side mode is auto applied now when clicked in the settings menu with no need to reload.
** Fix is also in <code>libultrahand</code>, so it will apply to all newly compiled overlays.
* Launch combo mode settings is now rendered within its own dropdown instead of being drawn directly within the root of overlay setting's menu (when specified).
* Various minor corrections.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/8a7904e...a3a4519 Full Changelog: 8a7904e...a3a4519]

'''Version 2.0.0'''
* New combo package launcher (similar to the overlay launcher).
** Users can set any package to key combos.
** New <code>Quick Launch</code> package setting (for disabling <code>Boot Commands</code> for the package during combo launches).
** More button combinations have also been added to the list.
* New command <code>open</code> for opening overlays (with or without launch arguments) from the package menu.
** Called <code>open /path/to/overlay.ovl {LAUNCH_ARGUMENT_1} {LAUNCH_ARGUMENT_2} {...}</code>
** Overlays can now be compiled to handle specific tasks for Ultrahand packages.
* Buttons <code>ZL</code> and <code>ZR</code> will now skip the menu exactly one viewport's distance up or down.
** Multiple clicks and hold will trigger rapid page skipping.
** This should allow for quicker and easier menu navigation, as well as table scrolling.
* New atmosphere updater functionality.
** To use, copy / move / unzip files into place as you would expect (overwriting stratosphere and package3 in <code>/atmosphere/</code>).
*** Instead of being overwritten, the files will be assigned a <code>.ultra</code> extension.
** After files have been moved into place, any <code>reboot</code> command will automatically trigger the Ultrahand Updater payload.
*** This payload is downloaded once the moment <code>reboot</code> is ran after installing Atmosphere as well as during software updates.
*** Users must reboot from Ultrahand Overlay itself for changes to apply.
* <code>libultrahand</code> detection for overlays compiled with <code>libultrahand</code>.
** Highlight colors for overlays with <code>libultrahand</code> functionality.
** Recompilation of all <code>libultrahand</code> overlays is needed with the new Ultrahand signature added (see <code>Makefile</code>).
* New command <code>dot-clear</code>, called <code>dot-clear <PATH_TO_BE_CLEARED></code>.
** This command will remove all metadata files that begin with <code>._</code> from any specified directory (as well as all subdirectories).
** This is useful for users who transfer files and mods over to their SD card from macOS.
*** '''Side-note:''' These metadata files can cause issues with mods, so clearing them can be quite useful.
* New theme color configurations and updates to the default theme as well as <code>ultra.ini</code> and <code>ultra-blue.ini</code>.
** <code>banner_version_text_color</code>: Default color of the version label below the Ultrahand title.
** <code>overlay_text_color</code>: Default color for overlay titles.
** <code>overlay_version_text_color</code>: Default color for overlay versions.
** <code>ult_overlay_text_color</code>: Default color for libultrahand compiled overlay titles.
** <code>ult_overlay_version_text_color</code>: Default color for libultrahand compiled overlay versions
** <code>package_text_color</code>: Default color for package titles.
** <code>package_version_text_color</code>: Default color for package versions.
** <code>ult_package_text_color</code>: Secondary color for package titles.
** <code>ult_package_version_text_color</code>: Secondary color for package versions.
** <code>text_separator_color</code>: Default color for text separator symbols.
** <code>selection_value_text_color</code>: Default color for the selection value.
*** '''Side-note:''' Users may want to re-apply the default theme once for some of the changes to apply.
* Proper input isolation so menu navigation buttons do not interfere with combos and vise versa.
* Thread safe ini, hexing, file operations, and page swapping.
** New libultrahand command <code>swapTo</code> to safely handle swapping between pages (goBack / pop + changeTo).
* The <code>Miscellaneous</code> settings menu has been re-organized and now includes <code>Theme Settings</code>.
** Theme settings includes options that allows you to toggle on and off various theme configurations.
* On return from within package dropdowns / forwarders, the page is now automatically refreshed.
** All command footers and tables will automatically redrawn.
* Package headers can now utilize <code>;show_widget=true</code> for rendering the widget.
* Dropdown menu commands can now utilize <code>;mode=slot</code> for changing the dropdown symbol to the option symbol.
* Software update now installs <code>nx-ovlloader / nx-ovlloader+ v1.1.1</code> (latest release).
** Bug fixes for rapid overlay swapping, reduced file io calls, better memory mapping, and slight optimizations.
* Language changes are now instantly applied to the menu from within the language selection.
* Faster menu drawing.
* Buffer sizes for <code>nx-ovlloader+</code> (memory expansion) are now loaded immediately during overlay launch.
** Slight buffer size tweaks for base loader.
* Slight improvements to <code>Swipe To Open</code>.
* Slight redesigns to various text components within the overlay.
* Rendering related fixes and improvements.
* Fixes to file list generation from copy and move to include subdirectories.
** This functionality allows <code>Mod Alchemist</code> to properly handle the removal of folders when appropriate for toggling content mods.
* Numerous bug fixes, memory optimizations, navigational fixes and alignment corrections.
** Significantly reduced memory pressure throughout numerous methods.
** Countless code optimizations and better memory handling.
** Bug fix for step track-bar values vanishing.
** Touch related fixes (long touch and release).
** Dangerous pattern bug fixes.
** <code>json_file</code> / <code>json_file_source</code> bug fixes.
** Many other fixes not mentioned.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/2602970...v2.0.0 Full Changelog: 2602970...v2.0.0]

Quick update:
* Transparent screenshot cursor opacity bug fix. ~ 8/6/2025 12:11 PM PST

'''Version 1.10.0'''
* Expansion of the overlay key combo launcher implementation.
** New launch argument modes implementation.
*** Users can add launch argument modes to overlay entries in <code>/config/ultrahand/overlays.ini</code>.
*** For example, for <code>mini</code> and <code>micro</code> entry points on my [https://github.com/ppkantorski/Status-Monitor-Overlay/releases/tag/v1.1.9%2Br4 Status Monitor fork], users can add <code>mode_args=(-mini, -micro)</code> as well as <code>mode_labels=(Mini, Micro)</code> for labeling them.
*** After adding <code>mode_args</code> (or <code>mode_args</code> and <code>mode_labels</code>) new mode options will appear within the overlay settings menu (<code>Y</code> on an overlay).
** All <code>libultrahand</code> compiled overlays (compiled with v1.10.0+) now allow for quick launches.
*** This means you can jump from one overlay / overlay mode to another without ever returning to <code>ovlmenu.ovl</code>.
** Pressing the combo used to launch the overlay will now also return users back to <code>ovlmenu.ovl</code>.
** Setting combos will now also instantly be applied (no need to exit the menu).
** You can now also be anywhere within Ultrahand and trigger an instant jump to any overlay / overlay mode using key combos.
* New <code>Launch Combos</code> global toggle in the <code>Miscellaneous</code> settings menu.
** This will disable all overlay launch combos from working.
** Can be useful if you are playing a game that demands lots of button combinations.
* Critical bug fixes for menu navigation.
** The <code>ScriptOverlay</code> was actually still broken in v1.9.10 on certain menus.
** These fixes address a lot of potential mishandling of pointers in <code>main.cpp</code>.
* Unzip commands have been improved and are now less prone to errors.
* Commands in progress will now properly hit 100% instead of going from 99% to complete.
* Cursor center focus has been slightly lowered.
** This prevents ''slight'' scrolling from kicking in after hitting the 4th item on the list.
* Slight re-organization of the <code>Miscellaneous</code> settings menu.
* The overlay / package settings menu now displays the version, with slight formatting improvements.
* Changing the sort priority for overlays / packages now triggers an immediate jump to the item being sorted upon return.
* Various alignment corrections and bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.10...2602970 Full Changelog: v1.9.10...2602970]

'''Version 1.9.10 Quick patch (stability update)'''
* Restoration of the <code>ScriptOverlay</code> (minus on a command).
** There was a lingering issue within the <code>List</code> class that was causing mis-handlings of the cached items for certain menus upon return.
*** This issue should be resolved now.
* Potential memory leak bug fix for aborted <code>unzip</code>/<code>download</code> commands.
* Smoother text scrolling (for list items with long text).
* Slightly improved color sampling for the cursor blink effect.
* Slight optimizations to the <code>handleRunningInterpreter</code> input handler.
* Removal of unused variable declarations in the <code>MainMenu</code> class.
* Slight alignment corrections to the table background.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/8ee2844...v1.9.10 Full Changelog: 8ee2844...v1.9.10]
* More widget options have been added to the settings menu.
** New toggle for disabling dynamic temperature colors.
** New toggle for forcing center text alignment (on by default).
*** When off, text alignment will be set to the right (like before v1.9.8).
** New toggle for extended backdrop (off by default).
*** This is an alternative style choice to the backdrop that some users may prefer.
** Widget menu has also now been broken up into "Widget Items" and "Widget Settings".
** Widget positioning and alignments have also been corrected.
* Important navigational bug fixes (memory leak fixes).
** Page swapping (including rapid page swapping), list deconstruction, and management of list item cache have been significantly cleaned up to prevent crashes.
** These changes should prevent lingering navigational memory related issues from randomly occurring.
* New theme color configurations.
** <code>temperature_color</code>: color for temperatures on the widget with dynamic colors disabled.
** <code>battery_charging_color</code>: color for the power indicator on the widget with the battery charging.
** <code>battery_low_color</code>: color for the power indicator on the widget when battery is below 20%.
** Propagation of <code>version_text_color</code> to apply to overlay and package versions on the menu (in addition to the <code>Ultrahand</code> / <code>nx-ovlloader</code> version displayed below the logo).
* Improved dynamic logo with higher resolution color sampling (smoother gradient color progression).
* New alpha fix for screenshots taken with <code>Opaque Screenshots</code> set to off.
** This sets the alpha for certain elements to 14, others to 15 to make screenshots with transparency look more accurate.
* Slight changes to default theme.
** Table background has been reset to a darker shade of gray.
** '''Side-note:''' Default theme must be re-applied for changes to occur.
* Various alignment corrections and bug fixes.
* '''Notice:''' Next version is currently planned to be v1.9.10, so don't get your hopes up for v2.0.0 quite yet.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/3c6125a...v1.9.9 Full Changelog: 3c6125a...v1.9.9]

Quick update: (cosmetic)
* Slight alignment fix to the widget / widget backdrop (1 pixel shift). ~ 7/6/2025 8:46 AM PST
* Script overlay has been temporarily disabled to prevent issues. ~ 7/6/2025 10:25 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.9...8ee2844 Full Changelog: v1.9.9...8ee2844]
* '''Warning:''' The script overlay is currently not working right (minus on a command). I am working on a fix. For now do not use this function.

'''Version 1.9.8'''
* Important bug fix for <code>pchtxt2ips</code> conversion not properly naming the ips files.
** This issue came up because of the <code>NO_FSTREAM</code> directive change in v1.9.7 (was not properly handled).
** '''Side-note:''' Conversion of pchtxt's in v1.9.7 is bugged so v1.9.8 is recommended (for usage with <code>Mod Alchemist</code>).
* Various UI improvements to the widget.
** Widget text are now centered instead of aligned to the right.
** New widget backdrop implementation for highlighting the widget region with a uniform rounded rectangle.
*** This makes the widget easier to see with certain wallpapers, or transparencies.
*** Located in <code>UI Settings > Widget</code> (on by default).
*** New theme color settings <code>widget_backdrop_color</code> and <code>widget_backdrop_alpha</code>.
* The default theme has some new color changes.
** For changes to be applied, users must re-apply the default theme in the settings menu.
** There are also a couple minor changes in <code>ultra.ini</code>.
* Screenshot opacity implementation has been cleaned up.
** Longer opacity delay as well as cleaner click and release state handling.
* Shake highlight implementation bug fixes and top / bottom of list triggering.
** Clicking left on the overlay page or right on the packages page now triggers the shake highlight effect (like before v1.9.7).
** Holding down / up and hitting the last / first item will now triggers a shake highlight in the direction you are traversing from (new).
* Bug fix for certain theme color changes not fully being applied after application and returning to main menu.
* Rendering methods have been optimized again (very slightly faster than v1.9.7).
* Various alignment corrections and bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.7...v1.9.8 Full Changelog: v1.9.7...v1.9.8]

Update:
* Revert of new screenshot opacity implementation. - 07/03/2024 4:53 AM PST
** The issue was if a capture event gets missed, the opacity might never reset.
** A simpler, better fix is just to set opacity duration to 1.5s.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.8...3c6125a Full Changelog: v1.9.8...3c6125a]

'''Version 1.9.7'''
* Improved <code>download</code> and <code>unzip</code> commands.
** Library <code>zzip</code> has been migrated to <code>minizip</code> for improved compatibility (as well as z64 support).
** Tested with near 4 GB downloads (FAT32 limit) as well as files within zips.
*** Also tested with zips containing thousands of files.
* Buffer calibrations for <code>download</code>, <code>unzip</code>, <code>copy</code>, and <code>hex</code> functions.
** Calibrations have been set for <code>nx-ovlloader</code> and <code>nx-ovlloader+</code> based upon available heap memory.
** <code>nx-ovlloader</code>:
*** '''Download:''' 128 KB read, 32 KB write
*** '''Unzip:''' 128 KB read, 32 KB write
*** '''Copy:''' 64 KB read / write
*** '''Hex:''' 64 KB read
** <code>nx-ovlloader+</code>:
*** '''Download:''' 256 KB read, 128 KB write
*** '''Unzip:''' 256 KB read, 128 KB write
*** '''Copy:''' 256 KB read / write
*** '''Hex:''' 256 KB read
** The result is faster downloads / unzips / copying / hexing and less memory issues.
*** Optimizations in this revision have lead to more heap memory available overall.
* The selection overlay (sourced commands) has been optimized.
** Improved memory management for usage with <code>nx-ovlloader</code> (base loader).
*** Base loader will now only draw up to 250 list items to prevent crashes.
**** '''Side-note:''' Keep in mind that if you have more than 250 items on the page, you will not be seeing everything.
**** <code>nx-ovlloader+</code> however has this draw limit uncapped.
* Library migration for <code>jansson</code> to <code>cJSON</code>.
** <code>cJSON</code> compiles smaller and should be faster for the use cases within Ultrahand.
* Now compiled without <code>fstream</code> (<code>NO_FSTREAM</code> directive), utilizing <code>stdio.h</code> instead.
** This should be faster and help keep compilation size smaller.
* Optimizations and fixes to various rendering methods.
** The result is very slightly faster rendering than v1.9.6 with less potential issues.
* Across the board optimizations to all <code>libultra</code> methods.
** Improved ini, hex, path, and json functions.
** Bug fixes for <code>NO_FSTREAM</code> directive.
* Slight cleanup of lingering visual annoyances within the <code>List</code> class.
** This fixes the menu not returning all the way to the top after scrolling.
** Fix for menu auto jumping to top / bottom when pressing into a table at the very bottom / top instead of scrolling to the end.
** Slightly improved table scrolling.
** Removal of unnecessary internal methods.
** Memory leak bug fix for rapid page swaps (faster than it can draw).
* Bottom touch regions have been properly aligned based upon the text.
** This should keep the touch regions clean and uniform regardless of language changes.
* New flag option for disabling the auto update of <code>nx-ovlloader</code>/<code>nx-ovlloader+</code> during the software update command.
** To use this, add a file (can be empty) named <code>NO_LOADER_UPDATES.flag</code> into <code>/config/ultrahand/flags/</code>.
** '''Side-note:''' Be cautious of using this, because once the flag has been added, Ultrahand will not be updating <code>nx-ovlloader</code>.
* For interpreter in progress with downloads / unzips / large copies, the bottom menu bar will now display <code>Hide</code> and <code>Cancel</code> with proper touch integration.
* Cleanup of <code>unique</code> and <code>shared</code> pointers in <code>main.cpp</code> to now purely utilize raw pointers instead.
* The glyph cache will now be cleared automatically when you enter Ultrahand packages as well as the selection overlay.
** This prevents the glyph cache from getting too large after entering tons of pages. (potential memory leak)
* The <code>Script Overlay</code> now displays the package forwarder commands.
* New language variable for abbreviated <code>Overlays</code>, for drawing on the bottom touch region.
** This will be helpful for languages with large translations of this word.
* Faster wallpaper loading.
* Removal of all <code>.reserve</code> declarations throughout the project.
** From extensive testing, it appears that memory reservations have been contributing to heap overload and memory leaks.
* Revert of all <code>__builtin_</code> memory related methods back to their <code>std</code> counterpart.
** For the use cases within the project, the builtin appears to be less ideal since in many circumstances size is not determined during compilation.
* Bug fix for memory expansion toggle.
** <code>nx-ovlloader+</code> was not auto-applying upon the first click (with no expansion zips initially installed).
* Bug fix for favoriting / starring overlays not properly utilizing jump menu navigation.
* Various alignment corrections and bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/907f143...v1.9.7 Full Changelog: 907f143...v1.9.7]

'''Version 1.9.6'''
* New commands <code>set-json-val</code>/<code>set-json-value</code> and <code>set-json-key</code> (similar to <code>set-ini-val</code> and <code>set-ini-key</code>).
** <code>set-json-val <JSON_PATH> <JSON_KEY> <JSON_VALUE></code>
*** This will set a value in a json according to a key.
*** If the json / key does not exist, it will be auto-created.
** <code>set-json-key <JSON_PATH> <JSON_KEY> <NEW_JSON_KEY></code>
*** This changes the name of a key in a json
*** Will do nothing if the json does not exist.
* Cleanup of all lingering visual glitches during menu navigation.
** No more cursor flicker as pages transition.
** Proper isolation / cleanup of <code>jumpToItem</code> execution.
** The '''Language Menu''' will now also return to the last selected item after a language change (with translations properly applied).
* Updating Ultrahand from the <code>Software Update</code> page will now also update the version label stored in the HBAppStore's <code>info.json</code>.
** This will prevent "new update" flags from appearing on the HBAppStore after updating Ultrahand from within itself.
*** '''Side-note:''' If you don't see the version label on the update command footer before clicking it, the version label will not be updated.
**** If HBAppStore does not have the latest version, the store will still say that there is an update available.
* Various alignment corrections (tables, scrollbar, list height corrections, internal <code>List</code> corrections, etc).
* Various scrolling related fixes and improvements.
* Various bug fixes and code optimizations.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.5...v1.9.6 Full Changelog: v1.9.5...v1.9.6]

Quick update:
* Lingering memory leak fixed for rapid language changes. - 6/23/2025 6:12 AM PST '''(UPDATE IS RECOMMENDED)'''
* Last minor bug fix:
** Table drawer wasn't properly updating colors on the main menu. - 6/23/2025 7:55 AM PST
*** You'd only notice if you have a table on the page that you are returning to after changing themes.
* Final fix:
** Rounded rects drawing out of bounds bug fix (like touching next page on Japanese for instance). - 6/23/2025 10:24 AM PST
** This was causing a crash because of my renderer optimizations. Should all be good now.
*** Alignments will be corrected in the next version.
*** [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.6...907f143 Full Changelog: v1.9.6...907f143]

'''Version 1.9.5'''
* Forward list caching has been properly implemented.
** This allows <code>jumpToItem</code> to seamlessly transition during forward navigation (like in v1.9.3, but with no memory leaks).
* Refresh commands with <code>jumpToItem</code> are now moved to <code>refresh-to</code>.
** Called <code>refresh-to <ITEM_NAME> [ITEM_VALUE] [EXACT_MATCH]</code>.
** Exact match is an optional <code>true</code>/<code>false</code> value, set to <code>true</code> by default.
*** When false, it will check if the value / versions are contained within the strings rather than an exact match.
* Various fixes to scrolling as well as table scrolling.
* Fixes to download commands using a completion timeout (cancelling downloads early).
** This completion timeout was added by mistake and could make downloads of large files fail.
* New language <code>Ukrainian</code> has been added.
* Additional key combos have been added to the combo list.
* Table wrapping alignments have been corrected.
* Various bug fixes and corrections.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/6d027f9...v1.9.5 Full Changelog: 6d027f9...v1.9.5]

'''Version 1.9.4'''
* Several critical memory leaks have been properly addressed.
** Memory leaks can cause crashes when the heap gets overloaded.
*** This was especially noticeable with extremely long menus or long chains of commands (like download and unzip).
** The prior frame caching implementation needed to be reworked / revised.
*** Potential broken / dangling pointers not properly being managed / cleared.
*** Backwards caching works fine, but forward caching of prior frames with <code>jumpToItem</code> needs to be revised in the next release to prevent the menu from briefly flickering into view.
** Directory path caching has been completely removed (an unnecessary "old" implementation).
** Various tweaks to <code>libultra</code> functions for improved reliability.
* Implementation of a <code>Font Manager</code> class in <code>tsl::gfx</code> with a universal glyph cache for better memory management across <code>drawString</code> and <code>calculateStringWidth</code> methods.
** All <code>drawString</code> methods and have been reconsolidated.
** Fixes for alternative fonts were also implemented.
* Complete rework of the prior scrolling implementation for smoother scrolling navigation.
** Table scrolling for subsequent tables has been fixed (was not working properly in v1.9.3).
** Table scrolling is also a lot smoother than before, with proper velocity interpolation.
* (NEW) Dropdown commands (normally empty command blocks) can now be written with <code>;mini=true</code> for making mini dropdown menus command forwarders.
* Various alignment corrections, selection text color corrections, method optimizations and bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/a592584...v1.9.4 Full Changelog: a592584...v1.9.4]

Quick Update:
* Ini placeholder bug fix.
** Certain ini placeholders replacements were not being properly handled within the source replacement functions.
** This likely affected <code>Reboot To</code> for certain entry names in <code>hekate_ipl.ini</code>.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.4...6d027f9 Full Changelog: v1.9.4...6d027f9]

'''Version 1.9.3'''
* Menu navigation has been significantly cleaned up utilizing the new jump to item implementations.
** Returning to the exact overlay entry you launched on the menu (on both the <code>Overlays</code> and <code>Hidden Overlays</code> pages).
** Auto navigation to the checkmark on dropdown selections.
** Page caching for smoother page to page transitions.
** Left to right page swaps now have seamless transitions.
* New <code>Show Hidden</code> toggle in <code>Settings > UI Settings > Miscellaneous > Menu Items</code>.
** This will hide your hidden tabs on the <code>Overlays</code> and <code>Packages</code> pages.
** Hidden overlays with <code>Show Hidden</code> set to off will also have their launch combos blacklisted.
** This should be useful for giving your device to a kid to play without having them mess-up something critical.
* Numerous across the board code optimizations.
** Slightly faster rendering than v1.9.2.
* Tables will now only poll new values when placeholders are present.
* Complete cleanup of alignments (including table alignments).
* Complete cleanup/rewrite of the <code>List</code> class in <code>libtesla</code> for seamless menu navigation.
* Various touch scrolling bug fixes (especially for touch scrolling on tables, then resuming with controller input).
* Jump menu navigation can now be used in packages (expansion of <code>refresh</code> command).
** <code>refresh <ITEM_NAME> [ITEM_VALUE]</code> will auto-return the cursor to the item that fits the match.
** <code>ITEM_VALUE</code> is '''optional''' and does not have to be defined.
** <code>ITEM_NAME</code> is only optional with a blank string as its value, i.e. <code>''</code>.
* Numerous bug fixes and corrections.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.2...v1.9.3 Full Changelog: v1.9.2...v1.9.3]
Update: (Users should run update again for proper polling isolation.)
* New <code>;polling=</code> table header (<code>true</code>/<code>false</code>) for placeholder polling. (<code>false</code> by default)
** This will make it easier for users to manually specify when placeholder polling should be enabled.
** '''Notice:''' Projects leveraging placeholder polling will need to set <code>;polling=true</code> on their table commands.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.3...a592584 Full Changelog: v1.9.3...a592584]

'''Version 1.9.2'''
* Restoring of debug logging.
** This caused issues in rare test cases, using the <code>USING_LOGGING_DIRECTIVE</code> set to 0 (off).
** Debug logging needs to be consolidated more (later).
* Opacity bug fix.
** This caused wallpapers to hit opacity before the rest of the items, making screenshots look weird. All fixed now.
* Jump menu navigation from clicking up at the top of the list bug fix.
** This caused multiple "up" clicks to get stuck on the last item on the list initially for the second <code>up</code> click. Also fixed.
* Slight refinement to the <code>up</code> / <code>down</code> jump menu navigation.
* Threshold for successive clicks has been set from 150ms to 100ms for smoother navigation.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.1...v1.9.2 Full Changelog: v1.9.1...v1.9.2]

'''Version 1.9.1'''
* Significant rendering improvements in <code>libultrahand</code> / <code>libtesla</code> (again).
** Faster string rendering (with safeguards) as well as rendering of other objects.
** Faster glyph lookup (for drawing strings).
** Safe optimizations to critical rendering components (considerable improvements).
** 60fps now works on 918 MHz CPU with wallpapers.
** 60fps also works with 714 MHz CPU without wallpapers.
*** 612 Mhz CPU without wallpapers is now very close to 60fps with it rendering 60fps on certain menus.
* Bug fixes for left to right scrolling text (long ListItem text) not returning to its original position before restarting.
* Rewrite of the <code>List</code> class in <code>libtesla</code> to properly allow jump menu navigation.
** When at the top of the menu and <code>up</code> is pressed, the cursor will now automatically go to the bottom most item.
** When at the bottom of the menu and <code>down</code> is pressed, the cursor will now automatically go back to the top.
** When <code>L</code> is pressed, the cursor will jump to the top of the menu.
** When <code>R</code> is pressed, the cursor will jump to the bottom of the menu.
*** All jump menu implementations works on menus with ListItems and tables, or even just tables.
** Complete rewrite of the table scrolling implementation for smoother scrolling and less potential issues.
* Download commands now have a 10s timeout.
* <code>Software Update</code> now removes the version label if it cannot pull the latest version details from GitHub.
** This will prevent people thinking an older version of the overlay is the latest.
* Slight cleanup of debug <code>logging</code>.
* Beta for [https://github.com/ppkantorski/nx-ovlloader/releases/tag/v1.1.1 nx-ovlloader+ v1.1.1] is now live (not linked to <code>Update</code> for now for testing).

What's Changed:
* Tweak for dist target by [https://github.com/impeeza @impeeza] in [https://github.com/ppkantorski/Ultrahand-Overlay/pull/232 *232]
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/215e878...v1.9.1 Full Changelog: 215e878...v1.9.1]

'''Version 1.9.0'''
* Title ID polling bug fixes in <code>libultrahand</code> (cleanup of the foreground fix implementation).
** Before it was using old / outdated service calls for pulling the title ID.
** This issue appears to have caused crashes on certain switch environments according to users.
* Various code optimizations in <code>libultrahand</code>.
** Rendering is slightly faster now than v1.8.9.
** Removal of <code>chrono</code> for libnx alternatives.
* <code>nx-ovlloader</code>/<code>nx-ovlloader+</code> have been re-compiled.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/becd070...v1.9.0 Full Changelog: becd070...v1.9.0]

Update:
* Slight bug fixes with <code>libcurl</code> initializations (revert of changes).
* <code>setNextOverlay</code> bug fix for overlay filename launch arguments. - 06/07/2025 10:30 PM PST
* Bug fix for text extending off the screen causing crashes (like in lang file <code>es.json</code>). - 06/08/2025 6:07 AM PST
* A more elegant solution will be applied later to speed up the rendering a pinch.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.9.0...215e878 Full Changelog: v1.9.0...215e878]

'''Version 1.8.9'''
* Significantly improved rendering has been applied to <code>libultrahand</code>'s custom <code>libtesla</code> fork.
** This now allows for 60fps wallpapers on stock CPU clock speeds.
** CPU <code>714 MHz</code> under-clock without wallpapers should now render at 60fps as well.
** CPU <code>612 MHz</code> under-clock is not quite at 60fps yet, but on various pages it can get pretty close.
* A new bug fix for input isolation failing (foreground bug) on changing titles has also been applied to <code>libtesla</code>.
** This should prevent overlays compiled with <code>libultrahand</code> from losing their input focus on the menu when a game starts up.
* Various optimizations to <code>drawTable</code> (the table drawing method).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.8...v1.8.9 Full Changelog: v1.8.8...v1.8.9]

Update:
* Slight cleanup of <code>libtesla</code>.
* Revert of some of the cleanup changes. (bug fix for scrolling text)
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.9...becd070 Full Changelog: v1.8.9...becd070]

'''Version 1.8.8'''
* New <code>Key Combo</code> implementation for launching any overlay.
** Located in the overlay settings menu (<code>Y</code> on an overlay).
** This lets you set any overlay to any key combination (excluding your Ultrahand <code>Key Combo</code>).
** When setting an already used combo, combos set for overlays with the same combo are removed.
** Very useful for quickly launching any overlay without invoking the <code>Ultrahand Overlay</code> menu.
* Default theme table info color has been changed.
** For changes to apply to the default theme, users must re-apply the default theme in the theme selector on the settings menu.
* Fixes for <code>slot</code> commands to render the updated footers instead of a checkmark.
* Long tap on commands now invoke the <code>ScriptOverlay</code>.
** This makes all options of the menu fully accessible now via touch.
* Bug fix for new packages and overlays not initially being listed with names until the menu reloads.
* Slight code optimizations.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.7...v1.8.8 Full Changelog: v1.8.7...v1.8.8]

'''Version 1.8.7'''
* Bug fixes for <code>file_source</code> toggles.
** There were issues with <code>file_source</code> not being properly resolved with subsequent clicks to <code>file_source</code> toggles.
** Issues should now be resolved.
* Sorting related bug fixes for command grouping <code>split5</code>.
* New method <code>flag</code> for generating empty text files with the name of files/folders within a directory
** Called <code>flag <input_path_wildcard_pattern> <output_dir></code>.
** Might not be particularly useful in most cases, but it is essential for proper management of active contents mods within <code>Mod Alchemist</code>.
* Tweaks / improvements to <code>dangerous pattern</code> detection.
** Patterns with multiple <code>*</code> next to each other (i.e. <code>**</code> or <code>***</code>, etc) are now considered dangerous and will return a failed command for <code>move</code> and <code>delete</code>.
** <code>null*</code> and <code>*null</code> are also considered to be dangerous patterns (failed placeholder replacements).
** Cleanup of failed placeholder replacements to return <code>null</code> instead of empty values when necessary.```
* <code>ScriptOverlay</code> (minus on a command) related bug fixes.
* Slight corrections to <code>compare</code> as well as <code>split</code> and <code>slice</code> placeholder methods.
* Slight code optimizations.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/06f9666...v1.8.7 Full Changelog: 06f9666...v1.8.7]

'''Version 1.8.6'''
* Tables now render live values with placeholder replacements.
** Values will poll / update once every second.
* New <code>back</code> command implementation for simulating <code>Back</code> / <code>KEY_B</code> button press.
* <code>filter</code> commands now accept wildcard patterns for more advanced filtering of source inputs.
* New command grouping (<code>;grouping=</code>) option <code>split5</code>. (similar to <code>split3</code> except it works on the folder containing the file/folder).
** '''Side-note:''' All command grouping modes will eventually be renamed to avoid confusion.
* Title ID placeholders <code>{title_id}</code> now work within source function definitions.
* <code>pxhtxt2ips</code> conversions now create an empty title ID text file within the folder where the IPS mod is generated.
** This feature is necessary for proper management of active mods within <code>Mod Alchemist</code>.
** The title ID is read from the comments within the <code>.pchtxt</code> file (already necessary for pxhtxt2cheat conversions).
** All IPS mods must be regenerated for this file to be generated. Otherwise IPS mods will not register within the <code>Active</code> tabs on <code>Mod Alchemist</code>.
* Various menu traversal related bug fixes.
* Various bug fixes within <code>libultrahand</code>.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.5...v1.8.6 Full Changelog: v1.8.5...v1.8.6]

Update:
* Slight bug fix with menu traversal.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.6...06f9666 Full Changelog: v1.8.6...06f9666]

'''Version 1.8.5'''
* Critical bug fixes for decimal to hex conversions.
* Updates to all <code>devkitpro</code> related libraries.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/2f3a5b6...v1.8.5 Full Changelog: 2f3a5b6...v1.8.5]

'''Version 1.8.4'''
* Various bug fixes to <code>isDangerousCombination</code> (dangerous pattern detection). Certain wildcard patterns were being flagged with the old implementation that should not be.
** This fixes <code>exeFS Groups</code>'s <code>Enable All</code> and <code>Disable All</code> commands in <code>Mod Alchemist</code>.
* Bug fixes for the <code>ScriptOverlay</code> (minus on a command) where <code>./</code> placeholders were not being properly replaced with the package folder for commands.
* Various logging related bug fixes. (default log is currently set to <code>sdmc:/switch/.packages/log.txt</code> when <code>logging</code> is enabled)
* Tweaks to <code>decimalToHex</code> implementations in <code>libultra</code> to manually specify byte group size (byte_group_size 2 = XX, byte_group_size 4 = XXXX, byte_group_size 6 = XXXXXX, etc). This should resolve problems related to a decimal value of 0. Default byte_group_size is 2, then will be assumed according to the decimal value if greater.
** <code>hex-by-custom-decimal-offset <file_path> <custom_pattern> <offset> <decimal_data> [byte_group_size]</code>
** <code>hex-by-custom-rdecimal-offset <file_path> <custom_pattern> <offset> <rdecimal_data> [byte_group_size]</code>
** <code>hex-by-decimal <file_path> <decimal_data_to_replace> <decimal_data_replacement> [byte_group_size] [optional_occurrence]</code>
** <code>hex-by-rdecimal <file_path> <decimal_data_to_replace> <decimal_data_replacement> [byte_group_size] [optional_occurrence]</code>
** <code>{decimal_to_hex(decimal, byte_group_size)}</code> or <code>{decimal_to_hex(decimal)}</code>
* Sidenote: For usage of <code>optional_occurrence</code>, <code>byte_group_size</code> must be specified. 
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.3...v1.8.4 Full Changelog: v1.8.3...v1.8.4]

Update:
* Pull Request [https://github.com/ppkantorski/Ultrahand-Overlay/issues/5 *5] got deleted in <code>libultrahand</code> for some reason, so <code>respect @disabled flag pchtxt</code> functionality has been restored.
* Fixes to various hex method calls (some got broken with the update). - 06/26/2025 6:04 PM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.4...2f3a5b6 Full Changelog: v1.8.4...2f3a5b6]

'''Version 1.8.3'''
* New toggle option <code>Dynamic Logo</code> in <code>UI Settings > Miscellaneous</code> for enabling / disabling the dynamic logo effect.
* Various fixes to <code>libultrahand</code>.
** Launch combo is read from the <code>tesla.ini</code> if <code>ultrahand.ini</code> does not exist for overlays compiled with libultrahand. (bug fix)
** Fix for converting pchtxt's with embedded comments as well as a couple other tweaks.
** Subtle UI corrections / improvements.
* The memory indicator on the <code>System</code> page now shows the true memory (no longer -8MB) and has custom coloring.
** New theme colors <code>healthy_ram_text_color</code>, <code>neutral_ram_text_color</code>, and <code>bad_ram_text_color</code>.
*** Healthy is >= 9MB.
*** Neutral is < 9MB, >= 3MB.
*** Bad is < 3MB.
* Various minor tweaks.
** The pre-generated package.ini now has symbols on some of the <code>Reboot To</code> commands and the <code>Shutdown</code> command.
** The <code>ultra.ini</code> theme that is installed when updating has been updated to use white text color.
** The <code>ultra-blue.ini</code> theme that is installed when updating is now the old <code>ultra.ini</code> theme color.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/d448e61...v1.8.3 Full Changelog: d448e61...v1.8.3]

'''Version 1.8.2'''
* New <code>Page Swap</code> toggle for swapping the overlays and packages page locations.
** Located in <code>Settings > UI Settings > Miscellaneous > Effects > Page Swap</code>.
** This feature will draw the packages menu on the left and the overlays menu on the right when enabled.
* Fixes to <code>libultrahand</code> for preventing screenshots from occurring during capture event initializations.
** This is particularly useful for isolating actual capture button events from initializations within projects like [https://github.com/HookedBehemoth/bitmap-printer bitmap-printer] / [https://github.com/J-D-K/PNGShot PNGShot].
*** If using <code>bitmap-printer</code>, it is currently recommended to use a version built with pull request [https://github.com/HookedBehemoth/bitmap-printer/pull/25 *25] or else there will be dragons (unwanted screenshots in the <code>Bitmaps</code> directory generated every time a <code>libultrahand</code> compiled overlays is opened).
*** If using <code>PNGShot</code>, it is currently recommended to use a version built with pull request [https://github.com/J-D-K/PNGShot/pull/5 *5], however builds from latest source code on the repo should now work as well without producing unwanted screenshots.
** '''Notice:'''
*** All projects built with <code>libultrahand</code> will need to be recompiled with latest <code>libultrahand</code> for this fix to apply.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.1...v1.8.2 Full Changelog: v1.8.1...v1.8.2]

Update:
* Fixes for returning to overlay menu after exiting overlay with <code>Page Swap</code>. - 11/05/2024 3:06 AM PST
* Touch selection fixes for left / right page with <code>Page Swap</code>. - 11/05/2024 3:33 AM PST
* Dangerous pattern tweak for wildcard patterns within the <code>Album</code> folder. - 11/05/2024 6:42 PM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.2...d448e61 Full Changelog: v1.8.2...d448e61]

'''Version 1.8.1'''
* New package header <code>;show_version=</code> is an optional <code>true</code>/<code>false</code> option for forcing the menu to show the package version instead of the current section title under the package title. (<code>false</code> by default)
* Various bug fixes.
** Fix to <code>Software Update</code> command and <code>Memory Expansion</code> to download <code>nx-ovlloader</code>/<code>nx_ovlloader+</code> v1.0.8 instead of v1.0.9 if AMS version is < 1.8.0.
** Fix for forwarder footers being updated when they should not be.
** Fix for table with <code>null</code> value replacements not correctly aligning <code>Not available</code> / <code>UNAVAILABLE_SELECTION</code> text properly.
** Fix for combo labels not being converted to their icon counterparts upon initialization.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.8.0...v1.8.1 Full Changelog: v1.8.0...v1.8.1]

'''Version 1.8.0'''
<ol>
<li>Introduction of new <code>true</code> / <code>false</code> command options <code>;mini=</code> and <code>;selection_mini=</code> for usage of "mini" ListItems.
<ul>
<li><code>;mini=true</code> will enable mini mode for the ListItem. (<code>false</code> by default)</li>
<li><code>;selection_mini=true</code> will enable mini mode for the dropdown selection ListItems. (for <code>*</code> commands; <code>false</code> by default)</li></ul>
</li>
<li>Introduction of new command <code>volume</code> to control the system master volume level, called <code>volume <PERCENTAGE></code> where <code><PERCENTAGE></code> is an integer value from 0 to 150.
<ul>
<li>Users can create a volume level slider similarly to a brightness level slider.
<pre class="language-ini">[Volume Level]
;mode=trackbar
;min_value=0
;max_value=150
;units=%
;on_every_tick=true
volume {value}
</pre></li>
<li>'''Side-note:''' Max volume scale has been capped at 150%. Will only scale the current active system volume level (not modify it). 
</li></ul>
</li>
<li>Package forwarder commands will now update footer labels when modified from within the forwarder package.</li>
<li>Option footers will now be automatically loaded from the <code>config.ini</code> upon command success instead of returning a checkmark.</li>
<li>Expansion of <code>timestamp</code> placeholder argument to include <code>%f</code> for fractional seconds.
<ul>
<li>Basic timer example:
<pre class="language-ini">[Timer]
;mode=option
ini_file ./config.ini
try:
set-ini-val ./config.ini Timer stop {timestamp(%s.%f)}
set-footer {math({ini_file(Timer,stop)}-{ini_file(Timer,start)})}s
remove-ini-key ./config.ini Timer start
try:
set-ini-val ./config.ini Timer start {timestamp(%s.%f)}
set-footer ●
</pre></li></ul>
</li>
<li>Various code / compiler optimizations for smaller compilation size.</li>
<li>Various bug fixes and subtle UI corrections.
<ul>
<li>Max value bug fix for regular track-bars.</li>
<li>Fixes to <code>math</code> placeholder operation parsing.</li>
<li><code>set-footer</code> for <code>null</code> values will now return a failed command.</li></ul>
</li>
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/367a0bb...v1.8.0 Full Changelog: 367a0bb...v1.8.0]</ol>

'''Version 1.7.9'''
# Complete rework of the <code>Script Overlay</code> (<code>-</code> / <code>minus</code> on a command).
#* Users can now preview command blocks and execute would be executed commands on the <code>Script Overlay</code>.
#* All command objects are now compatible.
# Package header routing has now been implemented.
#* This will make it easier for users to tell where they are within the menu when navigating through packages.
# Ultrahand's overlay development libraries have now been moved to [https://github.com/ppkantorski/libultrahand libultrahand].
#* Numerous improvements have been made within <code>libultrahand</code> to make recompiling overlays easier.
#* Users can also use these libraries for their own overlay development, or to rebuild other Tesla overlays with Ultrahand features.
#** A number of overlays have been rebuilt as examples. (see [https://github.com/ppkantorski/libultrahand?tab=readme-ov-file#build-examples Build Examples])
# Introduction of new theme colors.
#* <code>default_overlay_color</code> for specifying the default title color for overlays compiled with <code>libultrahand</code>.
#* <code>default_script_color</code> for specifying the default title color for the <code>Script Overlay</code>.
# Various fixes to track-bars.
#* Users can now also click <code>A</code> to apply track-bar settings.
#* Users can hold <code>R</code> on top of an unlocked track bar to enable changing pages <code>left</code> / <code>right</code> (using D-Pad).
#* Fixes to rapid left / right clicks.
#* Fixes to text alignments.
#* Color swap for cursor over locked / unlocked trackbars.
#* Various touch related bug fixes.
# New table drawing options and various improvements to table rendering.
#* <code>;wrapping_mode=</code> can be set to <code>none</code>, <code>char</code>, or <code>word</code> for tables. (default is <code>none</code>)
#* <code>;wrapping_indent=</code> can be set to <code>true</code> or <code>false</code> for drawing an indent on the wrapped lines.
#** '''Notice:''' Wrapping modes will only be applied to the '''section''' text on the table.
# Software update command now updates <code>nx-ovlloader</code> / <code>nx-ovlloader+</code> as well as the included themes.
#* [https://github.com/ppkantorski/nx-ovlloader/releases/tag/v1.0.9 nx-ovlloader+] has been updated for HOS 19.0.0 support.
#** '''Notice:''' This update is required for proper reading of device FUSE data.
# Fixes for drawing the overlays / packages menu for newly added overlays / packages.
# Various UI corrections / improvements and code optimizations.
#* Wallpapers now consume half the system memory they used to.
#* Text width computations are now fixed. This should allow Ultrahand to display other fonts and languages more properly.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/aabb4e7...v1.7.9 Full Changelog: aabb4e7...v1.7.9]

Update:
* Bug fix for <code>nx-ovlloader+</code> / <code>nx-ovlloader</code> latest release URL. (was set to v1.0.8 instead of latest) - 10/19/2024 4:57 AM PST
** If you already updated to v1.7.9 with the "Software Update" menu, you may want to click update 2x. (first update will pull the fixed ovlmenu, second update will pull the correct loader)
* Cleanup of package header route labels. - 10/19/2024 6:25 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.9...367a0bb Full Changelog: v1.7.9...367a0bb]

'''Version 1.7.8'''
<ol>
<li>Fix for display underscanning in libtesla.
<ul>
<li>Overlays will need to be rebuilt with this fix for them to also have no issues with display underscan. (see [https://github.com/ppkantorski/EdiZon-Overlay Edizon] as an example)</li></ul>
</li>
<li>New command expansion for <code>backlight</code> called <code>backlight auto</code> (which takes parameter <code>on</code> / <code>off</code>) for controlling the <code>auto screen brightness</code> feature.
<ul>
<li><code>backlight auto on</code> will turn on the auto brightness feature.</li>
<li><code>backlight auto off</code> will turn off the auto brightness feature.</li>
<li>Example toggle:</li></ul>
<pre>[Auto Brightness]
;mode=toggle
on:
backlight auto on
off:
backlight auto off
</pre></li>
<li>New placeholder function <code>math</code> to resolve mathematical expressions.
<ul>
<li>Called <code>{math(MATH_EXPRESSION)}</code> where <code>MATH_EXPRESSION</code> is a mathematical expression like <code>1+1</code>, <code>(5+4)/9</code>, etc.</li>
<li>Can also be called <code>{math(MATH_EXPRESSION, true)}</code> where <code>true</code> forces the output to always be an integer.</li>
<li>Users can use <code>+</code>, <code>-</code>, <code>/</code>, <code>*</code>, <code>%</code> as well as brackets <code>(</code> and <code>)</code> within their mathematical expressions.</li></ul>
</li>
<li>New placeholder function <code>random</code> to generate a random integer.
<ul>
<li>Called <code>{random(START_VALUE,END_VALUE)}</code>.</li></ul>
</li>
<li>New placeholder function <code>length</code> to compute the length of a provided string.
<ul>
<li>Called <code>{length(STRING)}</code>.</li>
<li>Any white spaces on the left and right of the string will be trimmed.</li></ul>
</li>
<li>Placeholder replacement order of operations fix.
<ul>
<li>Users can use nested placeholders called in any sequence now.</li></ul>
</li>
<li>Removal of old <code>progress animation</code> UI setting.
<ul>
<li>Mostly unused, and a bit out dated in terms of design preferences. I think it is better for now to remove this feature.</li></ul>
</li>
<li>Bug fix for touch with trackbars.
<ul>
<li>Issue was that sliding to the left of the slidable area caused the value to become the max value for the slider.</li>
<li>This should no longer be an issue.</li></ul>
</li>
<li>Various subtle UI tweaks.</li></ol>
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/73b10bd...v1.7.8 Full Changelog: 73b10bd...v1.7.8]

Update:
* Placeholder replacement bug fix. - 09/30/2024 3:06 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.8...aabb4e7 Full Changelog: v1.7.8...aabb4e7]

'''Version 1.7.7'''
* New table scrolling implementation.
** <code>;scrollable=</code> is a <code>true</code>/<code>false</code> table parameter for initializing a table with a scrollable property (<code>false</code> by default).
** <code>;top_pivot=</code> is a <code>true</code>/<code>false</code> table parameter for making the top of the table have a selectable property (<code>false</code> by default).
** <code>;bottom_pivot=</code> is a <code>true</code>/<code>false</code> table parameter for making the bottom of the table have a selectable property (<code>false</code> by default).
** A variety of modifications were made to properly handle table scrolling (for touch / click both above and below scrollable tables).
* Tables can now use <code>list_file_source</code> for reading raw text files directly into a table and displaying the text line by line.
** Called <code>list_file_source <PATH_TO_TEXT_FILE></code>
** Text is drawn in the section portion and can utilize <code>;section_text_color=</code> for alternative coloring.
* Various UI related tweaks and fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/d016b6f...v1.7.7 Full Changelog: d016b6f...v1.7.7]

Update:
*Slight table scrolling bug fix. (was miscounting the last step) - 09/15/2024 3:30 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.7...73b10bd Full Changelog: v1.7.7...73b10bd]

'''Version 1.7.6'''
* New symbol placeholder variables.
** '''<code>{A}</code>, <code>{B}</code>, <code>{X}</code>, <code>{Y}</code>, <code>{L}</code>, <code>{R}</code>, <code>{ZL}</code>, <code>{ZR}</code>''': Button symbols for A, B, X, Y, L, R, ZL, and ZR.
** '''<code>{DUP}</code>, <code>{DDOWN}</code>, <code>{DLEFT}</code>, <code>{DRIGHT}</code>''': Directional pad (D-Pad) buttons symbols.
** '''<code>{LS}</code>, <code>{RS}</code>''': Symbols for the left stick (LS) and right stick (RS) click buttons.
** '''<code>{PLUS}</code>, <code>{MINUS}</code>''': Symbols for the Plus and Minus buttons.
** '''<code>{UP_ARROW}</code>, <code>{DOWN_ARROW}</code>, <code>{LEFT_ARROW}</code>, <code>{RIGHT_ARROW}</code>''': Arrow symbols pointing up, down, left, and right.
** '''<code>{RIGHT_UP_ARROW}</code>, <code>{RIGHT_DOWN_ARROW}</code>, <code>{LEFT_UP_ARROW}</code>, <code>{LEFT_DOWN_ARROW}</code>''': Diagonal arrow symbols indicating direction combinations.
** '''<code>{POWER}</code>''': Power button symbol.
** '''<code>{HOME}</code>''': Home button symbol.
** '''<code>{CAPTURE}</code>''': Capture button symbol.
** '''<code>{REFRESH_SYMBOL}</code>''': Refresh symbol.
** '''<code>{WARNING_SYMBOL}</code>''': Warning symbol.
** '''<code>{INFO_SYMBOL}</code>''': Information symbol.
* New progress symbol throbber implementation. (for commands in progress that do not utilize the progress percentage)
* Toggle-related bug fixes. (bug was introduced in v1.7.5)
** This should resolve issues a number of issues with toggles not retaining their state after being clicked.
* Storage capacity in <code>Device Info</code> has been corrected. (was previously showing free space instead of the amount of space being consumed)
* Slight UI corrections.
* Various code optimizations.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/3801fca...v1.7.6 Full Changelog: 3801fca...v1.7.6]

Update:
* String formatted combo symbols replacements for tables. - 09/10/2024 09:08 PM PST
* Slight tweak to throbber implementation (slightly more optimized). - 09/10/2024 09:46 PM PST
* Arrow symbols fix. (some were mis-mapped) - 09/11/2024 09:00 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.6...d016b6f Full Changelog: v1.7.6...d016b6f]

'''Version 1.7.5'''
* Introduction of new <code>Swipe to Open</code> feature (an alternative to <code>Key Combo</code> for opening Ultrahand).
** This feature is now on by default, but can be toggled off in <code>Settings > UI Settings > Miscellaneous > Effects > Swipe to Open</code>.
** To trigger a swipe launch, swipe your finger from off the screen inwards ~1.5cm from the side where the menu is being drawn (left by default or right) in < 150ms.
** '''Note:''' It should be relatively hard to trigger by accident even if you play touch sensitive games, but still easy enough to launch any time you try.
* Introduction of new placeholder variable <code>{title_id}</code> for returning the title ID of the currently running game / application.
** Will return <code>null</code> if a game / application is not open.
** This placeholder should allow some more complex packages to be made.
* Root package folder <code>exit_package.ini</code> will now have command <code>exit</code> only ran when Ultrahand (and any other running overlay) is completely closed.
* More bug fixes and code optimizations.
** Clean-up of progress percentage implementation.
** Reduction of string copying for various string functions. (faster commands, less memory)
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/0ef1c3a...v1.7.5 Full Changelog: 0ef1c3a...v1.7.5]

Update:
* Slight tweak to <code>Swipe to Open</code>. - 09/09/2024 03:19 AM PST
* <code>lang.zip</code> translations update. - 09/09/2024 05:24 AM PST
* Bug fix for update languages (menu was triggering unnecessary reload). - 09/09/2024 05:36 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.5...3801fca Full Changelog: v1.7.5...3801fca]

'''Version 1.7.4'''
* Introduction of <code>exit_package.ini</code> (similar to <code>boot_package.ini</code> but with command name <code>exit</code> instead of <code>boot</code>).
** <code>Exit Commands</code> are now a toggle-able option for package settings. (on by default)
*** The <code>Boot Package</code> toggle has been renamed to <code>Boot Commands</code>.
** <code>exit_package.ini</code> can go in <code>/switch/.packages/</code> or be used in <code>/switch/.packages/<YOUR_PACKAGE_NAME>/</code>.
** When present in package root path, exit commands will be ran every time you close Ultrahand.
** When present in an Ultrahand package, exit commands will be ran every time you close the package.
* Temperature widget calls are now read directly from <code>i2c</code> instead of <code>ts</code>/<code>tc</code> services.
** This should help prevent any conflicts that may have arrises from usage with <code>ts</code>/<code>tc</code> in prior versions.
* Refinement of tap and hold functions.
** Holding on a package/overlay for > 0.3s, <= 1.0s then releasing will trigger the Settings key.
** Holding on a package/overlay for > 1.0s then releasing will trigger the Star key (favorites key).
* Introduction of <code>Right-side Mode</code>. (located in <code>Settings > UI Settings > Miscellaneous > Effects</code>)
** This feature will draw the Ultrahand menu on the right side of the screen instead of the left.
* Updating Ultrahand will now auto-reload the newly installed version when returning to the main menu after.
* New table command options <code>;start_gap=</code> and <code>;end_gap=</code> (same as <code>;gap=</code>) for manual aligning of tables.
* More details have been added to the [https://github.com/ppkantorski/Ultrahand-Overlay/wiki/Command-Reference Commands Documentation].
* Various UI tweaks / corrections.
* Various bug fixes and code optimizations / cleanups.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/28e239f...v1.7.4 Full Changelog: 28e239f...v1.7.4]

Update:
* Software update menu bug fix. - 09/07/2024 6:23 AM PST
* <code>Right-side Mode</code> touch fixes. - 09/07/2024 7:48 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.4...0ef1c3a Full Changelog: v1.7.4...0ef1c3a]

'''Version 1.7.3'''
* Long tap (touch > 0.5s) of an overlay / package on the main menu will now open the overlay / package settings menu upon release.
* Fuse data is now reloaded / re-dumped upon boot.
** New <code>true</code> / <code>false</code> option <code>disable_reload</code> is now stored in <code>fuse.ini</code> for manual disabling of the fuse data reload function.
* More corrections and improvements to the wallpaper swapping feature.
* Interpreter relevant bug fixes (especially with handing large <code>boot_package.ini</code> files).
** These fixes should make opening <code>OC Toolkit</code> faster as well as fix the <code>Backup</code> and <code>Restore</code> functions when used with wallpapers.
* Few additional minor bug fixes.
* '''Important:''' Fuse data has new key names, so you may need to reboot once or delete <code>sdmc:/config/ultrahand/fuse.ini</code> after updating from v1.7.2. 
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/9ff96ba...v1.7.3 Full Changelog: 9ff96ba...v1.7.3]

Update:
* Slight table text alignment correction. - 09/05/2024 6:10 AM PST
* Various services cleanup. - 09/05/2024 9:35 PM PST
** Temperature calls now only initialize the temperature service when the temperature widgets are enabled.
** <code>Reboot To</code> bug fix introduced from prior modification. - 09/05/2024 10:40 PM PST
** Another bug fix (for toggling on widgets). - 09/06/2024 3:30 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.3...28e239f Full Changelog: v1.7.3...28e239f]

'''Version 1.7.2'''
* Continued expansion of <code>Device Info</code> to now include local IP, eMMC storage, CPU/GPU/SOC Speedo + IDDQ and more.
** Fuse related data is auto-dumped to <code>sdmc:/config/ultrahand/fuse.ini</code> if <code>fuse.ini</code> is missing.
** Special thanks to Masagrator.
* Slight reorganization of <code>Settings Menu</code>.
* More renderer related tweaks and bug fixes. (faster pixel rendering / more FPS)
* Package settings menu now includes a toggle for <code>Boot Package</code> and <code>Error Logging</code>.
** Error logging will now only occur for packages when <code>Error Logging</code> is set to an <code>On</code> state. (off by default)
** Logs will be generated within the package folder in <code>log.txt</code>.
** Root package / root boot package logging will only work with command <code>logging</code>.
** Calls of <code>logging</code> command will always bypass <code>Error Logging</code> and log errors and commands to the designated <code>log.txt</code>.
* New placeholder variables <code>{cpu_speedo}</code>, <code>{cpu_iddq}</code>, <code>{gpu_speedo}</code>, <code>{gpu_iddq}</code>, <code>{soc_speedo}</code> and <code>{soc_iddq}</code>.
* New progress indicator bar for visualizing download, unzip, and copy percentages.
** New theme color settings <code>progress_color</code> and <code>progress_alpha</code>.
* Return of <code>shutdown controllers</code> for manually powering off all connected bluetooth controllers.
** This feature still does not work with <code>Mission Control</code>. Just a heads up.
* New language variables.
** Alternate languages may still need translations done to the updated <code>.json</code> files.
* Updates to libraries <code>devkitA64</code> and <code>libnx</code>.
* Numerous code optimizations for smaller compilation size and slightly faster commands.
* Various bug fixes.

* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/d959363...v1.7.2 Full Changelog: d959363...v1.7.2]

Update:
* Pre-release period is over. Things appear to be stable. - (09/03/2024 12:27 PM PST)
* Number of memory related bug fixes.
* Corrections to memory ID (got messed up upon initial release).
* Couple logging related bug fixes.
* Copy buffer has been increased to 4x and properly linked.
* Live wallpaper swapping bug fix. - (09/03/2024 3:21 AM PST)
* More live wallpaper swapping bug fixes. - (09/03/2024 4:15 AM PST)
** Tighter/stricter timing for swapping wallpapers to prevent more ''random'' crashes. - (09/03/2024 6:28 AM PST)
* Placeholder replacement order of operations bug fix. - (09/03/2024 6:00 PM PST)
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.2...9ff96ba Full Changelog: v1.7.2...9ff96ba]

'''Version 1.7.1'''
* Expanded <code>System</code> page to include various device related information.
** This table currently includes device firmware, bootloader version, hardware type, memory information, and storage information.
** Special thanks to ComplexNarrative.
* New command placeholder variables <code>{ram_vendor}</code>, <code>{ram_model}</code>, <code>{ams_version}</code>, and <code>{hos_version}</code>.
* Expansion of <code>refresh</code> command to include <code>wallpaper</code> for the ability to reload <code>wallpaper.rgba</code>,
** Called <code>refresh wallpaper</code>.
* Improved scrolling implementation. (proper time-synced speed interpolation)
* Complete recalibration of character width map.
** This should result in more proper table alignments when using tables with info sections aligned to the right.
* Multiple memory related bug fixes.
** More memory leaks have been fixed, which should result in less heap overloads / crashes.
* Language replacements are now performed on every ListItem and CategoryHeader upon initialization.
** This fixed entries like, for example, <code>Reboot To</code> and <code>Shutdown</code> from not being properly translated.
** Language json's may still need some translations for the new words that have been included.
* Removal of <code>shutdown controllers</code> for space conservation. (commented out)
** Did not want to remove this function, but because it only works with Nintendo controllers (and not Mission Control) it does seem somewhat redundant since the <code>sync button</code> on Nintendo controllers effectively turns off the controller as well.
** If it is highly desirable, I may include this command again in future revisions. But for size stability, I could not get it to fit properly this time around.
* Numerous code optimizations and bug fixes.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/6961b2e...v1.7.1 Full Changelog: 6961b2e...v1.7.1] 

Update:
* Placeholder bug fix for new variables + bug fix for <code>refresh</code> command. - 08/28/2024 4:40 PM PST
* TrackBar highlight width adjustment / fix. - 08/29/2024 5:05 AM PST
* Rename hardware model <code>Nx</code> to <code>Icosa</code> and <code>x1</code> to <code>X1</code>. (correction) - 08/29/2024 5:28 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.1...d959363 Full Changelog: v1.7.1...d959363]

'''Version 1.7.0'''
* New memory expansion option (located inSettings > System).
** This function requires internet the first time it is ran, otherwise you can place nx-ovlloader.zip and nx-ovlloader+.zip in sdmc:/config/ultrahand/expansion/. (see [https://github.com/ppkantorski/nx-ovlloader/releases/tag/v1.0.8 here] for the .zips)
** nx-ovlloader.zip (base memory) and nx-ovlloader+.zip (expanded memory) are recompilations of WerWolv's nx-ovlloader 1.0.6/1.0.7.
** Notice: This feature will utilize an extra 2 MB of system memory for overlays and will require a reboot after being toggled for changes to apply.
* New wallpapers implementation. (requires memory expansion)
** Wallpapers must be formatted in .rgba and be exactly 448x720 pixels in resolution.
** Place .rgba formatted wallpapers into sdmc:/config/ultrahand/wallpapers/, then they will show up in the Wallpaper Manager in the Settings Menu.
** Sidenote: For full 60 FPS in Ultrahand with wallpapers, overclock CPU >=1581.0 MHz.
* Numerous optimizations to the libTesla renderer.
** Multi-thread rendering (requires expanded memory).
** Reduced big-O complexity.
** Sidenote: With stock clocks and no wallpaper, users should expect to now get ~60 FPS in menu.
* Various improvements to tables, track-bars and the track-bar highlight/select cursor.
* Time-synced controller scrolling implementation, time-synced click saturation effect, and a variety of corrections within libTesla.
* Mod .pchtxt's now utilize @stop properly when generating IPS mods. (helpful for developers)
* New Polish language implementation and slight bug fixes to the languages menu.
* Various bug fixes.
** Fix for missing pre-generated root package. (was missing in v1.6.9)
** Downloads bug fix. (was broken fi missing path sdmc:/config/ultrahand/downloads/ in v1.6.9)
* Compilation libraries have been updated (excluding devkitA64 which has been left at r25.1-1).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.9...v1.7.0 Full Changelog: v1.6.9...v1.7.0]

Update:
* Expanded memory toggle bug fix. 08/24/24 9:00 AM PST
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.7.0...6961b2e Full Changelog: v1.7.0...6961b2e]

'''Version 1.6.9'''
* Dropdown and forwarder commands can now use custom labels/footers by using <code>footer=</code> with a value other than <code>null</code> in the package's <code>config.ini</code>.
* Custom name and version labels for overlays and packages can now be set in <code>/config/ultrahand/overlays.ini</code> and <code>/config/ultrahand/packages.ini</code> by using options <code>custom_name=</code> and <code>custom_version=</code>.
** Overlays will only be renamed when displayed on the menu. Direct modification of the overlay is still required for any re-naming of the overlay modules themselves.
** Packages will now assume names in the following priorities. 
i. Priority 0: Custom names and versions written in <code>packages.ini</code>. 
ii. Priority 1: Package name stated in the header in the <code>package.ini</code> file for the Ultrahand package. 
iii. Priority 2: If none of the above, it will assume the name based upon the Ultrahand package folder.
** If left empty, custom name and version parameters will be unused.
* New option for table <code>;header_indent=</code> for drawing a single header indent on left side of the line.
** This is meant to be used on one line "header-like" tables.
* New table text color options for <code>info_text_color</code> and <code>section_text_color</code>.
** <code>text</code> : Ultrahand theme text color used for default text.
** <code>header</code> : Ultrahand theme text color used for headers.
** <code>on_value</code> : Ultrahand theme color for <code>On</code> values / values.
** <code>off_value</code> : Ultrahand theme color for <code>Off</code> values / version labels.
* Key combo string representations in packages will now return their symbolic representation.
* Software update menu will now pull an indicator for the latest Ultrahand Overlay version from the GitHub API.
* Themes <code>classic.ini</code> and <code>ultra.ini</code> will now be auto-downloaded when opening the Theme manager if they do not exist.
* Downloads are now stored in a temporary state until completion. After completion, they are then moved into place.
** This should help with failed downloads and files being removed/replaced after a failed download to an existing filepath.
* The packages menu commands section now utilizes the same core logic as the packages themselves. (code optimization)
* Improvements to <code>Reboot To</code> pre-generated command in root package. (<code>/switch/.packages/package.ini</code>)
** If you are missing this feature, you may need to delete <code>/switch/.packages/package.ini</code>.
* Various subtle UI positioning corrections and bug fixes.
** Bug fix for cursor jumping/sliding after using hotkeys (with a d-pad down button) in games.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/cc7afad...v1.6.9 Full Changelog: cc7afad...v1.6.9]

'''Version 1.6.8'''
* Introduction of <code>ini_file_source</code> function and expansion of <code>ini_file</code> function.
** Dropdown selections can now use <code>ini_file_source <PATH_TO_INI></code> which will return a list of ini section name.
** Introduction of new placeholder index replacements selections<code>{ini_file(<INDEX>)}</code> / <code>{ini_file_source(*)}</code> for returning section names. (regular usage of <code>ini_file</code> placeholder calls will still function the same way, as well as <code>ini_file_source</code>)
* Named step-trackbars can now use standard <code>json_source</code>, <code>json_file_source</code>, and <code>ini_file_source</code> source functions and placeholder replacements.
* Expansion of <code>filter</code> to non-path type entries in dropdown selections.
** Called <code>filter <NAME_OF_ENTRY></code>.
* Expansion of <code>exit</code> command to exit directly to the overlays menu or packages menu.
** Called <code>exit overlays</code> / <code>exit packages</code>.
* Expansion of <code>refresh</code> command.
** <code>refresh theme</code>: reload/refresh the current current loaded theme (<code>/config/ultrahand/theme.ini</code>)
** <code>refresh package</code>: reload/refresh the current working package (redraws menu)
* Introduction of <code>compare</code> function to compare two text file lists and output a duplicate files list.
** Called <code>compare <PATH_TO_TXT_1> <PATH_TO_TXT_2> <OUTPUT_TXT_PATH></code>.
* New option <code>-copy_filter</code> / <code>-cp_filter</code> for <code>move</code> / <code>mv</code> commands utilizing <code>-src</code> + <code>-dest</code>.
** Called <code>move -src <SRC_TXT> -dest <DEST_TXT> -copy_filter <FILTER_TXT></code>.
** This will run a copy instead of move for files in the filter list text file.
* Introduction of new placeholder function <code>split</code> for splitting strings.
** Called <code>{split(<STRING>,<PATTERN>,<INDEX>)}</code>.
** For example, if the string is <code>Test - String</code>, the pattern is <code>" - "</code>, and the index is <code>0</code>, the output would be <code>Test</code>.
* Updates to the pre-generated <code>/switch/.packages/package.ini</code> root package file to include <code>Reboot To</code> (for booting directly into <code>/bootloader/hekate_ipl.ini</code> boot entries.
** '''Notice:''' Users may need to delete <code>/switch/.packages/package.ini</code> for it to generate a new one.
* Various optimizations to the command interpreter, file manipulation logging, bulk execution implementations, and to <code>move</code> / <code>mv</code> operations.
* Additional tweaks to the dangerous pattern detection function.
* Update to [https://github.com/ppkantorski/Mod-Alchemist Mod Alchemist] now at v0.4.7.
** Bug fixes for toggling content mods with duplicate files (utilizing <code>-copy_filter</code> and <code>compare</code>).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.7...v1.6.8 Full Changelog: v1.6.7...v1.6.8]

Update:
* Filter bug fix. (affected <code>Reboot To</code>) - 07/22/2024 2:53 PM PST
* Addition of <code>-filter <FILTER_TXT></code> command option for <code>move</code>, <code>copy</code>, and <code>delete</code>. - 07/22/2024 8:35 PM PST
** This allows for filtering of bulk executions (<code>-src</code> / <code>-dest</code>).
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.8...cc7afad Full Changelog: v1.6.8...cc7afad]

'''Version 1.6.7'''
<ol>
<li>New optional command parameters for <code>copy</code>/<code>cp</code>, <code>move</code>/<code>mv</code>, and <code>delete</code>/<code>del</code> commands for transfer logging and bulk executions.
a. File manipulation logging: <code>-log_src</code> / <code>-log_dest</code> (outputs a text list for source file and destination file locations)
<ul>
<li><code>copy <source_file_path> <destination_file_path> -log_src <src_output_txt_file_path> -log_dest <dest_output_txt_file_path></code></li>
<li><code>move <source_file_path> <destination_file_path> -log_src <src_output_txt_file_path> -log_dest <dest_output_txt_file_path></code></li>
<li><code>delete <source_file_path> -log_src <src_output_txt_file_path></code></li></ul>
b. Bulk execution: <code>-src</code> / <code>-dest</code> (utilizes text lists to perform transfer operations on all entries)
<ul>
<li><code>copy -src <src_input_txt_file_path> -dest <dest_input_txt_file_path></code></li>
<li><code>move -src <src_input_txt_file_path> -dest <dest_input_txt_file_path></code></li>
<li><code>delete -src <src_input_txt_file_path></code></li></ul>
</li>
<li>Improvements and fixes to <code>file_source</code> toggle functions.</li>
<li>Improved handling of <code>null</code> placeholder replacements.</li>
<li>Corrections to <code>isDangerousCombination</code> (the dangerous pattern combination detection function).
<ul>
<li>The following paths are now ultra-protected (unable to delete or move files from):
<ul>
<li><code>sdmc:/Nintendo/Contents/</code></li>
<li><code>sdmc:/Nintendo/save/</code></li>
<li><code>sdmc:/emuMMC/RAW1/Nintendo/Contents/</code></li>
<li><code>sdmc:/emuMMC/RAW1/Nintendo/save/</code></li></ul>
</li>
<li>Slight improvements to dangerous pattern detection.</li></ul>
</li>
<li>Updates to [https://github.com/ppkantorski/Mod-Alchemist Mod Alchemist] (now v0.4.6, requires Ultrahand v1.6.7+).
<ul>
<li>Now utilizes the new command options for managing "Contents" mods.</li></ul>
</li></ol>
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.6...v1.6.7 Full Changelog: v1.6.6...v1.6.7]

'''Version 1.6.6'''
* Major memory leak has been fixed.
** This issue was present for a while now, but until <code>Mod Alchemist</code> was never as concerning. Since <code>Mod Alchemist</code> can draw extremely long menus, memory overflow problems became more apparent.
** Has been resolved and should result in better memory handling across all Ultrahand packages/commands.
* Slight tweaks to the displayed version label formatting for overlays and packages.
* Failed interpreter spawning bug fix.
** Commands would occasionally get locked in an "in-progress" mode when there were memory related problems when trying to spawn the interpreter thread. When memory related problems occur, the command will return a failed command state instead (red "X").
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/1c08f0f...v1.6.6 Full Changelog: 1c08f0f...v1.6.6]

'''Version 1.6.5'''
* Introduction of root-layer boot package implementation for executing commands upon startup.
** Command <code>[boot]</code> located within <code>/switch/.packages/boot_package.ini</code> (if it exists) will be now be auto-ran once on startup.
** This feature can be useful for Switch Android users if they wanted to remove the auto-generated Android folders (for instance).
* Introduction of new command <code>pchtxt2cheat</code> (called <code>pchtxt2cheat /path/to/file.pchtxt</code>).
** This function will convert <code>pchtxt</code> files and load them into the correct directory for the game's cheat.
** '''Important:''' The game's title ID must be present somewhere within the pchtxt for this function to work.
* Various bug fixes to <code>pchtxt2ips</code>'s IPS generation.
* Expansion of <code>shutdown</code> command to turn off all bluetooth controllers.
** This function is called <code>shutdown controllers</code>.
** '''Notice:''' I have heard that this command may fail (return a red X) with <code>MissionControl</code> due to conflicting services, so just a heads up.
* Source function <code>file_source</code> can now be chained (called one after another) for combining multiple sources into a single list.
* Source function definitions can now also utilize an <code>ini_file</code> placeholder replacement (with the <code>ini_file</code> specified before the definition).
* Various bug fixes to <code>file_source</code> toggles.
** Subsequent clicks to <code>file_source</code> toggles are now handled properly with alternating path replacements according to the last line <code>move {file_source} /destination/path/</code> (must be present for <code>file_source</code> toggles).
* Various bug fixes to <code>ini_file</code> placeholder replacements.
** Failed replacements now return <code>null</code> again instead of <code>Not available</code> (the <code>UNAVAILABLE_SELECTION</code> language variable).
** When a value is <code>null</code> on a table info section, it is now auto replaced with <code>UNAVAILABLE_SELECTION</code>.
* Language selections in the <code>Settings Menu</code> now state their full names in their translated language with their abbreviations listed as footers.
** This included updates to all <code>/config/ultrahand/lang/</code> files.
* Additional key combo <code>LS+RS</code> has been added to the combos list.
** This includes a correction to the <code>LS</code> button icon.
* Commands <code>mirror_copy</code> and <code>mirror_delete</code> can now accept wildcard patterns.
* Introduction of new Ultrahand Package [https://github.com/ppkantorski/Mod-Alchemist <code>Mod Alchemist</code>] designed for managing, converting, and installing game mods. (formerly the <code>Mod Master</code> example package)
** '''Notice:''' This package requires Ultrahand Overlay v1.6.5+.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.4...v1.6.5 Full Changelog: v1.6.4...v1.6.5]

Update:
* Bug fix for the root-layer boot package implementation. - 07/07/2024 7:09 AM PST
** The issue was the commands appeared to be executing every time the overlay is spawned. Now it is fully isolated to run once on boot.
* Wildcard pattern bug fix. - 07/07/2024 9:00 PM PST
** The issue was that in certain cases, folder patterns were still returning files. Should be resolved now.
* Slight optimizations to transfer memory. - 07/07/2024 9:34 PM PST
** Freed up a little more memory to prevent some potential memory related bugs.
* Json replacement failure fall back value bug fix. - 07/08/2024 1:10 AM PST
** This includes fall back <code>null</code> related bug fixes as well as fixes to table drawing with <code>null</code> values.
* Transfer memory correction. - 07/09/2024 05:07 AM PST
** Issues noticed after freeing up a bit too much of the transfer memory, so corrections needed to be made.
* IPS generation bug fix. - 07/09/2024 06:16 AM PST
** Offsets were improperly being applied during <code>pchtxt2ips</code> generation. Corrections have been made.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.5...1c08f0f Full Changelog: v1.6.5...1c08f0f]

'''Version 1.6.4'''
* Optimizations to the <code>;on_every_tick=</code> implementation for track-bars.
** Faster on every tick command execution.
* New table option additions <code>;section_text_color=</code> and <code>;info_text_color=</code>.
** Both section and info text color are optional parameters that can be set to:
*** <code>default</code> (normally <code>default</code> when unspecified)
*** <code>warning</code> (new built-in theme color <code>warning_text_color</code>)
*** or any specified RGB888 hex color string
* Forwarder package versions and title colors are now inherited from the layer 0 package (package.ini) if left unspecified within the forwarder package.
** Users no longer need to specify forwarder package versions and colors on every forwarder package ini.
* Bottom buttons and settings menu touch functions now utilize theme colors <code>click_color</code> and <code>click_alpha</code> for drawing highlights on the touch regions.
* Various touch interaction bug fixes. (touching "OK" on top of a track-bar, bottom regions for touch adjusted to language text size, etc.)
* Slight tweaks to pixel blender for drawn strings during hiding.
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/0eeef44...v1.6.4 Full Changelog: 0eeef44...v1.6.4]

'''Version 1.6.3'''

List of changes:
<ol>
<li>'''IMPORTANT:''' Tables in v1.6.3 no longer utilize <code>;header=</code> pattern and no longer draw headers. Tables also no longer require a <code>$</code> in the command name.
<ul>
<li>To define a header, use an empty package command (like how they are defined normally).</li></ul>
</li>
<li>Introduction of 3 track-bar command mode implementations. 
i. Regular track-bar is called utilizing <code>;mode=trackbar</code>.
<ul>
<li><code>;min_value=</code> sets the minimum integer value</li>
<li><code>;max_value=</code> sets the maximum integer value</li>
<li><code>;units=</code> sets the display units</li>
<li><code>;unlocked=</code> is an optional true/false parameter for unlocked track-bars (locked by default)
<ul>
<li>At least one track-bar must first be clicked (A) for all track-bars to be editable (unless unlocked).</li></ul>
</li>
<li><code>;on_every_tick=</code> is an optional true/false parameter for executing listed commands on every track-bar tick (off by default)
<ul>
<li>By default, commands are executed the moment the interactions with the slider stop.</li></ul>
</li></ul>

ii. Step track-bar is called utilizing <code>;mode=step_trackbar</code>.
<ul>
<li><code>;steps=</code> is an optional integer parameter for directly specifying the number of steps utilized with the step track-bar.</li></ul>

iii. Named step track-bar is called utilizing <code>;mode=named_step_trackbar</code>.
<ul>
<li>Requires a <code>list_source</code> definition or a <code>list_file_source</code> definition (for loading the names).</li>
<li>Does not use <code>;min_value=</code>, <code>;max_value=</code>, <code>;units=</code>, nor <code>;steps=</code>.</li></ul>

All track-bars commands can be used with placeholders <code>{value}</code> for returning the value and <code>{index}</code> for returning the index. Both value and index are also stored within the package config.ini file according to the track-bar entry.</li>
<li>Introduction of 5 new placeholder commands. 
i. <code>{slice(<ANY_STRING>,<START_INDEX>,<END_INDEX>)}</code> slices any string according to a start and end index. 
ii. <code>{decimal_to_hex(<DECIMAL>)}</code> converts a decimal string into a hex string. 
iii. <code>{ascii_to_hex(<ASCII>)}</code> converts an ascii string into a hex string. 
iv. <code>{hex_to_rhex(<HEX>)}</code> inverts the endian of a hex string. 
v. <code>{hex_to_decimal(<HEX>)}</code> converts a hex string into a decimal string.
Bug fix: All variable placeholders no longer require a specified order for operations.</li>
<li>Optimized input handling for smoother / faster menu item traversal.</li>
<li>New theme colors and updates to theme [https://github.com/ppkantorski/Ultrahand-Overlay/blob/main/themes/ultra.ini <code>ultra.ini</code>]. 
i. <code>header_text_color</code> is the text color for category headers. 
ii. <code>header_separator_color</code> is the separator rectangle color for category headers. 
iii. <code>star_color</code> is the color of the favorites star when unselected. 
iv. <code>selection_star_color</code> is the color of the favorites star when selected. 
v. <code>bottom_button_color</code> is the color of the buttons displayed at the bottom of the window. 
vi. <code>bottom_separator_color</code> is the color of the separator drawn near the bottom of the window. 
vii. <code>bottom_text_color</code> is the color of the text drawn at the bottom of the window next to the buttons. 
viii. <code>trackbar_slider_color</code> is the color of the trackbar slider. 
ix. <code>trackbar_slider_malleable_color</code> is the color of the trackbar slider when it is in a modifiable mode (unlocked / press A). 
x. <code>trackbar_slider_border_color</code> is the color of the thin border around the slider. 
xi. <code>trackbar_full_color</code> is the color of the trackbar for the filled portion. 
x. <code>trackbar_empty_color</code> is the color of the trackbar for the empty portion. 
xi. <code>default_package_color</code> is the default color for package titles (used if none is specified in the package header).
'''IMPORTANT''': All colors with word <code>seperator</code> are now spelt correctly <code>separator</code>. (grammer typo fix)</li>
<li>Expansion of <code>backlight</code> command.
<ul>
<li>In addition to <code>on</code> and <code>off</code>, backlight can now take an integer percentage value for precise backlight modifications.</li>
<li><code>backlight <PERCENTAGE></code></li></ul>
</li>
<li>Bug fix for <code>refresh</code> command.
<ul>
<li><code>refresh</code> should now behave on the level / page it is called upon.</li></ul>
</li>
<li>Improved touch scrolling implementation. (cursor no longer is redrawn as touch scrolling is initiated)</li>
<li>Updated <code>libnx</code> from <code>v4.6.0</code> to <code>v4.7.0</code>.</li>
<li>Page left / right traversal now works with joysticks in addition to the d-pad.</li>
<li>Various bug fixes and command optimizations.</li></ol>
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.2...v1.6.3 Full Changelog: v1.6.2...v1.6.3] 

Update:
* Alignment correction for track-bar sliders and up / down bounce effect for track-bar cursors. (06/14/24 3:45 AM PST)
* Named step-bar tick indicator color and position correction. (06/14/24 3:53 AM PST)
* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v1.6.3...0eeef44 v1.6.3...0eeef44]

'''Version 1.6.2''' 
List of changes: 
* New methods <code>list_file</code> and <code>list_file_source</code> for reading lines from a text file.
** They are defined <code>list_file <path_to_text_file></code> / <code>list_file_source <path_to_text_file></code>.
** Their behavior is similar to a regular list with placeholders <code>{list_file(<index>)}</code> and <code>{list_file_source(<index>)}</code>.
* Bug fixes for nested package dropdown selections.
* Opaque screenshots will now be turned on by default upon initialization.
** To disable, enter the <code>Miscellaneous</code> menu and click the toggle item.
* Bug fixes for Tesla combo persistence.
* Addition of a couple more default Tesla combos as well as fixes for reading alternate user specified combos.
* Settings menu code revision. (for smaller compilation)
* Various <code>libtesla</code> alignment corrections.

Update:
* Widget alignment correction. (05/26/2024 2:44 AM PST)
* Couple additional key combos (added by request). (05/26/2024 3:32 AM PST)
* Slight footer alignment correction. (05/26/2024 5:08 AM PST)

'''Version 1.6.1'''
* New command mode <code>;mode=slot</code> for slot commands.
** <code>slot</code> commands are similar to <code>default</code>, but with the ability to set footers (similar to an <code>option</code> command).
* Various placeholder replacement bug fixes.
** Preservation of <code>null</code> arg with default to <code>Not available</code> upon final replacement.
** Placeholder replacements now no longer contribute to command success/failure. (determined now solely by commands themselves.)
** <code>{file_name}</code> replacements no longer include file extensions.
* Hex edits will now be unprocessed for <code>null</code> arguments and still return successful. (bug fix)
* New placeholder <code>{timestamp(<strftime>)}</code> for logging time as a variable.
** <code>strftime</code> are datetime formats like <code>"%Y-%m-%d"</code>.
* Nested layers bug fix (for nested layers beyond layer 1).
* Package forwarder bug fixes.
* Slight tweaks to libtesla.

'''Version 1.6.0'''
* More improvements to UI and libtesla.
** Rending related bug fixes and optimizations.
** Pixel blender bug fix (for transparency layer blending).
** Improvements to string/character length computations.
** Slightly improved cursor and menu layout.
* New themes values <code>selection_bg_alpha</code> and <code>table_bg_alpha</code> for blended transparency.
** Updates to <code>default</code> + <code>ultra</code> themes.
* New effect option <code>Opaque Screenshots</code> (located in Settings > UI Settings > Miscellaneous) for removing overlay transparency from screenshots for Ultrahand.
* Slight improvements to the <code>unzip</code> command method. (boundary case bug fixes)

'''Version 1.5.9'''
* More improvements and optimizations to the tables implementation.
** New option <code>;background=</code> which is a <code>true</code>/<code>false</code> value for drawing the table background.
** New configurable theme color <code>table_bg_color</code> for configuring table background colors.
* More refinements and optimizations to libTesla.
** Slightly faster rendering + cleanup of various implementations.
* Update to <code>default</code> and [https://github.com/ppkantorski/Ultrahand-Overlay/blob/main/themes/ultra.ini ultra] themes.
* Bug fix for Ultrahand starting opened after shutting down within an overlay. (only present in v1.5.8)
* Bug fix for nested package pages.
'''Version 1.5.8'''
* Numerous across the board optimizations and bug fixes. (Significant memory/speed improvements from v1.5.7.)
** Improved code structure and memory consumption.
** Optimized menu item sorting. (for drawing the <code>overlays</code> / <code>packages</code> menu)
** Improved themes loading implementation.
** New hiding overlay implementation. (animations + widget throttling correction)
** <code>set-ini-value</code> now will create folders if necessary when initializing new ini's.
** Bug fixes for <code>move</code> and <code>delete</code> commands.
** CURL global initialization. (fix for random crashes using download function)
** Bug fixes for default key combo initialization. (for fresh setups)
* New table implementation for drawing information.
** Table commands must start with <code>$</code> in the command name and include <code>;mode=table</code>.
** Additional options for configuring tables:
*** <code>;header=</code> is a <code>true</code>/<code>false</code> option for drawing the section header with the table.
*** <code>;alignment=</code> is a string value <code>left</code>, <code>right</code>, or <code>center</code> for controlling the value column alignment. (default value is <code>right</code>).
*** <code>;offset=</code> is an integer value for configuring the values column offset with a <code>left</code> / <code>center</code> alignment. (default value is <code>160</code>)
*** <code>;spacing=</code> is an integer value for configuring the newline spacings for drawing the table. (default value is <code>0</code>)
*** <code>;gap=</code> is an integer value for configuring the post-table gap. (default value is <code>3</code>)
** Placeholders are fully functional for drawing tables with parsed values. (json, hex, list, etc.)
** New theme color options <code>table_section_text_color</code> and <code>table_info_text_color</code>.
* New unzip + copy progress indicator.
* Progress animation. (see <code>Settings > UI Settings > Miscellaneous > Effects > Progress Animation</code>)
* Various subtle UI improvements and corrections.

'''Version 1.5.7'''
* List of changes:
** New function remove-ini-key for removing key/value pairs from a specified INI section.
*** remove-ini-key <path_to_ini> <desired_section> <desired_key>
** Unzip / copy progress indicator for background commands in progress. (similar to the download progress indicator)
*** WARNING: cp / copy now behaves more like the Shell / Bash version of cp, where it copies contents from the specified directory directly to the specified directory. it no longer forces a copy of the folder, requiring a potential rename.
** Buffer s and heap memory are now configurable from /config/ultrahand/config.ini. (see new package Memory Config)
*** This was added for additional configurations during testing.
*** When properly set, functions may gain a speed improvement. But configure with caution.
** Across the board optimizations and code revisions for faster functions with reduced memory.
*** Numerous revisions and improvements to libultra.
** Various minor bug fixes.
* Update:
** Copy folder related bug fix. (05/10/2024 6:51 AM PST)
** hex-by-custom-rdecimal-offset bug fix. (05/10/2024 4:59 PM PST)
** More slight optimizations + bug fixes with hexing. (05/10/2024 11:14 PM PST)

'''Version 1.5.6'''
* List of changes:
** Package path shortcuts implementation, called ./ for package path within command ini's.
*** i.e. /switch/.packages/<NAME_OF_PACKAGE>/ can now be called as ./
*** When fully utilized, this allows users to rename Ultrahand packages without any path conflicting.
** Basic toggles called without sourcing can now take a default state.
*** ;mode=toggle?on for defaulting to on when never clicked
*** ;mode=toggle?off for defaulting to off when never clicked (current default functionality for ;mode=toggle)
** backlight command now requires a on / off state. (bug fix)
*** Here is a simple way to use can the backlight function as a toggle.
*** [Backlight]
*** ;mode=toggle?on
*** on:
*** backlight on
*** off:
*** backlight off
** Numerous optimizations for a variety of the *_funcs.hpp methods. (faster menu drawing and commands)
** New scroll bar implementation has been corrected.
** Returning from a hidden overlay now takes you back to the hidden overlay menu.
** Reduced memory imprint of ovlmenu.ovl.
** Creation of libultra (restructuring of project into a custom library).
*** This allows users to potentially build their own Ultrahand Overlays when utilized with my libtesla fork.
*** To use, users simply need to copy the libs folder into their project, then import and use libtesla as they would normally.
* Update:
** Hidden package / overlay settings bug fix + setIniFile bug fix. (05/07/2024 5:49 AM PST)
*** If you did use v1.5.6 before this update, you might want to run this command once (just to be safe).
*** [Clear INIs]
*** delete /config/ultrahand/packages.ini
*** delete /config/ultrahand/overlays.ini
*** delete /config/ultrahand/theme.ini
*** delete /config/ultrahand/config.ini
*** delete /config/.packages/config.ini
*** delete /switch/.packages/*/config.ini
** Path shortcut fix for json_file_source + fix for commands grouped together with a package forwarder. (05/07/2024 4:04 PM PST)
** Wildcard pattern bug fix + move files/folders bug fix. (05/07/2024 8:55 PM PST)
*** This may have affected this line from executing properly delete /switch/.packages/*/config.ini. You may still want to run this command once if you used v1.5.6 earlier than the first update.
** More last minute wildcard pattern bug fixes. (05/07/2024 11:19 PM PST)

'''Version 1.5.5'''
* List of changes:
** Implementation of new package forwarders for extended Ultrahand packages.
*** To use forwarders, use command mode ;mode=forwarder with * in the command name.
*** Forwarder package is defined with package_source <PATH_TO_FORWARDED_INI>.
*** Additional commands listed along side package_source are executed upon click.
** UI related bug fixes and tweaks.
*** Scroll bar implementation has been modified.
*** Page alignment has been slightly adjusted.
*** Adjustments to spacing of info sections.
** Touch implementation has been cleaned up a bit more.
*** Fix for unmapped toggle commands (and others).
** Various minor menu traversing related bug fixes.
* Update:
** Nested package implementation bug fix. (05/05/2024)

'''Version 1.5.4'''
*List of changes:
**Better memory management and utilization of smart pointers. (potential memory leaks resolved hopefully)
**Interpreter thread now is initialized when command is ran.
**Root package commands now accept dropdown commands (similar to the current package command implementation).
**Removal of last_menu setting from /config/ultrahand/config.ini. (no longer needed)
**Setting key combo from the Settings Menu now also updates /config/tesla/config.ini. (for persistence reasons with libTesla overlays)
**Menu traversing related bug fixes.
**Various bug fixes.

'''Version 1.5.3'''
*List of changes:
**Removal of <sys/stat.h>/<cstdio> and implementation of <fstream> in every function.
**More improvements to make every function to make them thread safe (json, hex, ini, etc.)
**Slight restructuring of various sections of code.
**Reduction of compilation size.
**Various bug fixes and improvements.

'''Version 1.5.2'''
*List of changes:
**Numerous menu related memory leak bug fixes.
**Revision to the background thread implementation.
**Various improvements to download, json, ini, and path functions.
**Bug fixes for refresh function as well as exec boot.

'''Version 1.5.1'''
*List of changes:
**Full touch support is now included.
***You can now touch the logo/widget section to enter the settings menu.
**Multi-threading implementation for the interpreter.
***Package commands (except boot_package for now) now operate on a background thread, allowing users to hide the overlay during long tasks. This includes background downloads.
**Introduction of new theme coloring variables. (mostly for commands in progress)
**New ;system= command headers, called ;system=erista or ;system=mariko.
***These headers will only draw commands onto the menu depending upon what system they are being displayed on.
**New file path grouping types (will be better documented later with the revision of Mod Master, now planned for v1.5.2).
**Pressing L jumps back to the first item on the menu.
**Various bug fixes in download_funcs as well as libTesla.
*Update:
**Download progress implementation.
**Pressing R cancels / kills a command in progress.
**Many bug fixes.
**New command exit for exiting Ultrahand directly.
**Interpreter optimizations and stability bug fixes. (final update 04/25/2024)

'''Version 1.5.0'''
* Introduction of new pchtxt2ips method, called pchtxt2ips <PCHTXT_FILE_PATH> <OUTPUT_FOLDER>.
** This allows the easy conversion of .pchtxt files into .ips binaries.
* Download commands now show a downloading indicator (footer) to help users understand when a file is downloading.
* Failed replacements now return null instead of -1. Failed json replacements now return Not available (UNAVAILABLE_SELECTION variable).
* Bug fix for starring / favoriting hidden overlays and packages.
* libnx has been updated.

'''Version 1.4.9'''
*List of changes:
**Numerous refinements to the UI and libTesla.
***(cleanup alignments, rounded corner cursor, corrections to footer draw locations, listItem size, etc.)
**Expansion of the configurable themes.
***New variables for customizing background color, various text colors, logo color, and dynamic logo color.
***New themes light.ini and light-v2.ini (light mode themes) as well as updates for the rest.
**Introduction of DEFAULT_CHAR_WIDTH variable within the language json for more precise mapping of character width in alternate languages.
*Update:
**Slight default logo color tweak.

'''Version 1.4.8'''
*List of changes:
**Improved toggles implementation.
***Toggles no longer require a source and use the pre-generated config.ini for storing state information.
***Sidenote: Dropdown selection toggles still may require revisions to their implementation some time down the line.
**Failed variable replacements now return a value.
***Currently set to -1 for failed replacements, but may be revised to something more unique in the next update.
**Various bug fixes as well as code optimizations.
***This included a footer bug fix (was present in v1.4.6 but missing from v1.4.7).
***More memory related optimizations across a variety of functions.
**Updates to OC Toolkit (now at v0.3.6).
***Sys-clk Settings are now configurable from the Tools menu.
*Update:
**Another bug fix for option command selection footers. - 11/25/23 10:06 PM PST
**libTesla bug fixes (widget drawing related fixes). - 11/26/23 7:00 AM PST

'''Version 1.4.7'''
*Numerous code optimizations and revisions across the board for all methods.
**These ranged from bug fixes to stricter/cleaner memory management within functions.
**Especially helpful for downloading command failure related bugs.
*New commands:
**backlight toggles on/off the screen
**hex-by-custom-decimal-offset, hex-by-custom-rdecimal-offset (similar to hex-by-custom-offset but accepts decimal representations of hex for replacement.
**mariko:, erista: define code blocks that will execute based upon if the device is mariko or erista.
*Update:
**Bug fix for mariko: and erista: calls.
**More memory related optimizations. - 11/19/23 6:21 AM PST
**Default Tesla combo bug fix. - 11/20/23 2:40 PM PST
**Overlay sorting bug fix for overlays with _ within overlayNames. - 11/20/23 8:08 PM PST
**Last minute memory related optimizations. - 11/21/23 3:40 AM PST
**Rewrite of Studious Pancake's functions for IsErista and IsMariko. (bug fix) - 11/21/23 5:02 PM PST
**Bug fix for Not available commands in alternate languages. - 11/22/23 6:47 AM PST
**More libTesla optimizations. (faster menu). - 11/22/23 6:47 AM PST
**New clear command clear hex_sum_cache for clearing the hexSumCache. - 11/22/23 7:22 AM PST

'''Version 1.4.6'''
*Addition of a toggle-able User Guide (drawn by default on the Packages Menu).
*Reboot directly to Hekate menu now implemented within the reboot command.
**Called reboot hekate or reboot HEKATE (similar to reboot ums).
*Initialization / auto-generation of /config/tesla/config.ini for legacy compatibility.
**This is primarily for preserving hide/show hot keys within overlays.
**You are not required to ever touch nor modify /config/tesla/config.ini.
**Modifications within Ultrahand will automatically carry over.
*Default Tesla launch combo (L+DDOWN+RS) now works upon first run in addition to Ultrahand's default launch combo (ZL+ZR+DDOWN).
**The combo that is clicked first will be the combo that Ultrahand assumes.
**Combo can then be updated from the Settings Menu.
*Version Labels is now a subcategory within Miscellaneous in addition to Menu Items.
**Users can show/hide the User Guide from within Miscellaneous.
*Various bug fixes and implementation modifications.
**Update:
*Slight indentation cleanups.

'''Version 1.4.5'''
*New function try: for executing blocks/lines of code with error catching.
**Commands in the chain are still executed normally without try:.
**Subsequent try: statements blocks will be executed in order until success is reached throughout an entire block.
**(See updated examples Easy Installer and OC Toolkit.)
*New highlight color added to themes for "clicking".
**This color will only be applied when the selection background is set to not be drawn.
**When selection background is disabled, clicking backgrounds will also be disabled.
*If any of the lines within the command that involve sourcing, hexing, downloading, or unzipping fail, it will return a red cross symbol instead of a checkmark.
*Various bug fixes.

'''Version 1.4.4'''
*Theme manager is now built into the Settings Menu (PLUS / +).
**Themes will have their own custom name and be placed within /config/ultrahand/themes/<THEME>.ini.
*Themes have been expanded to include variables selection_text_color, selection_bg_color, disable_selection_bg and disable_colorful_logo.
**disable_selection_bg is set to true by default. This significantly improves the speed of rendering the UI, resulting in a smoother experience moving around (especially noticeable in the Script Overlay).
*Addition of several extra Key Combo button combinations on the Settings Menu. (ZL+ZR+PLUS, L+R+PLUS, PLUS+MINUS)
*Numerous libTesla bug fixes and optimizations.
**These ranged from improper cropping of certain menu items to correcting draw locations.
**Additional improvements to text scrolling.
**Half float data-type implementations.
*Update: 11/6/23 2:13 AM PST
*Bug fixes for download functions, json_source functions, and Package Info drawing.
*Updates, fixes and expansions to OC Toolkit (now v0.2.9).

'''Version 1.4.3'''
* Key combo initialization bug fix (primarily for people not coming from Tesla Menu).
** This bug made an initialized /config/ultrahand/config.ini file not write hotkeys to the ini without Tesla config files.
** Default key combo is now ZL+ZR+DDOWN if no key combo is found and will be auto generated with the config.ini.
* ListItem scrolling is now time synchronized in libTesla.
** When you under clock your device and see a long command name, this is especially noticeable.
** Previous behavior would scroll the text from left to right very slowly when clock speeds go down, then faster when they speed up.
** With time synchronized animation, behavior is standardized, creating an overall smoother experience on the menu. (better resource management)
* Various (minor) fixes and improvements.
* Update: 11/02/2023 10:49 PM PST
** Credits are now an addition in Ultrahand packages, called ;credits= (similar to ;about=).
*** Slight cleanup of scrolling implementation.
** smoothing effect has been added to scrolling (for cleaner animation)
** Toggles for "On" and "Off" for Ultrahand Packages now use the active language.

'''Version 1.4.2'''
* Built with latest libnx for official HOS 17.0.0 support.
** Temperatures are now working on HOS 17.0.0.
* Addition of UI Settings menu. (within Settings Menu PLUS/+).
** Widget for clock, temperature, and battery is now easily toggleable.
** Version Labels has been moved into it's own subgroup.
* Software Update is now its own subgroup with overlay info for Ultrahand as well as language update options.
** Ultrahand Overlay information is now displayed in the Software Update section.
* JSON placeholder replacement functions have been rewritten/improved.
* Various bug fixes and improvements.

'''Version 1.4.1'''
*Ini parsing and formatting related bug fixes.
**This fixes issues like the first key in your keyCombo not working in libTesla.
**Also improves formatting structure when adding in entries into ini files.
*Expanded themes and UI improvements.
**Themes (/config/ultrahand/theme.ini) now have options trackbar_color, highlight_color_1, highlight_color_2.
**The /config/ultrahand/config.ini also lets you control visibility of clock, temperatures, and battery.
**libTesla dynamic color effects are now synced to time instead of being driven by clock-speed. You will notice that even when under-clocking the color effects are always full speed.
*RebootToPayload functions via Studious Pancake (AMS 1.6.0+).
**The reboot command has now been expanded with payload / Hekate functionality. This was done in preparation for HOS 17.0.0.
***reboot ini <ENTRY_NAME> or reboot ini <ENTRY_INDEX>
***reboot boot <ENTRY_NAME> or reboot boot <ENTRY_INDEX>
***reboot /path/to/payload.bin
***reboot UMS
***reboot
**sidenote: Reboot by id is coming soon. All of these functions have been coded to work on both Mariko and Erista.
*Software updates for Ultrahand can now be performed from the Settings menu (PLUS / +).
*Launch arguments for overlays are now passable from /config/ultrahand/overlays.ini.
**You can press Y on an overlay to enter the Overlay settings menu, then enable/disable launch arguments.
**Launch arguments must be set by hand within /config/ultrahand/overlays.ini otherwise are initialized empty.
*Temperature now include both SOC and PCB temperature, but 17.0.0 implementation for temperature is currently still pending on libnx. (soon).
**Backend for implementation has been written and is currently commented out.
*Various updates to languages files (still a WIP).

'''Version 1.4.0'''
* Improvements to UI (battery, configurable clock, sensor, drawspace, etc.)
* International languages implementation.
** Language files go in /config/ultrahand/lang/*.json
** NOTE: Help is still needed to get some of these translations down. Language files are subjected to updates, but feel free to modify them yourself for your language.
* Expanded settings menu.
** key combo is now configurable from the Settings menu (PLUS)
* Start of themes implementation (text_color, clock_color, battery_color).
** Themes are stored in /config/ultrahand/theme.ini.
* Improved overlay sorting. (done by Overlay name instead of Overlay file name).
* Multiple bug fixes.
* Faster command interpreter. (update 10/20/23 9:23 PM PST)
** After inspection, this actually resulted a in ~0.4MB file size reduction.
* Sidenote: HOS 17.0.0 messed up temperature readings with libnx. This should be easily fixed once libnx is updated for 17.0.0.

'''Version 1.3.9'''
*Star-ing overlays is now done by pressing X instead of PLUS.
*Pressing PLUS on main menu now invokes the Ultrahand Settings menu (a page to control some settings in the config.ini).
*Pressing Y on top of an overlay / package pulls up the Menu settings for that particular item.
*New hidden overlays/packages page for storing hidden overlays/packages (will be drawn at the bottom when populated).
*New option clean_version_labels in /config/ultrahand/config.ini (can be set on Ultrahand Settings menu).
**Clean versions restricts all displayed version labels into a X.X.X format.
*Various bug fixes.

'''Version 1.3.8'''
*Introduction of Pages: Now, you can define pages using empty commands [@PAGE1] and [@PAGE2], where PAGE1 and PAGE2 are labels for the page. Note that only two of these empty @-commands can be referenced in a package. You can navigate between PAGE1 and PAGE2 using the left and right buttons on the DPAD.
*New Command remove-ini-section: I've added a new command called remove-ini-section <ini_file_path> <section_name>. This command allows you to quickly remove a section from an INI file.
*Package Info Section: You can now include a Package Info section within your package.ini file by using [Package Info] as an empty command. If there's no reference to [Package Info], the package info section will not be displayed.
*Package title colors now accept custom RGB888 hex representations (i.e. #FFFFFF for white).
*NOTE: RGB888 hex color format will be downscaled to RGB444 for libTesla compatibility.
**Bug Fixes: Addressed various bug fixes, including a memory leak issue on the main menu.
*New updates to OC Toolkit.

'''Version 1.3.7'''
*Hex offset caching has been implemented for faster hexing read/write calls.
*Various additional improvements to hex functions.
*New true/false property hide for packages.ini and overlays.ini to toggle visiblity.
*New command logging to enable/disable command logging (now off by default).
*New command clear for deleting Ultrahand relavent files (so far only clear log works).
*New ;color= header definition in package.ini for choosing colors for your package title.
**Colors: red, green(default), blue, yellow, orange, purple, pink, white, ultra(wip)

'''Version 1.3.6'''
*Added the ability to define functions in boot_package.ini other than boot.
*Enabled referencing and execution of global functions defined in boot_package.ini from your script using exec <COMMAND>.
*Introduced a new refresh command to redraw the current menu page.
*Various bug fixes as well as improvements to OC Toolkit.
*Menu related bug fix (memory leak). Opening and closing selection overlay with dictionaries was not unloading the dictionary. Issue has been resolved.
*If a command has the footer "Not available" it will no longer function.

'''Version 1.3.5'''
*Introduction of boot_package.ini (commands that will run when your package is opened). This file is placed in the same folder as your package.ini file.
*Introduction of new hex_file advanced function for reading/parsing hex data from files.
*Introduction of command tags, i.e. [COMMAND?Tag]. Tags are not printed, but are helpful for making similar named commands unique (which is essential).
*New example package OC Toolkit for advanced modifications of kip files. (WIP)
*Update:
*Ive added a new function ini_file to read data from ini files.
**ini_file <ini_file_path> is how it is defined.
**{ini_file(section, key)} is how it will be called.

'''Version 1.3.4'''
* List of changes:
** Empty commands now define grouping sections.
** Empty commands with a * at the start of them define group commands. Commands defined after will show up in a dropdown menu.
** To end the identification of a group command, a group section must be defined.
** New command set-footer.
** Various bug fixes.
*Basic example:
<pre>
[Section 1]
[*Test]
;mode=option
list_source '(test1, test2, test3)'
set-footer {list_source(*)}

[*Timings]
;mode=option
list_source '(1, 2, 3, 4, 5, 6)'
set-footer {list_source(*)}

[*Commands Group]
[*Test2]
json_source '[{"key_1":"entry 1", "key_2":"entry 2", "key_3":"entry 3"}, {"key_1":"entry a", "key_2":"entry b", "key_3":"entry c"}]' key_1

[Section 1]
[*Test3]
;mode=option
list_source '(test4, test5, test6)'
set-footer {list_source(*)}
</pre>
*update:
**Bug fix for selected footer after entering command groups. - 10/3/2023 4:48 PM

'''Version 1.3.3'''
* List of changes:
** Fixed dropdown toggles. (Setup double click prevention to ensure commands are properly parsed.)
** New option command mode for selections. (useful for developing configurators scripts.)
** New auto-generated config.ini for each package.ini within the package folder. Settings will be parsed from package.ini if provided as a comment.
*** mode: this can be set to default, option, or toggle.
*** grouping: this can be set to default or split (split splits commands into groups based upon subfolders)
*** footer: null by default. When used with option mode, it can be dynamically read on the menu.
** DONE is now replaced by a checkmark.
* Basic Option Example:
** Package: /switch/.packages/Test/package.ini

'''Version 1.3.2'''
* Bug fixes with interpreter allocating too much memory.
** This affected unzip and download in certain test cases, but is no longer an issue.
** Easy Installer and other download packages should now work properly again.
* UPDATE: (stable)
** Root menu commands (/switch/.packages/package.ini) now behave the same way as package menu commands.
** Config menu has now been fixed. (09/26/23 11:21 PM)
** Multiple menu related bug fixes. (09/27/23 2:25 AM)

'''Version 1.3.1'''
* json_data (the non source version) is now json_file.
* json is now a new non-source version of json_source for storing data within the package.ini.
* list_source has been fixed. Items defined in list can be called by {list_source(<INDEX>)}.
* list is now a new non-source version of list_source. Items defined in list can be called by {list(<INDEX>)}.
* Re-built interpreter and SelectionMenu/SubMenu.
* Introduction of selection modes ;mode=.
* Drop of _on and _off functions.
** Sections can be defined using ;mode=toggle and on: followed by the on commands and off: followed by the off commands.

'''Version 1.3.0'''
*config.ini is now package.ini for Ultrahand packages.
*source is now file_source
*source_on is now file_source_on
*source_off is now file_source_off
*json_source is now json_file_source
*New function json_source for defining JSONs directly within the package.ini file.
**Example: json_source '[{"key1":"value1"}, {"key1":"value2"}]' key1
*Menu item sorting are now implemented differently.
**New files /config/ultrahand/overlays.ini and /config/ultrahand/packages.ini for manually specifying priority and storing information.
**Priority value is a number from 0 to 9999

'''Version 1.2.1'''
* hide_overlay_versions and hide_package_versions are now true or false options within /config/ultrahand/config.ini.
* hex-by-custom-offset is now a new command for using custom string pattern offsets for more advanced hex-editing scenarios.
* New wildcard source command type list_source implementation for specifying list variables within package inis.
* Several bug fixes.

'''Version 1.2.0'''
* Commands now state "DONE" after pressed.
* Bug fix for "set-ini-value". Issue was that for a new entry, it would inject the new entry into every section.
* Simple fix, but since its bound to affect someone's project eventually, I'm updating the release.

'''Version 1.1.9'''
* Bug Fixes: Static menu variable and rootFrame handling.
* These bug fixes potentially resolve the menu handling issue that occasionally can occur for some testers.
* Overall it should be more stable with static implementations of the particular variables I modified.

'''Version 1.1.8'''
* Introduction of footers for commands.
* Testing potential bug fix for handling menu input.
* This issue is not very common, but occasionally the menu can get locked into a weird orientation, preventing you from moving to packages or overlays at times. Its hard to figure out the exact trigger, but I've attempted to address the issue here. Pre-release will be dropped after more testing. If you see this bug on this version, do let me know in issues.

'''Version 1.1.7'''
* Download and unzip files implementation has been added.
* Command to download:
** download <FILE_URL> <DESTINATION_FILE_OR_FOLDER>
* Command to unzip:
** unzip <SOURCE_FILE> <DESTINATION_FOLDER>
* CURL has made it a bit beefier as you can tell, but the potential benefits are pretty great for having these commands handy. Lots of new packages can be made for updating and installing software.
* update: slight bug fix for handling more URLs (07/07/2023)
* update: bug fix for unzip and createDirectories (07/08/2023)

'''Version 1.1.6'''
* Move commands now create directory if the directory does not exist.
* Bug fix for exiting main menu that can sometimes occur when exiting (locked users in the menu until an item is selected).
* Multiple filters are now implemented. filter, filter_on, filter_off calls will store your filter path into a list.

'''Version 1.1.5'''
* Bug fix for those who specify their default menu mode instead of resorting to last_menu.
* Several cosmetic improvements.
* Easier transition from Tesla Menu by copying combo from sdmc:/config/tesla/config.ini if it exists and the combo is not within sdmc:/config/ultrahand/config.ini.
* update: more cosmetic improvements after initial release (only difference)

'''Version 1.1.4'''
* Ultrahand is now a replacement for ovlmenu.ovl.
* Ultrahand packages are now relocated to sdmc:/switch/.packages/.
* Ultrahand specific settings are now stored in sdmc:/config/ultrahand/config.ini.
* Left on the menu takes you to your overlays.
* Right on the menu takes you to your packages and commands.
* More improvements to come.

'''Version 1.1.3'''
* Introduction of more selection command features.
* Multi-wildcard statements.
* New functions 'mirror_copy' and 'mirror_delete' for implementing mirror functions on directory contents.
* All copy functions now create destination directories.

'''Version 1.1.2'''
* Selection (wild card commands) toggles are now implemented.
* Simple one line filter added. (see updated examples).

'''Version 1.1.1'''
*Introduction of wildcard commands (new command-type).

'''Version 1.10.0'''
* Pre-release: Testing new hex editing functions.
* New commands "hex-by-offset", "hex-by-swap", "hex-by-decimal", "hex-by-rdecimal"
* Still needs more testing to confirm full functionality, but since it appears to be compiling properly ill leave it here for now for testing.

'''Version 1.0.9'''
* Implemented safeguards so you don't delete or move your entire SD card or essential files. Still have more features to implement for this version, it should be better than using 1.0.8 but since I made changes that need review I am still calling it pre-release for now.
* Update: More advanced pattern searching. Multiple wildcards. 2:42 AM PST 06/08/2023
* Update: Updated safeguards for more advanced patterns. 3:16 AM PST 06/08/2023

'''Version 1.0.8'''
*Added new feature "new-ini-entry" and restored original example config.ini generated if no config is present.

'''Version 1.0.7'''
*Improvements to menu. Version handling for user packages.

'''Version 1.6'''
* More improvements, "edit-ini" commands have now been labeled "set-ini". You can also press X on an individual command and see and execute individual lines within.
** Update: Faster copying. - 05/31/23 4:19PM PST
** Update: Even faster copying. - 05/31/23 4:35PM PST
** Update: Slight size reduction. - 06/01/23 6:34PM PST

'''Version 1.0.5'''
* Too many bug fixes with statement logic.
* Ability to execute individual commands from a package have been added (press X on package).
* More slight tweaks and capabilities packed into the functions.
** Update: Fixed editINI adding new lines by mistake. - 05/29/23 05:16 PM PST
** Update: Fixed copy directory not copying subdirectories. - 05/29/23 05:59 PM PST
** Update: Edit ini key or value now. - 05/29/23 09:40 PM PST

'''Version 1.0.4'''
*Slight tweaks to libtesla. This is pre-release, but it is still commits ahead of 1.0.3 and stable.
**Update: Got new features as well as pattern searching implemented. New documentation coming soon. 05/29/23 9:11 AM PST

'''Version 1.0.3'''
* Improvements to code structure, menu layout, new commands (reset, shutdown), etc.
** Update: Copy function now can rename to file as well as copy to directory. This makes it simulate "cp" a bit better. - 05/27/23 7:37 AM PST
** Update: Fixed edit-ini bugs. - 05/27/23 2:21 PM PST
** Update: Fixed even more edit-ini bugs. Should be working. - 05/27/23 3:27 PM PST
** Update: Fixed one last edit-ini bug for handling command. Testing safer reboot method. - 05/27/23 9:40 PM PST

'''Version 1.0.2'''
* Folders have now been added.
* Future plans: cleaner UI, separation for "Packages" and "Commands" sections with titles.
** Update: Fixed a bug that occurred with linking folders. - 05/28/23 05:59 PM

'''Version 1.0.1'''
* New feature 'parse-ini'.
* Update: Delete directory bug fix. - 05/28/23 8:11 AM PST

'''Version 1.0'''
* First Release.
**Update: Improved structure and examples for testing. - 05/25/23 5:52 PM PST

== External links ==
* GitHub - https://github.com/ppkantorski/Ultrahand-Overlay
* GBAtemp - https://gbatemp.net/threads/ultrahand-overlay-the-fully-craft-able-overlay-executor.633560/

Tetris Overlay Switch

2026-07-17T02:09:04Z

HydeWing: 0.5.2

{{Infobox Switch Homebrews
|title=Tetris Overlay
|image=TetrisOverlaySwitch.png
|description=A Tetris overlay for the Nintendo Switch.
|author=ppkantorski
|lastupdated=2026/07/12
|type=Overlays
|version=0.5.2
|license=GPL-2.0
|download=https://github.com/ppkantorski/Tetris-Overlay/releases
|website=https://gbatemp.net/threads/tetris-overlay.661021/
|source=https://github.com/ppkantorski/Tetris-Overlay
|donation=https://ko-fi.com/ppkantorski
}}
{{#seo:
|title=Switch Homebrew Apps (Overlays) - GameBrew
|title_mode=append
|image=TetrisOverlaySwitch.png
|image_alt=Tetris Overlay
}}

An [[Ultrahand Overlay Switch|Ultrahand]]-enhanced Tesla overlay that brings classic Tetris gameplay to the overlay menu. This overlay allows for in-menu gameplay with dynamic UI elements, saving and loading of game state, and high score tracking.

== Features ==
* '''Ultrahand Integration:''' Enhanced with Ultrahand libraries for smooth and seamless gameplay with Ultrahand system settings and improved rendering.
* '''Classic Tetris Mechanics:''' Enjoy traditional Tetris gameplay, including line clears, level progression, and scoring.
* '''Dynamic UI:''' Provides a responsive interface with previews of the next and stored Tetriminos.
* '''Save and Load:''' Save your game progress and load previous games seamlessly.
* '''Pause and Resume:''' Easily pause and resume the game without losing progress.
* '''High Score Tracking:''' Tracks your highest score across sessions.
* '''In-Game Access:''' Launch the overlay directly within games using Ultrahand Overlay (or Tesla Menu).

== Installation ==
Ensure you have a homebrew-enabled Nintendo Switch with [https://github.com/ppkantorski/Ultrahand-Overlay Ultrahand Overlay] (or Tesla Menu) installed.

Download the latest release of Tetris Overlay from the [https://github.com/ppkantorski/Tetris-Overlay/releases Releases].

Copy tetris.ovl to the sdmc:/switch/.overlays/ directory on your Nintendo Switch's SD card.

Open the [https://github.com/ppkantorski/Ultrahand-Overlay Ultrahand Overlay] (or Tesla Menu) and launch the Tetris Overlay.

==User guide==
The game state is automatically saved upon pausing or exiting the overlay.

To load a previous session, start the overlay again.

== Controls ==
'''In game:'''

Left/Right - Move the Tetrimino left or right

Down - Soft drop the Tetrimino

Up - Hard drop the Tetrimino

A - Rotate the Tetrimino clockwise

B - Rotate the Tetrimino counterclockwise, Exit the game on pause

L - Swap the current Tetrimino with the stored one

Plus - Pause or resume the game

'''On game over:'''

A or Plus - Restart the game

==Screenshots==
[[image:TetrisOverlaySwitch.png|link=]]

==Compatibility==
HOS 16.0.0+

==Changelog==
'''0.5.2'''
* Re-compilation with latest <code>libultrahand</code> (v2.5.2).

'''0.5.1'''
* Hold down piece dropping bug fix.
** In the prior version, holding down was triggering a rapid spam of subsequent piece slams.
* Sleep halting of the background event poller in libultrahand (to prevent all polling activity during shallow sleep).

'''0.5.0'''
* Compilation with latest <code>libultrahand</code> (v2.4.1).
* Quick Update:
** <code>hide_widget_border</code> variable linking bug fix. - 04/20/2026 7:56 AM PST

'''0.4.9'''
* Piece drop height correction (now always aligned with its bottom most edge directly above the game board's top).
* Game board, pieces, and particles now respect renderer->a (the opacity limiter).
* Feedback corrections (for latest libultrahand) , settings sound effect for pausing / unpausing, move sound effect for piece swapping.
* Slight code optimizations, alignment corrections, and more.
* Exit feedback correction in libultrahand v2.4.0 during active notifications. - 04/19/2026 12:51 AM PST
* Piece swapping initial height bug fix. - 04/19/2026 8:24 AM PST

'''0.4.8'''
* Wall kick bug fix for L pieces.
* Code cleanup / optimizations.
* Improved notifications and feedback (from latest libultrahand).

'''0.4.7'''
* Line clearing score has been repositioned for unrestricted view of the game board.
* Slight code cleanup.

'''0.4.6'''
* Recompilation with latest libultrahand (v2.2.7).
* Removal of disableSound (for click sounds when tapping on the bottom menu bar).

'''0.4.5'''
* Recompilation with latest libultrahand (v2.2.3).
* Improved piece rotation logic.
* Improved haptics logic.
* "Game Over" particle rain effect.

'''0.4.4'''
* Recompilation with latest libultrahand (v2.2.1).

'''0.4.3'''
* Bug fix for save data not being stored (sdmc:/config/tetris/ was not being generated on startup).

'''0.4.2'''
* Improved piece rotation logic + fixes for clicks resetting the drop timer when they should not be.
* Updated for proper nx-ovlloader v2.0.0 support (in libultrahand).

'''0.4.1'''
* Recompiled with latest <code>libultrahand</code> (v2.1.8).
* <code>libnx</code> has been updated for <code>AMS 1.10+</code> support.
* Haptics have now been implemented (on when enabled in the Ultrahand settings).
* Slight tweaks to compilation settings.

'''0.4.0'''
* Recompiled with latest <code>libultrahand</code> (v2.1.4).
** Various fixes within <code>libultrahand</code>.

'''v0.3.9'''
* New notifications implementation.

'''v0.3.8'''
* Recompiled with latest libultrahand (v2.0.1).
** Underscan fixes, controller input isolation and more.

'''v0.3.7'''
* Recompiled with latest <code>libultrahand</code> (v2.0.0).
** Overlay / package launching, <code>libultrahand</code> signature, etc.
* Bug fix for bottom menu touch regions.
* Variable optimizations and removal of <code>fstream</code>.
* Quick update:
* Save state on exit bug fix.
* Better input isolation for <code>KEY_L</code>.

'''v0.3.6'''
* Tetris pieces are now dropped with exactly 1 block's distance into the game-board frame.
* Updated with latest <code>libultrahand</code> (v1.9.10).
** Improved widget, slightly improved rendering, etc.

'''v0.3.5'''
* Various code and compiler optimizations for smoother gameplay.
* Updated using latest libultrahand (from Ultrahand Overlay 1.9.6 pre-release).
* Faster rendering than v0.3.4; true 60fps on stock clocks with wallpapers.

'''v0.3.4'''
* Significant rendering improvements and bug fixes in libultrahand.
** 60fps rendering with wallpapers.
** Foreground bug fix (losing input isolation during title ID changes).
** Various code optimizations and library updates.

'''v0.3.3'''
* Bug fix for B key exiting when it should not be.
* Increased duration for screenshot opacity.

'''v0.3.2'''
*Updated for compilation with latest libultrahand (v1.8.2).

'''v0.3.1'''
*Updated with new libtesla and libultra from Ultrahand v1.7.8.

'''v0.3.0'''
* Improved texture design.
* Slight fixes to rotation logic.
Update:
* Slight adjustment to kick logic. - 09/26/2024 11:15 PM PST
* Spawn new piece centering bug fix. - 09/26/2024 11:54 PM PST

'''v0.2.9'''
* More fixes to various Tetris piece movement / rotation (as well as auto-locking).
** More boundary cases have been addressed.
** Pieces will no longer rotate indefinitely.
** Pressing <code>down</code> on the floor will now trigger a hard drop.
* Fixes to <code>Game Over</code> prompt delay.

'''v0.2.8'''
* Slight improvement to block texture design.
* Bug fix for combo variables not resetting upon new game.
* More fixes to piece rotation, kicks and placement.
* Various subtle UI tweaks.

'''v0.2.7'''
* Previews for next 2 Tetris pieces have been added.
* Scores for each line clearing event are now rendered, along with the clearing event. (like <code>T-Spin Double</code>, <code>2x Tetris</code>, etc)
* New particle effect for fast dropping pieces (clicking up).
* Fixes to sliding pieces left / right on floor. (limit to number of floor sides possible before locking)
* Fixes to pieces not automatically locking when rotation is not possible (but rotation is pressed).
* Improvements to the new game particle burst effect.
* Various minor bug fixes and subtle UI tweaks and improvements.
Update:
* Fix for next 2 Tetris pieces not resetting upon new game. - 09/24/2024 12:17 AM PST
* Symbol indicator for pieces. - 09/24/2024 12:34 AM PST
* Expansion of save states to preserve back to back combo variables. - 09/24/2024 3:37 AM PST

'''v0.2.6'''
* More bug fixes.
** Fixed a bug that caused a crash when clearing lines near the top of the board.
** Fixed the piece lock duration / duration reset function. (so items don't just hit the floor while you are still spinning them)
** Various additional safety measures.
* Various UI improvements.
** Improved clear line event indicator.
** New game particle effect.
* Dynamic color logo property is now read from Ultrahand's <code>theme.ini</code> again.
Update:
* Bug fix for line clear event indicator causing screen flicker during paused game. - 09/23/2024 3:07 AM PST

'''v0.2.5'''
* New line clearing particle-burst effect.
* New "ghost" piece preview for placing Tetris pieces with higher accuracy.
* Improved scoring and falling speed according to level.
* Clear event details for number of lines cleared. (like "Single", "Double", "Triple", or "Tetris")
* Various minor UI improvements.
Update:
* Lines cleared logging bug fix. - 09/22/2024 3:27 AM PST
* "Tetris" event text cleanup. - 09/22/2024 3:33 AM PST
* Slight bug fix. - 09/22/2024 4:02 AM PST
* Another slight bug fix. - 09/22/2024 4:43 AM PST
* Piece initial position bug fix. - 09/22/2024 5:00 AM PST
* Potential crash related bug fix. - 09/22/2024 6:40 AM PST

'''v0.2.4'''
* Improved controls.
** Directional click and holds now functions properly.
* Clean-up of UI.
** Ultrahand widgets are now rendered.
** Ultrahand swipe to open and opaque screenshots settings now function properly.
** Cleanup of button labels and colorization of application title.
* Custom wallpaper override option.
** This is done by placing an Ultrahand <code>wallpaper.rgba</code> into <code>sdmc:/config/tetris/</code> and requires <code>nx-ovlloader+</code> to function.
* Custom theme override option.
** This is done by placing an Ultrahand <code>theme.ini</code> into <code>sdmc:/config/tetris/</code>.
* Various bug fixes.

'''v0.2.3'''
* First Release.

== External links ==
* GitHub - https://github.com/ppkantorski/Tetris-Overlay
* GBAtemp - https://gbatemp.net/threads/tetris-overlay.661021/

NX Mod Manager Switch

2026-07-17T02:08:59Z

HydeWing: 3.2.9

{{Infobox Switch Homebrews
|title=NX Mod Manager
|image=NXModManagerSwitch.png
|description=Nintendo Switch Mod Manager.
|author=TOM-BadEN
|lastupdated=2026/07/13
|type=Utilities
|version=3.2.9
|license=GPL-2.0
|download=https://dlhb.gamebrew.org/switchhomebrews/NXModManagerSwitch.7z
|website=https://gbatemp.net/threads/nx-mod-manager-v2-0-0-a-local-mod-manager-for-the-nintendo-switch.675101/
|source=https://github.com/TOM-BadEN/NX-Mod-Manager
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Utilities) - GameBrew
|title_mode=append
|image=NXModManagerSwitch.png
|image_alt=NX Mod Manager
}}
NX Mod Manager is a mod management tool designed specifically for the Nintendo Switch platform. The current version features a complete code rewrite and underlying architecture redesign, with significant improvements in both functionality and stability. The project is fully open-source and permanently free, with no paid content of any kind. It supports online browsing and downloading of mods, and provides a complete on-device management workflow, allowing mod acquisition and management without manually handling the SD card. The development and maintenance of online mod resources relies on the participation and contribution of the community.

'''Note:''' Please use at your own risk.

== Features ==
* Game Management - Add games from installed game list or by manually entering TID; supports game removal and favorites.
* Mod Management - Add, install, uninstall, and remove mods; compatible with both ZIP archives and folder formats.
* Patch Conversion - Automatically converts pchtxt text patches to IPS patches during mod installation.
* Smart Detection - Automatically identifies mod files with non-standard directory structures and detects file conflicts between mods.
* Smart Search - Supports pinyin, polyphone, initials, fuzzy matching and other search methods, deeply adapted for Chinese users.
* Mod Toggle - One-click disable or restore all mods for quick game issue troubleshooting.
* File Transfer - Supports MTP (USB wired) and FTP (Wi-Fi wireless) for transferring mods to the console.
* Online Store - Built-in mod store with browsing, searching, downloading and uploading; includes like and comment features.
* Customization - Customize various content such as game name, mod name, description, version, author, and type.
* Multi-language - Simplified Chinese, Traditional Chinese, and English interfaces.
* Theme Switching - Light and dark themes with automatic system-following option.
* Auto Update - Check and download new versions within the app.
* Force Cleanup - Fix reference count corruption caused by abnormal interruptions.

== Installation ==
Download the [https://github.com/TOM-BadEN/NX-Mod-Manager/releases latest .nro file] and install it on your SD card.

For detailed usage instructions, please view the basic tutorial within the app under "About" or the [https://www.bilibili.com/video/BV1zd5o6wE5B/ video tutorial].

==Screenshots==
{| style="max-width:80%; margin-left:0em;"
|
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-03.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-04.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-05.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-06.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXModManagerSwitch-07.png
|}

==Changelog==
'''v3.2.9'''
* A few users may crash after auto-update finishes
* No need to worry, this bug was accidentally added last version, restart your device to resolve it
* I’ve been busy lately, so this version is mainly for bug fixes
* The next version will add more support, including Don't Starve, RAR and 7z
* The program will force you to update if a new version is detected on startup
* Because many users using old versions reported to me that they couldn't find features that belong to the new version
* Redesigned layouts for long-text popups, more intuitive and neat
* Fixed auto game version update failure on firmware 21-22
* Fixed crashes caused by continuous popups in extreme cases
* Fixed store mod detail page navigation logic inconsistent with intuition
* Fixed missing sound when clicking buttons on the second screenshot of mod detail page
* Fixed progress bar briefly showing 100% during auto-update
* Fixed screen flicker when switching tabs on plugin page
* Fixed upload failure when upload page uses non-Chinese language
* Surprisingly, no users reported this bug
* Non-Simplified Chinese users shouldn’t upload on Simplified Chinese page, which breaks auto-translation

'''v3.2.8'''
* Optimized serial number adaptation mechanism for Monster Hunter Rise mod files
* A bubble notification will pop up in the upper right corner when a new version is detected
* Game icons on the store page are cached locally to greatly improve loading speed
* Significantly boosted icon loading speed after searching and filtering on the store page
* Reorganized and categorized the function settings menu on the homepage
* Added an icon repair function in the function settings menu
* Added CPU acceleration function in the function settings menu (recommended to enable)
* Added a button on the store page to view the web address of uploaded mods
* Added author link viewing feature on the store mod detail page
* Fixed the issue where non-standard aspect ratio images would have stretched edges in the image viewer on the store mod detail page
* Fixed the problem that overly long comments cannot wrap lines correctly on the message board
* Adjusted partial UI texts
* Optimized other task workflows

'''v3.2.7'''
* Self-update from v3.1.7 may crash. Restart to recover
* Added mod support for Asian and European versions of Monster Hunter Rise
* Supports mod install and uninstall for versions v3.4.1-v16.0.2
* The manager automatically corrects special mod file numbering for this game
* Because this game's rules are complex, please follow these rules:
* Clear existing Monster Hunter Rise mods from the SD card before using the manager
* Do not manually modify this game's mod files or use third-party tools while using the manager
* If an issue occurs, use Force Clean to remove all mod files for this game from the SD card
* Download limit messages now show the specific rules
* Comment nickname settings moved to the home page Settings menu
* A quick setup window appears when commenting in the store page without a nickname
* Uninstalling now always removes <code>romfs_metadata.bin</code>
* Mod installation now filters out files and folders starting with <code>.</code>
* After searching in the store page, the B button now resets the search
* Fixed abnormal CPU usage caused by memory monitoring
* Fixed possible home page card display issues after adding a game
'''v3.1.7'''
* Emergency update to fix a bug. Monster Hunter mod support has been postponed to the next release
* Fixed an issue introduced in v3.1.6 that could cause the FTP server to hang during startup
* Anonymous users on the message board will now see their display name correctly localized based on the selected language
* Timestamps in update logs are now automatically converted to the local time zone
'''v3.1.6'''
* Preview: the next version will add support for Monster Hunter mods
* Fixed the issue where store icon loading and mod downloads became extremely slow during evening hours due to server bandwidth throttling by the service provider
* Thanks to @[https://github.com/huangsam04 huangsam04] for generously providing a mirror server for file acceleration
* Added a Y button on the store mod details page to view the mod update history
* The local mod details page now automatically checks whether downloaded mods have available updates
* When a mod file on the cloud is updated, it can now be directly updated and downloaded from the store mod details page to replace the original mod
* Improved mod download speed, but considering server pressure, the limit has only been raised and not completely removed
* Reused TCP connections to improve icon loading speed on the store game list page
* romts_metadata.bin is now forcibly deleted when uninstalling a mod
* Fixed an issue that occasionally caused the page title bar to flicker
* Fixed a memory leak in the store
* Fixed an issue where full Pinyin search could not be used in the store search function
'''v3.1.5'''
* Fixed an issue where the game version displayed in the store would not update correctly after the installed game version on the console changed
* Fixed an issue where local data for downloaded mods could be lost after entering the store from the mod list page (causing mod icons to appear as question marks)
* Improved the store's detection mechanism for downloaded mods (please do not manually delete mod files inside the SD card's mods2 directory, as doing so will still prevent the mod from being downloaded again)
* Fixed an issue where the focus box would briefly flicker after returning to the home page from the mod list page after adding a new mod
* Improved the automatic cleanup process triggered when mod installation fails, including a new warning sound effect and a red progress bar during the cleanup phase
* Updated the download rate limit message to: “Server resources are limited. Downloads are restricted to once every 30 seconds. Thank you for your understanding.”
* Minor adjustments to various UI details and text presentation
'''v3.1.4'''
* Fixed several missing English text entries
* Sorry, I’ve been too busy and forgot to test the multilingual support in the previous version.
'''v3.1.3'''
* Fixed compatibility issues with certain 19.x firmware versions, such as 19.0.1
* Fixed an issue where the interface would not refresh immediately after closing the mod install/uninstall completion popup with the B button
* Fixed freezes and crashes caused by focus issues when opening the menu during page transitions
'''v3.1.2'''
* Redesigned the Home, Store, and Local Add pages from a 9-grid layout to a large card layout for a more modern UI
* Added page transition animations to improve visual distinction when switching between certain pages
* Home, Store, and Local pages can now be quickly switched using trigger buttons
* Added skeleton screen loading effect to the Store game list page
* Added "Return to Home" and "Mod List" buttons to the post-download dialog in the Store
* Added "Return to Home" button to the completion dialog in Local Add
* The top title on the Mod List and Store pages now displays the game version number for locally installed games
* Adjusted the long-press dialog text on first launch of the Home page for better guidance
* The Store button on the Home page has been merged into the X menu
* The Favorites menu option on the Home page is now triggered directly via the + button
* Added "Sort by Count" and "Sort by Recent" options to the Home page X menu
* Added a toggle to disable button sound effects in the Home page settings menu
* Significantly adjusted text and function option positions in the Home page X menu to improve interaction and guidance
* Added a long-press dialog on first entry to the Mod List page for better guidance
* Removed the + Store button from the Mod List page; it has been merged into the X menu
* Significantly adjusted text and function option positions in the Mod List page X menu to improve interaction and guidance
* The Mod List page now allows deletion of the last remaining mod
* Added quick access to the Store page and Local Add menu via trigger buttons on the Mod List page
* Added a long-press dialog on first entry to the Local Add page for better guidance
* The game list on the Local Add page is now sorted exclusively by recently played order
* The tutorial QR code on the About/Plugins page is now scannable
* Completely rebuilt asynchronous threading to enhance stability and improve page transition smoothness
* Fixed a crash caused by entering non-English characters via the native keyboard when using a custom keyboard
* Fixed a crash caused by games using the new NACP format (e.g., The Legend of Zelda: Breath of the Wild version 1.9.0)
'''v3.0.2'''
* Fixed an issue where the focus behaved incorrectly when removing the last game
* Fixed an issue where the homepage would not display games after adding mods via network or locally on first use of the project
* Reduced the number of times the SD card game directory name uses the TID when automatically adding games (thanks to [https://github.com/WE1ZARD @WE1ZARD] for the cleaning algorithm)
* Added a "Reset Status" feature, located at Home → Menu → Manage Games → Reset Status. This allows users to clear all internally saved project state data, such as mod installation status and conflict records, after reinstalling the Atmosphère modpack using a delete-and-reinstall method
'''v3.0.1'''
* Fixed the issue where using the Disable Mod, Restore Mod, or Force Clean functions failed to correctly handle IPS (exefs_patches) files
'''v3.0.0'''
*Although this is a subsequent version, it is a major overhaul: the entire project has been rewritten, and the architecture has been redesigned. It is incompatible with the old version of the manager. Users of the old version must first use the old manager to uninstall all installed mods before installing the new version.
*Completely new UI design, improved quality.
*Redesigned various interactions, enhanced user experience.
*Added online mod download feature, covering 200+ games and 380 mods in total, including hundreds of exclusive mods. Thanks to Qingfeng Mingyue for the free contribution.
*Two theme color schemes available, freely switchable.
*Mod store content supports Simplified Chinese, Traditional Chinese, and English, and automatically adapts to the user's system language.
*Mod store content supports fuzzy search by Pinyin, initials, or English.
*Supports <code>pchtxt</code> files, which are automatically converted to IPS files during installation.
*Adopts a new custom keyboard in multiple places, improving aesthetics and smoothness.
*Full touch support, can be used entirely without a controller.
*Supports self-updating plugins, no need to monitor release pages.
*Game names customizable, can be fetched from the server database, supporting Simplified Chinese, Traditional Chinese, and English.
*Plugin text itself supports multiple languages; currently only Simplified Chinese, Traditional Chinese, and English. If you wish to add new languages, please do not submit a PR directly, as this is a release repository, not the native repository. Contact the author through the proper channels.
*Added one-click disable all mods function, convenient for quick debugging.
*Added forced clean-up feature (see in-plugin instructions for details).
*Optimized multi-mod file conflict detection and resolution.
*Added intelligent mod file path recognition, no longer need to fully follow the old mod file structure.
*Added FTP feature, supporting mod file transfer to a relay station via FTP.
*Rewritten MTP feature for more stable transfer (however, folder-based mods may still cause MTP freezing; in such cases, it is recommended to package as ZIP or use FTP).
'''v2.2.7'''
*Recompiled with the latest libnx, supporting AMS 1.10 and HOS 21.
*Fixed the issue where zip files with additional "." in the filename could not be recognized.
'''v2.2.6'''
*Optimized conflict detection logic, now allowing multiple mods to share common files.
*Removed the feature to cancel mod uninstallation by pressing B.
*Fixed a critical bug in file-type mod installation.
'''v2.2.5'''
*Added Bilibili video tutorial and GitHub QR code images to the guide.
*Adjusted some details.
'''v2.2.4'''
*Fixed an issue where MTP transfers of large files could occasionally freeze (thanks to TotalJustice's libhaze fix).
*Added conflict detection when installing MODs: if the target path contains the same file, the system will compare and identify conflicting MODs.
*Added automatic cleanup of installed files when installation is interrupted by pressing B.
*Added automatic cleanup of installed files if installation fails due to an error.
*Adjusted the text position in confirmation dialogs: previously centered, now centered horizontally but left-aligned.
*Changed the Y button label from "Uninstall" to "Force Clean".
*Added confirmation dialog text for Force Clean.
*Added dynamic timer display in the console during MTP transfers.
*Fixed an error in MOD list sorting.
'''v2.1.4'''
*Added transfer speed information to the MTP transfer interface
*Slightly improved MTP stability for LITE models
*Completed the missing text in languages other than Simplified Chinese
'''v2.1.3'''
*Home Screen
**Added favorite marking feature
**Added search function, supporting touch, pinyin, fuzzy, initials, and full spelling search
**Added MTP transfer option in the menu (experimental; known issue: on LITE, uploading files larger than 1.5 GB will freeze)
**Added Remove Game option in the menu; removed mods will be moved to the addmod folder
**Added View Location option in the menu
**Added pre-sorting: games are displayed in A–Z order when opening the plugin
*Add Game Screen
**Added search function
**Added a reminder when installing mods if the version does not match
*Mod Screen
**Added Remove Mod option in the menu
**Added View Location option in the menu
*Others
**Simplified version comparison rules: now only compares the numeric part
**Added repeat input for Up/Down keys when held
**Adjusted the add function: it can only be used after the home scan finishes, to avoid blocking
**Removed the mod count display at the bottom left of the add-mod list, since long text in other languages caused overlap
**Adjusted some details to improve user experience (forgot the exact changes)
*Bug Fixes
**Fixed an exception where modifying the version number did not update the corresponding JSON file
**Fixed an issue where some game icons failed to load
**Fixed an issue where folders containing a dot were misidentified as files
**Fixed an exception with down-key navigation in the 3×3 grid under special conditions
**Fixed some minor bugs that didn't affect usage (details forgotten)
'''v2.0.3'''
*Fixed an issue where the scanned game version on the Switch remained outdated after the game version changed.
'''v2.0.2'''
*Fixed a bug that caused the program to crash when adding mods.
'''v2.0.1'''
*Fix the issue where the text on the virtual keyboard is invisible when the Switch theme is set to the light theme.
*Newly added games will now appear at the top of the page, eliminating the need to search for them.
'''v2.0.0'''
*Main Interface
**The vertical list interface has been rebuilt into a grid interface, allowing more content to be displayed at once.
**Added menu functionality for the X button.
**Supports custom game names and mod version editing (display purposes only).
**Added the ability to add games directly from installed games into the mod manager, avoiding the need for complex manual configuration.
*Installed Games Interface
**A new interface has been added to support the "Add Game" function from the main interface.
*MOD Interface
**Added menu functionality for the X button.
**Supports custom mod names, mod type modification, and adding mod descriptions.
**Supports appending mods freely, with mod files placed in /mods2/0000-add-mod-0000.
*Tutorial Interface
**The tutorial interface has been rebuilt. Previously, it was all text-heavy and hard to follow; now it is image-based.
*Others
**Added pinyin sorting, allowing Chinese game names to be sorted alphabetically.
**Fixed a bug that could cause installed mods to fail.
**Fixed several minor bugs that did not affect functionality.
'''v1.3.0'''
*Significantly improved ZIP MOD uninstallation speed
**Linkoer can now be uninstalled within 20 seconds.
**Princess Flower uninstallation improved from 3 minutes 30 seconds to 1 minute 30 seconds.
*Significantly improved installation speed for file-based MODs
**Linkoer installation improved from 1 minute 40–50 seconds to 1 minute–1 minute 20 seconds.
**Princess Flower installation previously unmeasured, now takes 7 minutes 10 seconds; using ZIP-based MOD installation is recommended.
*Significantly improved installation speed for ZIP-based MODs
**Linkoer installation improved from 1 minute 5–20 seconds to a more stable time, close to 1 minute 5 seconds.
**Princess Flower installation improved from 6 minutes 13 seconds to 4 minutes 50 seconds–5 minutes 10 seconds.
*Adjusted the file count background layer in the progress dialog to ensure it is not obscured by file names.
*Fixed a minor bug that does not affect usage.
'''v1.2.0'''
*Added support for installing MODs in ZIP format, primarily targeting large MODs, significantly improving installation speed.
*Refactored the installation and uninstallation code.
*For example, the Lin Ke'er MOD consists of 2,732 files totaling 500 MB.
*Slightly improved file-based installation speed, reducing the time from 1:50–2:00 to 1:40–1:55.
*Slightly improved uninstallation speed, now completing in most cases within 20 seconds (previously around 20 seconds).
*Greatly improved installation speed for ZIP-based MODs. When the Lin Ke'er MOD was packaged as a ZIP, installation time decreased from 1:40–1:55 to 1:05–1:20.
*The larger the MOD, the greater the relative performance improvement. For details on configuring ZIP installation, see the provided template or README.
'''v1.1.0'''
*Modified the bottom-left text in the game and mod interface from "Total" to "Current Index / Total".
*Fixed two minor bugs that did not affect usability.
*Added a per-file copy progress bar in the installation dialog, which only appears for large files.
*Significantly improved mod uninstallation speed. For example, uninstalling the "Lin Ke'er MOD" is reduced from over 1 minute 30 seconds to about 20 seconds.
*Slightly improved mod installation speed. For example, installing the "Lin Ke'er MOD" is reduced from 2:00–2:10 to 1:50–2:00.
*The "Lin Ke'er MOD" contains a total of 2732 files.
*Added timing display for installation and uninstallation completion. If under 1 second, it will display as 0.1s.
'''v1.0'''
* First Release.

== Credits & Libraries ==
Thanks to the following open-source projects:
{| class="wikitable"
|-
! Project
! Description
! Author
|-
| [https://github.com/xfangfang/borealis borealis]
| UI Framework
| [https://github.com/xfangfang xfangfang], [https://github.com/natinusala natinusala]
|-
| [https://github.com/Atmosphere-NX/Atmosphere/tree/master/troposphere/haze libhaze]
| MTP
| [https://github.com/ITotalJustice ITotalJustice]
|-
| [https://github.com/ITotalJustice/ftpsrv ftpsrv]
| FTP
| [https://github.com/ITotalJustice ITotalJustice]
|-
| [https://github.com/ibireme/yyjson yyjson]
| High-performance JSON parsing
| [https://github.com/ibireme ibireme]
|-
| [https://github.com/wolfgitpr/cpp-pinyin cpp-pinyin]
| Pinyin search
| [https://github.com/wolfgitpr wolfgitpr]
|-
| [https://github.com/sammycage/lunasvg lunasvg]
| SVG rendering
| [https://github.com/sammycage sammycage]
|-
| [https://github.com/nayuki/QR-Code-generator QR-Code-generator]
| QR code generation
| [https://github.com/nayuki nayuki]
|-
| [https://github.com/richgel999/miniz miniz]
| ZIP compression & decompression
| [https://github.com/richgel999 richgel999]
|-
| [https://github.com/DarkMatterCore/libnxtc libnxtc]
| Game info caching
| [https://github.com/DarkMatterCore DarkMatterCore]
|}

== External links ==
* GitHub - https://github.com/TOM-BadEN/NX-Mod-Manager
* GBAtemp - https://gbatemp.net/threads/nx-mod-manager-v2-0-0-a-local-mod-manager-for-the-nintendo-switch.675101/
* Homebrew App Store - https://hb-app.store/switch/NXModManager

TKMM-NX Switch

2026-07-17T02:08:56Z

HydeWing: 2.1.6

{{Infobox Switch Homebrews
|title=TKMM-NX
|image=TKMMNXSwitch.png
|description=Lightweight OS for the Nintendo Switch.
|author=TKMM-Team
|lastupdated=2026/07/16
|type=Operating Systems
|version=2.1.6
|license=Mixed
|download=https://tkmm.org/downloads/index.html?tabs=switch
|website=https://tkmm.org/index.html
|source=https://github.com/TKMM-Team/TKMM-NX
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Operating Systems) - GameBrew
|title_mode=append
|image=TKMMNXSwitch.png
|image_alt=TKMM-NX
}}
TKMM-NX is a mod manager for Tears of the Kingdom (TKMM) that runs directly on the Nintendo Switch.

Developed by the TKMM Team, TKMM-NX is a Linux-based operating system built upon [https://github.com/libretro/Lakka-LibreELEC Lakka (a lightweight Linux distribution focused on emulation)].

==Installation==
Download the OS Image from [https://github.com/TKMM-Team/TKMM-NX/releases Releases].

Copy the tkmm and bootloader folders to the root directory of the SD card.

Boot into RCM (Recovery Mode) on the Nintendo Switch.

Inject the Hekate payload using a compatible method.

In the Hekate menu, navigate to "More Configs" and select "TKMM" to boot into the TKMM-NX environment.

'''Updating:'''

TKMM should prompt you when it detects an update (if connected to wifi), when selecting "Yes" on the update prompt, the update will be downloaded and your Switch will reboot to the new version.

If you ever need to update manually, download the latest [https://github.com/TKMM-Team/TKMM-NX/releases/latest/download/update.tar update tarball] and place it under "tkmm/storage/.update/" on your micro SD card. The next time you boot to TKMM-NX, the update will be installed.

==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-01.png

https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-02.png

https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-03.png

https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-04.png

==Changelog==
'''v2.1.6'''
* Update readme + Bump OS version.
'''v2.1.4'''
* Bump OS version.
'''v2.1.3'''
* Bump OS version.
'''v2.1.2'''
* Bump OS version.
'''v2.1.1'''
* Bump OS version.
'''v2.1.0'''
* Change OS versioning scheme.
'''v2.0.3'''
* dotnet-runtime: Updated to 10.0.9
* dotnet-sdk: Updated to 10.0.301
'''v2.0.2'''
* Adjust workflow.
'''v2.0.1'''
* Revert "Temp fix for dotnet runtime".
'''v2.0.0-rev-nx1'''
* Temp fix for dotnet runtime.
'''v2.0.0'''
* Merge remote-tracking branch 'origin/main' into upfs-support.
'''v2.0.0-beta3'''
*Enabled eMMC in boot script.
'''v2.0.0-beta2'''
* Update game dump error messages.
* Disable optimizer by default.
* Use direct index merging for game__component__ConditionParam (*).
* Delete UltraCam config when optimizer is disabled.
* Bind the home button to reboot popup.
* Remove manual setup from NX setup wizard.
* Fix auto-updater checksum parser.
* Fix process name resolver.
* Fix BYML change tracking mergeable addition resolver.

(* Requires changelog rebuild)

'''v1.0'''
* First Release.

== Credits ==
The Team:
* [https://github.com/ArchLeaders Arch Leaders]: Lead TKMM Developer
* [https://github.com/LordBubblesDev Lord Bubbles]: TKMM-NX Developer & Maintainer
* [https://github.com/AsteroidPizza39 Aster]: Co-Founder, Artist, & Operations Manager
* [https://github.com/The5thTear The5thTear]: Co-Founder & Developer
* [https://github.com/okmika Mikachan]: Developer

Special Thanks:
* The [https://switchroot.org/ Switchroot] community for pioneering open-source development on the Nintendo Switch.
* The [https://www.lakka.tv/ Lakka] team, for its work that allowed us to create a custom OS for TKMM on Switch.
* The [https://libreelec.tv/ LibreELEC] team for creating the Linux distribution upon which all of this is built.

== External links ==
* Official Website - https://tkmm.org/index.html
* GitHub - https://github.com/TKMM-Team/TKMM-NX
* Homebrew App Store - https://hb-app.store/switch/TKMM-NX
* GameBanana - https://gamebanana.com/tools/19164

NXShare Switch

2026-07-17T02:08:52Z

HydeWing: 1.8.3

{{Infobox Switch Homebrews
|title=NXShare
|image=NXShareSwitch.png
|description=A Nintendo Switch homebrew app to access the album folder via a web browser on PC or phone.
|author=musebrot1
|lastupdated=2026/07/14
|type=Utilities
|version=1.8.3
|license=MIT
|download=https://dlhb.gamebrew.org/switchhomebrews/NXShareSwitch.7z
|website=https://github.com/musebrot1/NXShare
|source=https://github.com/musebrot1/NXShare
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Utilities) - GameBrew
|title_mode=append
|image=NXShareSwitch.png
|image_alt=NXShare
}}
NXShare is a Nintendo Switch homebrew app to transfer screenshots and videos to any device via browser.

NXShare starts a small web server on your Switch. Open the displayed URL in any browser on a PC, phone or tablet (same WiFi required), and you get a clean gallery view of all your screenshots and videos - with thumbnails, filters and multi-select download.

== Features ==
* Browse and view all screenshots and videos.
* Filter by screenshots/videos or by game.
* Download individual files or select multiple files at once.

== Installation ==
Download the latest <code>NXShare.nro</code> from the Releases page and copy it to the <code>switch/</code> folder on your SD card.

NXShare is also available in the [[Homebrew App Store Switch|Homebrew App Store]].

==User guide==
Make sure your Switch is connected to WiFi.

Launch NXShare from the Homebrew Launcher in Applet Mode.

The screen shows a URL/QR code.

Open the URL in any browser on the same network, or scan the QR code.

Browse, preview and download your media.

==Screenshots==
{| style=""max-width:80%; margin-left:0em;""
|
https://dlhb.gamebrew.org/switchhomebrews/images/NXShareSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXShareSwitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXShareSwitch-03.png
https://dlhb.gamebrew.org/switchhomebrews/images/NXShareSwitch-04.png
|}

==Compatibility==
* Atmosphère - Tested 1.9.3 and 1.11.1
* Firmware - Tested 20.3.0 and 22.0.0
* Storage - SysMMC and emuMMC (auto-detected)

== Changelog ==
'''1.8.3'''
* New icon.

'''1.8.2'''
* Fixed server recovery after sleep and network loss

'''1.8.1'''
* Web UI layout adjustments.

'''1.8.0'''
* added Date filter.

'''1.7.6'''
* fixed JSON escaping for control characters.

'''1.7.5'''
* fixed media sorting issue.

'''1.7.4'''
* more fixes.

'''1.7.3'''
* fixed how png files are getting saved.

'''1.7.2'''
* more fixes.

'''1.7.1'''
* some fixes.

'''1.7.0'''
* in full size view there are now left/right buttons to jump to the previous/next file.
* now also reads PNG files.

'''1.6.0'''
* added games filter.

'''1.5.0'''
* some fixes.
* new UI.
* now shows app icon in browser tab.

'''1.4.0'''
* URL now shows as QR code too.
* some layout adjustments for both desktop and mobile browsers.

'''1.3.1'''
* some minor fixes and layout changes.
* exit the app with [+].

'''1.3.0'''
* Nintendo Switch Homebrew app to transfer screenshots and videos via browser

== Credits ==
* [https://github.com/switchbrew/libnx libnx] by switchbrew - Nintendo Switch homebrew library, licensed under the ISC License.
* [https://devkitpro.org devkitPro] - ARM toolchain and build system.
* [https://github.com/iUltimateLP/NXGallery NXGallery] by iUltimateLP - inspiration for capsa API usage.

== External links ==
* GitHub - https://github.com/musebrot1/NXShare
* Homebrew App Store - https://hb-app.store/switch/NXShare

Tico Switch

2026-07-17T02:08:48Z

HydeWing: 0.7.5

{{Infobox Switch Homebrews
|title=tico
|image=ticoSwitch.png
|description=The first custom emulation frontend for Nintendo Switch.
|author=dantiicu
|lastupdated=2026/17/16
|type=Other Emulators
|version=0.7.5
|license=[https://github.com/ticohq/tico/blob/main/LICENSE.md tiicu]
|download=https://dlhb.gamebrew.org/switchhomebrews/ticoSwitch.7z
|website=https://ticoverse.com/
|source=https://github.com/ticohq/tico
|donation=
}}
{{#seo:
|title=Switch Homebrew Emulators (Other Emulators) - GameBrew
|title_mode=append
|image=ticoSwitch.png
|image_alt=tico
}}
tico is the first custom emulation frontend for Nintendo Switch, a controller-first, native C++ interface designed for performance, simplicity, and long-term portability.

tico is a game launcher that supports libretro cores and custom emulators. It organizes your games automatically, manages assets, and launches everything from one place. No file browsers, no fragmented tools, no config menus. Just pick a game and play.

tico does not include ROMs, BIOS files, system firmware, DRM circumvention tools, or emulator cores. Users are responsible for legal ownership of their games and compliance with local laws.

==Features==
===Interface===
* Redesigned UI with full dark mode
* Home screen with customizable game shortcuts and a dedicated favorites page
* Dynamic customizable cards — use custom images as console covers with swappable symbols and backgrounds
* Unified multi-console launcher
* Controller-first navigation
* Instant library loading with intelligent caching
* One-button rescan system
* Nintendo Switch account integration (avatar and nickname displayed in the interface)
* SteamGridDB integration — download cover art directly from the tico interface (API key required from steamgriddb.com)

===Settings===
* Comprehensive Settings screen with General, Display, Audio, Gamelist, and Emulator sections
* General settings: clock format (12-hour or 24-hour), ROM root directory picker with in-app folder navigation
* Per-core aspect ratio settings with unified display modes: 4:3, 16:9, Stretch, Integer 1×, and Integer 2×
* Per-core display configuration

===Game Management===
* Automatic No-Intro and Redump naming support
* Auto-organization by system and region
* Direct pinning from library to home screen
* Structured save and asset directories

===Embedded and External Emulator Cores===
* Built-in, statically linked cores
* External core support for flexible management, easier updates, and licensing compliance
* Resume app state support for external cores
* No manual installation
* No configuration required
* Optimized builds for Nintendo Switch

===System===
* Auto directory initialization — tico creates the complete folder structure for all supported consoles on first launch
* BIOS validation — tico checks for required BIOS files before launching a game and displays a clear error if any are missing

==Architecture==
* Written in modern C++
* Native performance
* No scripting languages
* No heavy frameworks
* Designed for long-term portability

==Supported Systems==
* Game Boy (GB)
* Game Boy Color (GBC)
* Game Boy Advance (GBA)
* Nintendo Entertainment System (NES)
* Super Nintendo Entertainment System (SNES)
* Nintendo 64 (N64)
* GameCube (GC)
* Wii
* PlayStation 1 (PS1)
* PlayStation Portable (PSP)
* Sega Dreamcast (DC)
* Sega Saturn
* Sega Game Gear
* Sega Master System
* Sega Mega Drive (Genesis)
* Sega CD

==Installation==
# Copy the tico folder to the root of your SD card
# Place tico.nro inside the switch folder
# Launch any game while holding R to open the Homebrew Menu
# Open tico
# Install required cores via the in-app settings updater or manually from https://github.com/ticohq
# Enjoy

'''Note:''' On first launch, tico auto-generates its full directory structure. After opening tico once, reconnect your Switch to a PC or phone to copy ROMs, saves, and BIOS files into the correct locations.

'''Important:''' tico does not work in applet mode.

'''Important (0.6.0):''' Cores are no longer bundled with tico. Systems will not run until the required cores are installed. Cores can be installed from the in-app settings updater or manually via https://github.com/ticohq.

===Migrating from earlier versions===
The project directory has been renamed from '''tiicu''' to '''tico'''. Existing users must:
# Navigate to the root of the SD card
# Rename the '''tiicu''' folder to '''tico'''
# Move custom assets: '''sdmc:/tiicu/covers''' → '''sdmc:/tico/assets/covers''' and '''sdmc:/tiicu/backgrounds''' → '''sdmc:/tico/assets/backgrounds'''
All ROMs, saves, states, and configuration will remain intact.

'''Note:''' If you have a custom ROM path set via the old '''custom_roms_path''' field in '''roms.json''', migrate your path through the new Settings interface — that field is deprecated and will be ignored.

===Directory Structure===
ROMs should be organized in the following structure:
sdmc:/tico/roms/{console}/
sdmc:/tico/assets/covers/{console}/
sdmc:/tico/assets/backgrounds/{console}/
sdmc:/tico/saves/{console}/
sdmc:/tico/states/{console}/

Where {console} can be: gb, gbc, gba, nes, snes, n64, gc, wii, psx, psp, dc, saturn, game-gear, master-system, genesis, sega-cd

ROMs can be organized into subfolders one level deep (e.g. psx/Resident Evil 2 (Disc 1)/).

Artwork must match ROM names (without extension) and must be in JPG format.

===Custom ROM Path===
You can set a custom ROM root directory through the built-in Settings screen under General Settings. Use the in-app folder navigation to select your preferred ROM root directory.

'''Note:''' Changing the ROM root path invalidates existing caches; a one-time rescan will be required.

Inside your custom path, keep consoles separated in their respective folders.

===BIOS Requirements===
====PlayStation (PS1)====
Place one of the following BIOS files in: sdmc:/tico/system/psx/
* scph5501.bin
* scph5502.bin
* scph5500.bin
* scph1001.bin

====Sega Saturn====
Place one of the following BIOS files in: sdmc:/tico/system/saturn/
* saturn_bios.bin
* sega_101.bin
* mpr-17933.bin

====Dreamcast====
Place the following BIOS file in:
sdmc:/tico/system/dc/

* dc_boot.bin — Dreamcast Boot ROM

====Sega Systems====
All Sega BIOS files should be placed in:
sdmc:/tico/system/sega-cd/

'''Sega CD / Mega CD:'''
* bios_CD_U.bin — Sega CD (NTSC-U)
* bios_CD_E.bin — Mega CD (PAL)
* bios_CD_J.bin — Mega CD (NTSC-J)

====Super Nintendo (Satellaview)====
For Satellaview games on SNES:
* Copy BS-X.bin to: sdmc:/tico/system/snes/

==Controls==
===Navigation===
* Type 1 — Dock: L/R, Pages: D-Pad ←/→
* Type 2 — Dock: ZL/ZR, Pages: L/R

===In-Game===
* Press + and - together to suspend gameplay and access game options
* Configure aspect ratio settings per-core for optimal display

====Sega Saturn====
* Press ZL and − to switch between Standard Pad and 3D Pad

==Configuration==
===Settings Screen===
The built-in Settings screen provides access to:
* General Settings — Clock format, ROM root directory
* Display Settings — Visual preferences
* Audio Settings — Sound output and volume controls
* Gamelist Settings — Library organization and display options
* Emulator Settings — Per-core configuration, core downloads and updates

===Core Settings===
PSP core settings can be customized at:
sdmc:/tico/config/cores/ppsspp.jsonc

Core improvements include:
* PPSSPP (PSP): 2x resolution rendering, 60fps support
* SwanStation (PS1): 2x resolution rendering, TrueColor mode enabled
* SNES9x (SNES): Overclock mode (Compatible), Flicker Reduction, Sinc Audio Resampling
* mGBA (GBA): Smart Color Blending, No Frameskip
* Gambatte (GB/GBC): Ghosting Reduction, Sinc Audio Resampling
* Flycast (Dreamcast): Seamless handheld-to-docked transitions, 1080p docked mode
* Beetle Saturn (Saturn): 720p/1080p output, FXAA, Scanlines, Bilinear filters, Standard Pad and 3D Pad support
* Mupen64Plus (N64): Initial support

==Screenshots==
{| style="max-width:80%; margin-left:0em;"
|
https://dlhb.gamebrew.org/switchhomebrews/images/ticoSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/ticoSwitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/images/ticoSwitch-03.png
https://dlhb.gamebrew.org/switchhomebrews/images/ticoSwitch-04.png
|}

==Changelog==
'''0.7.5 2026/07/16'''
* Fixes
** Fixed an bug an Core Update Manager caused by versions.json
** Locked tico startup from sdmc:/switch/tico/tico.nro to prevent confusion with core chainload back
** Added system folders creation for 3DS
** Added system name change for Azahar in Emulator Settings
** Added inverted screens orientation for Azahar to prevent grip to hide vents

'''0.7.4 2026/07/15'''
* What's New
** Azahar Support for Nintendo 3DS
*** Nintendo 3DS emulation is now available in tico via Azahar, bringing support for a large portion of the 3DS library.
*** Supported ROM formats: .3ds, .3dsx, .z3dsx, .elf, .axf, .cci, .zcci, .cxi, .zcxi, .app
** Shader Compilation
*** Shaders are compiled on a game's first launch and then cached, so subsequent launches load with improved visual stability and reduced stuttering.
*** Quick Hotkeys
*** L + Minus — Change screen orientation
*** ZL + Minus — Change screen layout 
These are also available from the quick menu by pressing + and − in-game.
* Fixes
** Fixed alphabetical ordering in console emulator settings
** Fixed a bug where resuming from a core would cause a crash

'''0.7.3 2026/06/14'''
* What's new
** Flycast updated to 2.6+
*** The Dreamcast/Naomi emulator core has been updated to version 2.6+, bringing the latest upstream fixes and compatibility improvements.
** Atomiswave and Naomi support
*** You can now launch Atomiswave and Naomi arcade games directly through tico, expanding the supported library beyond Dreamcast titles.
** Cover compressor for existing covers
*** A one-time compression pass runs on your existing cover art to reduce storage usage and improve loading times going forward.
* Improvements
** Smoother navigation when holding up/down in gamelist
*** Holding up or down in the gamelist now scrolls more fluidly, making it easier to browse through large collections.
** Better assets loading and download performance
*** Assets such as covers and metadata are now fetched and rendered more efficiently, reducing wait times when browsing your library.
** Compression applied on cover downloads
*** Newly downloaded covers are now compressed on the fly, keeping your storage footprint smaller without any extra steps.
* Bug fixes
** Game progress in RetroAchievements screen
*** Fixed an issue where game progress was not displaying correctly on the RetroAchievements screen.
** FBNeo cover fetching
*** Covers for FBNeo games were not being retrieved properly; this has been resolved.
** Crash when adding background to consoles
*** Fixed a crash that occurred when trying to set a custom background image for a console entry.
** Update downloads failing on lower clock speeds
*** Resolved an issue that caused update downloads to fail on devices running at lower CPU clock speeds.
* Warning: On first launch after this update, existing covers will be automatically compressed. This runs once and may take a moment depending on your library size.
* Note: Even with the Flycast 2.6+ improvements, Windows CE-based games (e.g. Sega Rally 2) and most Naomi 2 titles remain too demanding for Switch hardware and may not run well.

'''0.7.2 2026/06/01'''
* Installation & Updates
** New installer for a smoother first-time setup
** Built-in updater (Settings > Updates)
* Home
** New item sizes: 1x3, 3x1, 2x3, 3x2, 2x2
** Custom backgrounds and decorations per item (logo and cover)
** Console launch shortcut from homescreen
** Asset Finder accessible from homescreen
** Game logos displayed on launcher screen
** Fixed D-Pad when using navigation type 2
** Game Select
** Added jump titles by using left/right for fast navigation
** Added support for custom background, covers and logo using Find Assets
** Added support for added console as shortcut to Homescreen
* Retro Achievements
** Fully redesigned screen
** Faster and more responsive connection
* Customization
** Full card customization — frames, overlays, badge size, style and position
** New screen transition animations
** Non-square cover support with built-in crop tool
* Asset Manager
** Browse and download covers, backgrounds and icons in-app via SteamGridDB
** Seamless homescreen integration for quick asset assignment
* Audio
** Soundpacks - swap UI sounds and background music from Settings > Audio
** Console Colors
** Custom gradients per console for light and dark mode
** Game Library
** Game search across your library
** Fast navigation in game select screen for large collections
** Emulator Updates
** Dolphin - added support for WAD, WIA, M3U and more
* Fixes
** General smoothness improvements throughout the app
** Fixed UI scaling on 1080p displays

'''0.7.1 2026/04/25'''
* New: Vulkan backend
* Fixed: Updater
* New: Onboarding tips for new users
* Fixed: Passwords now fully hidden in Settings > Accounts

'''0.7.0-alpha 2026/04/20'''
* New: Experimental GameCube and Wii support via Dolphin core (enable from the new Experimental tab in Settings)
* New: Experimental tab added to Settings — Dolphin must be enabled here before it appears in the tico interface
* Note: Dolphin enables boost mode by default (1785 MHz CPU / 768 MHz GPU); monitor device temperature accordingly
* New (Saturn): Simulated BIOS / skip Saturn BIOS option added to Yabasanshiro core settings
* Cores: Fixes and updates available from the Updater in Settings

'''0.6.0-alpha 2026/04/06'''
* Breaking: Cores are no longer bundled with tico — cores must be installed manually after updating
* Breaking: Systems will not run until required cores are installed
* New: External core distribution model — cores are now distributed and updated independently from the main application
* New: Core downloads and updates available directly from the settings screen
* New: Nintendo 64 support via Mupen64Plus (note: app must be restarted after exiting an N64 game)
* New: FinalBurn Neo support via FBNeo
* New: ROM subfolder support — ROMs can be organized into subfolders one level deep
* New: Multi-disc handling — multi-disc titles grouped into a single entry with Disc 1 as primary; optional setting to list each disc individually
* New: Localization — English, Spanish, Portuguese, French, Japanese, and Chinese
* New: RetroAchievements screen with online summary and progress (supported platforms: Dreamcast, FinalBurn Neo, GB, GBC, GBA, Game Gear, Master System, Mega Drive, N64, NES, PlayStation, PSP, Sega CD, Sega Saturn, SNES)
* New: Navigation type option — Type 1 (Dock: L/R, Pages: D-Pad ←/→) or Type 2 (Dock: ZL/ZR, Pages: L/R)
* New (Saturn): CHD support (.chd), 1MB and 4MB RAM cartridge support, optional async rendering, optional compute shader output, fixed SRAM save persistence
* New (PlayStation): Rumble support, corrected button mapping, memory card support (.mcd, .mcr), automatic multi-disc switching
* New: Mesa 23.3 driver — shader cache support and NIR compiler for improved GPU utilization
* Fixed: Cover art loading for .cue, .m3u, and .bin formats
* Fixed: Core startup/exit when Music and SFX is enabled
* Core updates: All cores updated for improved compatibility and stability

'''0.5.0-alpha 2026/02/18'''
* New: Sega Saturn support (720p/1080p, 60fps 2D / 30fps 3D, Standard Pad and 3D Pad, FXAA/Scanlines/Bilinear filters)
* New: SteamGridDB integration — download cover art directly from the interface (API key required)
* New: General Settings section (clock format, ROM root directory picker with in-app folder navigation)
* New: Unified aspect ratio display modes across all cores (4:3, 16:9, Stretch, Integer 1×, Integer 2×)
* New: Auto directory initialization on first launch for all supported consoles
* New: BIOS validation — checks for required BIOS files before launching and displays clear error messages
* Improvement: Flycast seamless handheld-to-docked transitions, fixed 1080p docked resolution
* Improvement: Expanded PS1 BIOS compatibility (scph5501.bin, scph5502.bin, scph5500.bin, scph1001.bin)
* Improvement: Simplified Dreamcast BIOS requirement (dc_boot.bin only)
* Changed: Custom ROM path configuration via roms.json is deprecated — use the Settings interface instead
* Various minor fixes and stability improvements

'''0.4.0-alpha 2026/02/10'''
* Redesigned: Complete visual overhaul with new UI, refined colors, and sleek iconography
* Redesigned: Full dark mode across the entire application
* New: Dynamic customizable cards — custom images as console covers, swappable symbols and backgrounds
* New: Nintendo Switch account integration (avatar and nickname)
* New: Comprehensive Settings screen (Display, Audio, Gamelist, Emulator)
* New: Sega Dreamcast support
* New: Favorites page opens automatically on launch
* New: Per-core aspect ratio settings (stretch or integer scaling)
* New: External core support for flexible management and licensing compliance
* New: Resume app state support for external cores
* Changed: Project directory renamed from tiicu to tico
* Changed: Asset directories moved under sdmc:/tico/assets/
* Changed: Navigation — D-PAD Left/Right swaps home screen pages, L/R navigates docked screens

'''0.3.0-alpha 2026/01/23'''
* Fixed: Custom ROM paths now work correctly
* Fixed: Moving shortcuts no longer creates duplicates
* Fixed: PlayStation analog stick/axis controls now function properly
* Improvement: "Add to homescreen" automatically navigates to first available page
* New: Alert notification when all home screen pages are full
* New: Sega Game Gear support
* New: Sega Master System support
* New: Sega Mega Drive (Genesis) support
* New: Sega CD support
* New: PSP CHD format support
* New: Advanced PPSSPP settings customization via config file

'''0.0.2 2026/01/20'''
* Major: ROM scanning no longer strictly enforces No-Intro or Redump naming
* New: Custom ROM path configuration support
* New: NES (Nintendo Entertainment System) support
* Improvement: Desktop items now animate gracefully on startup
* Improvement: Consoles organized alphabetically in launcher
* Improvement: Better animation when entering games
* Bugfix: Shortcuts no longer disappear when deleting or moving other shortcuts
* Core: PPSSPP 2x resolution rendering, 60fps support
* Core: SwanStation 2x resolution rendering, TrueColor mode
* Core: SNES9x Overclock mode, Flicker Reduction, Sinc Audio Resampling
* Core: mGBA Smart Color Blending, No Frameskip
* Core: Gambatte Ghosting Reduction, Sinc Audio Resampling

== External links ==
* Official website - https://ticoverse.com/
* GitHub - https://github.com/ticohq/tico
* Discord - https://discord.gg/DPgXGqJMkJ
* Reddit - https://www.reddit.com/r/SwitchHacks/comments/1qh2kxc/tiicu_001_is_here_the_first_custom_emulator/

Balatro3DS

2026-07-17T02:08:41Z

HydeWing: Alpha 1.2.0

{{Infobox 3DS Homebrews
|title=Balatro3DS
|image=Balatro3DS.png
|description=A fanmade Balatro clone for the 3DS.
|author=idkhan
|lastupdated=2026/07/16
|type=Card
|version=Alpha 1.2.0
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/3dshomebrews/Balatro3DS.7z
|website=https://www.reddit.com/r/3dshacks/comments/1sliqql/version_01_of_balatro3ds_released/
|source=https://github.com/idkhan/Balatro3DS
|donation=https://www.patreon.com/thegazpacho
}}
Balatro3DS is a fan-made port/implementation of the game Balatro targeting the Nintendo 3DS, built with Lua and LÖVE.

== Installation ==
Requires a Nintendo 3DS with homebrew capabilities (for running custom software).

Download the [https://github.com/idkhan/Balatro3DS/releases latest release].

Copy the Balatro3DS.3dsx file into the 3ds folder on the root of your SD Card.

Open with the Homebrew launcher.

== Controls ==
R or Y - Play

L or X - Discard

D-Pad Left - Sort by Rank

D-Pad Right - Sort by Suit

D-Pad Up - Show Jokers

D-Pad Down - Hide Jokers

== Changelog ==
'''Alpha 1.2.0'''
* Features:
** Revamped Gamepad Controls - Please read the How to Play section for more information
* Bugfixes:
** Fixed Booster packs having owned Jokers
** Fixed the very large drag zone for Buy and Use
** Pareidolia Joker was debuffing all cards in a boss blind
** Smeared Joker was not working correctly
** New runs started with Vampire, fixed it.

'''Alpha 1.1.7'''
* Bugfixes:
** Resized the Drag Zone for Use to prevent it from overlapping with the Consumables
** Fixed the Matador triggering for each time a debuffed card is selected
** Fixed the Vampire triggering for every card instead of just cards with an enhancement (wrote "or" instead of "and" oops)
** Fixed the Mark having cards be face down when opening Tarot cards. Now all Boss Effects are removed from The Shop.

'''Alpha 1.1.6'''
* Features:
** Added Profiles and the ability to clear saves
* Bugfixes
** Fixed the R button selecting and unselecting cards when tapped in card select mode
** Fixed the Riff Raff joker spawning duplicates
** Fixed the Hit the Road Joker not resetting
** Fixed Hologram Joker triggering for every item bought from shop. Now it only triggers when cards are added to the deck

'''Alpha 1.1.5'''
* Features
** Added the Collection to view all Cards, Blinds, Enhancements, etc
** Added More Gamepad Controls, check the How to Play menu to learn more
** Boss Blinds no longer repeat
** Added the Diet Cola Joker (it was missing before)
** Added a sneaky little cheat to unlock everything (Konami Code)
* Bugfixes
** Astronomer Joker now works
** Shop prices are recalculated after buying the discount vouchers
** Main Menu is now aligned properly
** Hitting New Run in a game saves the last run
** There's a bunch more I cant remember

'''Alpha 1.1.3 (Fixed)'''
* Features:
** Menu Animation finally added
* Bugfixes:
** Fixed no price being shown on the Sell drop zone
** Fixed Tags and Spectral debuffs carrying over from previous runs
** Undiscovered cards now show their tooltips, just not their names

'''Alpha 1.1.2'''
* Features
** Adds Deck and Stake Unlocks
** Allows Discovering Jokers, Tarot, Spectral and Planet Cards
** Deck View now shows Deck, Stake and Blind Information
* Bugfixes
** Fixed the Invisible Joker bug (probably)
** Fixed Ankh not working
** Fixed incorrect Blind colors in the TopUI
** Vagabond not spawning tarot cards at $4
** Gros Michel was still in the shop pool after going extinct
** Changes made to the hand were not copied to the deck properly

'''Alpha 1.1.1 (Hotfix)'''
* Fixed the volume slider not working and freezing the game
* Fixed skip tags not rerolling after defeating a boss blind

'''Alpha 1.1.0'''
* Features:
** REVAMPED THE SHOP CONTROLS - drag and drop functionality similar to the Mobile UI
** Added a Win Screen for Ante 8 - Still no progression tracking
* Bugfixes:
** Negative, Foil, Holo, Polychrome Tags were not working. Fixed
** The voucher tag didn't do anything

'''Alpha 1.0.2'''
* Skip tags were crashing the game because I used a lua keyword as the name for a function parameter [https://github.com/idkhan/Balatro3DS/issues/31 #31]
* All Special Decks were being scored as Plasma deck because I missed a bracket [https://github.com/idkhan/Balatro3DS/issues/31 #31]

'''Alpha 1.0.1'''
* Now you can hold L to start Card Selection mode and use the DPAD to navigate through your hand.
* While in Card Selection Mode, pressing Up allows you to toggle a card and holding R and moving right or left lets you batch select cards
* Features:
** Added a Settings Menu ([https://github.com/pixelkat5 @pixelkat5])
** Improved Menu ([https://github.com/Promaster2007 @Promaster2007]) and new How to Play screen
** Added Gamepad support for card selection and navigation:
** New Icon ([https://github.com/Promaster2007 @Promaster2007])
* Bug Fixes ([https://github.com/idkhan @idkhan]):
** Fixed issue with card rendering in deck view.
** Fixed cards disappearing after opening a Booster Pack
** Fixed bad collisions in deck view
** Fixed an infinite loop caused by Brainstorm and Blueprint pointing at each other
** Fixed Cavendish being spawnable without Gros Michel going extinct

'''Alpha 1.0.0'''
* Features Added:
** Added a Deck View, now you can press Select to view your deck and owned vouchers
** Added all the Decks
** Added all Stakes
* Bug Fixes:
** Fixed Legendary Jokers not showing up properly
** Fixed multiple jokers like the Mail-in Rebate on syncing up
** Fixed some Jokers not triggering properly
** Grabber and Nacho Tong vouchers are in the game, apparently they were just missing from the catalog, so now they are in the game and can be obtained
** Some other stuff I cannot remember, but I know I fixed a lot of bugs and added a lot of features, so enjoy!

'''Alpha 0.4.0'''
* Bugfixes
** Bigger Buy button
** Fixed the long delay in scoring with many jokers
** I can't remember them all, there's a bunch

'''Alpha 0.3.6'''
* Bugfixes
** Score being too large to fit in the panel now resizes [https://github.com/idkhan/Balatro3DS/issues/15 #15]
** Castle Joker now changes suit and only picks suits present in the deck
** Blue Joker now counts cards in deck, used to count all cards [https://github.com/idkhan/Balatro3DS/issues/21 #21]
** Mr Bones not working properly [https://github.com/idkhan/Balatro3DS/issues/17 #17]
** Green Joker can no longer have negative mult [https://github.com/idkhan/Balatro3DS/issues/7 #7]
** Tarot Cards were not usable on less than the max number of cards, now they work as intended
** Fixed Boss blinds stopped working entirely
** Fixed glass break resetting score and changing hand types
* Noted Problems
** Some Jokers can be invisible, this is because of the 3DS's tiny VRAM cache filling up and not being able to display the texture. The Joker will still work. So if your booster pack comes with just one joker, the second one is probably invisible. Just tap where you expect it to be and the tooltip should show up. This will be fixed when new art assets are introduced.

'''Alpha 0.3.5'''
* Bugfixes
** Fixed Cavendish appearing before Gros Michel is Extinct
** Fixed Oops joker not counting correctly
** Fixed Music pitch
** Fixed Tooltip drawing
** Fixed Popcorn not destroying itself
** Fixed Suit order in hand
** Fixed Wheel of Fortune not rolling chances properly
* Noted Problems
** Some Jokers may be invisible in the shop or in booster packs, they're still intractable and can be bought. The sprites will appear when bought.
** Boss Blind may appear as empty

'''Alpha 0.3.4'''
* Bugfixes
** Fixed cards being debuffed after Boss Blinds [https://github.com/idkhan/Balatro3DS/issues/6 #6]
** Fixed Booster Pack layout in the shop
** Fixed Endless Mode (After Ante 8) chip scaling

'''Alpha 0.3.2 (Not Fully Tested)'''
* Additions
** Added Vouchers
* Bugfixes
** Fixed Hit the Bus Joker counting not scored cards
** Fixed Hand Levels not resetting
** Fixed Two Pairs not containing Pairs [https://github.com/idkhan/Balatro3DS/issues/5 #5]

'''Alpha 0.2.3'''
* Bugfixes
** Fixed check for Flush with Four Fingers
** Fixed Judgement Tarot card creating Legendary Jokers and implemented proper rarity distribution

'''Alpha 0.2.2'''
* Bugfixes
** Fixed Jokers not being sellable when opening Booster Packs
** Fixed the Fortune Teller and Stuntman Jokers not working
** Fixed check for hands contained in other hands

'''Alpha 0.2'''
* Added a Menu and Pause Screen
* You can now save and continue runs
* Bugfixes
** Wild cards work now (completely forgot about them on the first release, oops)
** Fixed a bug with Booster Packs triggering Red Card even when the pack wasn't skipped
** Fixed Steel cards not scoring properly

'''Alpha 0.1.0'''
* 150 Jokers
* All Tarot, Planet, Spectral Cards
* All Boss Blinds
* No Menu or Pause Screen
* No Vouchers and Tags

== External links ==
* itch.io - https://thegazpacho.itch.io/balatro3ds
* GitHub - https://github.com/idkhan/Balatro3DS
* Reddit - https://www.reddit.com/r/3dshacks/comments/1sliqql/version_01_of_balatro3ds_released/

Cloudpoint 3DS

2026-07-17T02:08:35Z

HydeWing: 0.6.0

{{Infobox 3DS Homebrews
|title=Cloudpoint
|image=cloudpoint3ds.png
|description=Bringing modern cloud save to 3DS.
|author=dwalker109
|lastupdated=2026/07/15
|type=Save Managers and Editors
|version=0.6.0
|license=MIT
|download=https://dlhb.gamebrew.org/3dshomebrews/cloudpoint3ds.7z
|website=https://github.com/dwalker109/cloudpoint
|source=https://github.com/dwalker109/cloudpoint
}}
Cloudpoint allows you to sync all of your saves (and extdata) between all of your 3DS & 2DS devices, via a central server. Transfer progress between consoles effortlessly, the way you're probably used to from more modern systems. Or PS Vita.

== Features ==
* Sync your game saves (and extdata) between all of your consoles (and, in most cases, emulators)
* Simple UI with minimal user intervention (works like cloud save on any other console)
* Public, free to use cloud available for zero setup syncing over the internet
* Self hosting your own instance is also supported, via the provided Docker image
* Auto sync all saves in one go, or sync specific game saves on demand
* Enable/disable specific saves from auto sync
* Auto discover your saves, and refresh them on demand as you add new games
* "Link" your consoles to enable initial setup using local ad-hoc wireless; syncs all happen directly with the server (your consoles don't all need to be online at once)
* Auto enable wireless on boot, disable on quit - be kind to your battery life
* Slightly increased performance on New... model consoles (but works on all of them really well)

== Installation ==
Cloudpoint is available on [[Universal-Updater 3DS|Universal Updater]], which is the best way to install it and keep it up to date.

Or, download the [https://github.com/dwalker109/cloudpoint/releases/latest latest release] manually:
* 3DSX - Copy .3dsx to /3ds/cloudpoint/ on your SD card, then launch via the Homebrew Launcher.
* CIA - Copy .cia to your SD card and install it via [[FBI 3DS|FBI]].

== User guide ==
=== If you have one console ===
* Run Cloudpoint on your first console (console 1) - it will scan for saves and enable them for auto sync.
* Press '''A''' to sync and wait for the progress bar to complete.
* You are synced! Take your user key to a new console or run Cloudpoint again after formatting your system to restore saves and extdata.

=== If you have additional consoles ===
* On console 1, press '''R''' to reach the "Link screen and press '''X''' to share your user key.
* Run Cloudpoint on another console (console 2) - it will scan for saves and enable them for auto sync.
* Press '''R''' to reach the ''Link'' screen and press '''Y''' to receive your key from the first console. Follow the onscreen prompts on both consoles; Cloudpoint will restart on completion.
* Once Cloudpoint reloads, press '''A''' to sync and expect to be asked to resolve conflicts for any game You have installed on both consoles. You will usually see this screen ''the first time'' you sync a game on a given console, or if you progress in a game on multiple consoles without syncing.
* You are synced! You are now free to use a N3DSXL at home and a N3DS on the go; no more compromise!

=== Best practice ===
* '''Keep save backups yourself'''. Do this from time to time. Bugs happen and I don't want you to lose your 1000 hour Pokémon saves.
* Make a backup of your ''user.key'' from <code>/3ds/Cloudpoint/user.key</code> (you will need this in the event you lose your console or memory card, there is no other way to recover your saves).
* Auto sync when you pick up your console for a play session, auto sync again when you finish. This will avoid any need to resolve conflicts.
* Use the same version of a game on all your consoles. Syncing saves to different versions may lead to data loss, so avoid this.
* Take extra care when reinstalling titles or formatting a console; detection of title reinstallation should now work well (on real hardware at least; emulator support here is patchy), but it is the thing most likely to lead to unexpected behaviour, so please ensure you have backups before doing either of those things.
*

== Screenshots ==
https://dlhb.gamebrew.org/3dshomebrews/images/cloudpoint3ds2.png
https://dlhb.gamebrew.org/3dshomebrews/images/cloudpoint3ds3.png

https://dlhb.gamebrew.org/3dshomebrews/images/cloudpoint3ds4.png
https://dlhb.gamebrew.org/3dshomebrews/images/cloudpoint3ds5.png

== Limitations ==
Cloudpoint can't run in the background, and it can't automatically run when you launch a game. This isn't something which 3DS can natively support, so you will need to manually run syncs (see best practice).

3DS doesn't provide a method for knowing when a save was last modified, so we can't show that in the UI. We ''do'' know when you last synced a save, so we use that in the UI instead.

== Changelog ==
'''v0.6.0'''
* Chunktree store impl does not check http responses by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/122 #122]
* Improve app load pre-connect by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/124 #124]
* Document server gc and verify commands by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/127 #127]

'''v0.5.1'''
* Enable CPU/L2 enhancements for New... family consoles by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/116 #116]

'''v0.5.0'''
* Fixes & Tweaks
** Refresh hangs with region changed systems (and general resilience to crashes causes by installed titles in a not-quite-normal state) by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/104 #104] - (thanks to [https://github.com/sofauxboho @sofauxboho] for all the support)
** Move Read + Seek impl from CtrFile to a CtrFileReader by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/110 #110]
** Recover from dubious archive reads (leniency on likely uninitialised saves) by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/113 #113]
* Improvements
** Auto enable wifi & connect to server on load by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/106 #106] - (thanks to [https://github.com/gearmo3ds @gearmo3ds] for identifying a great path forward)
** Add l/r on input control to page through titles by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/112 #112]
** Custom server to replace beta version's DUFS placeholder by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/105 #105] (self hosters should upgrade by looking at the self hosting readme

'''v0.4.0'''
* UI spinner & tweaks by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/97 #97]

'''v0.3.0'''
* Proper detection of title reinstalls and title uninstalls by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/95 #95]

'''v0.2.1'''
* Terraria oom on upload by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/93 #93]

'''v0.2.0'''
* Ensure title and state db's are recreated after a system format by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/89 #89]
* Tweak display of app version and user on sync screen by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/90 #90]

'''v0.1.2'''
* Add shutdown screen to display in app while we finish work and quit by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/84 #84]
* Display app version and user key on sync screen by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/85 #85]

'''v0.1.1'''
* Implement server request body size limit in Caddy to make abuse a little harder by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/79 #79]
* Better shutdown behaviour by [https://github.com/dwalker109 @dwalker109] in [https://github.com/dwalker109/cloudpoint/pull/81 #81]

'''v0.1.0'''
* Title discovery and auto sync of all discovered titles
* Conflict resolution on demand
* Per title manual sync auto sync enable/disable toggle
* Backup of local data on downloading saves
* Sharing user key between two consoles via UDS

== Credits ==
* [https://devkitpro.org/ devkitPro] makes all of this possible
* [https://github.com/rust3ds Rust3DS] packages it all up so I can actually use it
* [https://github.com/BernardoGiordano/Checkpoint Checkpoint] is a wonderful source of inspiration for this while thing, plus a brilliant help when trying to figure out how to do something

== External links ==
GitHub - https://github.com/dwalker109/cloudpoint

NetPass 3DS

2026-07-17T02:08:31Z

HydeWing: 2.0.3

{{Infobox 3DS Homebrews
|title=NetPass
|image=NetPass3DS2.png
|description=A new way to experience StreetPass.
|author=Sorunome
|lastupdated=2026/07/14
|type=Other Apps
|version=2.0.3
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/3dshomebrews/NetPass3DS.7z
|website=https://gbatemp.net/threads/netpass-a-new-way-to-experience-streetpass.664005/
|source=https://gitlab.com/3ds-netpass/netpass
|donation=https://liberapay.com/Sorunome
}}
{{#seo:
|title= (Other Apps) - GameBrew
|title_mode=append
|image=NetPass3DS.png
|image_alt=NetPass
}}
NetPass is a homebrew that offers new way to experience StreetPass.

The app works over the internet, you can pick various locations to go to, i.e. the train station, or a town plaza, then get passes of others who are in the same location.

While you are at the location, others who enter it can get passes with you. But beware, you can only switch locations once every 10 hours.

==Installation==
Available in 3DSX and CIA formats.
*3DSX - Copy .3dsx to the 3ds folder on your SD card and run it via Homebrew Launcher.
*CIA - Install the .cia with the CIA manager of your choice.

==FAQ==
'''Q. How do I use this thing?'''

You open the app and then it presents you the option to enter a virtual location. Currently there are three: the train station, the plaza and the mall. Upon entering a virtual location you can get netpasses of others who are also in that location.

'''Q, Any time I open the app it says I am in a location. What's up?'''

Once entering a location, a 10-hour long session is started. During those 10 hours any subsequent opening of the app will reconnect you to the same location. After 10 hours have elapsed you can choose a new location.

'''Q. I only got like one netpass when entering a location?'''

On the first connection your data is uploaded to a database. There is a chance you receive passes immediately, however given more time your data will “pair” with someone else’s data which will then be available to download. This random pairing can occur once an hour, so there is no guarantee you will receive passes every time the database updates.

Imagine it as someone with a 3DS walking past you, this can happen 2 times a day or 40 times a day, depending on your luck. Your uploaded data will remain in this pairing state for up to 30 days, therefore checking in and switching locations is advised, especially since each location has its' own database. Patience is key.

'''Q. Do I have to leave this app open? Can I put my 3DS to sleep?'''

There is no need to leave NetPass open to accumulate passes. The pairing of datasets happens server side, you simply need to check in every so often.

'''Q. Will normal StreetPass still work?'''

Yes, it'll still work just fine.

==Media==
'''3DS Now Has ONLINE StreetPass''' ([https://www.youtube.com/watch?v=Z50tuxYvAO0 Good Vibes Gaming]) 
<youtube>Z50tuxYvAO0</youtube>

==Changelog==
'''v2.0.3'''
* Re-register if the server says we aren't registered,
'''v2.0.2'''
* Fix error popup (Thanks @blaadeeee).
* Add scam warning.
* Add important popup about backing up nid_pwd.
* Add time setter for if your system time is off.
'''v2.0.1'''
* Store nid_password on the sd card.
* Make sure font scaling for chineese (simplified + traditional) and korean fonts work properly.
'''v2.0.0'''
* SpotPass support.
* ImageShare support.
* Add failed auth check.
* Add nid-password and verify with a TOTP token.
* Store mac to nand and use that one.
* Respect the 3DS proxy settings and use those.
* Remove stutter of music.
'''v1.2.9'''
* Add qr code and event location music.
* Explicitly send LFCS.
* Fix potential crashes on exit.
* Make purchasing passes from the back alley faster.
* Add spinner / busy indicator on bottom screen (Thanks @Silentium).
* Fetch passes until none are possible to be fetched anymore (Thanks @Silentium).
'''v1.2.8'''
* Fix some issues with the back alley not producing results.
'''v1.2.7'''
* Fix bad http call which lead to a crash.
'''v1.2.6'''
* various small stability fixes.
* preperation for bottom screen UI.
* logging with target settings.
* make self-updater have a progress bar.
'''v1.2.5'''
* Fix the qr code scanner crashing the app.
'''v1.2.4'''
* Fix accidentally leaving code in that always triggered the new version screen.
'''v1.2.3'''
* Further stability improvements around the new text rendering.
* Small improvements on self-updating the 3dsx.
'''v1.2.2'''
* Fix random crashes, especially with the back alley.
* These were caused by the GPU CMD buffer running out of space. Since the text rendering for outline text is really inefficient this started appearing with 1.2.0, but now it is fixed.
'''v1.2.1'''
* Hotfix: prevent 3ds from crashing on loading anything except the train station and home.
'''v1.2.0'''
* update graphics
* add settings music
* add ability to override artwork with custom images on sd card
* make report list loading more robust
'''v1.1.1'''
* Fix corrupted report list thingy
* Fix music stuttering during pass imports.
* Add music to beach, cat cafe and back alley (thank you batteries!)
* Add art to back alley (thank you Lyril!)
* Hopefully fix the cecd wrong state warnings.
* Make netpass self-update on new releases.
* Fix issue if dsp firm wasn't dumped yet.
* Show only artwork on holding down L or R.
'''v1.1.0'''
* Add event locations.
* Add ability to dynamically load location artwork.
* Add music to the arcade.
* Various error fixes.
* Better the error display even more.
'''v1.0.4'''
* Fix initial wifi check breaking things completely.
* Other small potential fixes.
'''v1.0.3'''
* many bugfixes.
* nicer UI around updates.
* allow for banned people to download / delete their personal data.
* better error popups and handling.
* fixing of various errors.
'''v1.0.2'''
* Fix version detection being broken for people using luma locale switcher.
* Better error display.
* Preparations for new feature.
* Various small fixes.
* Gray out last location visited.
'''v1.0.1'''
* Check for firmware version on startup.
* Add option to remove patches.
* Add option to turn off background music.
* Fix back alley not saving properly.
'''v1.0.0'''
* '''User on-boarding''': Upon startup up NetPass the user will now be asked to review our [https://netpass.cafe/rules.html rules] and [https://netpass.cafe/privacy.html privacy policy]. After that, the user will be on-boarded easily to apply the patches to make SPR (receiving passes in the background) properly.
* '''Stand-alone''': NetPass is now completely stand-alone and does not need Pretendo to work anymore. You can, of course, still use Pretendo if you want to. The two do not conflict.
* '''Integrations''': You don't want to use only NetPass'es SPR but also [https://pretendo.network Pretendo's]? That is easy now, just go to the integration settings and then enable Pretendo!
* '''Background music''': You all have been asking for this, and waiting for this, and now it is finally here! NetPass now plays music in the background! This music is also different per-location, however not many locations have their own track yet. Stay tuned for more updates regarding this!
* '''More accurate interpretation of StreetPasses''': StreetPass has a lot of features, some of them rather obscure and not a lot of titles use this. Now, more of the obscure features of streetpass should work properly, broadening the supported titles.
* '''Special Miis''': If you are doing a recurring donation, you can now have the NetPass server automatically mark your Mii in Mii Plaza as special. Miis that were marked special via other means will automatically be marked as normal Miis.
* '''Various small features and fixes''': A lot of small bugs/issues have been fixed, along with also some bigger ones. Also some smaller features like an in-app about screen exist now!
* '''Stability''': This is a big one: Soru considers NetPass so far into development now that it is stable enough to not have any major bugs anymore (hopefully....you know how it is with software >.<)
'''v0.8.2'''
* Add patch to upload/download all titles, e.g. Letterbox/Swapnote.
* Be sure to re-write patches and re-start your console!
'''v0.8.1'''
* Hotfix: Prevent crashing on adding streetpass mii plaza to the reports.
'''v0.8.0'''
* Fix Back Alley giving white screen.
* Cache title names in memory.
* Added better report screen.
* Hopefully fix SPR patches crashing for some.
'''v0.7.1'''
* Fix issue where if some titles were toggled off it would refuse to upload and download any data.
* Fix many crashes caused by the SPR BOSS patches.
'''v0.7.0'''
* Fix reporting being broken.
* Make reporting for messages received via SPR work.
* Switch to new way to download passes: This should fix all phantom pass bugs!
'''v0.6.1'''
*Fix sending fc-ident for sprelay.
'''v0.6.0'''
*Beta StreetPass-Relay (SPR) support!
**To activate SPR, you are required to:
***Use [https://pretendo.network/ Pretendo].
***In luma, enable both "game patching" and "loading external firms/modules".
***In NetPass settings, click on "Write patches". If you run luma from nand, copy over the created patches to nand.
***In NetPass settings, click on "Clear spr cache". This will reboot your console.
**To deactivate SPR, you need to:
***Delete the created patch files.
***In NetPass settings, click on "Clear spr cache".
'''v0.5.2'''
* Add Cat Cafe Image.
* Slight bugfixes.
* Add code to make it easier for soru to test/develop sprelay.
'''v0.5.1'''
* Added new icon.
* Fixed report screen crashing.
'''v0.5.0'''
* Added back alley.
* Fix various bugs around passing.
* potentially fix phantom green lights.
'''v0.4.0'''
* Reports.
* Various small fixes.
* Add more trans-ness.
'''v0.3.3'''
* Fix Language Picker.
* Fix some languages not scaling nicely.
* Add new banner jingle.
* Add more location art.
'''v0.3.2'''
* Add language picker.
* Fix banner.
* Hide NetPass from system usage.
* Fix crash related to default language being wrong.
'''v0.3.1'''
* Hopefully fix crashes once an for all.
* Add some more backgrounds.
'''v0.3.0'''
* More translations.
* More locations.
* Can't enter same location twice in a row.
* stability fixes.
'''v0.2.5'''
* Hopefully fix the crashes on DL'ing inbox.
* Nicer server-side autodetect of version upgrade.
* new jingle
* hopefully fix title names not always being 0-terminated.
'''v0.2.5'''
*hopefully fix the random crashes on startup for animal crossing.
'''v0.2.3'''
* Automatic aggregation on undiscovered streetpass data. This is so that soru can reverse-engineer streetpass bettr. This is not tied to any console at all. The only thing collected are a title_id, the name of the title and the reason why the unkown-detecter got tripped.
* Options to delete and download all personal data.
* preparation for switch from macs to unique ids.
* interface to allow messaging the client.
'''v0.2.2'''
*Fixed up little quirks about streetpassing rudimentary localization support.
'''v0.2.1'''
*Fixed multiple crashes, added translations.
'''v0.2.0'''
*The random crashes should be fixed now!
'''v0.1.2'''
* First Release.

== Credits ==
=== Research ===
* [https://gist.github.com/wwylele/29a8caa6f5e5a7d88a00bedae90472ed This gist] by wwylele, describing some cecd functionality
* [https://github.com/NarcolepticK/CECDocs This repo] by NarcolepticK documenting some more of the cecd sysmodule
* [https://gbatemp.net/threads/streetpass-2-rise-from-the-ashes.526749/ StreetPass 2] for valuable data dumps
* 3Dbrew and all its contributors, especially of the [https://www.3dbrew.org/wiki/CECD_Services cecd service]
=== Translations ===
* English: Sorunome
* German: Sorunome
* Russian: [https://gbatemp.net/members/rednorka.575239/ Rednorka], Geo
* Japanese: [https://gitlab.com/Akira-SN Akira SUNADUKA]
* Polish: [https://gitlab.com/DanteyPL DanteyPL]
* Spanish: [https://gitlab.com/Gato-kun Gato-kun], [https://gitlab.com/Amnesia1000 Amnesia1000]
* French: [https://straky.fr/en Straky], [https://gitlab.com/Essepeius Possemelius], Tourneur
* Italian: [https://github.com/LNLenost LNLenost]
* Chinese (Traditional): ManLok Ho
* Ukrainian: Geo
* Portugese: Lia, arth
* Dutch: Robbin12391, aiydn

== External links ==
* GitLab - https://gitlab.com/3ds-netpass/netpass
* GBAtemp - https://gbatemp.net/threads/netpass-a-new-way-to-experience-streetpass.664005/
* GBAtemp - https://gbatemp.net/threads/a-new-way-to-experience-streetpass.653810/

PocketCompiler 3DS

2026-07-17T02:08:23Z

HydeWing: 0.48

{{Infobox 3DS Homebrews
|title=PocketCompiler
|image=PocketCompiler3DS.png
|description=An almost fully featured HTML/JS/CSS compiler application made for 3DS/n3DS consoles.
|author=PlanetDogeCodes
|lastupdated=2026/07/14
|type=Other Apps
|version=0.48
|license=Apache-2.0
|download=https://dlhb.gamebrew.org/3dshomebrews/PocketCompiler3DS.7z
|website=https://github.com/PlanetDogeCodes/Pocket-Compiler
|source=https://github.com/PlanetDogeCodes/Pocket-Compiler
}}
PocketCompiler is an experimental Nintendo 3DS HTML/JS/CSS compiler and code editor.

PocketCompiler is designed to let you:
* Write HTML/JS/CSS on the 3DS, allowing for easy development
* Compile and run web pages directly on the top screen with a real DOM-based rendering engine
* Save/load/rename/delete projects from the SD card
* Debug with a live JS console

The default project path is <code>sdmc:/3ds/PocketCompiler/projects</code>/

== Features ==
* HTML parsing with DOM tree construction
* CSS engine with cascade, inheritance, specificity, custom properties (<code>var()</code>), <code>calc()</code>, <code>@media</code> skip, <code>:not()</code>, <code>:hover</code>/<code>:focus</code>/<code>:active</code>/<code>:checked</code>/<code>:disabled</code>, <code>:first-child</code>/<code>:last-child</code>/<code>:nth-child()</code>, comma selectors, <code>!important</code>, box-sizing, flex/grid layout, transitions, box-shadow, linear-gradient, word-wrap, and 40+ CSS properties
* JavaScript runtime via Duktape (ES5 + subset of ES6)
* DOM manipulation: <code>getElementById</code>, <code>querySelector</code>/<code>querySelectorAll</code>, <code>createElement</code>, <code>appendChild</code>, <code>innerHTML</code>, <code>textContent</code>, <code>classList</code>, live <code>style</code> object (Proxy-backed), <code>addEventListener</code>, <code>onclick</code>/<code>onload</code>/etc. property handlers
* Keyboard, mouse, and touch events with bubbling
* <code>document.write()</code> with incremental parsing
* Software keyboard integration for <code><input></code>/<code><textarea></code> text entry and <code>window.prompt()</code>
* Form submission via click on submit buttons
* <code>fetch()</code> / XMLHttpRequest (SD-card backed)
* localStorage / sessionStorage (SD-card persisted)
* IndexedDB (SD-card persisted, simplified sync API)
* Canvas 2D rendering
* WebGL scaffolding (Citro3D backend)
* Image loading (PNG via LodePNG)
* Web Audio (oscillators, gain, WAV playback via NDSP)
* Near-complete iframe support
* Auto-save draft (writes to SD on compile + 10s of idle)
* Crash-recovery: "Recover autosave" action restores unsaved work
* Remembers last-opened file across launches
* File explorer: save, load, rename, delete, sort by name/size/date

== Canvas / WebGL ==
PocketCompiler has rendering systems for:
* Canvas 2D: rectangles, paths, text, images, gradients, transforms, <code>fillText</code>/<code>strokeText</code>/<code>measureText</code>
* WebGL: <code>getContext("webgl")</code> detection, buffers, shaders/programs, uniforms/attributes, textures, draw calls, viewport/depth/blend/scissor state, Citro3D backend scaffolding
This is not yet full WebGL.

== Storage ==
PocketCompiler includes SD-card-backed storage systems:

<pre>sdmc:/3ds/PocketCompiler/
config.txt <- last-opened file (auto-managed)
autosave.html <- crash-recovery draft (auto-managed)
console_log.txt <- exported JS console log (written on demand)
projects/ <- all .html project files
storage/
local_*.json <- localStorage data
idb/ <- IndexedDB data</pre>

Supported:
* IndexedDB-style databases with <code>put</code>, <code>get</code>, <code>delete</code>, <code>clear</code>, <code>close</code>
* localStorage with SD-card persistence
* sessionStorage (in-memory, per session)
* Cookie-style storage

== Audio ==
PocketCompiler includes a Web Audio-style system:
* AudioContext-like runtime
* OscillatorNode (sine/square/triangle/sawtooth)
* GainNode
* AudioBufferSourceNode with WAV file loading
* NDSP-backed output when available
* Safe fallback if audio fails

== Limitations ==
PocketCompiler is still in early development.

It does not yet fully support:
* Full modern CSS (no CSS animations/@keyframes, no rotate()/scale() transforms, limited position: fixed)
* Full modern JavaScript (no ES modules, no async/await, no Proxy traps beyond get/set)
* Real networking (all fetch/XHR URLs resolve to SD-card files)
* Full WebGL 1.0 (no real GLSL shader translation)
* Full Canvas 2D API (no drawImage from video, no complex path fills)
* Full Web Audio API (no real-time effects, no offline rendering)
* Complete iframe isolation
* Pointer lock

The 3DS also has very limited RAM, CPU, GPU power, and screen space, so PocketCompiler uses strict safety limits (bounded DOM pool, bounded event queues, bounded command buffers, 4 MB max audio buffer, recursion depth guards).

==Controls==
'''Edit Mode — Editor Tab:'''

D-Pad Up/Down - Scroll code vertically

D-Pad Left/Right - Scroll code horizontally

Circle Pad - Move cursor dot

Touch - Snap cursor to tap; tap tabs / code lines / file rows

A - Edit current line (3DS keyboard; auto-indent if empty)

B - Undo (5-step ring)

X - Save project (file explorer)

Y - Load project (file explorer)

L - Toggle JS Console tab

R - Open Actions menu (Find, Go-to, Duplicate, Comment, Rename, Delete, Sort, Export log, Recover autosave)

Start - Compile + run

Select - Show controls menu (scrollable)

'''Edit Mode — Console Tab:'''

D-Pad Up/Down - Scroll console log

A - Type & eval JS expression

B - Clear console log

L - Back to editor tab

'''Run Mode:'''

D-Pad - Scroll web page (all directions)

Circle Pad - Move cursor (never scrolls)

A / L - Left-click

B / R - Right-click

X - Release cursor lock

Y - Space key (sent to web content)

Start - Stop, Return to editor

== Screenshots ==
https://dlhb.gamebrew.org/3dshomebrews/images/PocketCompiler3DS2.png
https://dlhb.gamebrew.org/3dshomebrews/images/PocketCompiler3DS3.png

== Changelog ==
'''v0.48'''
* The 3DS crash issue in the previous version was caused by the '''Duktape fatal error handler''' entering an infinite spin loop (<code>for(;;) svcSleepThread(...)</code>) after JS context creation completed. When any post-creation Duktape operation triggered a fatal error (OOM, etc.), the handler froze the entire 3DS, requiring a reboot.
* Fixes Applied
** '''Fatal handler no longer spins infinitely (web_js.c)'''
*** Changed the post-creation fatal handler from <code>for(;;) svcSleepThread(1000000000LL)</code> to simply <code>return</code>. While returning from a Duktape fatal handler is technically undefined, in practice Duktape propagates the error as a JS exception or returns a safe value. The app continues running instead of freezing the 3DS.
** '''<code><style></code> block buffer increased (web_html_parser.c)'''
*** <code>stbuf</code> increased from 8192 to 16384 bytes. A 31KB HTML file can easily have >8KB of CSS. Truncation at 8KB produced malformed CSS that could confuse the parser.
** '''<code><script></code> block buffer increased (web_html_parser.c)'''
*** <code>scbuf</code> increased from 16384 to 32768 bytes. Large inline scripts were being truncated at 16KB, causing syntax errors (caught by <code>duk_peval_string</code> but wasteful).
** '''DOM pool sizes increased (web_dom.h)'''
*** <code>WE_MAX_NODES</code>: 1024 → 2048 (a complex 31KB page can have >1024 elements + text nodes)
*** <code>WE_MAX_ATTRS</code>: 512 → 1024 (matching the larger node pool)
** '''C2D_TextBuf NULL checks (web_render.c)'''
*** Added OOM guards after <code>C2D_TextBufNew(4096)</code> in both the wrapping and non-wrapping text render paths. If allocation fails, the function skips drawing that text instead of crashing.
** '''All unprotected <code>duk_eval_string</code> calls replaced with protected versions:'''
: {| class="wikitable"
|-
! File
! Call
! Fix
|-
| <code>web_js.c:1346</code>
| <code>duk_eval_string_noresult</code> (polyfills)
| → <code>duk_peval_string_noresult</code>
|-
| <code>web_iframe.c:184</code>
| <code>duk_eval_string_noresult</code> (postMessage stub)
| → <code>duk_peval_string_noresult</code>
|-
| <code>web_canvas.c:369</code>
| <code>duk_eval_string</code> (canvas property setup)
| → <code>duk_peval_string</code> + fallback to plain object on failure
|}

'''v0.47'''
* '''Multi-line text rendering'''
** <code>wrender_text</code> previously drew the entire text string as a single <code>C2D_DrawText</code> call, so paragraphs that the layout engine had correctly wrapped to multiple lines rendered as one long line overflowing off-screen. The function now detects when text exceeds the available width, splits at word boundaries using the same <code>char_width</code> metric as the layout engine, and draws each line separately with correct alignment, bold, italic, and decoration.
* '''<code>position: fixed</code> / <code>sticky</code>'''
** <code>position: fixed</code> elements no longer scroll with the page — the renderer skips applying the scroll offset for <code>position==3</code> nodes, keeping them pinned to the viewport. <code>position: sticky</code> is now parsed (value 4) and treated like <code>relative</code> for layout. True scroll-tracking stickiness is deferred.
* '''Dirty-only CSS cascade'''
** <code>css_cascade</code> previously ran <code>css_compute_node</code> on every element every frame when any node was dirty. On a 100-element page with 50 CSS rules, that's ~5000 <code>selector_matches</code> calls per frame. Now only processes nodes where <code>dirty==1</code>. On page load all nodes are dirty (unchanged behavior); during per-frame hover/focus updates, typically 1-2 nodes are dirty, reducing cascade cost by ~99%.
* '''<code>window.getComputedStyle()</code>'''
** Returns a read-only object with 20+ computed style properties as CSS-formatted strings: <code>width</code>, <code>height</code>, <code>display</code> (as string), <code>color</code>/<code>backgroundColor</code> (as <code>rgba(...)</code>), <code>fontSize</code>, <code>position</code>, <code>opacity</code> (as 0-1 float), <code>visibility</code>, margins, padding, border, <code>left</code>/<code>top</code>, and <code>offsetLeft/Top/Width/Height</code>. Fixed: <code>display</code> was being set twice (boolean then string); <code>opacity</code> was returning 0-255 instead of 0.0-1.0.
* '''<code>Element.matches()</code> rewritten'''
** Previously only handled <code>#id</code>, <code>.class</code>, and bare tag names. Now delegates to <code>css_selector_matches</code> — the full selector matching engine — so it handles descendant selectors, attribute selectors, pseudo-classes (<code>:hover</code>, <code>:checked</code>), <code>:not()</code>, adjacent siblings (<code>+</code>), and pseudo-elements.
* '''<code>Element.closest()</code>'''
** New method. Walks up the ancestor chain (including self) until one matches the given selector, returning the element or <code>null</code>. Cycle-guarded with <code>g_dom_node_n</code> bound. Uses the full <code>css_selector_matches</code> engine for each ancestor check.
* '''<code>Array.from()</code> polyfill + <code>NodeList</code> alias'''
** Polyfills <code>Array.from</code> for array-like objects and iterables with optional <code>mapFn</code>/<code>thisArg</code>. Aliases <code>NodeList</code> to <code>Array</code> so <code>instanceof NodeList</code> checks pass and <code>NodeList.prototype.forEach</code> exists (Duktape arrays already have <code>forEach</code>). <code>JSON.parse</code>/<code>JSON.stringify</code> verified working via Duktape's built-in <code>DUK_USE_JSON_BUILTIN</code>.
* '''Files changed'''
{| class="wikitable"
|-
! File
! Changes
|-
| <code>web_render.c</code>
| Multi-line text wrapping in <code>wrender_text</code>; <code>position:fixed</code> scroll-offset skip
|-
| <code>web_layout.c</code>
| <code>position:fixed</code> uses viewport (0,0); <code>position:sticky</code> (value 4) treated like relative
|-
| <code>web_css.c</code>
| Dirty-only cascade in <code>css_cascade</code>; <code>css_selector_matches</code> public wrapper; <code>position:sticky</code> parser
|-
| <code>web_css.h</code>
| <code>css_selector_matches</code> declaration; <code>CSS_SEL_LEN</code> 64→128
|-
| <code>web_dom.h</code>
| <code>position</code> comment updated for sticky (value 4)
|-
| <code>web_js.c</code>
| <code>getComputedStyle</code>, <code>closest</code>, rewritten <code>matches</code>, <code>Array.from</code> polyfill, <code>NodeList</code> alias, opacity format fix
|}

'''v0.45'''
* '''All New Stuff'''
** CSS selectors were completely failing on complex selectors
*** The <code>selector_matches</code> function only handled '''simple selectors''' (tag, <code>.class</code>, <code>#id</code>, <code>tag.class</code>). It could not match any selector containing:
**** '''Descendant combinators''' (spaces): <code>.tog input</code>, <code>.field input[type=text]</code>, <code>details:not([open]) summary</code>
**** '''Adjacent sibling combinators''' (<code>+</code>): <code>.tog input:checked + .tog-sw</code>
**** '''Attribute selectors''' (<code>[type=checkbox]</code>): <code>input[type=checkbox]</code>
**** '''Pseudo-elements''' (<code>::after</code>, <code>::before</code>): <code>summary::after</code>, <code>.tog-sw::after</code>
*** Since nearly every selector in the EaglerLite CSS uses at least one of these, '''zero CSS rules were matching''' — the page rendered with default styles only.
** DPad scroll was broken
*** The v0.43 DPad scroll fix (which used <code>we_page_scroll_by</code> when the web engine was loaded) was accidentally reverted during the v0.44 bugfix pass, going back to the old text-mode-only scroll. DPad Up/Down did nothing when viewing a web page.
* '''What I fixed'''
** New <code>simple_selector_matches</code> function
*** Handles a single simple selector component, now with:
**** '''Attribute selectors''': <code>[attr]</code>, <code>[attr=val]</code>, <code>[attr="val"]</code> — parses the bracket, splits on <code>=</code>, strips quotes, checks the node's attribute
**** '''Pseudo-elements''': <code>::after</code>, <code>::before</code>, <code>::marker</code>, <code>::placeholder</code>, <code>::selection</code> — always accepted (we don't render them, but the selector matches the base element so its other properties still apply)
**** '''<code>*</code> with attribute selectors''': <code>*[attr=val]</code> works
**** Uses <code>css_classlist_has</code> (local, no strtok) instead of <code>classlist_has</code> (which lives in web_js.c)
** Rewritten <code>selector_matches</code> function
*** Now handles '''compound selectors''' with combinators:
**** '''Descendant''' (space): <code>.tog input</code> — walks up ancestors checking each part right-to-left
**** '''Adjacent sibling''' (<code>+</code>): <code>input + .tog-sw</code> — checks the immediately preceding sibling
**** Splits the selector at spaces and <code>+</code> (respecting <code>[bracket]</code> depth so <code>[type=checkbox]</code> doesn't get split)
**** Each part is matched via <code>simple_selector_matches</code>
**** Guard counter on all ancestor walks prevents infinite loops
** DPad scroll restored
*** DPad Up/Down/Left/Right now scrolls the web page via <code>we_page_scroll_by(0, ±30)</code> when <code>g_web_engine.loaded</code> is true. Falls back to text-mode scroll when the engine isn't loaded. Circle Pad is always cursor-only.

'''v0.44'''
* '''CSS Custom Properties (Variables) — <code>var()</code> + <code>:root</code>'''
** The biggest addition. <code>:root { --bg: #000; }</code> stores custom properties in a global variable table. <code>var(--bg)</code> is resolved at parse time before any property handler runs — works in colors, lengths, and any value. Supports <code>var(--name, fallback)</code> syntax and recursive resolution (variables referencing other variables). Up to 64 variables stored. Reset on page recompile.
* '''<code>@media</code> Queries — Graceful Skip'''
** <code>@media(max-width: 680px) { ... }</code> is now parsed and skipped gracefully (with proper brace-nesting tracking). Previously, <code>@media</code> would confuse the stylesheet parser and corrupt all subsequent rules. Also skips <code>@keyframes</code>, <code>@import</code>, <code>@font-face</code>, and <code>@charset</code>.
* '''<code>:root</code> Selector'''
** <code>:root { ... }</code> declarations are applied as a universal <code>*</code> rule with the lowest specificity, so <code>:root</code> properties cascade to all elements via inheritance. Custom properties (<code>--name: value</code>) are stored in the variable table.
* '''<code>:not()</code> Selector'''
** <code>:not(.hidden)</code> now works. The inner selector is recursively matched and negated. Forward-declared to handle the mutual recursion between <code>pseudo_matches</code> → <code>pseudo_not_matches</code> → <code>selector_matches</code>.
* '''Comma-Separated Selectors'''
** <code>h1, h2, h3 { ... }</code> now creates a separate rule for each sub-selector instead of creating one rule with a comma in the selector (which never matched anything).
* '''<code>!important</code> Support'''
** <code>color: red !important</code> is now accepted — the <code>!important</code> suffix is stripped before parsing. All declarations are treated as having the same specificity (later wins), so <code>!important</code> doesn't change cascade behavior but no longer causes parse failures.
* '''New CSS Properties (15 additions)'''
{| class="wikitable"
|-
! Property
! Description
|-
| <code>box-sizing</code>
| <code>border-box</code> / <code>content-box</code> (parsed, stored)
|-
| <code>flex</code> shorthand
| <code>flex: 1</code> → grow=1; <code>flex: 1 0 auto</code> → grow/shrink/basis
|-
| <code>flex-shrink</code>
| Default 1
|-
| <code>flex-basis</code>
| <code>auto</code> or length
|-
| <code>pointer-events</code>
| <code>none</code> / <code>auto</code>
|-
| <code>user-select</code>
| <code>none</code> / <code>auto</code>
|-
| <code>outline</code>
| Width + color (simplified, no layout impact)
|-
| <code>outline-width</code> / <code>outline-color</code> / <code>outline-style</code>
| Individual properties
|-
| <code>text-transform</code>
| <code>uppercase</code> / <code>lowercase</code> / <code>capitalize</code> / <code>none</code>
|-
| <code>letter-spacing</code>
| px or <code>normal</code>
|-
| <code>line-height</code>
| px, unitless multiplier, or <code>normal</code>
|-
| <code>list-style</code> / <code>list-style-type</code>
| <code>none</code> / <code>disc</code> / <code>circle</code> / <code>square</code> / <code>decimal</code>
|-
| <code>object-fit</code>
| <code>fill</code> / <code>contain</code> / <code>cover</code>
|-
| <code>min/max-width/height</code>
| Now handles <code>none</code> and <code>auto</code> correctly
|}

'''v0.43'''
* '''UI: DPad = Scroll, Circle Pad = Cursor (fixed)'''
** The biggest UX fix: DPad and Circle Pad no longer conflict. Previously, DPad both scrolled the fallback text renderer AND sent arrow key events to web content — pressing Up would scroll the page ''and'' fire a <code>keydown("ArrowUp")</code> at the same time. Circle Pad could also trigger scroll in some paths.
** '''Now:'''
*** '''DPad''' scrolls the web page (30px per press, all four directions). When the web engine isn't loaded, it scrolls the fallback text output instead.
*** '''Circle Pad''' always moves the cursor — it never scrolls, in any mode.
*** DPad was removed from the web content key map entirely, so no more phantom arrow key events.
*** Only '''Y''' (Space) generates a keyboard event for web content.
*** Controls help screen updated to reflect the new assignments.
* '''Cookie Clicker Compatibility: 3 Major JS APIs Added'''
** '''<code>element.classList</code>''' — Cookie Clicker (and most modern JS) uses <code>classList.add()</code>, <code>.remove()</code>, <code>.toggle()</code>, <code>.contains()</code> extensively. Previously only <code>className</code> existed. Now <code>classList</code> returns a live object with all four methods that manipulate the node's <code>class</code> attribute and trigger <code>css_compute_node</code> so styles re-cascade.
** '''Live <code>element.style</code> object''' — Cookie Clicker does <code>element.style.display = 'none'</code>, <code>element.style.left = '100px'</code>, etc. Previously <code>style</code> was a dead object — setting properties did nothing. Now the style object is wrapped in a '''Duktape Proxy''' that intercepts every property get/set:
*** '''Get''' (<code>element.style.display</code>): parses the inline <code>style</code> attribute and returns the property value.
*** '''Set''' (<code>element.style.display = 'none'</code>): updates the inline style string via a C-backed <code>cssText</code> setter, triggers <code>css_compute_node</code> + <code>dom_mark_dirty</code> so the layout and renderer pick up the change immediately.
** '''<code>onclick</code>/<code>onload</code>/<code>onerror</code> property handlers''' — Cookie Clicker assigns <code>element.onclick = function(){...}</code> instead of using <code>addEventListener</code> or inline <code>onclick="..."</code> attributes. Previously only inline attribute handlers and <code>addEventListener</code> worked. Now <code>we_dispatch</code> checks for JS function properties on the node object (<code>onclick</code>, <code>onmousedown</code>, <code>onload</code>, <code>onsubmit</code>, etc.) and calls them with a proper event object. Supports all 13 event types.

'''v0.42'''
* '''CSS Transitions'''
** <code>transition: 0.3s ease-in-out</code> now actually animates. When a style property changes on an element with a transition duration, the old and new values are interpolated over the duration using smoothstep easing. Supports 25 numeric properties (opacity, width, height, margins, padding, position, font-size, border, transforms) plus color properties (color, background) which interpolate per-channel. The transition engine runs in the frame loop and marks transitioning nodes dirty so layout re-runs each frame to reflect the changing values.
* '''Box-Shadow'''
** <code>box-shadow: 2px 2px 4px rgba(0,0,0,0.5)</code> is parsed into offset/blur/color and drawn as a semi-transparent rect behind the element before the background fill. No real gaussian blur (3DS hardware can't do that efficiently), but the spread approximation looks reasonable for most UI shadows.
* '''Linear-Gradient Backgrounds'''
** <code>background: linear-gradient(to right, red, blue)</code> is parsed into start/end colors and a direction, then rendered as 16 interpolated color bands. Supports <code>to right/bottom/left/top</code> directions and <code>Ndeg</code> angles. Falls back to solid <code>background</code> color when no gradient is active. Transparent colors work correctly (uses explicit "set" flags instead of checking for zero).
* '''CSS Grid Layout'''
** <code>display: grid</code> with <code>grid-template-columns</code> now lays out children in a grid. Supports fixed pixel widths, <code>fr</code>/<code>auto</code> (equal distribution), and <code>repeat(N, ...)</code> syntax up to 8 columns. Rows auto-size to the tallest cell, gap is applied between cells, and children are vertically centered within their row.
* '''CSS <code>calc()</code>'''
** <code>calc(100% - 20px)</code> is now evaluated at layout time. Supports <code>+</code>, <code>-</code>, <code>*</code>, <code>/</code> with correct operator precedence, and all length units (px, em, rem, vw, vh, %) work inside calc terms. Self-contained in the length parser — no new systems.
* '''Form Submission'''
** Clicking a <code><button type="submit"></code> or <code><input type="submit"></code> inside a <code><form></code> now fires the form's <code>onsubmit</code> handler and dispatches a <code>submit</code> event. This replaces the old START-key approach which conflicted with START=exit-run-mode.
* '''Keybind Conflict Fixes'''
** Resolved button assignment conflicts between the app shell and web content event system. In run mode, only DPad (arrow keys) and Y (Space) generate keyboard events for web content. A/B/X/L/R/START are exclusively mouse clicks, cursor lock, and exit-run-mode — no more phantom keydown events alongside mouse clicks.
* '''Bug Fixes'''
** IndexedDB path overflow: <code>store</code>/<code>key</code> strings from JS are now length-validated to prevent path truncation
** IndexedDB <code>get()</code> return logic: was returning true for empty files
** IndexedDB <code>clear()</code> prefix buffer: enlarged from 80 to 128 bytes to handle longer store names
** Transition color precision: RGBA8 colors now stored as uint32 (not float) to avoid precision loss past 2^24
** Gradient transparent-color: <code>0x00000000</code> (transparent) no longer treated as "unset"

'''v0.41'''
* '''<code><input></code>/<code><textarea></code> text entry'''
** New <code>we_input_prompt()</code> in <code>web_events.c</code> opens the 3DS software keyboard when a click lands on an <code><input></code>/<code><textarea></code> (or an ancestor of one). Reads the current <code>value</code> attribute, shows it as initial text, writes the result back, fires <code>input</code> + <code>change</code> events, and marks the node dirty so the renderer shows the new text.
** New <code>we_text_input()</code> helper wraps <code>swkbdInit</code>/<code>swkbdInputText</code> for reuse.
* '''CSS <code>transform: translate()</code>'''
** <code>wrender_node</code> now applies <code>translate_x</code>/<code>translate_y</code> to the draw position, and folds the offset into the children's <code>ox</code>/<code>oy</code> so children move with the translated parent. ~6 lines of real logic; the parser already stored the values since v0.39.
* '''Word-wrap in the layout engine'''
** Replaced the naive <code>tw/avail_w + 1</code> character-count wrapping with proper word-boundary wrapping. Walks the text word by word, tracks line width, breaks when the next word would overflow. Hard-breaks words longer than a full line. Respects <code>white-space: pre</code> and <code>nowrap</code>.
* '''CSS <code>:hover</code> / <code>:focus</code> / <code>:nth-child</code> pseudo-classes'''
** New <code>pseudo_matches()</code> function checks <code>:hover</code>, <code>:focus</code>, <code>:active</code>, <code>:checked</code>, <code>:disabled</code>, <code>:first-child</code>, <code>:last-child</code>, <code>:nth-child(n/odd/even)</code>.
** <code>selector_matches()</code> rewritten to split selectors at <code>:</code> and check the pseudo-class after the base selector matches. Supports chained pseudos (<code>a:focus:hover</code>).
** Dynamic re-cascade: <code>we_events_update</code> marks nodes dirty on hover/focus changes; <code>we_update</code> now re-runs <code>css_cascade</code> (not just <code>layout_document</code>) when nodes are dirty, so <code>:hover</code>/<code>:focus</code> styles apply dynamically.
* '''Keyboard input to web content'''
** <code>window.prompt(message, default)</code> now opens the 3DS software keyboard and returns the typed string (was a no-op stub returning <code>undefined</code>).
** Clicking an <code><input></code>/<code><textarea></code> opens the keyboard (Feature 1 above).
* '''localStorage persistence + IndexedDB completion'''
** '''IndexedDB C API hardened''': <code>ws_idb_open</code> now checks for existing databases with the same name (no duplicates); <code>ws_idb_get</code> validates <code>fread</code> return (was a potential underflow); <code>ws_idb_clear</code> is no longer a no-op — it scans the directory with <code>opendir</code>/<code>readdir</code> and removes all files matching the store prefix; all functions now have proper NULL/bounds checks.
** '''IndexedDB JS bindings''': <code>ws_install_idb</code> now installs a real <code>indexedDB</code> object to JS with <code>open()</code>, <code>put()</code>, <code>get()</code>, <code>delete()</code>, <code>clear()</code>, <code>close()</code> methods. <code>put()</code> JSON-encodes values; <code>get()</code> safely JSON-parses them back (falls back to string if not valid JSON). The "IndexedDB" feature pill is now actually true.

'''v0.38'''
* '''Crash / correctness bugs:'''
** Canvas 2D silently broken — wc_install_bindings() built its property-setup script with snprintf into a 512-byte buffer, but the actual script is 854 bytes. It was truncating mid-statement, so ctx.fillStyle = 'red' and every other canvas property setter did nothing, with zero error shown. Now passed as a literal directly to duk_eval_string — no buffer, no truncation possible.
** Event listeners could misfire — DOMEvent.js_ref was a uint8_t, silently wrapping after the 255th addEventListener() call in a session and firing the wrong callback. Widened to uint16_t.
** Listener ref counter never reset — it was a function-local static that persisted across every recompile instead of resetting with the fresh Duktape context each page load gets. Moved to file scope with an explicit reset tied to context creation.
** Unchecked array access in we_document_open() — switched to the existing bounds-checked accessor so a corrupted sibling chain can't read out-of-bounds memory.
* '''Stack-safety hardening (3DS has only 256KB of stack):'''
** ~3KB of stacked buffers in the CSS parser — css_parse_inline's 2048-byte buffer is called while css_parse_stylesheet's 1024-byte buffer is still live. Both made static (verified safe: parsing is never re-entrant).
** Unbounded layout recursion — nothing stopped a deeply-nested DOM tree (up to the 1024-node cap) from recursing that many stack frames deep. Added a depth guard capped well above any realistic page.
* Version v0.37 was skipped due to issues with a beta build.
* CIA files will be added in version 1.0

'''v0.36'''
* '''Crash / correctness fixes:'''
** <code>editor_find</code> and <code>editor_find_prev</code>: <code>start_line</code> was not clamped before use — with a corrupted or uninitialized value it could make <code>editor_get_line</code> walk off the end of the buffer. Now clamped to <code>[0, total-1]</code>.
** <code>editor_replace_at</code>: added <code>col > llen</code> guard so an exact-end-of-line replacement can't produce a negative memcpy count.
** <code>we_eval_js</code>: added <code>!g_web_engine.loaded</code> check — without it, a stale non-NULL <code>js_ctx</code> pointer left from a previous <code>we_unload()</code> call could be dereferenced.
** <code>draw_console</code>: <code>i < WJS_LOG_MAX_LINES</code> guard added — a corrupted <code>g_wjs_log_n</code> could have caused a read past the log array bounds.
* '''Compiler warning fixes:'''
** <code>(down & KEY_X) && ...</code> — explicit parentheses added (GCC -Wall warning eliminated).
** Two <code>strcat()</code> calls replaced with <code>strncat()</code>.
** <code>LAYOUT_ED_H</code> corrected to <code>178.0f</code> (was <code>180.0f</code>) — the 2px mismatch caused the cursor-to-line mapping to select the wrong line near the bottom of the editor panel.

'''v0.34'''
* Slight UI changes
* Bordered rendering for text & iframe
* Memory usage fixes
* More accurate CSS parsing

{| class="wikitable"
|-
! File
! Fixes/Changes
|-
| <code>web_layout.c</code>
| Body <code>avail_w</code> bug fixed: was <code>2×margin_left</code>, now <code>margin_left + margin_right</code>.
|-
| <code>web_layout.c</code>
| Text node <code>lay_w</code> uses full available container width for alignment.
|-
| <code>web_render.c</code>
| Scale formula <code>size/11.0f</code> → <code>size/30.0f</code> (correct for system font at scale 1.0 ≈ 30px).
|-
| <code>web_render.c</code>
| TEXT nodes use parent container width for proper text alignment.
|-
| <code>web_render.c</code>
| Bottom border drawn on document viewport to frame the output area.
|-
| <code>web_engine.c</code>
| <code>css_apply_ua_defaults()</code> called after <code>css_reset()</code>, before parse — so user styles always win.
|-
| <code>web_engine.c</code>
| RUNNING bar cleaned up; conflicting title bar overlay removed.
|}

'''v0.33.5'''
* Hopefully fixed crashing issues

'''v0.33.4'''
* MAYBE fixed crashing issues (untested, will update when tested)

'''v0.33.3'''
* Fixed surface-level crashing issues

'''v0.33.2'''
* Maybe fixed crashing issues
* Stability fixes
* Fixed errors while compiling

'''v0.33'''
* Fixed scrolling
* Fixed line truncation
* Added more complete rendering capabilities
* Added pointer lock integration
* Added page interaction

'''v0.32'''
* Fixed the HTML rendering engine
* Slight UI changes

'''v0.31.1'''
* Completely overhauled the UI (AI was used to help with this)
* New frame buffer that minimizes the visual bug to almost unnoticeable proportions.

'''Pre-Release v0.30'''
* Fixed app crashing on file explorer open (MAYBE FR THIS TIME)
* Fixed the visual bug (kinda)

== Credits ==
PocketCompiler project and idea by PlanetDogeCodes. Some browser runtime features, custom Canvas/WebGL Integration, and 3DS Optimizations were all made with help from GPT-5.5 (xhigh) and GLM 5.2 (max). Some UI elements and DOM-style event handling were made with help from Claude Sonnet 5 (high)

Built with:
* Visual Studio Code
* devkitPro
* devkitARM
* libctru
* Citro2D
* Citro3D

== External links ==
* GitHub - https://github.com/PlanetDogeCodes/Pocket-Compiler
* Universal-DB - https://db.universal-team.net/3ds/pocket-compiler

Chovy-sign Vita

2026-07-17T02:08:16Z

HydeWing: 2.0.7.1

{{Infobox Vita Homebrews
|title=Chovy-Sign
|image=chovysignvita.png
|description=Run any PS1 or PSP game on any PS Vita (including OFW).
|author=CBPS Team
|lastupdated=2026/07/14
|type=PC Utilities
|version=2.0.7.1
|license=GPL-3.0
|download=https://github.com/KuromeSan/chovy-sign/releases
|website=https://www.reddit.com/r/vitahacks/comments/12z59jd/release_chovysign_v2_now_with_ps1_support_run_any/
|source=https://silica.codes/SilicaAndPina/chovy-sign
|donation=
}}
{{#seo:
|title=Vita Homebrew PC Tools (PC Utilities) - GameBrew
|title_mode=append
|image=chovysignvita.png
|image_alt=Chovy-sign
}}
Chovy-Sign is an application that allows you to convert PSP and PS1 ISO's to be playable on unmodified PS Vita. The release was part of Project Chovy and was primarily created to allow PSP emulation on the PS Vita.

It requires a valid (official) PSP or PS1 license to work, a PSP DLC license should also work.

This tool is intended for making back up of the games that you actually own. The authors do not promote or condone piracy in any way.

==User guide==
Instructions can be found [https://silica.codes/SilicaAndPina/chovy-sign/src/branch/master/README.md here].

'''Notes:''' ISOs made with Chovy-Sign are "clones" of the original "base game", if you delete any of them it deletes the license.rif which breaks all the other "clones". This can be fixed by re-downloading the base game off of the PSN or copying any "clone" over to your PS Vita again.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/chovysignvita-02.png

==Media==
'''HOW TO Play PSP ISO's On PS VITA 3.71! NO CFW/ANY FIRMWARE! - ([https://www.youtube.com/watch?v=dSxMtWiBrEQ Tech James])''' 
<youtube>dSxMtWiBrEQ</youtube>

'''How To Play PSP Games On 3.71 FW Vita! *Without HENkaku/Trinity*''' ([https://www.youtube.com/watch?v=rX0swcSISTQ Nagato's Revenge]) 
<youtube>rX0swcSISTQ</youtube>

==Compatibility==
Works on FW 3.71 (CFW and OFW).

==Changelog==
'''v2.0.7.1'''
* Fix issue where it might download cover art even if its turned off(?)
* Attempt to fix icon sometimes being blank(?)
* Fix reading certain games with boot file prefixed with "CDROM:".
* Fix __sce_ebootpbp generation when not building PSVIMG.
'''v2.0.7'''
* Add option to use atracdenc for at3 encode, instead of at3tool.
* Add a MacOS version.
* Expose elf signing code to CLI version.
* Add Flatpak version.
* Fix output paths when not building PSVIMG files.
* add options to change startdat and simpledat in CLI version.
'''v2.0.6'''
* Fixed saving settings on linux.
* Fixed an issue where clearing selected png would not reset the image used.
* Update to .net 10.0.
* Fixed simple.dat pgd key (maybe?).
* Fixed cover downloads.
* Fixed nopspemdrm option using the wrong accountid.
'''v2.0.5'''
* Added ability to use temporary files instead of doing it all in memory (useful if you dont have alot of RAM...).
* Added ability to use NoPspEmuDrm for users with a hacked console.
* Updated to .NET 9.0.
* Also uploaded a build of the original PBPResign tool by SquallATF (some ppl wanted it idk).
'''v2.0.4'''
* Fix a bug relating to icons
* Fix a bug where you cant turn on the psvimg build option again after disabling it again
'''v2.0.3'''
* PS1 or PSP eboot.pbp can now be used to obtain either PS1 or PSP versionkey.
* this makes non un-henkaku'd vita equal with henkaku'd ones again-
* (this also makes KEYS.TXT kind of redundant, but whatever, i kept it in anyway.
'''v2.0.2'''
* Fix some bin/cue parsing errors
* Add better error handling
* Add builds for the Linux operating system
'''v2.0.1'''
* Add Support for games protected with the LibCrypt Copy Protection.
* Add Support to read .SBI files.
* Add a little settings menu to change between libcrypt methods (magic word / subchannel).
* Add option to force a different disc id.
* Fix a bug with Multi Disc and PSP Signatures not generating properly.
'''v2.0'''
* Completely rewrote the entire thing.
* Added PS1 Support.
* Added key generation from rif using act.dat and idps.
* Made a command line version also.
'''beta03'''
* CHOVY-SIGN.exe now has an icon.
* Non-MINI's now show the #ChovyProject logo on bootup.
* Created my own version of PSVIMGTOOLS which runs faster and is more accurate to the .psvimg format.
* "Get keys from CMA" is now LIGHTSPEED.
* Now shows Progress Bar while signing the declaration of independance.
* CHOVY-GEN.exe is now intergrated into CHOVY.DLL.
* Fixed a bug where your CMA directory wouldnt be found automatically.
'''beta02'''
* Now works on 32-bit windows PC's
* MINI's games ISOs now show the "MINIS" boot screen
* Caught some execptions that wherent previously caught.
'''beta01'''
* First Release.

==Credits==
* SquallATF (for "PspCrypto" and "PBPResigner", and making PS1 Game signing possible, And discovering a bug in __sce_ebootpbp handling that makes it possible to use multi-disc games.)
* Li: (for writing the original chovy-sign, Developing the GUI, finding the original psp bubbles method and, [https://github.com/KuromeSan/Sfo.NET/blob/master/README.md Sfo.NET] A Simple SFO Parser,
* Writing the PS1 Disc Compresison algorithm, making it possible to use custom ISOs, Writing C# Implementation of PSVIMGTOOLS, Being transgender)
* dots-tb (for [https://github.com/dots-tb/chovy-gen chovy-gen] (__sce_ebootpbp signing)
* Sony Computer Enterainment: (For at3tool)
* yifanlu & xyz for the original [https://github.com/yifanlu/psvimgtools psvimgtools].
* Mathieulh (Found psp signing keys?)
* Motoharu (For helping dots with __sce_ebootpbp)
* Davee (For finding the PS1 Signing Key)
* xlenore (For [https://github.com/xlenore/psx-covers PS1 Cover Art])
* RupertAvery (For their fork of DiscUtils to add PS1 Support)
* SquallATF's PBPResigner and PSPCrypto were derived from :
** xdotnano ([https://github.com/xdotnano/PSXtract PSXTract])
** swarzesherz ([https://github.com/swarzesherz/sign_np sign_np])
** tpunix ([https://github.com/tpunix/kirk_engine kirk_engine])
** dcherednik (For [https://github.com/dcherednik/atracdenc atracdenc] Open source Atrac3 Encoder.)

== External links ==
* Reddit - https://www.reddit.com/r/vitahacks/comments/12z59jd/release_chovysign_v2_now_with_ps1_support_run_any/
* Silica - https://silica.codes/SilicaAndPina/chovy-sign
* GitHub - https://github.com/KuromeSan/chovy-sign

Unreal Vita

2026-07-17T02:08:08Z

HydeWing: r7

{{Infobox Vita Homebrews
|title=Unreal Vita
|image=UnrealVita.png
|description=Port of Unreal for PS Vita.
|author=fgsfds
|lastupdated=2025/11/16
|type=Shooter
|version=r7
|license=N/A
|download=https://github.com/fgsfdsfgs/UE1/releases
|website=https://github.com/fgsfdsfgs/UE1
|source=https://github.com/fgsfdsfgs/UE1
|donation=
}}
{{#seo:
|title=Vita Homebrew Games (Shooter) - GameBrew
|title_mode=append
|image=UnrealVita.png
|image_alt=Unreal Vita
}}
Porting Unreal to the PS Vita involves using the reconstructed source code of Unreal Engine 1 v200. Unreal is a first-person shooter video game originally developed by Epic MegaGames and Digital Extremes, and published by GT Interactive for Microsoft Windows in May 1998.

==Features==
* Added SDL2 windowing/client driver (NSDLDrv).
* Added GLES2 and fixed pipeline GL graphics drivers (NOpenGLESDrv and NOpenGLDrv).
* Added OpenAL + libxmp audio driver (NOpenALDrv).
* Added GCC support and fixed a bunch of related bugs.
* Supported platforms: Windows (x86), Linux (x86, ARM32) and PSVita (ARM32).
* Editor UI is not supported.

==Installation==
===Requirements===
* Assets from the original Unreal v200 retail release or from the v205 demo. Other versions have not been tested.
* libshacccg.suprx
* kubridge.skprx

=== Linux and Windows ===
* Install the original retail v200 release of Unreal or the v205 demo.
* Copy over the new files:
** If you downloaded a ZIP from [https://github.com/fgsfdsfgs/UE1/releases Releases]:
*** Unzip said ZIP to the <code>Unreal</code> folder. Overwrite everything.
** If you built the game yourself:
*** Copy the .dll/.so/.exe/.bin files you built to <code>Unreal/System</code>. Overwrite everything.
*** Copy the contents of <code>Engine/Config</code> to <code>Unreal/System</code>. Overwrite everything.
* Run <code>System/Unreal.exe</code>.

=== PS Vita ===
* Install the original retail v200 release of Unreal or the v205 demo onto your PC.
* Copy the contents of the <code>Unreal</code> folder to <code>ux0:/data/unreal/</code> on your PS Vita.
* Copy the <code>unreal</code> folder from <code>unreal-arm-psvita-gcc.zip</code> to <code>ux0:/data/</code>. Overwrite everything.
* Install <code>unreal.vpk</code> from <code>unreal-arm-psvita-gcc.zip</code>.
* Run Unreal.

Update warning: Due to how the save list works in vanilla Unreal, do not replace your current Unreal.ini when updating if you have saved games, or the save list in the Load Game menu will become empty. You still need to replace the other files, though.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/UnrealVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/UnrealVita-02.png

==Changelog==
'''psvita-r7'''
* Performance improvements (PR [https://github.com/fgsfdsfgs/UE1/pull/45 #45]).
* Fixed potential collision hash-related crash.
* Fixed potential division by zero crash.
* Probably some other fixes.
'''psvita-r6'''
* Fixed the fan in Rrajigar Mines pushing you too fast at 60 FPS.
* Fixed lighting effects that are based on level time.
* Adjusted gamma calculation slightly.
* FOV should now be adjusted for widescreen (set <code>AutoFOV=0</code> under <code>[NOpenGLESDrv.NOpenGLESRenderDevice]</code> in <code>Unreal.ini</code> to disable).
* Added a way to lock the game to 30 FPS (set <code>SwapInterval=2</code> in <code>Unreal.ini</code> under <code>[NOpenGLESDrv.NOpenGLESRenderDevice]</code>).
* Probably some other fixes.
'''psvita-r5'''
*Fixed crash at the end of the game.
'''psvita-r4'''
*Fixed saves crashing the game when WLAN is off.
'''psvita-r3'''
* Fixed overwriting saves.
* Dug.unr (Depths of Rrajigar) should now load.
* Fixed startup.png.
'''psvita-r2'''
* Possibly fixed save corruption bug.
* Config should now save when exiting via the PS button.
* Brightness is now implemented.
'''psvita-r1'''
* First Release.

== External links ==
* GitHub - https://github.com/fgsfdsfgs/UE1
* GBAtemp - https://gbatemp.net/threads/unreal-pc-port-arm-psvita-gcc-r1-fgsfds.664671/
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1242

[[Category:PC game ports on Vita]]
[[Category:Vita game ports]]

GimliDS

2026-07-17T02:08:03Z

HydeWing: 1.7

{{Infobox DS Homebrews
|title=GimliDS
|image=gimlids.png
|description=Commodore 64 emulator for the DS/DSi.
|author=Dave Bernazzani (wavemotion-dave)
|lastupdated=2026/07/014
|type=Computer
|version=1.7
|license=GPL-2.0
|download=https://dlhb.gamebrew.org/dshomebrew2/GimliDS.7z
|website=https://gbatemp.net/threads/gimlids.669877/
|source=https://github.com/wavemotion-dave/GimliDS
|donation=https://ko-fi.com/wavemotiondave
}}
GimliDS is a Commodore 64 emulator for the DS/DSi developed by Dave Bernazzani, partially based on Troy Davis's [[FrodoDS]], which itself is a port of Frodo originally written by Christian Bauer.

== Features ==
* Commodore 64 with full 6510 CPU emulation, 64K of base memory, VIC II and SID chip rendering.
* PAL emulation at 50Hz provides the wide support for the C64 gaming scene.
* REU-1764 emulated with 256K of expanded memory.
* D64 disk file support for two 1541 drives (8, 9) with TrueDrive emulation optional (slower but compatible).
* CRT cartridge file support with writeback for EasyFlash (flash sectors) and GMOD2 (serial EE).
* Virtual touch-screen keyboard to replicate the C64 look and feel.
* Full key mapping of C64 Keyboard / Joystick to any of the main DS keys.
* Save/Load state so you can pickup gameplay right where you left off.

== Installation ==
You must have original Commodore BIOS files to run this emulator.

Place them in /roms/bios or /roms/c64 and be sure they are named exactly as follows:

<pre>KERNAL.ROM 8K with CRC32=dbe3e7c7 (901227-03)
BASIC.ROM 8K with CRC32=f833d117 (901226-01)
CHAR.ROM 4K with CRC32=ec4272ee (901225-01)
1541.ROM 16K with CRC32=899fa3c5 (251968-03)</pre>
For best performance, run it from a DSi/XL/LL via Twilight Menu++ or Unlaunch (134MHz, no frameskip, better audio). Flashcarts like R4 use a slower "Compatibility" mode (67MHz, light frameskip).

== User guide ==
'''How to use:'''
* Launch GimliDS.NDS on your DS.
* At the CBM BASIC "READY" prompt, use the DISK ICON to mount a .d64 game file.
* Once mounted, select the exit to menu option then press the Start button to auto-type <code>LOAD "*",8,1</code> and run the game.

'''Notes:'''
* The C= key on the lower right will let you set configuration for the game, save/load game states, etc.
* Use the Select button to swap joystick ports.
* Use L/R+D-Pad to scale and offset the screen. Settings are saved per game.
* You can remap any DS keys to 'PAN UP' or 'PAN DOWN' to temporarily shift the screen by 16 pixels up/down.
* You can assign any DS keys to 'TOGGLE ZOOM' in configuration for a 1:1 pixel mode to easy text reading.
* A few games use custom loaders that require 'True Drive' to be enabled. It mimics the original disk drive but it could take 2-5 minutes to load a game. It is recommended to create a save state after loading to avoid waiting for it to load again.

'''Cartridge support:''' (up to 1MB)
* Standard 8K
* Standard 16K
* Ultimax Carts (8K or 16K)
* Final Cartridge III up to 256K
* Action Replay Carts (v4.x, 5.x) up to 32K
* Super Game Carts up to 64K
* FunPlay/PowerPlay Carts at 64K
* Westermann Carts at 16K
* Comal80 Cart 64K
* Dinamic up to 128K
* C64 Games System up to 512K
* Ocean up to 512K
* Magic Desk up to 1MB
* EasyFlash up to 1MB with 256b RAM and Flash Write support
* GMOD2 up to 512K with 2K of Serial EE write support
* Magic Desk 16K (aka Magic Desk 2) up to 2MB on DSi or above only

Refer to the [https://github.com/wavemotion-dave/GimliDS/blob/main/README.md readme] for more details.

== Controls ==
L+D-Pad - Scale the screen in the X and Y directions

R+D-Pad - Offset the screen in the X and Y directions

Start - Issue the infamous <code>LOAD "*",8,1</code> (be sure the emulator is at the READY prompt)

Select - Switch between port1 and port2 that the joystick is in

D-Pad - Joystick directions

A - FIRE (can be remapped in Configuration)

B - SPACE (can be remapped in Configuration)

Y - RETURN (can be remapped in Configuration)

X - Joy Up for games where you jump (can be remapped)

Pressing and holding both shoulder buttons together will 'Turbo Warp' the emulator (runs as fast as it can until you release).

== Screenshots ==
https://dlhb.gamebrew.org/dshomebrew2/images/gimlids2.png
https://dlhb.gamebrew.org/dshomebrew2/images/gimlids3.png

https://dlhb.gamebrew.org/dshomebrew2/images/gimlids4.png
https://dlhb.gamebrew.org/dshomebrew2/images/gimlids5.png

== Changelog ==
'''Version 1.7 2026/07/14'''
* Improved cold memory initialization for better accuracy.
* Fix for Turrican to allow SELECT to work to get past title screen.
* Fix for EasyFlash cart loading to default to 16K despite what ROM header says.
* Improved CPU1541 Drive 2K RAM mirror handling.
* Improved SD Card flush so that disk files write-back immediately (so if you power off your DS the file will be properly saved).

'''Version 1.6 2025/12/10'''
* New 50Hz True Sync mode which changes the DS native 60Hz refresh to a 50Hz refresh and syncronizes the emulation to provide a nearly tear-free experience.
* New Favorites system implemented - press SELECT on game select to toggle LIKE/LOVE.
* Improved CPU timing accuracy for 'borrowed cycles', floppy cycles, etc. More games run more correctly.
* Improved SID emulation timing - DS-Lite gets a nice sound improvement and fixed bug on DSi for improved rendering.
* Major reworking of configuration options, all config options are reset with this release.
* Configuration changes allow you to press and hold the D-PAD to make rapid changes of things like key maps.
* Pressing X in configuration allow restoring of factory defaults for that game only.
* New CIA timer adjustment for slight tweaks that some games need (e.g. Flying Shark, Mr. Heli)
* New FLOPPY timer adjustment for slight tweaks that some games need (e.g. Dragon Wars now runs)
* Reverted CPU Adjustment to +0 (the +3 was too aggressive for some games - such as the new Sherwood!).
* Turrican I now works... press the DS SELECT key and hold for 1-2 seconds to get past the title screen.
* Fixed DS guru meditation (crash) error on some disk loads (fixes games like Barnsley Badger loading).
* Slight tweaks to disk icon graphics for read/writes.
* Slight optimization for another frame of performance.
* Numerous other small improvements that time forgets.

'''Version 1.5e 2025/12/06'''
* Reverted CPU Adjustment to +0 (the +3 was too aggressive for some games - such as the new Sherwood!)
* New Favorites system implemented - press SELECT on game select to toggle LIKE/LOVE.
* Improved CPU timing accuracy for 'borrowed cycles', floppy cycles, etc. More games run more correctly.
* Major reworking of configuration options, all config options are reset with this release.
* New CIA timer adjustment for slight tweaks that some games need (e.g. Flying Shark, Mr. Heli)
* New FLOPPY timer adjustment for slight tweaks that some games need (e.g. Dragon Wars now runs)
* Turrican I now works... press the DS SELECT key and hold for 1-2 seconds to get past the title screen.
* Slight tweaks to disk icon graphics for read/writes.
* Slight optimization for another frame of performance.
'''Version 1.5b 2025/12/02'''
* Reverted CPU Adjustment to +0 (the +3 was too aggressive for some games - such as the new Sherwood!)
* Slight tweaks to disk icon flashing for read/writes.
* Slight optimization for another frame of performance.

'''Version 1.5 2025/10/08'''
* Added Ultimax support plus the first pass at some of the Freezer carts.
* Improved speed almost 15% across the board - helps DS-Lite run at the right speed and DSi gets additional sound improvements.
* Improved floppy icon handling - cosmetic change only on green/blue/red LED handling.
* Other minor tweaks and improvements under the hood as timer permitted.

'''Version 1.4 2025/09/29'''
* Easyflash now supports flash writes with auto-persist to the SD card.
* GMOD2 cart type (60) supported with Serial EEPROM write to the SD card.
* Fixed Game Config so it properly restores the configuration last saved (oops!) - old configurations will be reset.
* Changed default keymap... B is now UP for help with platform/jumping games, X is SPACE typical for C64 games that need 2 buttons.
* Improved SID emulation on the DSi or above with the extra CPU horsepower.
* Improved keyboard screen dim handling.
* Fix .gss Save State names for cartridges.
* Save state tweaks and fixes. Old save states will be reset.
* Disk and Cartridges can be marked as read-only on a per game configuration basis. Use DISK/FLASH options.
* For the DSi and above (with the extra memory), 2MB MagicDesk 16K carts are supported (mainly for SNK vs Capcom - Stronger Edition)
* Added PAN LEFT / PAN RIGHT options to map keys to slide the screen left/right during gameplay.
* Other minor tweaks under the hood.

'''Version 1.3 2025/05/18'''
* New global options with a number of new configurations (dim screen, default buttons, etc).
* Added ability to swap LCD screens on the main Commodore menu.
* Slight extension of vertical pixel resolution for some games that utilize more raster lines (Gaplus, etc).
* Minor cleanup and refactor under the hood for improved maintainability and slight performance tweaks.

'''Version 1.2 2025/05/16'''
* Added new DIAGONALS joystick mode for a few Q-Bert clones.
* Slide-n-Glide joystick mode made more responsive.
* Extended visual display by 4 pixels for a few games that utilize long screen renderings.
* Minor tweaks and efficiency improvements under the hood.

'''Version 1.1 2025/05/11'''
* Fix to CIA vars initialization so games like Chuckie Egg start properly.
* Fix to TOD clock counters (previous versions would not clock at all... fixes some utilities mostly).
* Improved REU handling for a bit more speed (gain of 1-2 frames on REU games)
* Improved VIC handling for a bit more speed (gain of 1-2 frames across the board)

'''Version 1.0 2025/05/09'''
* Added TOGGLE ZOOM button map to scale screen 1:1 temporarily (to make text games readable)
* Another proper fix for CPU jump commands not handling the extra cycle it takes.
* Fixed CPU zero-page wrap so it's accurate.
* Added 256K REU-1764 support. Still quite preliminary.
* A bit of polish and cleanup for the big first release!

'''Version 0.9d 2025/05/06'''
* Added ability to remap the British Pound (£) symbol to one of the other rare missing keys (left arrow, up arrow, C=)
* Fix for CPU jump commands not handling the extra cycle it takes.
* All carts insertions do a proper reset so that we don't lock up when switching carts.
* Minor cartridge accuracy improvements - new LED added to cart icon for EasyFlash loading.

'''Version 0.9b/c 2025/05/05'''
* Pressing L+R shoulder buttons together is WARP mode (run emulator fast while the buttons are held)
* Improved L/R + DPAD scale/offset (so it doesn't also produce joystick input at the same time)
* Minor tweaks to TrueDrive mode for improved cycle accuracy
* CRT and PRG Cartridge support. Most popular game-based formats are supported. Use the new CART icon.
* 0.9c hot-fix release fixes the Cartridge Menu graphic and adds a bit more speed for the DS-Lite.

'''Version 0.9a 2025/05/02'''
* Fixed TrueDrive loading so it doesn't alter the CPU speed (for games like Pang which were playing quite 'uneven').
* Bumped up volume of the SID output by 50% (was too quiet)
* Improved 1541 Drive emulation - mostly in the GCR and IEC areas. Nothing noticeable but should be more accurate.
* Fixed write floppy icon color (instead of the usual green, will flash blue).
* Tweaks to C64 keyboard graphic to be more authentic.

'''Version 0.9 2025/04/30'''
* New and improved key mapping - including the new Slide-n-Glide joysticks handling.
* SID filtering improved for better audio rendering (Space Taxi voice heard!).
* Faster across the board - even the DS-Lite/Phat is now running at (or close to) full speed.
* Fixed joystick handling so we sample at the correct rate - smoother motion on screen.

'''Version 0.8 2025/04/27'''
* First public beta released!

== Credits ==
Acknowledgements:
* The opening jingle was done by DeNL and comes courtesy of the roalty free jingles at pixabay.
* The dwarf icon on the title screen was submitted online by 'anonymous' to an artwork site. If this is yours and you would like to be credited, please contact me.
* Christian Bauer - Original Frodo author - without whom none of this exists!
* Troy Davis(GPF) [http://gpf.dcemu.co.uk/ http://gpf.dcemu.co.uk] - FrodoDS initial porter and others who have contributed over the years.
* Wintermute and the contributors for devkitpro and libnds.
* djleviticus for his time and efforts in helping shake out some bugs during the beta testing.

== External links ==
* GitHub - https://github.com/wavemotion-dave/GimliDS
* GBAtemp - https://gbatemp.net/threads/gimlids.669877/

CardWars-Vita

2026-07-17T02:07:57Z

HydeWing: 4.5

{{Infobox Vita Homebrews
|title=CardWars-Vita
|image=CardWarsVita.png
|description=Native port of Adventure Time: Card Wars for PS Vita.
|author=Parindraaa
|lastupdated=2026/07/16
|type=Card
|version=4.5
|license=N/A
|download=https://dlhb.gamebrew.org/vitahomebrews/CardWarsVita.7z
|website=https://github.com/parindraaa867/AT-CardWars-Vita
|source=
|donation=
}}
{{#seo:
|title=Vita Homebrew Games (Card) - GameBrew
|title_mode=append
|image=CardWarsVita.png
|image_alt=CardWars-Vita
}}
A native PS Vita port of Card Wars: Adventure Time. Originally released for iOS/Android and shut down along with its servers, this port was meant to get the PC Port running on Vita hardware for a bounty.

Built with Unity 2017.4 (PSP2), based on the PC port of the decompiled game.

== Installation ==
No VPK is provided directly. Releases contain an xdelta patch that must be applied to your own copy of the original game. You need version 1.11.0 of CardWars for iOS 6.0 (CardWars 1.11.0 iOS IPA) (MUST BE ORIGINAL GAME FILES).

'''Instructions:'''
* Install <code>CardWars_Stub.vpk</code> on your Vita with [[VitaShell]].
* Download [[xdelta|xdelta3]] ([https://github.com/jmacd/xdelta-gpl/releases Windows builds available]) and put <code>xdelta3.exe</code>, the IPA and <code>CardWarsData.xdelta</code> in the same folder.
* Open a command prompt in that folder and run: <code>xdelta3 -d -B 536870912 -s Card_Wars_1.11.0_ios_6.0.ipa CardWarsData.xdelta CardWarsData.zip</code>
* Extract <code>CardWarsData.zip</code> and copy its contents into <code>ux0:app/CWRS00001/</code> and merge with the existing files. Launch Card Wars.

'''Notes:'''
* Runs much better on 444mhz/166mhz CPU/GPU clock than stock.
* Saves are stored in <code>ux0:/data/CardWars/</code>. Saves survive updates and reinstalls as they are separate from the game's actual data files.
* When updating, new vpk must be installed, old vpk will not work with new data files.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/CardWarsVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/CardWarsVita-02.png

==Media==
'''Official Adventure Time Card Wars Launch Trailer''' ([https://www.youtube.com/watch?v=5z9dX51mRrg TouchGameplay]) 
<youtube width="640">5z9dX51mRrg</youtube>

== Changelog ==
'''v4.5'''
* Touch inputs are mitigated, should not freeze anymore.
* Daily gift respins are 2 gems now, also rebalanced rewards received in daily gifts.
* Preloaded more battle assets and vfx, should lessen stutters during gameplay further.
* Added an option in settings for those who want a faster timing window.
* Languages such as German, Spanish (Spain), French, Italian, Latin American Spanish, and Portuguese should be supported.

'''v4'''
* Fixed persisting "earned heart" menu that wouldn't go away no matter what.
* Increased heap size for GC, should have less stutters.

'''v3.5'''
* Fixed the "You got a new HEART" popup freezing the game after beating a mission.
* Fixed the infinity symbol shrinking or showing as numbers (like 14/14) on some screens.
* Fixed the gem confirmation popup staying on screen after closing the Daily Gift menu.
* Extra Daily Gift spins now cost 1 gem instead of 5.
* Fixed cards sometimes disappearing or clipping wrong in the card menus.
* Upped resolution for card art.

'''v3'''
* THIS IS A MAJOR UPDATE WTH MIGRATION TO UNITY 2018
** Game rebuilt on Unity 2018 (from 2017). This resolves prevalent GPU crashes
** If there are GPU crashes, please make a GitHub issue. I've tested this build for multiple hours on end and have not experienced a GPU crash. Feel free to make any GitHub issues about potential improvements and bugs too!
* '''Performance/Visuals fixes'''
** Boots up slightly faster due to unity 2018.
** Reduced stutters everywhere: game rescanned asset files way too often... (card frames, battle effects, spells, floop abilities, summons).
** Preload common battle effects, card art, and quest maps in loading screen.
** Card Box / Sell Cards menus optimized much better, a bit of lag with multiple cards on screen but greatly improved compared to performance previously, it actually is manageable.
** Quest map opens a bit faster and finger scrolling is slightly more improved.
** Boot music no longer crackles while the game loads.
** Attack effects no longer linger for a couple seconds on screen after damage.
** Card Wars splash screen now in place of Unity splash screen.
** Capped more particles to increase performance.
* Gameplay fixes and additions
** Face buttons (✕/○/□/△) now work in the timing minigame alongside touch.
** Fixed daily gift claiming not saving.
** New options in settings: MSAA 4x (anti-aliasing, restart to apply), prioritize timing (blacks out the 3d environment during the timing ring to reduce stuttering), 30 fps cap (don't know why I added this), toggle to disable camera shake, and an option to erase the save.
** Stamina fix: the heart now shows ∞ so you can play as much as you want. :)
** A small "Saving..." indicator appears whenever the game writes your save in the bottom right corner.
* '''Daily Gift fixes'''
** Real time clock now works with daily gift claiming.
** Broken timers from older versions can fix themselves.
** Rebalanced the reward wheel to actually be engaging for an offline game.
** Extra spins now cost 5 gems (was free on accident, oops).
** New players start with 500 coins and 10 gems.

''' v2 '''
* '''To Do'''
** Reduce stutters in menu and gameplay caused by UI
** Make a menu to toggle anti-aliasing and other future performance/graphical settings
* '''Fixes'''
** Mitigated touch input loss during gameplay
** Fixed battle music not playing in Fionna & Cake quests (and a few other affected tracks)
** Removed invisible button in top right of quest map.
** Reclaimed 26MB of memory (headroom for more texture enhancements in the future)
** Upscaled more textures
** Turned up audio sampling rate (should sound better)
** Anti-aliasing enabled (MSAA 2x)
** Capped particles (reduced stuttering and mitigates chance of GPU crash)
** Minor performance improvements during gameplay
* '''Known Issue'''
** Very rare GPU crash that occurs as a result of GPU driver not responding to a call made from the game, (most likely cause is the game's GUI?)
** Happens very randomly, usually after several hours of playing on and off. (actively trying to find the root of this, I will be working on fixing this as my main focus)
* Saves are safe from updates! You don't need to worry about save data when installing this new patch and vpk.

''' v1.5 '''
* '''Fixes'''
** Optimized menus ( 30fps -> 60fps)
** Fixed heavy lag in deck manager
** Smoother scrolling in card lists
** Redid the pinch zoom gesture for quest map (much better)
** Slightly faster boot
** Removed "no connection" button in quest map (used to restart and crash app)
* '''Issues'''
** Card box can drop frames while scrolling fast through a large collection. (Cost to rebuild large UIs)
** Card glimmer effect on premium cards removed (as of now, huge performance boost in deck manager)

'''v1.0'''
* First Release.

== External links ==
* GitHub - https://github.com/parindraaa867/AT-CardWars-Vita
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1428

PkHouse Switch

2026-07-17T02:07:33Z

HydeWing: 1.10.5

{{Infobox Switch Homebrews
|title=pkHouse
|image=pkHouseLocalPokeBankSwitch.png
|description=Nintendo Switch homebrew for local bank system for Pokemon Games.
|author=Insektaure
|lastupdated=2026/07/17
|type=Other Apps
|version=1.10.5
|license=GPL-2.0
|download=https://dlhb.gamebrew.org/switchhomebrews/pkHouseLocalPokeBankSwitch.7z
|website=https://gbatemp.net/threads/pkhouse-local-bank-system-for-pokemon-switch-games.679665/
|source=https://github.com/Insektaure/pkHouse
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Other Apps) - GameBrew
|title_mode=append
|image=pkHouseLocalPokeBankSwitch.png
|image_alt=pkHouse - Local PokeBank
}}
pkHouse is a Nintendo Switch homebrew application that provides a local bank system for Pokemon games. It allows moving Pokemon between save files and local bank storage directly on the console, similar to Pokemon HOME but as a free offline solution.

The application supports multiple Pokemon games across different save formats, with automatic save backup, multi-select capabilities, search and filtering, and multiple color themes.

'''Note:''' Moving Pokemon between different games is not supported. Banks are separated by game family because transferred Pokemon would lack the HOME Tracker ID required for cross-game compatibility.

== Disclaimer ==
This software is provided "as-is" without any warranty. While the app has been tested, it may contain bugs that could corrupt or damage your save files.

Use at your own risk. The author is not responsible for any data loss or damage to your save data.

This is why the automatic backup system exists — always verify your backups before making changes.

If you need to restore a backup, use a save manager such as [[Checkpoint Switch|Checkpoint]] or [[JKSV Switch|JKSV]] to import the backup files back onto your Switch.

== Supported games ==
{| class="wikitable"
|-
! Game !! Tested Version !! Save Format !! Boxes !! Slots/Box
|-
| Pokemon Let's Go Pikachu || 1.0.2 || BEEF blocks (<code>savedata.bin</code>) || 40 || 25
|-
| Pokemon Let's Go Eevee || 1.0.2 || BEEF blocks (<code>savedata.bin</code>) || 40 || 25
|-
| Pokemon Sword || 1.3.2 || SCBlock (<code>main</code>) || 32 || 30
|-
| Pokemon Shield || 1.3.2 || SCBlock (<code>main</code>) || 32 || 30
|-
| Pokemon Brilliant Diamond || 1.3.0 || Flat binary (<code>SaveData.bin</code>) || 40 || 30
|-
| Pokemon Shining Pearl || 1.3.0 || Flat binary (<code>SaveData.bin</code>) || 40 || 30
|-
| Pokemon Legends: Arceus || 1.1.1 || SCBlock (<code>main</code>) || 32 || 30
|-
| Pokemon Scarlet || 4.0.0 || SCBlock (<code>main</code>) || 32 || 30
|-
| Pokemon Violet || 4.0.0 || SCBlock (<code>main</code>) || 32 || 30
|-
| Pokemon Legends: Z-A || 2.0.2 || SCBlock (<code>main</code>) || 32 || 30
|-
| Pokemon FireRed || 1.0.0 || GBA sectors (<code>FireRed_e.sav</code>) || 14 || 30
|-
| Pokemon LeafGreen || 1.0.0 || GBA sectors (<code>LeafGreen_e.sav</code>) || 14 || 30
|}

== User guide ==
=== Profile Selection ===
On Switch, pkHouse loads all user profiles from the system.

Select your profile, then choose a game.

The app detects which games have save data for the selected profile.

Your profile name is shown alongside the game name in all views.

=== Two-Panel Box Viewer ===
In "title override mode", the main view displays your "game save" on the left and your "bank" on the right, side by side.

In "applet mode" (bank-only), both panels show "banks", allowing bank-to-bank transfers.

Navigate freely between both panels to move Pokemon back and forth.

=== View All Banks ===
Browse banks across all your games from a single screen. On the game selector, navigate below the game cards to the "View All Banks" option.

Banks are displayed in a grouped list organized by game family (e.g. "Sword / Shield", "Scarlet / Violet"), in the same order as the game cards.

Selecting a bank opens it in dual-bank mode — no save file needed. After picking your first bank, you're prompted to pick a second bank from the same game for side-by-side management.

=== Pick & Place ===
Press A on a Pokemon to pick it up, navigate to any slot (in either panel), and press A again to place it.

Placing on an occupied slot swaps the two Pokemon.

Press B to cancel and return the Pokemon to its original slot.

Press X while holding Pokemon to delete them (with confirmation). Useful for clearing boxes of rejected eggs.

=== Multi-Select ===
There are three ways to select Pokemon:

* Tap Y on individual Pokemon to toggle selection one by one.
* Hold Y + D-Pad to draw a rectangular selection across multiple slots at once.
* Double-tap Y to select all Pokemon in the current box (shown in green).

Only occupied slots are selected. Selected slots display a numbered badge showing the pick-up order.

Press A to pick up all selected Pokemon, then navigate to another box and press A to place them.

Regular selections (cyan) place Pokemon into the first available empty slots.

"Select all" selections (green) preserve original positions — each Pokemon is placed at the same slot index in the target box. All matching slots must be empty.

Press B to cancel and return all Pokemon to their original positions.

Selection is cleared when switching boxes or panels.

=== Box View ===
Press ZL to open a box overview of all save boxes, or ZR for all bank boxes.

Navigate the grid with the D-Pad. A semi-transparent preview of the highlighted box's contents (Pokemon sprites) appears as you move.

Press A to jump directly to that box, Y to rename the box (bank boxes only, max 16 characters), or B to cancel.

=== Pokemon Details ===
Press X on any Pokemon to view detailed information:

* Catch ball icon and species name, level, gender
* National Pokedex number
* Original Trainer (OT) and Trainer ID
* Nature and Ability
* Held item (or "---" if none)
* All 4 moves with type icons (2x2 grid layout)
* IVs displayed as a hexagonal radar chart (perfect 31s highlighted in gold)
* EVs displayed as a hexagonal radar chart
* Ribbons and marks (displayed as sprite icons with names)
* Technical data: PID, EC, raw TID/SID, and TSV

Sprites are form-aware — alternate forms like Alolan, Galarian, Hisuian, Paldean, Origin, Therian, and many others display their correct sprite.

Shiny Pokemon use their shiny color sprites. Both apply everywhere: box grid, detail popup, held overlay, box view preview, and wondercard list.

If a form or shiny sprite is not available, the base sprite is used as fallback.

Shiny names are displayed in gold. 
Alpha Pokemon (Legends: Arceus / Z-A) show a dedicated icon.

Use L/Rin the detail view to navigate to the next or previous non-empty slot without closing the popup.

=== Bank System ===
Banks are local <code>.bin</code> files stored per game family. Paired games share the same bank folder, so you can move Pokemon between versions (e.g. Sword and Shield).

{| class="wikitable"
|-
! Game Family
! Bank Folder
|-
| Let's Go Pikachu / Eevee
| <code>banks/LetsGo/</code>
|-
| Sword / Shield
| <code>banks/SwordShield/</code>
|-
| Brilliant Diamond / Shining Pearl
| <code>banks/BDSP/</code>
|-
| Legends: Arceus
| <code>banks/LegendsArceus/</code>
|-
| Scarlet / Violet
| <code>banks/ScarletViolet/</code>
|-
| Legends: Z-A
| <code>banks/LegendsZA/</code>
|-
| FireRed / LeafGreen
| <code>banks/FireRedLeafGreen/</code>
|}

From the bank selector you can:

* Create a new bank (up to 32-character name). On Switch, available SD card space is checked before creating — if there isn't enough room, an error is shown.
* Rename an existing bank
* Delete a bank (with confirmation)

Each bank has the same box capacity as its game family (32 or 40 boxes).

The bank list shows the number of occupied slots for each bank.

You can switch between banks from the main view via the menu. Both the save and bank are saved together before switching to prevent data inconsistency.

If no other bank is available when switching, the app offers to create a new one directly.

You cannot delete a bank that is currently loaded.

=== Backup System ===
When loading a game save on Switch, an automatic backup is created before any modifications:

<pre>backups/<profile>/<game>/<profile>_YYYY-MM-DD_HH-MM-SS/</pre>
This is a full copy of the mounted save directory.

The backup is only created once when initially selecting a game — switching banks does not trigger additional backups.

Before backing up, the app checks available SD card space. If there isn't enough free space (2x the save size), a warning is shown with the option to continue without a backup or cancel. If the backup itself fails, you'll see a similar prompt before proceeding.

=== Themes ===
pkHouse includes 7 color themes:

{| class="wikitable"
|-
! Theme
! Style
|-
| Default
| Dark blue-gray (original)
|-
| HOME
| Light pastels inspired by Pokemon HOME
|-
| HOME - Violet
| Purple/lavender tones from HOME's Pokedex
|-
| HOME - Blue
| Blue palette from HOME's GTS
|-
| HOME - Green
| Green variant of the HOME style
|-
| HOME - Red
| Red variant of the HOME style
|-
| Pikachu
| Yellow and brown Pikachu colors
|}

Change themes from the "menu" (+ button) in the main view, or press Y on the profile/game selection screens.

A live preview is applied as you scroll through the list. Press A to confirm or B to cancel and revert.

Your theme choice is saved automatically and persists across sessions.

=== Language ===
pkHouse supports 9 languages:
* English (en)
* Deutsch (de)
* Español (es)
* Français (fr)
* Italiano (it)
* Nederlands (nl)
* Português (pt)
* Русский (ru)
* 日本語 (ja)

The app automatically detects the Switch system language on startup. You can also manually override the language from the menu (+ button → Language).

Your language choice is saved to language.txt and persists across sessions. Delete this file to revert to automatic system detection.

Missing keys automatically fall back to English.

Note: Korean (한국어), Simplified Chinese (简体中文), and Traditional Chinese (繁體中文) translation files are included but currently disabled. The system font (PlSharedFontType_Standard) does not include CJK/Korean glyphs - enabling these languages requires loading additional system fonts.

=== Search / Filter ===
Search for Pokemon across both panels (save and bank) using the "menu" (+ button > Search).

Available filters:

{| class="wikitable"
|-
! Filter
! Description
|-
| Species
| Alphabetical picker — select a letter, then choose from species available in the current game (with sprites). Letters with no matching species are dimmed and skipped.
|-
| OT Name
| Text search (substring, case-insensitive)
|-
| Shiny
| Toggle to match shiny Pokemon only
|-
| Egg
| Toggle to match eggs only
|-
| Alpha
| Toggle to match alpha Pokemon only (Legends: Arceus / Z-A only)
|-
| Gender
| Cycle: Any / Male / Female / Genderless
|-
| Level
| Min and max level range
|-
| Perfect IVs
| Off / 1+ (at least one 31 IV) / 6IV (all 31)
|-
| Ribbons/Marks
| Off / Has Ribbon / Has Mark / Has Any
|}

Two result modes are available (selectable in the filter with Left/Right, defaults to Highlight):

* Highlight (default): Returns to the box view with matching Pokemon outlined in color and non-matching Pokemon dimmed. The highlight follows Pokemon as you move them between slots. In box view (ZL/ZR), boxes containing matches are outlined and matching slots are highlighted in the preview. Press B to clear highlights, or open the menu to start a new search.
* List: Results are shown as a scrollable list with status badges ([S] shiny, [A] alpha, [E] egg), species name, level, gender, and location. Press A to jump directly to a result in the box view, L/R to skip 10 results (hold to auto-repeat), X to go back and adjust filters, or B to close.

=== Wondercard Injection ===
Inject event wondercard files directly into your save as fully formed Pokemon. Access from the "menu" (+ button > Wondercard).

Place wondercard files in the corresponding folder on your SD card:

{| class="wikitable"
|-
! Game Family
! Folder
! File Extension
|-
| Let's Go Pikachu / Eevee
| <code>wondercards/LetsGo/</code>
| <code>.wb7</code> / <code>.wb7full</code>
|-
| Sword / Shield
| <code>wondercards/SwordShield/</code>
| <code>.wc8</code>
|-
| Brilliant Diamond / Shining Pearl
| <code>wondercards/BDSP/</code>
| <code>.wb8</code>
|-
| Legends: Arceus
| <code>wondercards/LegendsArceus/</code>
| <code>.wa8</code>
|-
| Scarlet / Violet
| <code>wondercards/ScarletViolet/</code>
| <code>.wc9</code>
|-
| Legends: Z-A
| <code>wondercards/LegendsZA/</code>
| <code>.wa9</code>
|}

The wondercard list shows each card's species, level, and shiny status. Select a card and press A to inject it into the currently selected box slot.

The injected Pokemon is fully generated from the wondercard data — PID, IVs, nature, ability, moves, OT, and all metadata are set according to the event's rules, matching official distribution behavior.

Wondercard files can be downloaded from the [https://github.com/projectpokemon/EventsGallery Project Pokemon EventsGallery] repository.

=== Pokedex Auto-Registration ===
When transferring Pokemon from a bank to a save file, the Pokedex is automatically updated to register the Pokemon as caught. This solves the issue where version-exclusive Pokemon transferred between paired games would not appear in the Pokedex.

{| class="wikitable"
|-
! Game Family
! What gets registered
|-
| Scarlet / Violet (+ DLCs)
| Caught, seen, heard, gender, language (Pokemon + save), shiny, display, neighbor discovery
|-
| Sword / Shield (+ DLCs)
| Caught, seen (all gender/shiny regions), language, display, battled count, Gigantamax, Alcremie forms, Eternatus
|-
| Brilliant Diamond / Shining Pearl
| Caught, gender, shiny, language, alternate form tracking (Unown, Rotom, Arceus, etc.)
|-
| Let's Go Pikachu / Eevee
| Caught, seen, display, language, size tracking (height/weight), capture count
|-
| FireRed / LeafGreen
| Caught, seen (with all 3 copy sync), Unown/Spinda PID
|}

<blockquote>Legends: Arceus and Legends: Z-A are excluded from auto-registration as all Pokemon are obtainable in a single playthrough without trading.
</blockquote>
Pokedex completion rewards (Shiny Charm, diplomas) are triggered by the in-game NPC when the dex is complete.

=== Handling Trainer Updates ===
When a Pokemon is placed into a save file, its handling trainer (HT) data is updated exactly as an in-game trade would.

The games compare the full trainer identity (TID/SID, name, gender, game version), not just the trainer name, so a Pokemon moved to a save with the same OT name but different IDs is correctly treated as traded.

* If the Pokemon belongs to the save's trainer, it is marked as being back with its OT.
* If it belongs to a different trainer, the save's trainer is registered as its handling trainer: HT name, gender, and language are set, HT friendship is reset to the species' base value, and stale HT memories are cleared. The original OT data is never modified.
* '''No friendship loss on round-trips''': re-placing a Pokemon into a save whose trainer is already its registered handler keeps the HT friendship it has earned.
* '''Eggs''' traded to a different trainer are marked as link-traded with the current date, as the games do.
* '''Let's Go''': friendship is carried over instead of reset, so CP values are unaffected.

This keeps friendship routing (e.g. friendship evolutions), memories, and legality checks correct after transferring Pokemon between save files with the bank.

FireRed / LeafGreen are unaffected - Gen 3 has no handling trainer concept, so no changes are needed there.

=== Export Pokemon ===
Export Pokemon as decrypted <code>.pk</code> files compatible with PKHeX. Access from the "detail view" (single export) or the "menu" (batch export of selected Pokemon).

Exported files are saved to:

<pre>export/<GameFamily>/<filename></pre>
Filenames follow the PKHeX naming convention: game tag, national dex number, form name, status flags (<code>[S]</code>hiny/<code>[A]</code>lpha/<code>[E]</code>gg), species name, and checksum.

{| class="wikitable"
|-
! Game Family
! File Extension
|-
| Let's Go Pikachu / Eevee
| <code>.pb7</code>
|-
| Sword / Shield
| <code>.pk8</code>
|-
| Brilliant Diamond / Shining Pearl
| <code>.pb8</code>
|-
| Legends: Arceus
| <code>.pa8</code>
|-
| Scarlet / Violet
| <code>.pk9</code>
|-
| Legends: Z-A
| <code>.pa9</code>
|-
| FireRed / LeafGreen
| <code>.pk3</code>
|}

=== LED Activity Indicator ===
The controller notification LED blinks during save and backup operations (save writes, bank saves, backup creation) to provide visual feedback that data is being written.

* Standard / OLED Switch: The Joy-Con or Pro Controller LED pulses briefly during writes.
* Switch Lite: The built-in motherboard notification LED lights up during writes and turns off when the operation completes.

This works automatically with no configuration required.

Note: To disable the LED Indicator, place a <code>noled.cfg</code> file in the pkHouse folder (next to the NRO). Remove it to re-enable. The file can be empty — only its presence is checked.

=== Save Integrity ===
* SCBlock saves (ZA, SV, SwSh, PLA): Decrypted, modified, and re-encrypted. A round-trip verification runs on load to confirm the cycle is lossless.
* BDSP saves: Flat binary with MD5 checksum, recalculated on every save.
* LGPE saves: BEEF block format with CRC16 checksums, recalculated on every save. Storage is compacted before writing.
* FRLG saves: GBA sector-based format (128KB, two save slots). CheckSum32 recalculated per sector on save. Both slots are updated.
* All saves are written in-place to preserve the Switch filesystem journal.

== Controls ==
=== Main view ===
D-Pad - Move cursor

L/R - Switch box (hold to repeat)

ZL/ZR - Box view (save / bank)

A - Pick up, Place Pokemon

B - Cancel, Return held Pokemon

Y - Toggle multi-select

X - View Pokemon details, Delete held Pokemon, Export (in detail view)

Plus - Open menu

Minus - About

=== Profile selector ===
D-Pad Left/Right - Navigate profiles

A - Select profile

Y - Theme selector

Minus - About

Plus - Quit

=== Game selector ===
D-Pad - Navigate game grid and "View All Banks" option

A - Select game / View All Banks

B - Back to profile selector

Y - Theme selector

Minus - About

Plus - Quit

=== Bank selector ===
D-Pad Up/Down - Navigate bank list

A - Open bank

Y - Create new bank

X - Rename bank

Plus - Delete bank

B - Back (main view if bank loaded, otherwise game selector)

Minus - About

== Menu options ==
=== Title Override Mode ===
{| class="wikitable"
|-
! Option !! Description
|-
| Theme || Open the theme selector
|-
| Language || Open the language selector
|-
| Search || Search for Pokemon across both panels
|-
| Wondercard || Inject event wondercards as Pokemon (supported games only)
|-
| Export Selected || Export selected Pokemon as <code>.pk</code> files (shown when Pokemon are selected)
|-
| Switch Bank || Save game and bank, return to bank selector
|-
| Change Game || Save everything, return to game selector
|-
| Save & Quit || Save everything and exit
|-
| Quit Without Saving || Exit without saving changes
|}

=== Applet / Bank-Only Mode ===
{| class="wikitable"
|-
! Option !! Description
|-
| Theme || Open the theme selector
|-
| Search || Search for Pokemon across both panels
|-
| Wondercard || Inject event wondercards as Pokemon (supported games only)
|-
| Export Selected || Export selected Pokemon as <code>.pk</code> files (shown when Pokemon are selected)
|-
| Switch Left Bank || Save both banks, switch the left bank
|-
| Switch Right Bank || Save both banks, switch the right bank
|-
| Change Game || Save both banks, return to game selector
|-
| Save Banks || Save both banks
|-
| Quit || Exit
|}

==Screenshots==
{| style="max-width:80%; margin-left:0em;"
|
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-03.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-04.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-05.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-06.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-07.png
https://dlhb.gamebrew.org/switchhomebrews/images/pkHouseLocalPokeBankSwitch-08.png
|}

== Changelog ==
'''v1.10.5'''
* Bank files validation
** Some users are dropping unrelated random .bin files in the Bank folder : we now check if the files are valid Banks
** Invalid files are marked as such
** Invalid files cannot be opened as a Bank
** Invalid files can be deleted from the listing (same as any valid Banks)
* Bank file deletion
** Add soft-delete system
** Deleted Banks are now moved inside a "trash" sub-folder, keeping the same game folder structure
** Restoring deleted Banks require manual action (moving the file back to the corresponding game folder)
* Bank name checks
** Now checks if the Bank name is already used for the target game
** Add UI feedback when trying to create / rename a Bank with an already existing name
'''v1.10.4'''
* Add Handling Trainer (HT) info in detailed view.
* Add support for SV PJCS26 Garchomp Wondercard.
'''v1.10.3'''
* Fixed: Pokemon moved between saves kept the wrong handler
* Until now, moving a Pokemon through the bank into another save file did a raw copy - nothing about the Pokemon was adapted to its new trainer.
* In the games, anytime a Pokemon changes owners through a trade, the receiving trainer is registered as its handling trainer.
* Skipping that step caused real problems:
** Friendship didn't work correctly.
* The game reads friendship from the OT or the handler depending on who currently holds the Pokemon. A transferred Pokemon pointed at the wrong field, so friendship gained on the new save could be lost, and friendship evolutions (Eevee → Sylveon, Golbat → Crobat, etc.) could behave unexpectedly.
** Legality issues.
* A Pokemon whose OT doesn't match the save but which claims to still be with its OT is flagged by legality checkers and looks suspicious to Pokemon HOME.
** Same name ≠ same trainer.
* Two saves with the same trainer name are still different trainers - the games compare TID/SID, gender, and more, not just the name.
* pkHouse now does the same.
* What happens now
* Placing a Pokemon into a save behaves exactly like a real in-game trade:
** If the Pokemon belongs to the save's trainer (same game version, TID/SID, name, gender, plus language in SV/Z-A), it's simply marked as being back with its OT.
** If it's a different trainer, that trainer is registered as the handler: handler name/gender/language are set, handler friendship resets to the species' base value, and stale handler memories are cleared. The original OT data is never touched.
** No friendship loss on round-trips: moving a Pokemon bank ↔ save repeatedly does not keep resetting the friendship it earned with its current handler.
** Eggs traded to a different trainer are marked as link-traded with today's date, like the games do (including BDSP's quirk of also updating the handler, and SV's Jacq gift-egg exception).
** Let's Go: friendship is carried over instead of reset, so CP values are unaffected.
* Applies to all supported games with handler data:
* Legends: Z-A, Scarlet/Violet, Sword/Shield, Brilliant Diamond/Shining Pearl, Legends: Arceus, Let's Go Pikachu/Eevee.
* FireRed/LeafGreen are unaffected - Gen 3 has no handler concept, so transfers there were already correct.
** Warning: Existing Pokemon already sitting in your saves are not modified: the update applies whenever a Pokemon is next placed into a save.

'''v1.10.2'''
* Add Wondercard support for Shiny Volcanion (Legends Z-A).

'''v1.10.1'''
* Add box-state icons in ZL/ZR all-boxes overview (box cell now shows a small icon on the left indicating its state).

'''v1.10.0'''
* Multi-Language Support
** Internationalization (i18n): the app now supports 9 languages, with automatic detection based on the Switch system language.
** Support English, Deutsch, Español, Français, Italiano, Nederlands, Português, Русский, 日本語
** Language Selector: New "Language" option in the menu (+) to manually override the language at any time. Your choice is saved and persists across sessions.

'''v1.9.1'''
* FireRed / LeafGreen Multiple Version Support
** All regional versions of FireRed / LeafGreen are now supported (English, Spanish, French, German, Italian, and Japanese)
** Each version is detected automatically by title ID
** All FRLG versions share the same bank folder, so Pokemon can be moved freely between any language version via the bank
** Japanese character encoding support
** Nicknames and OT names from Japanese FRLG saves now display correctly in hiragana / katakana
** Uses the per-Pokemon language byte, so Japanese Pokemon traded into other language saves (or stored in the bank) are always decoded correctly
** Box names in Japanese saves also display properly
* Game selector pagination
** When more than 12 games are available, the selector is paginated across multiple pages
** Navigate pages with L / R shoulder buttons or buttons on the left and right edges

'''v1.9.0'''
* New: Pokedex Auto-Registration
** Pokemon transferred from the bank or wondercard to a save file are now automatically registered in the Pokedex as caught.
** This fixes the potential issue where version-exclusive Pokemon transferred between dual games would not appear in the Pokedex.
* Supported games:
** Scarlet / Violet (+DLCs)
** Sword / Shield (+DLCs)
** Brilliant Diamond / Shining Pearl
** Let's Go Pikachu / Eevee
** FireRed / LeafGreen
** Legends: Arceus & Legends: Z-A are excluded since all Pokemon are available (no version exclusive).
* What gets registered:
** Caught & Seen status
** Gender, Language, and shiny flags
** Form tracking (BDSP alternate forms, SwSh Alcremie decorations, Eternatus Gigantamax)
** Display entry (form, gender, shiny) on first registration
** Size data and capture count (LGPE)
** Seen copies sync (FRLG)
** Neighbor discovery / "heard" entries (SV)
** Battled count (SwSh)

'''v1.8.1'''
* Consolidated game format data.
* Unified Pokemon data field offsets.
* Shared binary I/O helpers.
* Modularized input handling.
* Removed dead PC debug code.

'''v1.8.0'''
* Replaced the free-text keyboard species search with a visual two-step picker.
* First screen: alphabetical letter grid - select a letter to filter species.
* Second screen: species list with sprites, sorted alphabetically - select to set the filter.
* Only species available in the current game are shown.
* Letters with no matching species are dimmed and cannot be selected.
* Selected species appears with its sprite on the search filter screen.
* Select "-" to clear the species filter back to "any".

'''v1.7.6'''
* New "View All Banks" option:
** On the game selector screen - navigate below the game cards to access it.
** Banks are displayed in a grouped list with game headers (e.g. "Sword / Shield", "Scarlet / Violet").
** Selecting a bank opens it in dual-bank mode - no save file needed, just like applet mode.
** After picking your first bank, you're prompted to pick a second bank from the same game for side-by-side management.
** Full bank management (create, rename, delete) available once a bank is opened.
** Theme selector accessible from the all-banks list via Y.
* Navigation Improvements:
** Cursor now wraps between panels - pressing left at the edge of the left panel jumps to the right panel, and vice versa.
** When only one panel is loaded, the cursor wraps within it instead of getting stuck at the edge.
* Bug Fixes:
** Fixed bank list scroll not resetting when the cursor wraps around (top to bottom or bottom to top).
** Fixed left panel showing stale Pokemon data from a previously loaded bank when no left bank is loaded in dual-bank mode.

'''v1.7.5'''
* Shiny Sprites: shiny Pokemon now display their actual shiny color sprites.
* Form-Aware Sprites: alternate forms (Alolan, Galarian, Hisuian, Paldean, Origin, Therian, Unown letters, and 140+ others) now show their correct sprite.
* LED Activity Indicator: can now be disabled by placing a noled.cfg file in the pkHouse folder.

'''v1.7.4'''
* LED Activity Indicator: the controller LED now blinks during save and backup operations (save writes, bank saves, backup creation, ...). On Switch Lite, the built-in notification LED lights up during writes instead.
* Optimized UI Rendering: text measurement now uses the rendering cache, eliminating redundant FreeType glyph shaping.
*
'''v1.7.3'''
* Reduced input lag and improved frame responsiveness across all screens.
* Pokemon data is now cached per box, eliminating repeated decryption overhead.
* Text and UI labels are now cached, reducing rendering workload.
* Slot display info (species, name, level, shiny, etc.) is pre-computed and cached per box.
* Screen only redraws when something actually changes, saving CPU/GPU cycles.
* App should now be smoother !

'''v1.7.2'''
* Ball Icon — The Poke Ball used to catch the Pokemon is displayed next to the species name in the detail view.
* Move Type Icons — Each move in the detail view now shows its type icon.
* Moves in 2-Column Layout — Moves display in a 2x2 grid, matching the in-game battle layout.
* Technical Data — PID, EC, raw TID/SID, and TSV shown at the bottom of the detail view.
* Hold L / R shoulder buttons to auto-repeat navigating in detail view (no more mashing!)

'''v1.7.1'''
* Pokemon details now show all ribbons and marks as sprite icons with names.
* Pokemon details now display held item.
* Use L / R to jump to the previous / next non-empty slot without closing the detail popup.
* Filter Pokemon by Has Ribbon, Has Mark, or Has Any in the search menu.
* New: Export Pokemon to file.
** Export individual Pokemon as PKHeX-compatible .pk files from the detail view (X button).
** Select multiple Pokemon and export them all at once from the menu.
** Exported filenames include human-readable form names (Alolan, Galarian, Origin, etc.) instead of numeric form IDs.

'''v1.7.0'''
* New: Wondercard Injection
** Inject event wondercard files directly into your saves / banks as fully formed Pokemon
** Support : LGPE / SWSH / BDSP / PLA / SV / LZA
** Fully generates the Pokemon from wondercard data (PID, IVs, nature, ability, moves, OT, ribbons, ...)
** Matches official distribution behavior — shiny locks, fixed IVs, ability restrictions, and date windows are all respected
** Game-specific stat calculations are handled correctly (LGPE awakening values + CP, PLA ganbaru values, ...)

'''v1.6.0'''
* Add FireRed / LeafGreen support (game version 1.0.0).

'''v1.5.2'''
* Rename bank boxes from the box view (ZL / ZR) — press Y on any box to set a custom name (max 16 characters).
* Names are saved in the bank file and persist across sessions.
* Existing banks are fully backward compatible — unnamed boxes display as "Bank 1", "Bank 2", etc.
* Box view overlay now shows a subtitle: bank file name for bank panels, profile and game name for save panels.
* Long bank file names are truncated with (..) in the panel header to prevent overflow.

'''v1.5.1'''
* Hold L / R shoulder buttons to auto-repeat box switching.
* Hold L / R in search results list to fast-scroll through pages.
* New search highlight mode: matching Pokemon outlined in box view, non-matches dimmed.
* Search result modes: choose between Highlight (default) and List via the Mode row in search filter.
* Live highlight tracking: moving, swapping, or deleting Pokemon while highlights are active updates them in real-time.
* Boxes containing search matches are outlined in the box view (ZL / ZR) with matching Pokemon highlighted.

'''v1.5.0'''
* Search for Pokemon across both panels (save and bank) from the menu (+ → Search).
* Filter by species name, OT name, shiny, egg, alpha, gender, level range, and perfect IVs.
* Results displayed as a scrollable list with status badges: [S] shiny, [A] alpha, [E] egg.
* Press A to jump directly to a Pokemon in the box view; L/R to skip 10 results; X to adjust filters.
* Delete Pokemon: press X while holding Pokemon (single or multi-select) to delete them with confirmation.

'''v1.4.0'''
* 7 color themes (Default, HOME, HOME - Violet, HOME - Blue, HOME - Green, HOME - Red, Pikachu)

'''v1.3.1'''
* Save backup now checks SD card free space before backing up (requires 2x save size).
* Warning dialog if space is low, with option to continue without backup or cancel.
* If backup fails, a prompt is shown before proceeding.
* Creating a new bank now checks available SD card space first.

'''v1.3.0'''

* New applet mode (album/HB menu): bank-only access for all games, two banks side by side for bank-to-bank transfers.
* Banks that are currently in use cannot be deleted.
* When switching banks, the selector appears on the side being switched while the other panel stays visible.
* Bank switching now always saves game and bank together to prevent data corruption.
* Multi-select improvements: drag selection (hold Y + D-Pad) to select a rectangular group of Pokemon at once.
* Double-tap Y to select all Pokemon in the current box (green). Position-preserving placement for "select all" selections.

'''v1.2.0'''
* Implement all boxes overview for save and bank boxes (access with ZL / ZR).

'''v1.1.0'''
* Now supports Let's Go Pikachu / Eevee games.

'''v1.0.1'''
* Implement full swap history to avoid losing Pokemon when doing multiple in-place swaps then canceling with B button.

'''v1.0.0'''
* Initial release.

== Credits ==
* [https://github.com/kwsch/PKHeX PKHeX] by kwsch - PokeCrypto research and save structure reference.
* [https://github.com/J-D-K/JKSV JKSV] by J-D-K - Save backup and write logic reference.
* Built with [https://github.com/switchbrew/libnx libnx] and [https://www.libsdl.org/ SDL2].

== External links ==
* GitHub - https://github.com/Insektaure/pkHouse
* GBAtemp thread - https://gbatemp.net/threads/pkhouse-local-bank-system-for-pokemon-switch-games.679665/

Sys-screenuploader Switch

2026-07-12T05:43:28Z

HydeWing:

{{Infobox Switch Homebrews
|title=sys-screenuploader
|image=sysscreenuploadernx.png
|description=A handy screen capture extractor.
|author=bakatrouble
|lastupdated=2020/05/02
|type=Sysmodules
|version=0.0.10
|license=LGPL-3.0
|download=https://dlhb.gamebrew.org/switchhomebrews/sysscreenuploadernx.7z
|website=https://gbatemp.net/threads/sys-screenuploader-a-handy-screen-capture-extractor.556519/
|source=https://github.com/bakatrouble/sys-screenuploader
|donation=
}}{{lowercase title}}
Homebrew Nintendo Switch NSP sysmodule for automatic upload of screen captures to remote server. It monitors /Nintendo/Album directory on your SD card for new files and uploads them to this website for further processing.

Currently available upload destinations:
*Telegram
*Discord

Instructions can be found [https://screenuploader.bakatrouble.me/ here] ([https://github.com/bakatrouble/sys-screenuploader-web website repo]).

Server implementations for self-hosting are available [https://github.com/bakatrouble/sys-screenuploader-servers/ here].

==Installation==
Download latest [https://github.com/bakatrouble/sys-screenuploader/releases/latest sys-screenuploader.zip] and extract it to SD card root.

SX OS users: move <code>42000062616B6101</code> directory from <code>/atmosphere/contents</code> to <code>/sxos/titles</code>.

Signup on [https://screenuploader.bakatrouble.me this website], create a destination and put its ID (visible on the destination list page) to <code>/config/sys-screenuploader/config.ini</code> under destinations section.

(You may replace <code>default</code> destination value or create a new one and set <code>default_destination</code> value under the <code>server</code> section to its name.)

Default configuration uploads captures to the [https://discord.gg/c5qBqAA #default-destination] channel on the project's [https://discord.gg/k7YYK8b Discord server].

If you want to use different destinations for some titles, add values under <code>title_settings</code> section following the example.

Configuration UI is TBD. For logs see <code>/config/sys-screenuploader/screenuploader.log</code>.

==User guide==
===FAQ===
'''Q. I can't open the log file'''

The log file is inaccessible while the sysmodule is running. Either stop the sysmodule (using Kosmos Toolbox or by any other means) or plug your SD card into another device.

'''Q. Media are not being sent.'''

The sysmodule only detects newest screenshots. Check the startup messages, if they say that the latest media has a future date, congratulations!

This usually means that you're an Animal Crossing cheater and have took some captures "in future", and the sysmodule will only detect media with a date later than your captures from future.

To resolve this issue either delete all captures with a wrong date or move them outside the Album folder.

'''Q. My log file is large.'''

It's safe to delete it from time to time.

==Changelog==
'''v0.0.10 2020/05/02'''
* Logging was remade completely: added an option to clear logs on launch; format was changed; log file is now readable even while the sysmodule is running (mostly).
*https://screenuploader.bakatrouble.me now supports placeholders for captions: {date}, {time} and {title}.

'''v0.0.9 2020/04/25'''
*Now it's possible to add captions to your uploaded media (if you're using my service) or pass individual arbitrary url parameters for requests to your own server.
*Also fixed logging messages a bit.

'''v0.0.8 2020/02/08'''
*Added option to disable uploading of certain media types globally and on per-app basis.
*Sysmodule version is now logged at start.
*A configuration builder tool was released at https://screenuploader.bakatrouble.me/cabinet/configuration/

'''v0.0.7 2020/01/30'''
*Destinations are now configurable on per-application basis.
*Album directory detection was also improved (thanks @HookedBehemoth).
*Default configuration is now usable and uploads to the #default-destination channel on this project's Discord server.
*Configuration file structure was changed, but should still be compatible with the old one.

'''v0.0.6 2020/01/29'''
*Old media are not reuploaded when the newest one is deleted.

'''v0.0.5 2020/01/28'''
*Fix frequent segfaults when the file we try opening is still opened by another process.

'''v0.0.4 2929/01/20'''
*Reduced memory footprint.
*Hardcoded /Emutendo/Album album path for SX OS (just checking whether the path exists, is there any better way to either detect SX OS or retrieve path from system configuration?).
*Configurable album path (use album_path option if yours was detected incorrectly).
*Skipping incorrect directory names ([https://gbatemp.net/threads/sys-screenuploader-a-handy-screen-capture-extractor.556519/page-2#post-8925334 issue report]).

'''v0.0.3 2020/01/19'''
*I've finaly made libcurl work, now we support arbitrary server URLs and HTTPS.
*Also a toolbox.json was added for integration with Kosmos Toolbox.

'''v0.0.2 2020/01/18'''
*Move to cloud service.

'''v0.0.1 2020/01/14'''
*Initial release.

==Credits==
This is my first nx homebrew app, a [https://github.com/vbe0201/libnx-template/ template project] by vbe0201 was used (and extended to support sysmodule building).

Initial sysmodule code was taken from SunTheCourier's [https://github.com/SunTheCourier/SwitchPresence-Rewritten SwitchPresence-Rewritten].

Icon by lordelan ([https://gbatemp.net/members/lordelan.359178/ GBAtemp] / [https://github.com/lordelan GitHub]).

== External links ==
* Official website - https://screenuploader.bakatrouble.me/
* GitHub - https://github.com/bakatrouble/sys-screenuploader
* GitHub - https://github.com/bakatrouble/sys-screenuploader-web
* GitHub - https://github.com/bakatrouble/sys-screenuploader-servers/
* GBAtemp - https://gbatemp.net/threads/sys-screenuploader-a-handy-screen-capture-extractor.556519/
* Discord - https://discord.gg/k7YYK8b
* Telegram - https://t.me/sys_screenuploader

Pngshot-ssu Vita

2026-07-12T05:43:10Z

HydeWing:

{{Infobox Vita Homebrews
|title=pngshot-ssu
|image=sysscreenuploaderVita.png
|description=Take screenshots in PNG format and upload screen captures to remote server.
|author=OctoNezd
|lastupdated=2026/04/29
|type=Plugins
|version=1.0.0
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/sysscreenuploaderVita.7z
|website=https://www.reddit.com/r/vitahacks/comments/1sw3hfl/kinda_ported_sysscreenuploader_from_switch_to_vita/
|source=https://github.com/OctoNezd/pngshot-sys-screen-uploader
|donation=
}}{{lowercase title}}
{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=sysscreenuploaderVita.png
|image_alt=sys-screenuploader
}}
pngshot-ssu (pngshot-sys-screen-uploader) is a modification of [[pngshot Vita|pngshot]] which allows making screenshots in PNG format. The modification is that screenshots are sent to Telegram or Discord using screenuploader.bakatrouble.me service based on the [[Sys-screenuploader Switch|sys-screenuploader Switch plugin]].

== Installation ==
Download from the [https://github.com/OctoNezd/pngshot-sys-screen-uploader/releases Releases section] or [https://nightly.link/OctoNezd/pngshot-sys-screen-uploader/workflows/build.yaml/master CI].

Copy <code>pngshot-ssu.suprx</code> to <code>ur0:tai</code> and add this into config.txt:

<pre>
# Upload screenshots from screenshot key
*main
ur0:tai/pngshot-ssu.suprx

# Swaps send to email button logic with upload to ssu button
*NPXS10004
ur0:tai/pngshot-ssu.suprx
</pre>

Create a <code>ux0:data/pngshot-ssu</code> directory. Write config.txt, based on the contents of [https://github.com/OctoNezd/pngshot-sys-screen-uploader/blob/master/config.sample.txt config.sample.txt] in the repository.

== Controls ==
PS button+Start - Take a screenshot

Screenshots can be accessed with the Photos app, or from <code>ux0:picture/SCREENSHOT</code>.

==Media==
'''Pngshot-sys-screen-uploader demo''' ([https://www.youtube.com/watch?v=NOtk0emn10Q Octo]) 
<youtube width="640">NOtk0emn10Q</youtube>

==Changelog==
'''v1.0'''
* I think its more or less stable. I think. Hadnt been able to reproduce livearea glitches and lags after I disabled debugging plugins.

== External links ==
* GitHub - https://github.com/OctoNezd/pngshot-sys-screen-uploader
* Reddit - https://www.reddit.com/r/vitahacks/comments/1sw3hfl/kinda_ported_sysscreenuploader_from_switch_to_vita/

Pngshot-ssu Vita

2026-07-12T05:39:10Z

HydeWing:

{{Infobox Vita Homebrews
|title=pngshot-ssu
|image=sysscreenuploaderVita.png
|description=Take screenshots in PNG format.
|author=OctoNezd
|lastupdated=2026/04/29
|type=Plugins
|version=1.0.0
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/sysscreenuploaderVita.7z
|website=https://www.reddit.com/r/vitahacks/comments/1sw3hfl/kinda_ported_sysscreenuploader_from_switch_to_vita/
|source=https://github.com/OctoNezd/pngshot-sys-screen-uploader
|donation=
}}{{lowercase title}}
{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=sysscreenuploaderVita.png
|image_alt=sys-screenuploader
}}
pngshot-ssu (pngshot-sys-screen-uploader) is a modification of [[pngshot Vita|pngshot]] which allows making screenshots in PNG format. The modification is that screenshots are sent to Telegram or Discord using screenuploader.bakatrouble.me service based on the [[Sys-screenuploader Switch|sys-screenuploader Switch plugin]].

== Installation ==
Download from the [https://github.com/OctoNezd/pngshot-sys-screen-uploader/releases Releases section] or [https://nightly.link/OctoNezd/pngshot-sys-screen-uploader/workflows/build.yaml/master CI].

Copy <code>pngshot-ssu.suprx</code> to <code>ur0:tai</code> and add this into config.txt:

<pre>
# Upload screenshots from screenshot key
*main
ur0:tai/pngshot-ssu.suprx

# Swaps send to email button logic with upload to ssu button
*NPXS10004
ur0:tai/pngshot-ssu.suprx
</pre>

Create a <code>ux0:data/pngshot-ssu</code> directory. Write config.txt, based on the contents of [https://github.com/OctoNezd/pngshot-sys-screen-uploader/blob/master/config.sample.txt config.sample.txt] in the repository.

== Controls ==
PS button+Start - Take a screenshot

Screenshots can be accessed with the Photos app, or from <code>ux0:picture/SCREENSHOT</code>.

==Media==
'''Pngshot-sys-screen-uploader demo''' ([https://www.youtube.com/watch?v=NOtk0emn10Q Octo]) 
<youtube width="640">NOtk0emn10Q</youtube>

==Changelog==
'''v1.0'''
* I think its more or less stable. I think. Hadnt been able to reproduce livearea glitches and lags after I disabled debugging plugins.

== External links ==
* GitHub - https://github.com/OctoNezd/pngshot-sys-screen-uploader
* Reddit - https://www.reddit.com/r/vitahacks/comments/1sw3hfl/kinda_ported_sysscreenuploader_from_switch_to_vita/

Pngshot-ssu Vita

2026-07-12T05:35:42Z

HydeWing: HydeWing moved page Sys-screenuploader Vita to Pngshot-ssu Vita

{{Infobox Vita Homebrews
|title=sys-screenuploader
|image=sysscreenuploaderVita.png
|description=Take screenshots in PNG format.
|author=OctoNezd
|lastupdated=2026/04/29
|type=Plugins
|version=1.0.0
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/sysscreenuploaderVita.7z
|website=https://www.reddit.com/r/vitahacks/comments/1sw3hfl/kinda_ported_sysscreenuploader_from_switch_to_vita/
|source=https://github.com/OctoNezd/pngshot-sys-screen-uploader
|donation=
}}
{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=sysscreenuploaderVita.png
|image_alt=sys-screenuploader
}}
pngshot-ssu (pngshot-sys-screen-uploader) is a modification of [[pngshot Vita|pngshot]] which allows making screenshots in PNG format. The modification is that screenshots are sent to Telegram or Discord using screenuploader.bakatrouble.me service based on the [[Sys-screenuploader Switch|sys-screenuploader Switch plugin]].

== Installation ==
Download from the [https://github.com/OctoNezd/pngshot-sys-screen-uploader/releases Releases section] or [https://nightly.link/OctoNezd/pngshot-sys-screen-uploader/workflows/build.yaml/master CI].

Copy <code>pngshot-ssu.suprx</code> to <code>ur0:tai</code> and add this into config.txt:

<pre>
# Upload screenshots from screenshot key
*main
ur0:tai/pngshot-ssu.suprx

# Swaps send to email button logic with upload to ssu button
*NPXS10004
ur0:tai/pngshot-ssu.suprx
</pre>

Create a <code>ux0:data/pngshot-ssu</code> directory. Write config.txt, based on the contents of [https://github.com/OctoNezd/pngshot-sys-screen-uploader/blob/master/config.sample.txt config.sample.txt] in the repository.

== Controls ==
PS button+Start - Take a screenshot

Screenshots can be accessed with the Photos app, or from <code>ux0:picture/SCREENSHOT</code>.

==Media==
'''Pngshot-sys-screen-uploader demo''' ([https://www.youtube.com/watch?v=NOtk0emn10Q Octo]) 
<youtube width="640">NOtk0emn10Q</youtube>

==Changelog==
'''v1.0'''
* I think its more or less stable. I think. Hadnt been able to reproduce livearea glitches and lags after I disabled debugging plugins.

== External links ==
* GitHub - https://github.com/OctoNezd/pngshot-sys-screen-uploader
* Reddit - https://www.reddit.com/r/vitahacks/comments/1sw3hfl/kinda_ported_sysscreenuploader_from_switch_to_vita/

Geometrizer Vita

2026-07-12T05:35:17Z

HydeWing:

{{Infobox Vita Homebrews
|title=Geometrizer Vita
|image=GeometrizerVita.png
|description=Sega Model 1 emulator for PSVita.
|author=frangarcj
|lastupdated=2026/07/01
|type=Arcade
|version=20260711
|license=N/A
|download=https://dlhb.gamebrew.org/vitahomebrews/GeometrizerVita.7z
|website=https://github.com/frangarcj/geometrizer
|source=https://github.com/frangarcj/geometrizer
|donation=
}}
{{#seo:
|title=Vita Homebrew Emulators (Arcade) - GameBrew
|title_mode=append
|image=GeometrizerVita.png
|image_alt=Geometrizer Vita
}}
Geometrizer is a Sega Model 1 arcade-board emulator written in C11, targeting Virtua Racing, running on macOS and the PlayStation Vita.

The project is a playground for AI-assisted development: most of the code is written by an AI coding agent iterating in a tight loop against real hardware, reference traces, and an emulator oracle. The goal is less "ship a polished emulator" and more "see how far an AI can drive a hard, low-level systems project" - cycle-accurate CPU cores, a custom geometry DSP, a software 3D pipeline, and a from-scratch GPU renderer on a 2012 handheld.

Status: experimental / work-in-progress. Virtua Racing boots, renders, and plays on both targets.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/GeometrizerVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/GeometrizerVita-02.png

https://dlhb.gamebrew.org/vitahomebrews/images/GeometrizerVita-03.png

==Changelog==
'''v2026-07-11'''
* First Release.

== External links ==
* GitHub - https://github.com/frangarcj/geometrizer
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1432

MOTHER Encore Vita

2026-07-12T05:35:15Z

HydeWing: xxx

{{Infobox Vita Homebrews
|title=MOTHER Encore Vita
|image=MOTHEREncoreVita.png
|description=Port of MOTHER Encore for PSVita.
|author=Wolff
|lastupdated=2026/07/09
|type=Role Playing
|version=0.2b
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/MOTHEREncoreVita.7z
|website=https://www.reddit.com/r/vitahacks/comments/1urf516/mother_encore_act_2_psvita_port_beta/
|source=https://github.com/WolffsRoom/MotherEncore-PSVita
|donation=
}}
{{#seo:
|title=Vita Homebrew Games (Role Playing) - GameBrew
|title_mode=append
|image=MOTHEREncoreVita.png
|image_alt=MOTHER Encore Vita
}}
A native PlayStation Vita port of MOTHER: Encore, the free fan-made reimagining of MOTHER 1, adapted from its original Godot Engine PC release. This project contains the source patches, control rewrites, and tooling created to make the game run natively on the PS Vita hardware.

Improvements & Adaptations for the PS Vita:
* Memory & loading (boot crash fix):
** Lazy UI loading - the UI manager previously preloaded around 11 heavy scenes (battle system, shops, storage, ATM, save/keyboard/ocarina screens, dialogue boxes) at boot; these now load on demand.
** Lazy map loading - maps now load individually when opened, instead of every map being instanced at startup.
** Result: boot RAM usage dropped from 365/365 MB (an out-of-memory crash) to around 181/365 MB, letting the game boot to the title screen and beyond.
* Data packaging:
** The game is fully data-driven (900+ <code>.yaml</code>/<code>.ecs</code>/<code>.dat</code> files). These raw data files were explicitly included in the Vita export so the runtime stops looping on missing data.
* Engine compatibility (Godot 3.6 → 3.5 Vita fork):'''
** Replaced a Godot 3.6-only API call (<code>is_node_ready</code>) with its 3.5 equivalent and restored a dropped <code>class_name</code> registration from the decompile.
* Controls and input:
** Gamepad-first prompts - on-screen prompts show real PS Vita buttons instead of PC keyboard keys by default.
** Touch L2/R2 - the Vita's missing L2/R2 buttons are mapped to the left/right halves of the touchscreen.
** PC hints removed - the title screen's "Fullscreen (F11) / Window Size (F5)" hints are hidden on console.
* Display:
** Adapted the game to the Vita's 960×544 screen.

Based on MOTHER: Encore ACT 2 - v0.4.0.3 (Windows). Original game by Pkdotts and team: https://mother-encore.itch.io/mother-encore

== Installation ==
Every release ships two files: the .vpk (the app itself) and a -GameData.zip (the game data, i.e. game_data/game.pck). Both are required.

Go to [https://github.com/WolffsRoom/MotherEncore-PSVita/releases Releases], download the latest MotherEncore-Vita-x.x.x.vpk and MotherEncore-Vita-x.x.x-GameData.zip.

Install the .vpk on the PS Vita using [[VitaShell]] or [[FMVita]] (a personalized VitaShell fork by the author).

Extract the -GameData.zip to get a game_data folder containing game.pck.

Connect the Vita via FTP or USB and copy the game_data folder into <code>ux0:app/MOTHER001/</code>, so that the file ends up exactly at <code>ux0:app/MOTHER001/game_data/game.pck</code>.

When updating, always install both the new .vpk and the new -GameData.zip, a newer VPK is not guaranteed to work with an older game.pck, and vice versa.

Save files are not lost when uninstalling or updating (stored under <code>ux0:data/godot/app_userdata/MOTHER Encore/...</code>).

== Controls ==
D-Pad or Left Analog - Move

Cross - Confirm / Interact

Triangle - Menu

Circle - Cancel, Back

Square - Crouch, Telepathy (hold)

Right Analog - Camera

L1 - Previous party member

R1 - Next party member

Touchscreen, left half (emulated L2) - Scope, Markers

Touchscreen, right half (emulated R2) - Crouch, Telepathy

The PS Vita has no physical L2/R2 (nor L3/R3) buttons; these are emulated by touching the left and right halves of the front touchscreen.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/MOTHEREncoreVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/MOTHEREncoreVita-02.png

https://dlhb.gamebrew.org/vitahomebrews/images/MOTHEREncoreVita-03.png

==Media==
'''MOTHER: Encore Act 2 LAUNCH TRAILER''' ([https://www.youtube.com/watch?v=rVubWY0Ubzs Mother Encore]) 
<youtube width="640">rVubWY0Ubzs</youtube>

==Known issues==
This is an early technical beta - expect rough edges:
* Battle crashes: The game still crashes when entering the first battle. Fix planned for the next version.
* Performance: GPU load is high and frame rate is currently low in the overworld/title; performance tuning is still in progress.
* Some scenes are still being optimized for the PowerVR GPU.
* Three unrecoverable developer/joke dialogue sheets from the decompile (Snowman, Testing, shitpost) were removed; they are not part of normal gameplay.

==Changelog==
'''v0.2b'''
* Fixed touch L2/R2: touching the left/right half of the screen now correctly presses L2 (Scope) and R2 (Crouch/Telepathy) in-game, not just on the polling checks.

'''v0.1b'''
* First Release.

== Credits ==
* MOTHER: Encore - created by Pkdotts and team - https://mother-encore.itch.io/mother-encore
* Please support the original developers and the official MOTHER series.

== External links ==
* Author's website - https://wolffsroom.wordpress.com/
* GitHub - https://github.com/WolffsRoom/MotherEncore-PSVita
* Reddit - https://www.reddit.com/r/vitahacks/comments/1urf516/mother_encore_act_2_psvita_port_beta/
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1431

Pngshot-ssu Vita

2026-07-12T05:35:15Z

HydeWing:

Noled Vita by Falkenhawk

2026-07-12T05:35:14Z

HydeWing:

{{Infobox Vita Homebrews
|title=noled by falkenhawk
|image=noledVitabyFalkenhawk.png
|description=A simple plugin to turn off the home button led of PS Vita.
|author=falkenhawk
|lastupdated=2026/07/05
|type=Plugins
|version=2.1
|license=N/A
|download=https://dlhb.gamebrew.org/vitahomebrews/noledVitabyFalkenhawk.7z
|website=https://www.reddit.com/r/vitahacks/comments/1unpf0m/noled_v20_vita_slim_night_owls_rejoice/
|source=https://github.com/falkenhawk/noled
|donation=
}}
{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=noledVitabyFalkenhawk.png
|image_alt=noled by falkenhawk
}}
A simple plugin to turn off PS Vita status LEDs, especially useful at night.

It is a fork of the original [[Noled Vita|noled]] and adds the first known software control of the PCH-2000 green power LED. Fully automatic, no configuration:
* Power LED dark whenever the console is on.
* Orange charging indication preserved - shows while actually charging, also in standby.
* Re-applied by itself ~2 s after every wake; the standby blink sequence is gone too.
* Vita 1000 autodetected and keeps the classic behavior; removal restores everything stock.

The LED is not a SoC GPIO; it hangs off the syscon MCU ("Ernie") and is driven by its autonomous power/charge policy, which is why every GPIO-based approach failed for years. The off switch is <code>ksceSysconCtrlLedBlinkType2</code> (syscon command <code>0x89F</code>): an off-pattern for device 1 parks the indicator dark, and claiming the engine's single pattern slot for device 0 releases it back to syscon policy. The full story - syscon LED command reference, the power LED state model, hardware-verified results and the dead ends - is in [https://github.com/falkenhawk/noled/blob/master/docs/pch2000-power-led-research.md docs/pch2000-power-led-research.md]; the other files in docs/ are the raw session-by-session research trail.

== Installation ==
Copy <code>noled.skprx</code> to your tai folder (<code>ur0:tai/</code> recommended - internal memory, works without a memory card; <code>ux0:tai/</code> works too) and add it to the <code>*KERNEL</code> section of your taiHEN <code>config.txt</code>:

*KERNEL
ur0:tai/noled.skprx

Note: taiHEN reads <code>ur0:tai/config.txt</code> only when <code>ux0:tai/config.txt</code> does not exist - add the line to whichever config is active on your system. Reboot afterwards.

No configuration file is needed - the plugin reads no config and writes no files at all. Removing it from the taiHEN config (plus a reboot) restores everything stock.

==Media==
'''Disabling the led on Vita''' ([https://www.youtube.com/watch?v=YbxpdJ67VgE Mithat Temizer]) 
<youtube width="640">YbxpdJ67VgE</youtube>

==Changelog==
'''v2.1 - slim release build'''
* the release plugin was slimmed down to the production policy only: 5.3 KB filesize, under 1 KB of resident kernel memory (v2.0: 30 KB / ~186 KB)
* zero file I/O: no config file read, no logs written - fixes v2.0 appending a heartbeat line to <code>ux0:data/noled/probe.log</code> every 10 s without bound; <code>ux0:data/noled/</code> is no longer used and can be deleted
* all research/diagnostic machinery moved to a build-it-yourself dev harness (<code>dev/</code>); releases ship only <code>noled.skprx</code>
* LED behavior is unchanged and was re-verified on hardware

'''v2.0 - Vita 2000 power LED support'''
* First known software control of the PCH-2000 (Vita Slim / Vita 2000) green power LED - the feature requested in [https://github.com/rereprep/noled/issues/3 rereprep#3] since 2018.
* '''Vita 2000 / PCH-2000''': power LED dark whenever the console is on; orange charging indication preserved (shows while actually charging, incl. in standby); re-applied automatically ~2s after every wake
* '''Vita 1000''': unchanged classic behavior (home button + game card LED off) - the plugin autodetects the model
* boot plugin only: no app, no configuration file needed
* bonus: the standby blink sequence is suppressed too (one short final blink remains, generated inside the syscon MCU)

== External links ==
* GitHub - https://github.com/falkenhawk/noled
* Reddit - https://www.reddit.com/r/vitahacks/comments/1unpf0m/noled_v20_vita_slim_night_owls_rejoice/

CardWars-Vita

2026-07-12T05:35:14Z

HydeWing:

Save Keeper Vita

2026-07-12T05:35:13Z

HydeWing:

{{Infobox Vita Homebrews
|title=Save Keeper
|image=SaveKeeperVita.png
|description=PS Vita save backup manager with Google Drive sync - QR sign-in, timestamped snapshots, multi-device.
|author=falkenhawk
|lastupdated=2026/07/05
|type=Utilities
|version=1.0.0
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/vitahomebrews/SaveKeeperVita.7z
|website=https://www.reddit.com/r/vitahacks/comments/1unp5ey/save_keeper_back_up_and_sync_saves_via_google/
|source=https://github.com/falkenhawk/vita-save-keeper
|donation=
}}
{{#seo:
|title=Vita Homebrew Apps (Utilities) - GameBrew
|title_mode=append
|image=SaveKeeperVita.png
|image_alt=Save Keeper
}}
Back up your PS Vita and PSP save games and sync them to your own Google Drive. Made for people with more than one Vita (or a PS TV) who want their saves to follow them.

== Features ==
* Creates timestamped ZIP snapshots of Vita, game card, and PSP/Adrenaline saves
* Uploads snapshots to a <code>PSV Saves</code> folder in your own Google Drive
* Downloads and restores snapshots on any of your devices, so a save made on one Vita can be picked up on another Vita or a PS TV
* Shows your games in a grid with real titles and icons, grouped into Vita / Homebrew / PSP tabs
* Sorts by name, by last saved, or by last synced (whatever was uploaded most recently, from any device, bubbles to the top)
* Signs in to Google by scanning a QR code with your phone - no typing on the Vita, and you stay signed in until you disconnect
* Keeps multiple snapshots per game, so you can go back to an older save at any time
* Before a restore overwrites anything, the current save is snapshotted automatically (shown as <code>[AUTO]</code>), unless an identical backup already exists

== Installation ==
'''What you need:'''
* A PS Vita or PS TV with HENkaku / h-encore homebrew enabled
* "Enable unsafe homebrew" turned on in HENkaku settings (the app reads save folders and the system app database)
* VitaShell (or another way to install a VPK)
* A Google account and about ten minutes for the [https://github.com/falkenhawk/vita-save-keeper#google-drive-setup-one-time one-time Google setup]

'''Install:'''
* Copy <code>save-keeper.vpk</code> to your Vita (for example over FTP to <code>ux0:/data/</code>)
* In [[VitaShell]], press X on the file and confirm the install, including the extended permissions prompt
* Do the one-time Google setup, then launch Save Keeper from the LiveArea

'''Google Drive setup (one time):'''

Save Keeper talks to your own Google Drive, so it needs credentials that belong to you. Follow [https://github.com/falkenhawk/vita-save-keeper/blob/master/docs/google-drive-setup.md docs/google-drive-setup.md] - it walks through creating a free Google Cloud project ("PSV Save Keeper"), enabling the Drive API, and creating a "TVs and Limited Input devices" OAuth client.

The short version of what you end up with: a small <code>google-client.json</code> file at <code>ux0:data/save-keeper/google-client.json</code> on each device. After that, connecting is a single Triangle press: scan the QR code with your phone, approve, done. The sign-in survives app exits, reboots, and reinstalls.

The app can only see files it created itself. It cannot read anything else in your Drive.

== Controls ==
D-Pad - Move through the game grid

L/R - Switch between the Vita/Homebrew/PSP tabs

Right Stick - Move through the backup list

Cross - Create a backup (on "New Backup") or restore the selected one (press twice)

Select - Upload the selected local backup to Google Drive

Start - Delete the selected backup, locally or from Drive (press twice)

Square - Change sorting: by name, last saved, or last synced

Triangle - Connect Google Drive, or re-sync the remote backup list

Circle - Cancel a pending confirmation or the Google sign-in

On Japanese-region consoles Cross and Circle swap automatically, following the system setting. Backups from Google Drive show a <code>[GD]</code> prefix in the list. Use the PS button to leave the app.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/SaveKeeperVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/SaveKeeperVita-02.png

https://dlhb.gamebrew.org/vitahomebrews/images/SaveKeeperVita-03.png

==Changelog==
'''v1.0'''
* First Release.

== External links ==
* GitHub - https://github.com/falkenhawk/vita-save-keeper
* Reddit - https://www.reddit.com/r/vitahacks/comments/1unp5ey/save_keeper_back_up_and_sync_saves_via_google/
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1430

Picture Poker Vita

2026-07-12T05:35:12Z

HydeWing:

{{Infobox Vita Homebrews
|title=Picture Poker
|image=PicturePokerVita.png
|description=A game inspired by Luigi's Picture Poker.
|author=4brm01
|lastupdated=2026/07/07
|type=Card
|version=1.0
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/PicturePokerVita.7z
|website=https://www.reddit.com/r/vitahacks/comments/1up4dt6/am_making_picture_poker_for_the_vita_d/
|source=https://github.com/4brm01/Picture-Poker
|donation=
}}
{{#seo:
|title=Vita Homebrew Games (Card) - GameBrew
|title_mode=append
|image=PicturePokerVita.png
|image_alt=Picture Poker
}}
Picture-Poker is a game inspired by Luigi's picture poker.

== Installation ==
Download the "PicturePoker.vpk" and install it on the Vita via [[VitaShell]].

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/PicturePokerVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/PicturePokerVita-02.png

https://dlhb.gamebrew.org/vitahomebrews/images/PicturePokerVita-03.png

==Changelog==
'''v1.0'''
* First Release.

== External links ==
* GitHub - https://github.com/4brm01/Picture-Poker
* Reddit - https://www.reddit.com/r/vitahacks/comments/1up4dt6/am_making_picture_poker_for_the_vita_d/
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1429

Pngshot Vita

2026-07-12T05:15:07Z

HydeWing:

{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=pngshotvita2.png
|image_alt=pngshot
}}
{{Infobox Vita Homebrews
|title=pngshot
|image=pngshotvita2.png
|description=Take PNG screenshots in any app + remove watermark.
|author=xyzz
|lastupdated=2019/04/06
|type=Plugins
|version=1.3
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/pngshotvita.7z
|website=https://github.com/xyzz/pngshot
|source=https://github.com/xyzz/pngshot
}}{{lowercase title}}
pngshot is a plugin that replaces standard compressed JPG screenshots with PNG screenshots without watermark.

It also enables screenshots taking in every game.

==Features ==
* Takes screenshots in png format.
* No watermark.
* Take screenshots in any app.

==Installation==
Copy pngshot.suprx to ur0:tai and add ur0:tai/pngshot.suprx below *main in ur0:tai/config.txt

*main
ur0:tai/pngshot.suprx

You can access screenshots with the Photos app, or from ux0:picture/SCREENSHOT/.

Note that this was only tested with retail SceShell. If, for some reason, you have some modifications done to your SceShell, this plugin will probably crash your Vita.

==Controls==
PS button+Start - Take a screenshot

==Known issues==
Will not work if you installed a DEX SceShell to your Vita (by [https://www.reddit.com/r/vitahacks/comments/6maxu9/comment/dk07ta5/?utm_source=share&utm_medium=web2x&context=3 devnoname120]).

==Changelog==
'''v1.3'''
* Added Testkit/DEX support.

'''v1.2'''
*Added support for 3.68

'''v1.1'''
*Added support for 3.65/3.67

== External links ==
* GitHub - https://github.com/xyzz/pngshot
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/283

Noled Vita

2026-07-12T05:09:55Z

HydeWing:

{{Infobox Vita Homebrews
|title=noled
|image=noledvita2.png
|description=Home button light disabler for PS Vita.
|author=xerpi, reprep
|lastupdated=2017/08/16
|type=Plugins
|version=1.2
|license=Mixed
|download=https://dlhb.gamebrew.org/vitahomebrews/noledvita.7z?k33p0fil35 1.1 & 1.2
|website=https://gbatemp.net/threads/release-noled-plugin-to-turn-off-the-home-button-led.466963/
|source=https://github.com/rereprep/noled
}}
{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=noledvita2.png
|image_alt=noled
}}
noled is a simple plugin to turn off the blue home button led of PS Vita. Especially useful at night.

With the release of v1.2, it will now disable both the Home Button LED and Game Cartridge LED.

==Installation==
It is a kernel plugin so enable it in kernel section of your config.txt.

To install, copy noled.skprx to ux0:tai/ or ur0:tai/.

Edit tai/config.txt (change to ur0 if you store the plugin there)

*KERNEL
ux0:tai/noled.skprx

After that, reboot your vita and restart henkaku.

==Media==
'''Disabling the led on Vita''' ([https://www.youtube.com/watch?v=YbxpdJ67VgE Mithat Temizer]) 
<youtube>YbxpdJ67VgE</youtube>

==Compatibility==
Compatible with Henkaku Ensō.

==Known issue==
After resuming from standby, blue light will turn on for a second and then turn off.

==Changelog==
'''v1.2'''
* It now disables both Home Button LED and Game Cartridge LED. If you only want Home Button LED disabled, please download v1.1.

'''v1.1'''
* compatible with Henkaku Ensō, thanks to Celeste for the tip.

'''v1.0'''
* First Release.

==Credits==
All credits to @xerpi, all i did was to compile the source.

== External links ==
* GitHub - https://github.com/rereprep/noled
* Wololo - https://wololo.net/talk/viewtopic.php?t=48017
* GBAtemp - https://gbatemp.net/threads/release-noled-plugin-to-turn-off-the-home-button-led.466963/
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/233

TomoToolNX Switch

2026-07-12T04:53:29Z

HydeWing:

{{Infobox Switch Homebrews
|title=TomoToolNX
|image=TomoToolNXSwitch.png
|description=A tool for managing Tomodachi Life Ltd directly on the Nintendo Switch.
|author=miiazertyy
|lastupdated=2026/07/06
|type=Save Managers and Editors
|version=1.3.8
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/switchhomebrews/TomoToolNXSwitch.7z
|website=https://github.com/miiazertyy/TomoToolNX
|source=https://github.com/miiazertyy/TomoToolNX
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Save Managers and Editors) - GameBrew
|title_mode=append
|image=TomoToolNXSwitch.png
|image_alt=TomoToolNX
}}
TomoToolNX is a Nintendo Switch homebrew tool for editing Tomodachi Life save data directly from the console. Both WebUI and on-Switch modes are supported.

The project is based on [https://gamebanana.com/tools/22435 LivinTheDreamToolkit] by the UGC editor contributors. Mii sharing is based on [https://github.com/Star-F0rce/ShareMii ShareMii] by Star-F0rce. The save-file parser, generated data tables (wishes, habits, clothes, coordinates, treasures), Map.sav schema hashes, UGC kind table, housing-edit safety rules, and the Custom BC1/BC3 texture encoder are derived from [https://github.com/alexislours/ltd-save-editor alexislours/ltd-save-editor] (AGPL-3.0-or-later). Early reference for save key hashes came from [https://github.com/tlmodding/ltd-gamedata tlmodding/ltd-gamedata].

== Features ==
* '''Textures - swap any UGC texture (FacePaint, Food, Goods, Thumbs) by importing a PNG. Images are resized, alpha-cleaned, and re-encoded automatically.
* '''Miis''' - edit just about everything visible: stats, words, habits, belongings, relationships, housing, and the social graph. Import / export individual Miis as <code>.ltd</code> files.
* '''TomodachiShare''' - browse the online catalogue, search and filter, preview, and download shared Miis directly into a save slot.
* '''Player save''' - adjust the global player fields: name, island, money, currency, birthday, region, languages, wishes, fountain, island size, and more.
* '''Map''' - view your island as a 120×80 tile grid, click any object to inspect and edit its position, rotation, linked map ID, or which Miis live in it; place new objects or remove existing ones. Works on both the WebUI and the on-Switch controller / touch UI.
* '''Backups''' - your save is copied to the SD card before any edit, and every texture import keeps a per-file backup. Restore from inside the app.
* '''MTP over USB''' - the SD card mounts as a USB drive while the WebUI is running (via [https://github.com/ITotalJustice/libhaze libhaze]).
* '''Translations''' - both the WebUI and the on-Switch UI can be translated by editing plain text files. Contributions welcome.
* '''Update check''' - on launch, lets you know when a newer release is up on GitHub.

== Installation ==
Copy <code>TomoToolNX.nro</code> to <code>/switch/TomoToolNX/</code> on your SD card and launch from the homebrew menu.

== User guide ==
Launch the app, pick a user account, decide what to do with any existing save backup, then choose a mode:
* WebUI - starts a local HTTP server. Open <code>http://<switch-ip>:8080</code> on any device on the same network and edit from the browser. The SD card also mounts over USB while the server is running.
* On-Switch - browse and edit directly with the controller. Tabs are switched with L / R (or ZL / ZR); each tab shows its own controls at the bottom of the screen.

Press B to back out at any point. The app prompts before discarding unsaved changes.

A few notes on textures: PNGs are auto-resized to the target format, a transparent background with clean edges gives the best result, and encoding is sRGB-aware to match the game's color reproduction. The default Custom encoder is a faithful port of [https://github.com/alexislours/ltd-save-editor ltd-save-editor]'s BC1/BC3 encoder; a faster PCA-only fallback is available in the settings.

==Screenshots==
{| style="max-width:80%; margin-left:0em;"
|
https://dlhb.gamebrew.org/switchhomebrews/images/TomoToolNXSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/TomoToolNXSwitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/images/TomoToolNXSwitch-03.png
|}

== Changelog ==
'''v1.3.8'''
* Added create blank UGC and Mii buttons
* Added a cursor inspired by hekate (Right stick to enable and left stick to click)
* Added a Penality travel clearer in the player tab
* UI Enhancements
* Bug fixes
* Prob more things I dont remember tbh

'''v1.3.7'''
* Added Japanese translation
* Libhazefix directly wired with make setup for easier building
* Customizable theme colors because why not
* UI enhancements
* Bug fixes

'''v1.3.6'''
* Added WebUI translations and sync from hb app language
* Added island stats (WebUI only) in the Player tab
* More editing features in the Map tab
* Bug fixes

'''v1.3.5'''
* QoL features and bug fixes
* Compressed the bundled save file (-4mo)

'''v1.3.4'''
* WIP island "generator", overwrite a user with a mostly well generated map 'seed system', you can also choose to use the 100% base save file
* Search and filter features in the texture tab
* Added mtp toggling to prevent crashes on emulator
* Parameter to change texture uploading resolution (for book and tv UGCs)
* Per user backup
* UI fixes, bug fixes and better emulator support

'''v1.3.3'''
* Fixed update checker
* Fixed .ltd* file support
* Better tomodachishare loading logic
* Updated for latest LTD update
* UI fixes

'''v1.3.2'''
* Better network loading spree
* AI-Translated new languages (send a pr if any translation is incorrect)
* New UI layout and sounds (revertable in the settings tab)
* Social tab rewritten
* Manual code optimization not ai

'''v1.3.1'''
* Removed the auto updater, it's a pain to maintain and because the app was added to the homebrew appstore it's more straight forward to update than before
* Added game assets icon for the item tab (only webui)
* New Credits button
* New Map tab
* New batch know relations buttons
* Bug fixes

'''v1.3.0'''
* Added multiple Language support, you can contribute with pull requests
* Added TomodachiShare Mii browser in the stats subtab (little export logo button)
* Added more bulk unlock features
* Added a straight forward Housing subtab to assign houses to Miis
* Items tab now straightforward on the app
* Bug fixes and qol features

'''v1.2.5'''
* Added MTP file sharing for people that don't want to enable Wifi
* Added color encoding settings
* Bug fixes

'''v1.2.4'''
* Importing now supports every ugc files
* Touch screen now works in the belonging and habits tab
* Updater fixed
* Bug fixes

'''v1.2.3'''
* Added U-2-Netp ai to remove background of ugcs easily
* Thumb is now written automatically
* Touch screen fixes
* New Habits tab
* QoL UI additions

'''v1.2.2'''
* Subtabs are now implemented in the WebUI
* Now shows a prompt when running applet mode because of the "Error - User not found" confusion
* Added ability to change encounter dates in the relation tab
* Backup now saves up to 8 saves by default so there's less chances of overwriting an incorrect backup
* Added a belongings tab
* New settings tab in the user menu
* ShareMii version v3.2.3 fixes implemented
* Better UI logic and bug fixes

'''v1.2.1'''
* UI and WebUI bug fixes, better logic and additions
* Added more editing features in mii stats and player tabs

'''v1.2.0'''
* Added save editing features for player file and miis
* QoL changes and bug fixes

'''v1.1.6'''
* Added touch screen support
* Added the ability to choose the export path
* Exporting now shows the path where it's importing

'''v1.1.5'''
* Added drag to import on webui
* Bug fixes from ShareMii v3.2.2
* Fixed crash when exiting app
* Now shows the actual name of the ugcs instead of the file name
* Fixed random hb menu crashing when closing the app
* Lots of UI logic enhancements

'''v1.1.4'''
* Fixed webui importing issue
* Added free file browsing
* Pictures now keep the current aspect ratio when importing
* UI enhancements

'''v1.1.3'''
* UI enhancements
* Fixed reddish color preview for the ugcs

'''v1.1.2'''
* Revamped the UI so On-Switch and WebUI aren't separated anymore
* Added a skip button while update's being checked
* QoL features
* Known issue: reddish color on preview but everything works ingame

'''v1.1.1'''
* Added an auto update feature, from github
* Added a QR code to the WebUI and the Wifi status
* Made the Mii tab phone compatible
* Miis load on computer correctly now
* Known issue: Reddish preview, still works perfectly ingame

'''v1.1.0'''
* Fixed semi transparent pixels and a weird outline appearing with certain pictures
* Added Mii Exporting and Importing as LTD thanks to the ShareMii project
* Added mikhak font locally
* Known issue: Reddish preview, still works perfectly ingame

'''v1.0.1'''
* Thumb files not listed anymore for ugcs
* Added a savefile backup feature and prompt
* Logs now go to "TomoToolNX" folder instead of "tomodachi-ugc"
* Made the UI cleaner
* Added ability to choose either webui or directly on switch
* QoL features

'''v1.0.0'''
* Initial Release
* Uses only WebUI atm
* Supports UGC importing
* Be careful and backup your files using jksv before using this, no backup feature yet

== External links ==
* GitHub - https://github.com/miiazertyy/TomoToolNX
* Homebrew App Store - https://hb-app.store/switch/TomoToolNX

Checkpoint Switch

2026-07-12T04:53:29Z

HydeWing:

{{Infobox Switch Homebrews
|title=Checkpoint
|image=checkpointnx.png
|description=Fast and simple homebrew save manager for 3DS and Switch.
|author=FlagBrew
|lastupdated=2026/07/11
|type=Save Managers and Editors
|version=4.0.0
|license=GPL-3.0
|download=https://github.com/BernardoGiordano/Checkpoint/releases
|website=https://flagbrew.org/
|source=https://github.com/FlagBrew/Checkpoint
|donation=https://www.patreon.com/FlagBrew
}}

A fast and simple homebrew save manager for [[Checkpoint 3DS|3DS]] and Switch written in C++.

Checkpoint is created following ideas of simplicity and efficiency. The UI has been designed to condense as many options as possible, while keeping it simple to work with.

Moreover, Checkpoint is extremely lightweight - while being packaged with a nice graphic user interface - and is built using the most recent libraries available.

Checkpoint for Switch natively supports NAND saves for the titles you have played. Title information are loaded automatically.

==Features==
Checkpoint backs up and restores save data for:
* 3DS: 3DS cartridges and digital titles (including demos), extdata, DS cartridges, DSiWare and GBA Virtual Console titles
* Switch: saves for the titles you have played, with title information loaded automatically
Both versions share the same core feature set:
* A completely redesigned user interface, with light and dark mode theming
* A Settings section to configure everything directly from the console: favorites, filters, additional save folders and more, with no manual file editing required
* Internationalization support: English, Italian, French, German, Portuguese, Spanish, Dutch, Japanese and Chinese
* Fast, responsive file operations: backups and restores run on a worker thread, and backups can be cancelled while in progress
* Additional save folders, configurable per title through a built-in folder browser
* A background FTP server, to access your save backups directly from your PC
* Wireless save transfer between consoles
* An HTTP log server, to view Checkpoint's logs in real time from any browser on your network
On Switch, Checkpoint also provides:
* A rendering backend built on deko3d, which makes the application ~70% smaller than before
* 1080p docked mode support, alongside 720p in handheld
* File-by-file verification after restore, and safer handling of large save restores

==Installation==
Place the .nro to the /switch/ folder on the SD card.

Checkpoint for Switch runs on homebrew launcher. Make sure you're running up-to-date payloads.

==chlink==
Checkpoint comes with chlink, a companion command line app for your PC that talks to Checkpoint's wireless save transfer feature. With chlink you can send save backups from your PC to the console and receive backups from the console to your PC, over your local network - no cables and no SD card swapping required.

Transfers are protected by a 4-digit PIN displayed on the console, and chlink automatically recognizes backups coming from a Checkpoint SD card layout, so title and backup information are filled in for you.

chlink is a single, dependency-free executable available for Windows, macOS and Linux. You can download it from the [https://github.com/BernardoGiordano/Checkpoint/releases/latest releases page], or build it yourself from the <code>tools/chlink</code> folder.

==User guide==
===Working path===
Checkpoint relies on the following folders to store the files it generates. Note that all the working directories are automatically generated on first launch (or when Checkpoint finds a new title that doesn't have a working directory yet).

*<code>sdmc:/switch/Checkpoint</code>: root path
*<code>sdmc:/switch/Checkpoint/logs</code>: log files
*<code>sdmc:/switch/Checkpoint/config.json</code>: custom configuration file
*<code>sdmc:/switch/Checkpoint/saves/<title id> <game title></code>: root path for all the save backups for a generic game

===Configuration===
You can configure Checkpoint directly from the console through the Settings section. All the options that used to require manual edits to the configuration file can now be managed from there. The <code>config.json</code> file is still stored in Checkpoint's working directory, but you're not required to touch it anymore.

===Troubleshooting===
Checkpoint displays error codes when something weird happens or operations fail. If you have any issues, please ensure they haven't already been addressed, and report the error code and a summary of your operations to reproduce it.

Additionally, you can receive real-time support by joining FlagBrew's [https://discord.gg/bGKEyfY Discord] server.

==Controls==
Minus - Instructions

'''Title selection:'''

D-Pad/Joystick - Scroll between titles

L/R - Scroll between pages

A - Enter selected title

B - Exit the selected title

Y - Multiselect title

Hold Y - Selection all titles

'''Menu options:'''

L - Backup save

R - Restore save

X - Delete a backup

==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/checkpointnx2.png

https://dlhb.gamebrew.org/switchhomebrews/checkpointnx3.png

https://dlhb.gamebrew.org/switchhomebrews/checkpointnx4.png

==Media==
'''[Switch] How To Backup & Restore Saves Using Checkpoint''' ([https://www.youtube.com/watch?v=U908bDIgxcE DarkFlare]) 
<youtube>U908bDIgxcE</youtube>

==Known issues==
https://github.com/BernardoGiordano/Checkpoint/issues

==Changelog==
'''4.0.0 2026/07/11'''
* Added: '''complete UI/UX redesign'''
* Added: internazionalization support.
** Translations have been done through the use of LLMs. If you're a native speaker and think that text wording and appearance in the UI can be improved, please submit a pull request or open an issue on this repository.
** Current language support includes English, Italian, French, German, Portuguese, Spanish, Dutch, Japanese and Chinese
* Added: a brand new '''Settings section''': it is now possible to edit Checkpoint's config.json file directly from the console with a nice settings interface.
** Added: '''light and dark mode''' theming
** Added: a folder browser to navigate the SD card and choose additional save folders on device
** Added: quick backup toggle to use the default backup name without any prompt
** Added: confirm restore toggle to avoid being asked for confirmation for save restore operations
** Added: file-by-file verification after restore
* Added: '''complete graphics backend migration from SDL2 to deko3d'''
** Among all the benefits that the rewrite brought to the software, the application size is now '''~70% smaller'''
* Added: '''HTTP log server on port 8000''' — view logs in real-time from any browser on your network.
** Logs can now be accessed from the application directly via Settings > Connectivity > Logs.
* Added: 1080p docked mode support (alongside 720p handheld).
* Fixed: async IO makes file operations faster and more efficient by running them in a worker thread, separated from the main UI thread
* Fixed: backup list navigation is now massively more intuitive
* Added: large save restore with journal pre-extend and mid-file commits, preventing out-of-space failures (fixes [https://github.com/BernardoGiordano/Checkpoint/issues/541 #541]).
* Fixed: avoid restoring files after a corruption error occurred during copy.
* Fixed: the project's code architecture has been greatly improved.
** The codebase is now 9 years old and has never seen an architecture overhaul like this before.
** Dozens of performance, security and safety bugfixes have been pushed to the project, making the app more secure and efficient.
* Removed: '''pksmbridge save transfer feature'''
* Removed: '''cheats feature'''.
** The cheat database required constant updates to stay in sync with game updates, and its maintenance wasn't sustainable.
* Removed: the HTML settings page accessible through local network, and all its dependencies
* Removed: unneeded dependencies like the SDL2 suite and libpng.
* Added: '''chlink''', a companion command line app for your PC that works together with Checkpoint's wireless save transfer feature.
** Send save backups from your PC to the console, or receive them from the console to your PC, over your local network.
** Transfers are protected by a 4-digit PIN displayed on the console.
** chlink automatically recognizes backups stored in a Checkpoint SD card layout, so title and backup information are inferred for you.
** It ships as a single, dependency-free executable for Windows, macOS and Linux, attached to this release.
* General system stability improvements to enhance the user's experience.

'''V3.13.0 2026/06/21'''
* Added: support for 8MB DS cartridges.
* Added: wireless save transfer between 3DS consoles (thanks! [https://github.com/edu1010 @edu1010])
** The feature needs to be enabled via a flag in Checkpoint's configuration file.
* Added: show progress bars for DS cartridge backup and restore operations.
** The previous behaviour made Checkpoint look like it froze. The UX is more interactive now.
* Added: show an additional progress bar for multi-backup operations.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* Fixed: support for latest toolchains and libraries versions.
* General system stability improvements to enhance the user's experience.

'''V3.12.0 2026/05/13'''
* Added: '''support BCAT saves''' on the Switch version of the app.
* Added: '''support device saves''' on the Switch version of the app.
* Added: '''support system saves''' on the Switch version of the app.
** The UI of the app has been slightly upgraded to account for these new save types.
* Added: per-file progress bar.
** The UI will now display two progress bars, one for the overall save progress and one for each file in the save archive.
* Fixed: occasional crash when loading NAND saves on the 3DS version of the app.
* Fixed: Checkpoint should not freeze anymore when performing backup or restore operations.
* Fixed: support asian system fonts in the Switch version of the app.
** This solves an issue where special characters were not rendered in the UI.
* Fixed: add not-empty validation for backup names.
* Fixed: file paths could contain multiple <code>/</code> characters one after the other, causing folder deletion issues.
* Fixed: undefined behaviour when trying to close directories that were not opened.
* Fixed: undefined behaviour could occur when reading a file's size.
* Fixed: log directory read errors.
* General system stability improvements to enhance the user's experience.

'''V3.11.0 2026/02/25'''
* Added: backup and restore modal UI has been greatly improved with a proper progress bar.
* Fixed: an issue with title cache persistence preventing new title installations from being recognized from Checkpoint.
* Fixed: occasional crashes when moving the buttons too fast on the 3DS version of the app.
* Fixed: an issue with the app freezing when holding B to refresh the title cache.
* Fixed: crash when no titles available on the Switch version of the app.
* Fixed: occasional crash when quitting the Switch version of the app.
* Fixed: name and icon of the selected account not updating on certain conditions.
* Fixed: various memory leaks here and there when disposing the application on quit.
* Fixed: properly print strings with percent characters in the logfile.
* Fixed: compiled with latest version of the needed dependencies.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* General system stability improvements to enhance the user's experience.

'''V3.10.2 2025/11/22'''
* Fixed: breaking compatibility issue with latest Switch OS version.
* Fixed: compiled with latest version of the needed dependencies.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* General system stability improvements to enhance the user's experience.

'''v3.10.1 2025/06/22'''
* Fixed: add support for archived, hidden and readonly 3ds save backup folders.
** This bug has been in the codebase from the very beginning. Eventually, we fixed it.
* Fixed: a bug where some text could not be rendered on screen properly.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* General system stability improvements to enhance the user's experience.

'''v3.10.0 2025/04/19'''
* '''Fixed: startup time has been drastically improved: ~50% speedup on uncached boot, ~90% speedup on cached boot.'''
** This has been achieved by profiling the application boot process, and realizing that title cache persistence on the SD card took majority of the loading time. Now this operation is lazily done in a separate thread. It's funny to realize that a badly implemented optimization can become a bottleneck of its own, so take my mistake as a lesson.
** Here's the improvements I had on my console (improvements may vary since they depend on how many games you have on your console):
*** Uncached startup went down from 9.8s to 5.7s
*** Cached startup went down from 5.7s to 0.6s
* '''Added: due to requests from multiple users, Checkpoint can now be updated from Universal Updater.'''
* Fixed: cartridge loading now runs immediately rather than waiting for the title cache to be persisted on the SD card.
* Fixed: properly quit the application gracefully when an handled exception occurs.
* Fixed: initial code refactoring.
* Removed: some redundant logs in the title loader.
* General system stability improvements to enhance the user's experience.
'''v3.9.0 2025/04/14'''
* '''Fixed: the startup crash issue affecting all version since 3.8.0 has been identified and patched.'''
** Huge shoutout to achinech on Discord who volunteered to debug the issue on their console.
** If you still encounter startup crash issues, please notify the team immediately on [https://discord.gg/bGKEyfY Discord] and on GitHub issues.
* '''Fixed: cartridge scanning has been refactored to be way more efficient.'''
** Previously, the software used to poll the cartridge synchronously for every frame of the UI thread. Cartridge scanning is now happening on a separate thread which only runs twice per second.
* Added: a more advanced threading framework ported from PKSM.
* Added: networking support and an integrated HTTP server. This is currently used to provide real-time online access to the application logs, but this code will be useful for future features like self-updating.
* Added: more robust logging ported from PKSM. Logs are stored in the <code>/3ds/Checkpoint/logs</code> folder and are split by date.
** Logs are also accessible at runtime through the integrated HTTP server at the following addresses:
*** <code>http://3ds-ip-address:8000/logs/memory</code> for the logs of Checkpoint's current run
*** <code>http://3ds-ip-address:8000/logs/file</code> for all the logs for the current date
* Added: compiler optimizations are back. This includes link-time optimization and an upgrade from <code>O2</code> to <code>O3</code> compared to v.3.7.4.
* Fixed: better configuration file handling ported from PKSM.
* Fixed: better thread synchronization between UI thread and title loading thread.
* Fixed: wrap the entire program into try-catch blocks to prevent crashes caused by other unhandled exceptions in the future.
* Fixed: few graphics improvements.
* Fixed: readme has been updated with latest screenshots.
* General system stability improvements to enhance the user's experience.
'''v3.8.2 2025/04/02'''
* Added: Initial upgrade from C++17 to C++20
* Added: Built with latest Sharkive's cheats repository
* Fixed: UI has been improved and rendering has been simplified in order to make the screen render faster
* Fixed: the color scheme has been improved (to my liking)
* Fixed: a crash when playing certain games and then going directly into checkpoint afterwards
* Fixed: logs on the Switch version are now split by day. This avoids keeping a huge <code>checkpoint.log</code> file after years of use.
** You can safely remove <code>/switch/Checkpoint/checkpoint.log</code>.
** You can find the new logs under <code>/switch/Checkpoint/logs</code> folder.
** Logs for the 3DS version will be added in the next releases.
* Fixed: dependencies have been updated to their latest version
* Fixed: displayed play time is now rendered correctly
* Fixed: L/R buttons double binding (thanks [https://github.com/Noxor11 @Noxor11])
* Fixed: source compilation (thanks [https://github.com/mrhappyasthma @mrhappyasthma] and [https://github.com/l-austenfeld @l-austenfeld])
* Removed: link time optimizations have been disabled.
** These were originally introduced to strip down some weight off the compiled executable, but the difference is too small to consider this feature useful. LTO has caused some trouble in v3.8.0 on the 3DS version.

'''v3.8.1 2025/03/23'''
* Updated dependencies to their latest version
* Disabled link time optimizations
* Initial upgrade from C++17 to C++20
* Built with latest Sharkive's cheats repository
* Fixed displayed play time
* Fixed L/R buttons double binding (thanks [https://github.com/Noxor11 @Noxor11])
* Fixed source compilation (thanks [https://github.com/mrhappyasthma @mrhappyasthma] and [https://github.com/l-austenfeld @l-austenfeld])

'''v3.8.0 2021/11/13'''
*Fixed: Checkpoint is now compatible again with latest firmware. Compatibility with latest Atmosphère has also been fixed.
**It took some time to this release to be fully working, but it is finally out.
*Added: title sorting by Alphabetical, Last Played and Played Time. (thanks @diwo)
**You can now sort your title list by pressing X. More details are available holding minus.
*Added: Sword & Shield PKSM Bridge support.
**This is a bonus feature for PKSM users. You can enable the PKSM Bridge functionality from the web configuration panel.
*Added: [https://github.com/FlagBrew/Sharkive embedded Sharkive's cheat database] has been updated.
**This counts ~2 years of cheat updates.
*Fixed: support for games containing character ū in their title.
*Fixed: documentation.
*Fixed: compilation with latest libraries (such as libnx 4.2.0).
*Stability improvements and tons of minor code improvements.

'''v3.7.4 2019/12/09'''
*Added compatibility for Atmosphere 0.10.0+. This changes the cheats path from <code>/atmosphere/titles</code> to <code>/atmosphere/contents</code>, so that means this version won't be able to put cheats in place for older Atmosphere versions.
*Fixed: the <code>Aborted by user</code> issue occurring when trying to perform a backup in Applet mode.
**This means that if you're running Checkpoint in Applet mode, you won't be prompted to decide a name for your backup and the default name will be used instead.
**This also solves incompatibilities for CFWs that don't properly support title takeover.
*Fixed: the Account Selection applet won't cause Checkpoint to hang anymore if using Applet mode, if you're running Atmosphere 0.10.0+.

'''v3.7.3 2019/10/26'''
*Fixed: built in FTP server is now able to open the Checkpoint folder, finally letting this feature to be useful for easy and fast save retrieval.
*Fixed: removed red watermark if Checkpoint was launched in applet mode.
**Pro Tip: you shouldn't launch Checkpoint or homebrew in general in applet mode anyways. Please don't.
*Fixed: latest cheats submissions are built in this release through Sharkive.
**If you have cheat codes that are not already available in this release, please submit them to Sharkive's databases here.
*Fixed: unused folders in the SD card are not created anymore.

'''v3.7.2 2019/09/15'''
*Fixed: build compiled with support for system version 9.0.0. Please update to Checkpoint 3.7.2+ in order to be able to run this software on system versions 9.0.0 or superior.
*Fixed: graphics fixes and routine dependancies updates.

'''v3.7.1 2019/09/12'''
*Added: Checkpoint can now run again under applet mode, but:
**It will be very annoying.
**Functionalities may not work properly and memory corruption may happen. Occasionally, the application could hang when trying to access one of the system applets.[https://www.youtube.com/watch?v=-1uxh6wsNLY Watch this video for an example].
**Please do not run Checkpoint in applet mode.
*Fixed: changed port of built in FTP server to 50000.

'''v3.7.0 2019/09/09'''
*Added: Sharkive feature for the Switch as well. A brand new Cheat menu has been implemented inside Checkpoint to be able to manage cheats for Atmosphere.
**The entire cheat database is offline and bundled inside of Checkpoint.
**You're able to select and enable just the cheats you really want to have. This is an alternative approach to cheat toggles.
**Cheat updates will happen when:
***Checkpoint updates.
***You build Checkpoint from source.
***You build the cheat database and place it into the sd card in the expected location, so that it'll be loaded instead of the bundled one.
*Added: Online configurations. You can now configure Checkpoint from your internet browser. Checkpoint will behave as an HTTP server while running.
**Connect to <code>SWITCH_IP_ADDRESS:8000</code> from any device connected to the same network as your Switch to be able to access configurations.
*Added: FTP server. You probably want to be able to get your saves out of the switch once they have been backed up. While I come up with handier solutions, enjoy this non blocking FTP server. You can access connecting to <code>SWITCH_IP_ADDRESS:5000</code> (As of v3.7.1, <code>SWITCH_IP_ADDRESS:50000</code>) with empty username and password.
*Added: redesigned UI. Enjoy it while it's fresh.
*Added: system keyboard support. The custom keyboard originally setup has been removed from Checkpoint to fully take advantage of the system keyboard applet.
*Added: switch pages with L/R.
*Added: logging. Logs will be written to <code>/switch/Checkpoint/checkpoint.log</code>.
*Fixed: favorite sorting now works properly again.
*Fixed: cut down size of the executable. It now stores an entire cheat database inside and still manages to be ~1MB lighter than the previous stable release.
*Fixed: Checkpoint doesn't run anymore if nx-hbmenu is launched over a system applet (like Album).
*Refactoring, refactoring, refactoring...

'''v3.6.0 2019/01/01'''
*Added: a bridge functionality between Checkpoint for Switch and [https://github.com/FlagBrew/PKSM PKSM] (for 3DS, v6.0.0 and above) has been implemented.
**It allows to send (and then receive back) a save file over the network, to allow manipulations without having to browse your save backups manually on your PC.
**It also needs to be manually enabled by editing your configuration file. Once it's enabled, you can access the bridge by pressing <code>L+R</code> on a valid game.
**This feature currently works only with LGPE.
*Fixed: buttons are now responsive as before while navigating the UI.
*Fixed: titles with black background are now displayed properly.
*Fixed: checkmark color doesn't confuse with title icons anymore.
*Fixed: text doesn't bleed textboxes like before anymore.

'''v3.5.0 2019/10/28'''
*Added support for Hardware Acceleration. Checkpoint now relies on the GPU to render graphics and text, removing load from the CPU.
**The interface now relies on SDL2 to render images and text.
**Text rendering is optimized by using a customized version of SDL_FontCache which caches glyphs in memory rather than creating textures every frame. This also allows to use the system font already available in the console.
**Checkpoint caches from PlSharedFontType_Standard and PlSharedFontType_NintendoExt fonts, so both regular characters and symbols are now supported to be rendered on screen.
*Added option to set a title as Favorite. You can now edit your configuration file to set a title id to be a favorite title, so this will always appear at the top of the title list.
*Fixed crashes caused by too many file descriptors opened.
*Key behaviour changed. ( thanks @IBNobody )
**You can now select rows in the backup list, creating backups and restoring a backup just with the button A.
**Pressing Y will select the current title but deactivate/reset the backup list. It will also enable the backup touch button only. Creating a backup will then disable the backup touch button. This makes it more clear to the user what buttons / UI elements are relevant to multi-backup.
*Fixed occasional crashes while changing account.
*Checkpoint now uses latest libnx 1.5.0, which supports timezone and fixes wrong default backup names if your console never connected to internet.
*Checkpoint is now compiled using C++17.

'''v3.4.2 2019/09/04'''
*Fix compatibility with certain games and CFWs. Now Checkpoint is fully compatible with custom firmwares using <code>fs_mitm</code>, <code>layeredfs</code> and other modules massively relying on file operations.
**Confirmed working on both hekate, Atmosphere and ReiNX using said modules.
**Other CFWs may be compatible as well, even if not directly tested.
**The issue was caused by a poorly optimized function to recursively delete folders, which has been now replaced by the one available on JKSV, too.
*Fixed configuration override after updating Checkpoint version.
*Avoid using a separate thread to populate titles.
*Default selected button for the homebrew keyboard is now <code>OK</code> (thanks @fennectech).

'''v3.4.1 2018/08/17'''
*Fixed corrupted save backup folders if your Account name contains non-ascii characters.
*You can now properly cancel a backup if you press B from the keyboard screen.
*Fixed parallel building.
*Code cleanup and multiple minor fixes.

[https://github.com/BernardoGiordano/Checkpoint/releases Release notes.]

==Building==
devkitA64 is required to compile Checkpoint for Switch. Learn more at [https://devkitpro.org/wiki/Getting_Started devkitpro.org]. Install or update dependencies with <code>dkp-pacman -S libnx switch-pkg-config deko3d switch-freetype switch-libjpeg-turbo</code>.

Build from the repository root with <code>make switch</code>.

==License==
This project is licensed under the GNU GPLv3. Additional Terms 7.b and 7.c of GPLv3 apply to this. See [https://github.com/BernardoGiordano/Checkpoint/blob/master/LICENSE LICENSE.md] for details.

==Credits==
*[https://github.com/BernardoGiordano/ Bernardo] for creating Checkpoint.
*[https://github.com/J-D-K J-D-K] for the original [https://github.com/J-D-K/JKSM JKSM] version.
*[https://github.com/tuxsh TuxSH] for [https://github.com/TuxSH/TWLSaveTool TWLSaveTool], from which SPI code has been taken.
*WinterMute, fincs and [https://devkitpro.org/ devkitPro] contributors for devkitARM, devkitA64 and [https://github.com/devkitPro/pacman/releases dkp-pacman].
*Yellows8 and all the mantainers for [https://github.com/switchbrew/switch-examples switch-examples].
*[https://twitter.com/rakujira rakujira] for the awesome Checkpoint logo.
*Fellow testers and troubleshooters for their help.
*The huge amount of supporters that this project has gained over the years.

== External links ==
* Official website - https://flagbrew.org/
* GitHub - https://github.com/FlagBrew/Checkpoint
* GBAtemp - https://gbatemp.net/threads/release-checkpoint-a-fast-and-simple-save-manager-for-3ds-and-switch.503899/
* Homebrew App Store - https://apps.fortheusers.org/switch/Checkpoint

Checkpoint 3DS

2026-07-12T04:53:28Z

HydeWing:

{{Infobox 3DS Homebrews
|title=Checkpoint
|image=Checkpoint2.png
|description=Fast and simple homebrew save manager for 3DS and Switch.
|author=FlagBrew
|lastupdated=2026/07/11
|type=Save Managers and Editors
|version=4.0.0
|license=GPL-3.0
|download=https://github.com/BernardoGiordano/Checkpoint/releases
|website=https://flagbrew.org/
|source=https://github.com/FlagBrew/Checkpoint
|donation=https://patreon.com/FlagBrew
}}

Checkpoint is a fast and simple homebrew save manager for 3DS and [[Checkpoint Switch|Switch]] written in C++. The UI has been designed to condense as many options as possible, while keeping it simple to work with.

Checkpoint for 3DS natively supports 3DS and DS cartridges, digital standard titles and demo titles. It also automatically checks and filters homebrew titles which may not have a save archive to backup or restore, which is done without an external title list and filters. For this reason, Checkpoint doesn't need constant user maintenance to retain full functionality.

==Features==
Checkpoint backs up and restores save data for:
* 3DS: 3DS cartridges and digital titles (including demos), extdata, DS cartridges, DSiWare and GBA Virtual Console titles
* Switch: saves for the titles you have played, with title information loaded automatically
Both versions share the same core feature set:
* A completely redesigned user interface, with light and dark mode theming
* A Settings section to configure everything directly from the console: favorites, filters, additional save folders and more, with no manual file editing required
* Internationalization support: English, Italian, French, German, Portuguese, Spanish, Dutch, Japanese and Chinese
* Fast, responsive file operations: backups and restores run on a worker thread, and backups can be cancelled while in progress
* Additional save folders, configurable per title through a built-in folder browser
* A background FTP server, to access your save backups directly from your PC
* Wireless save transfer between consoles
* An HTTP log server, to view Checkpoint's logs in real time from any browser on your network
On Switch, Checkpoint also provides:
* A rendering backend built on deko3d, which makes the application ~70% smaller than before
* 1080p docked mode support, alongside 720p in handheld
* File-by-file verification after restore, and safer handling of large save restores

==Installation==
3DS version is available in 3DSX and CIA ([https://github.com/FlagBrew/Checkpoint/releases QR code]).

Works for both CFW and Rosalina-based Homebrew Launchers (hax-based Homebrew Launchers are not supported by Checkpoint).

==chlink==
Checkpoint comes with chlink, a companion command line app for your PC that talks to Checkpoint's wireless save transfer feature. With chlink you can send save backups from your PC to the console and receive backups from the console to your PC, over your local network - no cables and no SD card swapping required.

Transfers are protected by a 4-digit PIN displayed on the console, and chlink automatically recognizes backups coming from a Checkpoint SD card layout, so title and backup information are filled in for you.

chlink is a single, dependency-free executable available for Windows, macOS and Linux. You can download it from the [https://github.com/BernardoGiordano/Checkpoint/releases/latest releases page], or build it yourself from the <code>tools/chlink</code> folder.

==User guide==
You can use Checkpoint for 3DS with both cfw and Rosalina-based Homebrew Launchers. *hax-based Homebrew Launchers are not supported by Checkpoint.

The first launch will take longer than usual, due to the working directories being created - Checkpoint will be significantly faster upon launch from then on.

===Working path===
Checkpoint relies on the following folders to store the files it generates. Note that all the working directories are automatically generated on first launch (or when Checkpoint finds a new title that doesn't have a working directory yet).

* <code>sdmc:/3ds/Checkpoint</code> Root path.
* <code>sdmc:/3ds/Checkpoint/config.json</code> Configuration file.
* <code>sdmc:/3ds/Checkpoint/logs</code> Log files
* <code>sdmc:/3ds/Checkpoint/saves/<unique id> <game title></code> Root path for all the save backups for a generic game.
* <code>sdmc:/3ds/Checkpoint/extdata/<unique id> <game title></code> Root path for all the extdata backups for a generic game.

===FAQ===
'''Q. Checkpoint displays error codes.'''

You may see error codes when something weird happens or operations fail. If you have any issues:
* Please ensure if they haven't already been addressed ([https://github.com/FlagBrew/Checkpoint/issues Reported List]).
* Report the error code and a summary of your operations to reproduce it.

Additionally, you can receive real-time support by joining FlagBrew's [https://discord.gg/bGKEyfY Discord server].

==Controls==
D-Pad/L/R - Scroll between the title list

A - Target a title

D-Pad or Touchscreen - Choose a target backup to restore/overwrite

==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/checkpoint2.png

==Media==
'''Checkpoint cheats tutorial''' ([https://www.youtube.com/watch?v=o7mdfoZbJE0 Ikeb0mb]) 
<youtube>o7mdfoZbJE0</youtube>

==Changelog==
'''4.0.0 2026/07/11'''
* Added: '''GBA Virtual Console save backup and restore''' (thanks [https://github.com/LiquidFenrir @LiquidFenrir])
* Added: '''DSiWare save backup and restore''' (thanks [https://github.com/SNBeast @SNBeast] for the feature PoC)
* Added: '''complete UI/UX redesign'''
* Added: '''background FTP server'''. Access your save backups from the PC directly through Checkpoint
* Added: a brand new '''Settings section''': it is now possible to edit Checkpoint's config.json file directly from the console with a nice settings interface.
** Added: '''light and dark mode''' theming
** Added: a folder browser to navigate the SD card and choose additional save folders on device
** Added: quick backup toggle to use the default backup name without any prompt
** Added: confirm restore toggle to avoid being asked for confirmation for save restore operations
* Added: it is now possible to configure additional save folders for DS titles.
* Added: internazionalization support.
** Translations have been done through the use of LLMs. If you're a native speaker and think that text wording and appearance in the UI can be improved, please submit a pull request or open an issue on this repository.
** Current language support includes English, Italian, French, German, Portuguese, Spanish, Dutch, Japanese and Chinese
* Added: backup cancellation by holding B during backup
* Fixed: backup list navigation is now massively more intuitive
* Fixed: async IO makes file operations faster and more efficient by running them in a worker thread, separated from the main UI thread
* Fixed: greatly improved cached and uncached title loading times
* Fixed: cached text storage now allows faster rendering for all the text in the interface
* Fixed: the project's code architecture has been greatly improved.
** The codebase is now 9 years old and has never seen an architecture overhaul like this before.
** Dozens of performance, security and safety bugfixes have been pushed to the project, making the app more secure and efficient.
* Fixed: an issue where swapping DS carts would crash Checkpoint because of a stack-smashing bug
* Removed: '''cheats feature'''.
** The cheat database required constant updates to stay in sync with game updates, and its maintenance wasn't sustainable.
* Added: '''chlink''', a companion command line app for your PC that works together with Checkpoint's wireless save transfer feature.
** Send save backups from your PC to the console, or receive them from the console to your PC, over your local network.
** Transfers are protected by a 4-digit PIN displayed on the console.
** chlink automatically recognizes backups stored in a Checkpoint SD card layout, so title and backup information are inferred for you.
** It ships as a single, dependency-free executable for Windows, macOS and Linux, attached to this release.
* General system stability improvements to enhance the user's experience.

'''V3.13.0 2026/06/21'''
* Added: support for 8MB DS cartridges.
* Added: wireless save transfer between 3DS consoles (thanks! [https://github.com/edu1010 @edu1010])
** The feature needs to be enabled via a flag in Checkpoint's configuration file.
* Added: show progress bars for DS cartridge backup and restore operations.
** The previous behaviour made Checkpoint look like it froze. The UX is more interactive now.
* Added: show an additional progress bar for multi-backup operations.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* Fixed: support for latest toolchains and libraries versions.
* General system stability improvements to enhance the user's experience.

'''V3.12.0 2026/05/13'''
* Added: '''support BCAT saves''' on the Switch version of the app.
* Added: '''support device saves''' on the Switch version of the app.
* Added: '''support system saves''' on the Switch version of the app.
** The UI of the app has been slightly upgraded to account for these new save types.
* Added: per-file progress bar.
** The UI will now display two progress bars, one for the overall save progress and one for each file in the save archive.
* Fixed: occasional crash when loading NAND saves on the 3DS version of the app.
* Fixed: Checkpoint should not freeze anymore when performing backup or restore operations.
* Fixed: support asian system fonts in the Switch version of the app.
** This solves an issue where special characters were not rendered in the UI.
* Fixed: add not-empty validation for backup names.
* Fixed: file paths could contain multiple <code>/</code> characters one after the other, causing folder deletion issues.
* Fixed: undefined behaviour when trying to close directories that were not opened.
* Fixed: undefined behaviour could occur when reading a file's size.
* Fixed: log directory read errors.
* General system stability improvements to enhance the user's experience.

'''V3.11.0 2026/02/25'''
* Added: backup and restore modal UI has been greatly improved with a proper progress bar.
* Fixed: an issue with title cache persistence preventing new title installations from being recognized from Checkpoint.
* Fixed: occasional crashes when moving the buttons too fast on the 3DS version of the app.
* Fixed: an issue with the app freezing when holding B to refresh the title cache.
* Fixed: crash when no titles available on the Switch version of the app.
* Fixed: occasional crash when quitting the Switch version of the app.
* Fixed: name and icon of the selected account not updating on certain conditions.
* Fixed: various memory leaks here and there when disposing the application on quit.
* Fixed: properly print strings with percent characters in the logfile.
* Fixed: compiled with latest version of the needed dependencies.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* General system stability improvements to enhance the user's experience.

'''V3.10.2 2025/11/22'''
* Fixed: breaking compatibility issue with latest Switch OS version.
* Fixed: compiled with latest version of the needed dependencies.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* General system stability improvements to enhance the user's experience.

'''v3.10.1 2025/06/22'''
* Fixed: add support for archived, hidden and readonly 3ds save backup folders.
** This bug has been in the codebase from the very beginning. Eventually, we fixed it.
* Fixed: a bug where some text could not be rendered on screen properly.
* Added: cheat database updated to latest [https://github.com/FlagBrew/Sharkive Sharkive] release.
* General system stability improvements to enhance the user's experience.

'''v3.10.0 2025/04/19'''
* '''Fixed: startup time has been drastically improved: ~50% speedup on uncached boot, ~90% speedup on cached boot.'''
** This has been achieved by profiling the application boot process, and realizing that title cache persistence on the SD card took majority of the loading time. Now this operation is lazily done in a separate thread. It's funny to realize that a badly implemented optimization can become a bottleneck of its own, so take my mistake as a lesson.
** Here's the improvements I had on my console (improvements may vary since they depend on how many games you have on your console):
*** Uncached startup went down from 9.8s to 5.7s
*** Cached startup went down from 5.7s to 0.6s
* '''Added: due to requests from multiple users, Checkpoint can now be updated from Universal Updater.'''
* Fixed: cartridge loading now runs immediately rather than waiting for the title cache to be persisted on the SD card.
* Fixed: properly quit the application gracefully when an handled exception occurs.
* Fixed: initial code refactoring.
* Removed: some redundant logs in the title loader.
* General system stability improvements to enhance the user's experience.
'''v3.9.0 2025/04/14'''
* '''Fixed: the startup crash issue affecting all version since 3.8.0 has been identified and patched.'''
** Huge shoutout to achinech on Discord who volunteered to debug the issue on their console.
** If you still encounter startup crash issues, please notify the team immediately on [https://discord.gg/bGKEyfY Discord] and on GitHub issues.
* '''Fixed: cartridge scanning has been refactored to be way more efficient.'''
** Previously, the software used to poll the cartridge synchronously for every frame of the UI thread. Cartridge scanning is now happening on a separate thread which only runs twice per second.
* Added: a more advanced threading framework ported from PKSM.
* Added: networking support and an integrated HTTP server. This is currently used to provide real-time online access to the application logs, but this code will be useful for future features like self-updating.
* Added: more robust logging ported from PKSM. Logs are stored in the <code>/3ds/Checkpoint/logs</code> folder and are split by date.
** Logs are also accessible at runtime through the integrated HTTP server at the following addresses:
*** <code>http://3ds-ip-address:8000/logs/memory</code> for the logs of Checkpoint's current run
*** <code>http://3ds-ip-address:8000/logs/file</code> for all the logs for the current date
* Added: compiler optimizations are back. This includes link-time optimization and an upgrade from <code>O2</code> to <code>O3</code> compared to v.3.7.4.
* Fixed: better configuration file handling ported from PKSM.
* Fixed: better thread synchronization between UI thread and title loading thread.
* Fixed: wrap the entire program into try-catch blocks to prevent crashes caused by other unhandled exceptions in the future.
* Fixed: few graphics improvements.
* Fixed: readme has been updated with latest screenshots.
* General system stability improvements to enhance the user's experience.
'''v3.8.2 2025/04/02'''
* Added: Initial upgrade from C++17 to C++20
* Added: Built with latest Sharkive's cheats repository
* Fixed: UI has been improved and rendering has been simplified in order to make the screen render faster
* Fixed: the color scheme has been improved (to my liking)
* Fixed: a crash when playing certain games and then going directly into checkpoint afterwards
* Fixed: logs on the Switch version are now split by day. This avoids keeping a huge <code>checkpoint.log</code> file after years of use.
** You can safely remove <code>/switch/Checkpoint/checkpoint.log</code>.
** You can find the new logs under <code>/switch/Checkpoint/logs</code> folder.
** Logs for the 3DS version will be added in the next releases.
* Fixed: dependencies have been updated to their latest version
* Fixed: displayed play time is now rendered correctly
* Fixed: L/R buttons double binding (thanks [https://github.com/Noxor11 @Noxor11])
* Fixed: source compilation (thanks [https://github.com/mrhappyasthma @mrhappyasthma] and [https://github.com/l-austenfeld @l-austenfeld])
* Removed: link time optimizations have been disabled.
** These were originally introduced to strip down some weight off the compiled executable, but the difference is too small to consider this feature useful. LTO has caused some trouble in v3.8.0 on the 3DS version.

'''v3.8.1 2025/03/23'''
* Updated dependencies to their latest version
* Disabled link time optimizations
* Initial upgrade from C++17 to C++20
* Built with latest Sharkive's cheats repository
* Fixed displayed play time
* Fixed L/R buttons double binding (thanks [https://github.com/Noxor11 @Noxor11])
* Fixed source compilation (thanks [https://github.com/mrhappyasthma @mrhappyasthma] and [https://github.com/l-austenfeld @l-austenfeld])

'''3.8.0 2021/11/13'''

3DS:
* Added: embedded Sharkive's cheat database has been updated.
** This counts ~2 years of cheat updates.
* Fixed: optional 3DS cartridge polling.
* Fixed: documentation.
* Stability improvements and tons of minor code improvements.

'''3.7.3 2019/10/26'''

3DS:
* Added: Checkpoint now shows the original icon for DS cartridges.
* Fixed: a very annoying crash during startup if you had a very little amount of games has been fixed.
* Fixed: latest cheats submissions are built in this release through Sharkive.
** If you have cheat codes that are not already available in this release, please submit them to Sharkive's databases here.
* Fixed: unused folders in the SD card are not created anymore.

'''3.7.1 2019/09/12'''

3DS:
* Fixed: hard crash on startup has been fixed.
** Card scanning has been permanently shut down for this release to mitigate the error.
** If you still encounter this issue, please file an issue on this repo so that we can research about it more.

'''3.7.0 2019/09/09'''

3DS:
* Added: Sharkive is now merged into Checkpoint. A brand new Cheat menu has been implemented inside Checkpoint to be able to manage cheats for Luma3DS.
** The entire cheat database is offline and bundled inside of Checkpoint. No more internet required, no more molasses slow loading times caused by cheat downloads.
** You're able to select and enable just the cheats you really want to have. This solves issues caused by cheat files too big to be fully displayed in Luma3DS' cheat engine.
** Cheat updates will happen when:
*** Checkpoint updates.
*** You build Checkpoint from source.
*** You build the cheat database and place it into the sd card in the expected location, so that it'll be loaded instead of the bundled one.
** This feature deprecates Sharkive.
* Added: ability to change play coins. Lots of you kept requesting this all the time. I don't know why you want this feature so much, but here it is. You can access it by hovering the Activity Log NAND title or by pressing SELECT + tapping the top-right corner.
* Added: redesigned UI. Enjoy it while it's fresh.
* Added: optional cartridge hotswap. You can now choose from the configuration if you want to be able to hotswap the cartridge while Checkpoint is running.
** This is disabled by default. Downside of this feature being enabled is that the UI slows down for a couple seconds before being responsive during boot time.
* Added: logging. Logs will be written to /3ds/Checkpoint/checkpoint.log.
** This feature deprecates JEDECheck.
* Fixed: cart is not cached anymore. This means cache won't be rebuilt every time you swap cartridges before running Checkpoint.
* Fixed: favorite sorting now works properly again.
* Fixed: cut down size of the executable. It now stores an entire cheat database inside of it (~1.6MB json), functionalities from other two different applications and still manages to be basically equal in size compared to the old stable release.
* Refactoring, refactoring, refactoring.

'''3.6.0 2019/01/01'''

3DS:
* Added: a check for *hax environment has been introduced to avoid Checkpoint loading without CFW.
* Fixed: buttons are now responsive as before while navigating the UI.
* Fixed: Extdata is now restored properly even when files change size.

[https://github.com/BernardoGiordano/Checkpoint/releases Revision history.]

==Building==
devkitARM is required to compile Checkpoint for 3DS. Learn more at [https://devkitpro.org/wiki/Getting_Started devkitpro.org]. Install or update dependencies with <code>dkp-pacman -S libctru citro3d citro2d tex3ds</code>.

Build from the repository root with <code>make 3ds</code>.

==License==
This project is licensed under the GNU GPLv3. Additional Terms 7.b and 7.c of GPLv3 apply to this. See [https://github.com/BernardoGiordano/Checkpoint/blob/master/LICENSE LICENSE.md] for details.

==Credits==
Even though this is the result of independent research and work, Checkpoint for 3DS couldn't be possible without J-D-K's original [[JKSM 3DS|JKSM]] version.

TuxSH for [https://github.com/TuxSH/TWLSaveTool TWLSaveTool], from which SPI code has been taken.

WinterMute, fincs and [https://devkitpro.org devkitPro] contributors for devkitARM, devkitA64 and [https://github.com/devkitPro/pacman/releases dkp-pacman].

Yellows8 and all the mantainers for [https://github.com/switchbrew/switch-examples switch-examples].

[https://twitter.com/rakujira rakujira] for the Checkpoint logo.

Fellow testers and troubleshooters for the help.

==External links==
* Discord - https://discord.gg/bGKEyfY
* GitHub - https://github.com/FlagBrew/Checkpoint
* Bountysource - https://www.bountysource.com/teams/checkpoint
* GBAtemp - https://gbatemp.net/threads/release-checkpoint-a-fast-and-simple-save-manager-for-3ds-and-switch.503899

PKHeX 3DS

2026-07-10T03:30:38Z

HydeWing: 26.07.07

{{Infobox 3DS Homebrews
|title=PKHeX
|image=Pkhex2.png
|description=Pokemon core series save editor, programmed in C#.
|author=Kaphotics
|lastupdated=2026/07/07
|type=Save Editors
|version=26.07.07
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/3dshomebrews/pkhex.7z
|website=https://projectpokemon.org/home/files/file/1-pkhex
|source=https://github.com/kwsch/PKHeX
}}
PKHeX is an open-source save file editor for the main series of Pokémon games, allowing you to transfer Pokémon data between saves, customize them to your liking, and much more.

==User guide==
PKHeX expects save files that are not encrypted with console-specific keys. Use a savedata manager to import and export savedata from the console ([[Checkpoint 3DS|Checkpoint]], save_manager, [[JKSM 3DS|JKSM]], or SaveDataFiler).

===Supported files===
* Save files ("main", *.sav, *.dsv, *.dat, *.gci, *.bin).
* GameCube Memory Card files (*.raw, *.bin) containing GC Pokémon savegames.
* Individual Pokémon entity files (.pk*, *.ck3, *.xk3, *.pb7, *.sk2, *.bk4).
* Mystery Gift files (*.pgt, *.pcd, *.pgf, .wc*) including conversion to .pk*.
* Importing GO Park entities (*.gp1) including conversion to .pb7.
* Importing teams from Decrypted 3DS Battle Videos.
* Transferring from one generation to another, converting formats along the way.
* Data is displayed in a view which can be edited and saved. The interface can be translated with resource/external text files so that different languages can be supported.

===Showdown Sets===
Showdown sets can be imported and exported for the Pokémon currently loaded to the tabs. Party and Battle Box may only be exported.

To export a showdown set from tabs:
* Press CTRL-SHIFT-T, or
* ALT click the Species label, or
* Tools > Showdown > Export Set to Clipboard.

To import a showdown set to tabs:
* Press CTRL-T, or
* CTRL click the Species label, or
* Tools > Showdown > Import Set from Clipboard.

Exporting Party/Battle Box sets:
* Click on the "Party" or "Battle Box" label directly above the sprites, or
* Tools > Showdown > Export Party to Clipboard, or
* Tools > Showdown > Export Battle Box to Clipboard.

===PKHeX's Database===
PKHeX is able to create a 'pkmdb' folder and store pkm files from all generations for later use. Consider it like a Pokémon Bank.
* The Database may be accessed via Tools > Data > Database, or by pressing CTRL-D.
* Pokémon from the active save file will also appear in the Database.
* You can search to find certain properties via the options on the right side of the window.

What can you do with the results?
* View - Loads into the Main window to view all properties, and can be set into the save file.
* Delete - Can be removed from the database (no undo).

You may additionally use the script command format used by the Batch Editor to do more advanced searching:
* To access the input region, Tools > Search Settings > Advanced Search or press CTRL-A.
* Advanced Search filtering is done after the regular GUI filters on the right side are processed.
* Refer to the Batch Editor tutorial for questions regarding figuring out what to enter.

===Transferring between Generations===
PKHeX only supports methods of transfer that the games support, emulating the official method of transferring for you.

Transferring can only be done forwards. For example, a pk7 cannot be imported to previous generations. There are multiple ways to accomplish a transfer:
* Individual Transfer:
** Open two instances of PKHeX, one with the source save and one with the destination save.
** Drag and Drop between the two windows.
* Bulk Transfer:
** Open the source Save File. At the top of the main window, select Tools > Data > Dump Boxes.
** You may choose to save to PKHeX's Database, or you may save to a Folder (highly recommend).
** Open the destination Save File in another instance of PKHeX.
** Drop the folder of PKM's on the save file.
** The box contents of the destination save file will be overwritten so that all PKM files have been imported.

===Using the Batch Editor===
Be cautious when using Batch Editor, because there is no undo:
* If you modify the contents of a Folder, the changes are permanent to those files.
* If you modify the contents of a Save File, the changes are permanent unless you re-load the Save File.

The Batch Editor is a powerful tool in which the user can make mass modifications to Pokémon in either their save file or supplied folder. By using the built in 'script builder', you may select from properties to either 'set' them or filter according to its value. There are three types of 'script commands' that may be entered:
* <code>.</code> - This sets the property of the Pokémon equal to the value.
* <code>.=</code> - This requires the property to be EQUAL to the value.
* <code>.!</code> - This requires the property to be NOT EQUAL to the valueIf a 'filter' (=,!) is not satisfied, the Pokémon is skipped.

The script interpreter is smart enough to understand the difference between numbers, strings, and booleans; quotation marks are interpreted literally and should not be used. A hint of the value type is provided beneath the dropdown.

Empty or invalid slots are skipped by default. A slot / file must have a valid Pokémon in order to be modified. Example:
=Box=1
!Slot=1
.Species=7
=IsNicknamed=false

Filters are interpreted first. Even though the "=IsNicknamed=false" appears after the ".Species=7" command, the batch editor will require all filters to be satisfied before any modifications are made. To explain what the above script does, it requires the Pokémon to be in the first box, but not in the first slot, and to be not nicknamed. It then sets the Species ID to 7 (Squirtle).

===Batch Editor Special Tricks===
* The Batch Editor window references the PKM that is currently viewed in the editing tabs.
** If you select a property name, the Batch Editor will indicate whether or not the tabs PKM has that property.
** If the tabs PKM has that property, the Batch Editor will display the property's current value as well as the data type (number, text, etc).
* To Randomize a PID, use ".PID=$rand".
* To Randomize EncryptionConstant, use ".EncryptionConstant=$rand"
* To Randomize a value within a range, use ".Nature=$x,y" for an inclusive range of [x,y].
* To make a Pokémon Shiny: use ".PID=$shiny".
* To copy the Encryption Constant to the PID, use ".EC=PID".
* To delete a Pokémon, use ".Species=0".
* To set a date (Met / EggMet), use yyyyMMdd for the string.
** Example: ".MetDate=20160409" will set the Met Date to April 9th, 2016.
* Suggestions can be automatically applied for Moves, RelearnMoves, and Met_Location.
** Example: "Moves=$suggest" will retrieve and apply suggested moves from the legality interpreter, same as if you clicked on the Moves groupbox in the tabs editor.
* Legality can be used as a filter. Use "=Legal=false" to only modify illegal Pokémon.
* A full up to date list is available by reading the source code (BatchEditor.cs, ProcessPKM method).

Remember that certain formats/generations do not always have future properties. There are many applications of the Batch Editor including mass hatching, deleting, making everything shiny, or clearing EVs from all applicable Pokémon.

===FAQ===
'''Q. Is PKHeX available for the Macintosh OS or Linux?'''

No. You can use software like Wine/Mono to run it on these operating systems, however the program may not function as intended.

'''Q> My Pokémon won't work on WiFi battles or can't be traded. Why?'''

This is usually a Pokémon legality issue. These problems aren't dealt with in the PKHeX subforum; see the announcement regarding cheating online.

'''Q. What is the Mystery Gift "Received List"?'''

Every Gift has a unique ID associated with it. When you receive a Mystery Gift the game flags your save file as having obtained the gift, and doesn't allow it to be obtained again.

PKHeX will set the used IDs for you; an ID can be deleted by right clicking the ID and choosing to "Delete".

'''Q. Can PKHeX create backups automatically?'''

Yes, create a "bak" folder in the same location as the executable, and PKHeX will export a backup of every new save you load.

'''Q. (Gen 7, 6) Is PKHeX compatible with Powersaves or Sky3DS?'''

No. It never will be. Save files must be decrypted in order to load & save, and must be resigned before put back into your cart data.

'''Q. (Gen 5, 4, 3) I'm using a flash card (R4, Acekard, etc) or emulator and my save file isn't able to be loaded. What's going wrong?'''

Make sure the save data is in 4 megabit format (512KB) for Gen4/5 games, and 128KB flash for Gen3 games.

'''Q. (Gen 2, 1) Does PKHeX support these games?

Yes Be sure you are exporting your save file in the "Battery" format (raw save file, not emulator specific).

===Useful links===
* [https://projectpokemon.org/home/files/file/1-pkhex/ PKHex Project page].
* [https://projectpokemon.org/home/forums/topic/38168-frequently-asked-questions/ Frequently Asked Questions].
* [https://projectpokemon.org/home/tutorials/save-editing/using-pkhex/ Using PKHeX] - A set of tutorials about how to use certain aspects of PKHeX.
* [https://projectpokemon.org/home/forums/forum/83-pkhex/ Support Forum] - Post here if you have questions or found bugs.
* [https://www.reddit.com/r/PokemonCreate/wiki/pkhex/ The Beginner's Guide to PKHeX] - From PokemonCreate Reddit.

==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/pkhex3.png
https://dlhb.gamebrew.org/3dshomebrews/pkhex4.png

https://dlhb.gamebrew.org/3dshomebrews/pkhex7.png
https://dlhb.gamebrew.org/3dshomebrews/pkhex8.png

https://dlhb.gamebrew.org/3dshomebrews/pkhex5.png
https://dlhb.gamebrew.org/3dshomebrews/pkhex6.png

==Media==
'''How To Use PKHeX - Official Tutorial (2022) Sword/Shield/BDSP/Legends Arceus''' ([https://www.youtube.com/watch?v=t7uQ26s_pkY KlutchxGaming]) 
<youtube>t7uQ26s_pkY</youtube>

==Known issues==
GNU/Linux is not the main Operating System of developers of this program so there may be bugs; some may come from non GNU/Linux specific code of Mono/Wine, so other users may not be able to reproduce the error you are experiencing.

==Changelog==
'''26/07/07'''
* Legality:
** Added: Handling for HOME 4.0.0 absolute (float) size mismatches with Legends: Arceus.
** Added: Handling for HOME BD/SP "None" location remapping unused location IDs.
** Added: Handling for Gen1/2=>Gen7 Virtual Console bugged current PP values. Thanks [https://github.com/Lusamine @Lusamine], [https://github.com/santacrab2 @santacrab2], [https://github.com/Bowarcky @Bowarcky] !
** Added: New check for Effort Value gains when not possible (no EXP gained or any other mechanic), like on Eggs.
** Fixed: Matching errors for HG/SS swarm & safari and R/S/E swarms resolved.
** Fixed: Mystery Gifts generated from encounter now respect IVs if requested.
** Fixed: Gen5 handling of Basculin ability mismatches is now correct while in Gen5 format.
** Fixed: Relaxed rules for Gen4 Korean <-> International trades via GTS. Thanks [https://github.com/abcboy101 @abcboy101] !
* Added: Inventory editor now displays item sprite (if available) for a better visual editing experience.
* Added: Experience Bar is now indicated in the PKM editor. Can be hidden via Settings. Scroll/Drag & Shift/Alt modifiers can edge.
* Added: Tools/Troubleshooting - Hex Import (from Clipboard) and Plugin Info.
* Added: Tools/Troubleshooting - Save file force loader added to bypass sanity checks for corrupted save files.
* Added: Gen4 HG/SS Pokéathlon editor added.
* Added: Gen5 B2/W2 Join Avenue editor added.
* Added: Gen5 B2/W2 Medal dedicated editor added.
* Added: Gen5 Pokémon Global Link status editor added.
* Added: Settings now auto-detects dark mode on new settings.
* Added: Settings can now configure high Dpi text for high Dpi monitors.
* Added: Settings can now configure hover/set exports to show Champions-style EVs.
* Added: Settings can now configure the number of rows the Encounter/PKM/Mystery Gift Database.
* Fixed: Gen3 RSBox Pokémon no longer read erroneous status conditions.
* Fixed: Gen8a/9 inventory give all items no longer gives unobtainable items.
* Fixed: Gen8a extra byte indexes fixed, now shows correct unused data structure indexes. Thanks [https://github.com/gcolotti @gcolotti] !
* Changed: Stat Nature renamed to Stat Alignment to match official terminology.
* Changed: Save File editor buttons in the SAV tab are now bigger, and the quick-actions are auto-sized.
* Changed: Program settings editor now shows horizontal tabs for each settings category rather than vertical.
* Changed: Program language selection now displays all options in a list rather than having to click a drop-down.
* Changed: Translations for the Settings editor, box export, and About/Shortcuts now provided. Thanks [https://github.com/doomsday616 @doomsday616] !
'''26/05/05'''
* Legality: Updated handling for HOME=>ZA transfers.
** Added: Gen9a HOME gifts are now recognized. Thanks [https://github.com/Manu098vm @Manu098vm] !
** Added: Gen9a HOME 4.0.0 scale reset handling. Thanks ILCA !
** Added: Gen9 Hisuian Zoroark WC9 being forced to Max size is now recognized as legal.
** Added: Gen3 default trainer trash bytes are now handled, and regular OT trash bytes are more tightly checked.
** Fixed: Gen8+ Shedinja with affixed ribbons now correctly check when ribbon is missing (due to evolution creation).
** Fixed: Gen4 Evolution Move checks now work properly when transferred to Gen8+ with a met level of 100 (Gen4=>Gen5).
** Fixed: Gen4 HG/SS Bug Catching Contest/Safari encounters now correctly check for the 4x 31IV reroll attempts. Thanks Unknown Warrior!
** Fixed: Gen2 Odd Egg IVs are now enforced. Thanks [https://github.com/ry4242 @ry4242] !
** Fixed: Gen1 Trade Evolution outsider check no longer throws an error. Thanks MrCMFTRBLE !
* Added: Gen6 XY Battle Chateau Rank can now be changed. Thanks [https://github.com/joelsrzalvarez @joelsrzalvarez] !
* Added: Gen4 HG/SS save files now differentiate between versions.
* Added: Gen3 Mirage Island appear cheat button to match first party slot PID, making the island appear for the day.
* Fixed: Box export now always saves party stats rather than leaving blank.
* Fixed: Gen9a pc data import now behaves as expected.
* Fixed: Gen3 French LeafGreen now detects better instead of assuming FireRed ("feu").
* Fixed: Transparent sprite pixel handling for hovering over sprites improved. Thanks [https://github.com/BtEtta @BtEtta] & [https://github.com/abcboy101 @abcboy101] !
* Updated: PK2 transfers Korean<->English now work for anything with western text chars. Thanks [https://github.com/abcboy101 @abcboy101] !
* Updated: Drag Drop threshold setting added to lessen click accidents. Thanks [https://github.com/BtEtta @BtEtta] !
* Updated: Translations improved for all languages. Thanks [https://github.com/Ka-n00b @Ka-n00b], [https://github.com/Coki628 @Coki628] !
'''26/04/11'''
* Added handling for HOME's update for Z-A transfers.
* Added backwards transfer logic for Z-A and LATAM language to previous Gen8/9 games.
* Added: Sound setting to disable all other beeping sounds the program makes where appropriate.
* Added: Gen9a donut generator.
* Added: Champions set imports now upscale EVs for mainline entities the set is applied to.
* Fixed: Gen5 imports for Pokédex Skin and Musicals revised.
* Fixed: Gen3 Options (sound, set/switch, etc) read/write fixed.
* Changed: Gen5 Nicknames in the PKM editor now better detect all-caps transfer permissions for Gen3/4 origin entities.
* Changed: Some internal API methods have been rewritten for performance (exporting/importing/reading/writing slots).
* Changed: Form Argument editing in the PKM editor improved, now shows the decomposed values.
* Changed: Main and OT tabs of the PKM editor revised, some controls widened/spaced.
* Changed: LATAM met locations for past games added, thanks [https://github.com/sora10pls @sora10pls] !
* Changed: Updated translations for various languages. Thanks [https://github.com/Ka-n00b @Ka-n00b] !
'''26/03/20'''
* Added handling for ZA's new patch revision tag.
* Legality: Gen3 Updated nickname checks for Japanese language origin.
* Changed: Hover preview in boxes now renders much quicker.
* Added: Gen8 encounters via the Encounter Database now respect requests for Shiny.
* Added: Gen1-5 Trainer editors can now edit OT trash bytes via CTRL-Click, same as the main entity GUI.
* Added: Gen3 Hall of Fame can now set current party to the selected entry.
* Fixed: Gen4 chatter and Records now read from the correct save block (rather than potentially the backup).
* Fixed: Performing many thousand Drag-drop operations will no longer crash the program (handle leak).
'''26/03/06'''
* Legality: Added Gen3 FR/LG virtual console legality restrictions and trash byte checks.
* Added: Gen3 FR/LG dex editing will clear unavailable captured dex flags.
* Added: Gen3 FR/LG item lists for virtual console no longer permit items exclusively from R/S/E/C/XD.
* Added: Folder Browser can now delete backup/recent save files via right click context menu.
* Changed: Minor improvement to some translatable GUI elements. Thanks @jcx521lj1315, @easyworld, @wubinwww & @Mimigris !
'''26/02/27'''
**Added: Garchompite Z & Blazikenite now released, can exist in inventory/held.
**Changed: Invalid PP Up count message now indicates the exact invalid value (relevant for Gen1/2 VC => Gen7).
**Fixed: Gen4 transfers from Gen3 now handle HG/SS's ball value correctly.
*Note: Gen3 FR/LG save files from Nintendo Switch are able to be loaded (no additional handling/conversion needed). Undecided on Legality handling.
*Added: Box Search button now available; can apply a filter to all slots (faded out) for easier searching your save data. Thanks @RandomGuy155 !
*Added: Box Popout button now available; the previous shortcut (double clicking the box tab) still exists. Now more accessible/discoverable.
*Added: Batch Editor can now perform math operations (+-/* and bitwise operators); refer to the dropdown menu.
*Added: PKM Editor now alerts when exporting a save file with unsaved PKM Editor changes.
*Added: Gen9a gender changing via Trainer Editor now resets clothing selection to default to avoid game startup crashes. Thanks @abcboy101 !
*Fixed: Gen9a Inventory edits for Mega Shards can now manually enter 4 digits (up from 3).
*Fixed: Gen8a Move Mastery/Purchased flags changed via Batch Editor now are set as per legality rules (rather than invalid).
*Fixed: Gen3 Emerald PC stored items now allow all item types (except Key items). Thanks @ShadowMario3 !
*Changed: Square shiny sprites now only appear when in SW/SH context.
*Changed: More translations for event flags in prior games. Thanks @Mimigris & @Ka-n00b !
'''26/01/31'''
* Legality: Swampertite now released, can exist in inventory/held.
* Added: Gen9a handling for 9,999 Mega Shards
* Fixed: Showdown Set parsing now recognizes IVs/EVs entered in non-standard order.
'''26/01/22'''
* Added: Gen9a file size recognition for Z-A patch 2.0.1
* Legality:
** Changed: Height/Weight/Scale messages now show the expected value, when applicable.
** Fixed: Alpha Pokémon without the requisite scale value are now flagged.
** Fixed: Forgotten initial moves (via HOME) are now extrapolated for cross-game transfers that expect specific moves.
* Changed: Gen4 Battle Revolution saves now load faster (more performant checksum algorithm).
'''26/01/07'''
* Changed: PKHeX now uses .NET 10 for its runtime (updated from .NET 9)! Dark Mode (Options->Settings->Startup->DarkMode) is now better supported.
* Legality: Sceptilite now released, can exist in inventory/held.
* ** Fixed: Gen9a handling for Rotom/Hoopa plus move flags.
* ** Fixed: Gen4 EV verifier for Level100 gifts now only allows Vitamin increments rather than allowing any 0-100 range. Thanks [https://github.com/andrebastosdias @andrebastosdias] !
* ** Fixed: BattleForm logic updated to differentiate Zygarde and Greninja better. Thanks [https://github.com/Parnassius @Parnassius] !
* ** Added: Gen9a Bulk checker now verifies Primal Orb unique assignment.
* Added: Gen9a Donut editor now displays the flavor profile of a donut in a visual manner. Thanks [https://github.com/RandomGuy155 @RandomGuy155] !
* Fixed: Gen9a Donut editor timestamp now correctly updates. Thanks [https://github.com/foohyfooh @foohyfooh] !
'''25/12/15'''
* Legality: Improved location ID detection of wild encounters, should work for 99.9%.
** Crossovers are not currently handled for detecting location IDs. Generating from encounter template is 100% legal.
* Added: Gen9a Donut editor. Can randomize, clone, fill, export, import, and manually edit individual donuts. Thanks [https://github.com/Lusamine @Lusamine] & [https://github.com/sora10pls @sora10pls] !
* Added: Gen9a Trainer Editor can now change Hyperspace Survey Points. Refer to the DLC tab in the editor.
* Fixed: Gen9a Meowstic/Magearna mega entries now update the Pokédex as expected.
* Fixed: Gen9a Event Flag editor no longer sometimes opens with a popup warning.
* Fixed: Gen3 Battle Frontier streak edits no longer reset adjacent streak values. Thanks [https://github.com/rjgabel @rjgabel] !
'''25/12/02'''
* Added Mewtwonite X/Y as released items, and Mewtwo encounter data.
* Legality:
** Fixed: Gen9a Plus moves from level-up learnset now allow Seed of Mastery to mark as Plus, without the Plus level threshold.
'''25/11/30'''
* Added Chesnaughtite, Dream Ball as released items.
* Legality:
** Fixed: Gen9a Gift encounters now enforce IV correlation when the template does not have any fixed/flawless IVs.
** Fixed: Gen9 transfers to SW/SH now recognized again.
** Fixed: Gen7 breeding ball inheritance for Gen2-5 starters now allow Gen4 balls via Island Scan encounter parents. Thanks manolin18 !
** Fixed: Gen4 Pokewalker IVs now recognize seed skipping via Mic Test. Thanks [https://github.com/John-0902 @John-0902] !
** Fixed: Gen3 GCEA PID/IV enforcing now uses BACD_R_A rather than BACD_U_AX (PCNY Antishiny).
* Added: Gen9a Player Appearance can now be changed via Block Data editor. Thanks [https://github.com/pasqualenardiello @pasqualenardiello] !
* Fixed: Gen9a suggesting of Plus Moves for Alphas now recommends the guaranteed Alpha Move as plus (as intended).
'''25/11/16'''
* Legality: Improved location ID detection of wild encounters, should work for 99.9%.
** Crossovers are not currently handled for detecting location IDs. Generating from encounter template is 100% legal.
** Fixed: Gen9a Ability change rules for Z-A have been updated to reflect form change behavior and encounter selection.
** Fixed: Gen9a minimum move count rules have been updated to ignore optional relearn moves (still not perfect).
** Fixed: Gen8 Raid shinies no longer flagged illegal, rather unverified like before.
** Fixed: Gen8/8b now allow Rare Candy @ lvl100 triggering evolution. Thanks JeongJeong !
* Fixed: Running PKHeX with LATAM language selected no longer crashes for past-gen string fetches.
* Fixed: Gen9a Colorful Screw quantity can now be edited again. Previous release had prevented changes so Give All did not set to 995.
* Changed: Gen9a Alpha IVs from generated templates are more random than before.
* Changed: Entity Editor move edit dropdown now shows egg moves/encounter moves in green if possible for the current entity.
'''25/11/07'''
* Fixed inventory edits.
* Added Diancite, Delphoxite, Sport Ball as released items.
* Legality:
** Checks for Z-A improved, but wild encounter location ID recognition outside of Wild Areas still needs work.
** Please do not report issues with this release's handling with legality/encounters. We are aware of what still needs work.
* Fixed: Gen9a Pokédex edits now retain Charizard-Y mega seen bitflag.
* Fixed: Gen9a Pokédex registering now sets applicable alternate form flags the same way the game normally grants.
* Fixed: Gen9a Species names for LATAM language now load correctly.
* Fixed: Gen9a Inventory editor no longer treats all acquired items as "NEW" when saving.
* Fixed: Gen9a Inventory editor no longer modifies Colorful Screw quantity when giving all.
* Fixed: Gen9a Scale evaluation now uses the less-detailed size labels to match the appearance in-game.
* Fixed: Gen9a Box/PC data file I/O now works as expected.
* Fixed: Friendship value now loads correctly when viewing a PKM. Thanks @DiogoOliveiraReis !
* Changed: Gen9a Event Flag editor now shows more event block tabs; existing tabs have been renamed to match their block's function.
* Added: Gen9a Fashion editor can now give all as owned via a button at the bottom of the form. Hold shift to give all for every tab.
* Added: Gen9a Trainer editor now has a button for collecting all Colorful Screws, which updates your inventory count.
* Added: Gen9a ConfigSave in Block Data can be used to change the Text speed to 3 (instant).
* Added: Gen9 S/V Fashion Editor added, matching the features available in Z-A's new fashion editor. Thanks @foohyfooh !
* Added: Encounter Database can now modify the Encounter Criteria directly instead of inferring from main window tabs.
'''25/10/26'''
* Added: Support for Legends: Z-A.
* Legality:
** Initial handling for recognizing and generating encounters from Z-A.
** Please do not report issues with this release's handling with legality/encounters. We are aware of what still needs work.
* Notes:
** All encounters can be traced back to an RNG seed.
** With multiple shiny rolls (wild only) or shinies, this calculation is not instant (>15 seconds), so it is only done for non-shiny 1-rolls.
** Do not be lulled into a false sense of safety that PKHeX does not flag your modified Pokémon's PID/IVs.
** Cheat codes that modify the RNG generation routine is detectable in the resulting Pokémon, as previously mentioned in Discord.
** Ability editing via the GUI has been forced into All-Abilities mode due to GameFreak not updating a Pokémon's ability on evolution.
* Added: Gen9a: Pokédex and Trainer Info editor are available.
* Added: Gen9a: Event block editors are available. 64-bit hash => text is not provided at this time.
* Added: Gen9a: Fashion block editors are available. Fashion-item ID => text is not provided at this time.
* Added: Bulk (Verify All) checks for issues with the save file, such as mismatched Fused slots or Mega stone inventory state issues.
'''25.09.25'''
* Legality:
** Added the Shiny Miraidon/Koraidon mystery gifts, and the other Ruins gifts.
** Added Reg J mythical participation ribbon legality.
* Added: Loading of zipped save file/folders is now supported, and can export-update the same zip. Thanks @nitz !
* Added: Status (paralyze, sleep, etc) browser is now localized. Thanks @abcboy101 !
* Fixed: PK1=>PK2 conversion no longer errors.
* Fixed: Gen2 Japanese Crystal save files now detect correctly.
'''25.06.09'''
* Legality:
** Fixed: Gen3 XD trainer ID checks no longer required for PAL copies of the game.
** Fixed: Gen8 PLA purchased/master flag check regression fixed.
** Changed: Updated badwords list. Thanks [https://github.com/abcboy101 @abcboy101] !
* Added: Gen4 PBR box names and play time now available for edits. Thanks [https://github.com/abcboy101 @abcboy101] !
* Fixed: Gen9 inventory edits with duplicate/cleared item slots now behaves correctly for editing items near the end of the list.
* Fixed: Gen3 nickname encoding is better handled when transferring between international and Japanese games.
* Fixed: PokePreview hover form no longer flickers the main GUI.
* Fixed: Stat abbreviations for other languages have been updated for easier parsing.
* Changed: Legality resources for levelup/eggmove/evolve have been re-serialized to a more compact & straightforward format, improving startup time.
* Changed: Plugin loading logic reworked for better containerization.
'''25.05.18'''
* Legality:
** Added: Gen3/4 egg PID types can be allowed to be any PID type by the user if changed via program settings.
** Added: Gen3 XD Poké Spot IV animation is now checked for legality.
** Added: Gen2 Stadium's move reminder learnset is now implemented for GB-Era relearning.
** Fixed: Gen3 Colo Murkrow added rebattle team locks (lack thereof). Thanks Unknown Warrior !
** Fixed: Gen4 Eggs now permit a PID of 0 (Masuda method re-rolling into 0 when receiving egg).
** Fixed: Gen8 PLA handling of un-transferred mid-scale fixed Alpha encounter sizing checks. Thanks Yorhu !
** Changed: Encounter Templates for eggs are now context-specific rather than a shared implementation for all games.
* Added: ShowdownSet localization - separate settings for Exporting to clipboard and Hovering slots.
* Added: Scrolling the mouse within the EXP/Level/IV/EV/Friendship text boxes will increment/decrement (nuzlocke edging/etc).
* Added: Gen1 Stadium boxes will now initialize boxes if not yet used, and hide empty slots/compress storage on save.
* Added: Gen4 Battle Revolution now recognizes the save file language. Thanks [https://github.com/abcboy101 @abcboy101] !
* Added: Gen4 Group seed editing. Thanks [https://github.com/taxicat1 @taxicat1] !
* Fixed: Gen4 PCD active flag now activates correctly. Thanks [https://github.com/glencoe2004 @glencoe2004] !
* Fixed: Gen4 Pokédex now un-sees forms correctly. Thanks [https://github.com/rganhoto @rganhoto] !
* Fixed: Gen6 PP for Submission is now correctly updated to 20. Thanks [https://github.com/FrostedGeulleisia @FrostedGeulleisia] !
* Fixed: Gen9 SV picnic inventory is no longer bumped to at least 1 when saving inventory edits.
* Fixed: Gen9 now shows the Battle Memory Ribbon in gold if 7 ribbons instead of 8 (to match the game behavior).
* Changed: Gen9 SV save file sizes now check for a range of sizes rather than specific sizes.
* Changed: Translations updated. Thanks [https://github.com/mk360 @mk360], [https://github.com/easyworld @easyworld], [https://github.com/Mimigris @Mimigris] !
* Changed: Intel CPUs might work better with the recent .NET 9 runtime. Thanks [https://github.com/hewenhan @hewenhan] !
* Changed: ShowdownSet parsing/exporting was rewritten for more flexibility (localization) as well as new formats/representations.
'''25.02.23'''
* Legality:
** Added: Handling for new HOME gifts (Meltan, Keldeo, Manaphy, Enamorus).
** Added: Gen7b Received DateTime validation. This was missed for how many years? Use the batch editor to fix any affected.
** Added: Gen1 recognition for Japanese tour Mews. Thanks [https://github.com/ShadowMario3 @ShadowMario3] !
** Added: Separated word filter for NDS, 3DS, and Switch contexts. Thanks [https://github.com/abcboy101 @abcboy101] !
** Added: Gen3 encounters now show nearest initial seeds and frame counts elapsed.
** Added: Gen4 Pokewalker IV spreads are now validated and show initial seeds.
** Added: Current PP verifier. This is a naive check to highlight box mons that haven't been healed since capture. Will be improved in future.
* Added: Gen1 Hall of Fame editor.
* Added: Gen3 Hall of Fame editor.
* Added: Gen3 Secret Base editor. Thanks [https://github.com/pasqualenardiello @pasqualenardiello] !
* Fixed: Gen7b encounters now generate with a valid Received DateTime.
* Fixed: Gen6 Link data now saves correctly. Thanks [https://github.com/R-YaTian @R-YaTian] !
* Changed: Gen3 RSBox now shows boxes similar to visual row order in-game rather than by order in the save file.
* Changed: Sprite generating performance improved (less allocation).
* Changed: Encounter template generating loops have been improved to better seek input criteria (IVs, nature, etc).
* Now requires .NET 9.0 runtime.
'''24.11.11'''
* Legality:
** Added: Gen3/4 Nidoran eggs now recognize their PID correlation. Thanks [https://github.com/abcboy101 @abcboy101] !
** Added: Gen7 LGPE crossover locations added. Thanks [https://github.com/Lusamine @Lusamine] !
** Changed: Gen3 event recognition enhanced to verify OT genders and complete PID/IV correlations. Thanks [https://github.com/kamronbatman @kamronbatman] !
** Fixed: Gen3 encounter slots now generate & recognize their encounter conditions more accurately. Thanks [https://github.com/ymaniz09 @ymaniz09] & TFS!
* Added: Encounter Database: New setting to enable displaying detailed information about each template on hover.
* Added: Encounter Database, mgdb: New tab to allow toggling settings used when generating templates.
* Added: PKM Database: New tab to allow toggling settings used when searching. Requires reopening the form.
* Added: Gen9 SV personal data now exposes the computed BaseEXP property instead of 0.
* Added: Gen6/7/SWSH trainer editor can now change the save file's trainer gender, by updating model data. Thanks [https://github.com/abcboy101 @abcboy101] !
* Added: Gen5 DLC editor added. In addition to the C-Gear skin editor, can load/export Musicals, Pokedex skins, Battle Videos, etc!
* Added: Gen5 DLC supports reading/writing the never-distributed Battle Test data.
* Added: Gen5 misc editor can now change more Battle Subway properties. Thanks [https://github.com/Mowstyl @Mowstyl] !
* Added: Gen3 misc editor can now change Lilycove Museum paintings (RNG abuse). Thanks [https://github.com/pasqualenardiello @pasqualenardiello] !
* Added: Gen2 misc editor for Crystal added button to enable the GS Ball event.
* Added: Gen2 mail formats now read/write for all languages. Thanks [https://github.com/abcboy101 @abcboy101] !
* Fixed: Complete Dex cheat (BDSP, SV, etc) now retains already set shiny flag records for entries. Thanks [https://github.com/TankedThomas @TankedThomas] !
* Fixed: Partner Ribbon now shows up in the Affixed Ribbon list.
* Fixed: Met tab now loads Version/Location correctly when starting up with a RBY save and loading a future game save.
* Fixed: Gen8 BDSP Manaphy egg now generates correctly.
* Fixed: Gen4 HGSS box modification corruption on single in-game save issue fixed. Thanks [https://github.com/Lusamine @Lusamine], [https://github.com/gingrentse @gingrentse], [https://github.com/WonderSquid @WonderSquid] !
* Fixed: Gen3 GameCube OT names that are 7 characters long now convert to PK3 correctly.
* Changed: Gen5 C-Gear Skins loaded from image files no longer completely fail when too many tiles, instead showing partial results.
* Changed: Errors generated by plugins are now more clearly indicated that they are caused by the plugin, for error reporting.
'''24.07.27'''
* Legality:
** Added: Most Gen3 events from Japan are now recognized.
* Fixed: Gen6 box name editing now edits the right offset. Thanks @javierhimura !
* Fixed: Other small regressions/oddities reported have been resolved.
* Fixed: Save files with uncommon appended footer types no longer cause issue when saving/closing subforms.
'''24.07.03'''
* Legality:
** Added: Slot source legality checks for miscellaneous slots like Daycare. Shouldn't flag anyone ;)
* Added: Gen4 trainer stat record editor. Thanks [https://github.com/abcboy101 @abcboy101] !
* Added: Gen3 memory cards can now be auto-detected as the latest save file on startup/request.
* Added: Gen3 Berry Powder, Pokéblock, and Decoration editors. Thanks [https://github.com/abcboy101 @abcboy101] !
* Fixed: Gen9 eggs now no longer auto-clear trash bytes for nicknames (and no longer flag in doing so).
* Fixed: Gen5 misc editor now opens correctly for editing the Key system.
* Fixed: Gen4 pk4->ranch conversion no longer throws an error.
* Fixed: Gen4 battle revolution nickname/OT now reads correctly.
* Fixed: Gen1-3 saves with misc footers are retained as intended.
* Changed: Some internals changed to better work with web browsers (wasm). Thanks [https://github.com/arleypadua @arleypadua] !
* Changed: Resource fetching abstraction extracted for better reuse with plugins.
'''24.05.05'''
* Legality: Added Regulation G.
* Added: Entity editor can now modify battle-Status effects (Burn, Paralyze, etc). Click the bottom right corner of the window for the GUI.
* Added: Gen5 trainer records can now be edited via Misc editor. Not documented well, but exposes the values for editing.
* Added: Gen1-3 games now detect language/version based on the save file name. If not detected, can be overridden via settings before loading.
* Added: Gen1 can now show an Entity's gender if enabled via settings, using Gen2 IV gender determination logic.
* Fixed: Gen7 Chinese species names now write correctly.
* Fixed: Gen6 OR/AS DexNav count read/write fixed.
* Fixed: Gen3 trash bytes now reference the Entity for translating the string, rather than the save file.
* Fixed: Gen2 Box Names now read/write ligatures correctly.
* Fixed: Gen1/2 box data now retains empty slot data instead of reformatting into empty box lists (glitching friendly).
* Changed: Legality settings have been extracted to a more easily customized settings object.
* Changed: Translations updated for Chinese & Japanese. Thanks @ppllouf & @902PM !
'''24.03.26'''
* Legality:
** Fixed: Handled some edge cases with latest release RNG Frame checks for Gen4.
** Added: Verification for Gen3 CHANNEL and MYSTRY seed patterns.
* Added: Gen4/5 API now supports reading/writing battle videos to the savefile object.
* Fixed: Gen5 Entree Forest in Misc now saves correctly. If broken, open the editor on the previous release and save again.
* Fixed: Event Flag diff now works as intended. Pokedex button restored for some save formats (regression from last release).
* Changed: Plugin error messages will now more clearly indicate they are an issue with plugins rather than PKHeX's fault.
* Fixed: Gen4 Daycare seed set now works as intended, no longer corrupts Daycare slot 2.
* Fixed: Gen4 Mystery Gift now reads correctly.
'''24.03.10'''
* Legality: Added Encounter Slot RNG correlation checks for Gen4 (and Gen3). Because Encounter Type PID mismatch wasn't enough!
** When hovering over a slot, the program will indicate a possible method to encounter the slot with a lead & initial seed (not Method 1).
** Added: Gen8+ RNG seeds that are 64bit correlation (like SW/SH raids) will now indicate the detected RNG seed.
** Added: Gen1/2 Event Gifts are now recognized completely. Thanks @ShadowMario3!
* Changed: Save Block handling reworked to better match the real game behavior of managing chunks of memory. Thanks @foohyfooh!
* Changed: Gen6 O-Power editor now edits individual indexes and usage counts.
* Added: Out-of-bounds text entry characters are now indicated with a [?] next to the Nickname/OT text entry. Thanks @abcboy101!
* Added: Batch Editor commands are kept when the window is closed, while the program remains open.
* Added: Loading empty save files (all 00 or FF) will now give a more detailed error message indicating failure.
* Added: More games indicate Daycare status completely. Maybe editing in the future?
* Added: Gen1/2 NSO save files are now able to be loaded, edited, and exported without needing an external tool.
* Added: Gen2 player color palette now editable via Block Data editor. Thanks @Bl4ckSh4rk!
* Added: Gen4/5 Battle Videos can now be extracted & interacted with via PKHeX.Core API code.
* Fixed: Gen3 FR/LG National Dex unlock fixed. Thanks @Bl4ckSh4rk!
* Fixed: Gen9 Alcremie formarg handling for Pokédex fixed. Thanks @sora10pls!
'''24.01.12'''
* Legality: Added Mochi Mayhem Pecharunt, Regulation F, and Blaziken Tera Raid recognition.
** Fixed: Level 100 encounters that were evolved in S/V with level-up methods (Eevee, Magikarp) now recognize correctly.
** Fixed: Gen1/2 transfers to Gen7+ will now recognize filtered OT names as valid. Thanks @abcboy101!
** Fixed: Recognition of Gen8 Hidden Ability patched raids now works as intended.
** Fixed: Recognition of Gen8+ GO encounters that evolve via form arguments now are recognized as intended.
* Added: MarkingCircle/Triangle/Square/etc now reimplemented, able to be used in Batch Editor commands.
* Added: Gen1/2 transfers to Gen7 can now override the default transfer version via program settings.
* Fixed: Gen9 Stellar type can now be set via Batch Editor with its corresponding type value (99).
* Fixed: Hover preview custom tooltip shows Hidden Power type correctly (was off by 1).
* Changed: Box Dump now uses a GUI to allow changing settings with more flexibility.
'''23.12.22'''
* Legality: Updates for Scarlet & Violet 3.0.0 behaviors revised to fix inaccuracies.
** Fixed: Recognition of marks, stellar fixed encounters, and underdepths encounters.
** Gold Bottle Cap on flawless IVs in S/V is now flagged; upload to HOME & back to get the official fix.
* Fixed: Gen9 S/V 7-Star Raid records now can be edited with the revised raid block editor. Thanks @foohyfooh!
* Fixed: Other misc regressions too insignificant to note (but observed & reported by many -- thanks!)
'''23.10.11'''
* Added support for Scarlet & Violet 2.0.2 save file sizes.
* Legality:
** Badwords list has been updated to be more strict per latest Nintendo Switch 16.0.0 firmware. Thanks @Bl4ckSh4rk!
** Gen9 Distribution Outbreaks now recognized. Thanks @Lusamine & @sora10pls!
** Gen9 Crossover met location logic tweaked for better location identification in Kitakami.
** Gen4 Pokéwalker IV spreads are now validated. Thanks @Lincoln-LM & @HappyLappy1!
* Added: Gen8 SW/SH adventure start date can now be changed in the Trainer Editor. Thansk @foohyfooh!
* Added: Gen4 Pokeathlon Points can now be edited via the Block Editor.
* Fixed: Initial program startup now notifies all plugins when a save is loaded on startup.
'''v23.09.25'''
* Added support for more Scarlet & Violet 2.0.1 save file sizes.
* Legality: Added more Kitakami encounters (sub-zones) and basic weather mark recognition.
* Fixed: Encounter template recognition regressions resolved (Gen4 Pokewalker, Gen9 static encounter scale).
* Fixed: Gen9 S/V Pokédex for 2.0.1+ save files now references a new save file block & GUI editor.
* Added: Gen9 TM/Fly cheats now check for if a flag exists for pre-2.0.1 save files.
* Added: Gen9 Fashion unlock cheat now adds 2.0.1+ fashion if available.
'''23.09.16'''
* Added support for Scarlet & Violet 2.0.1 (Teal Mask)
* Legality: Added encounters / changes as per Teal Mask DLC adjustments.
** May still have issues with crossovers / hidden ability permissions.
** Changed: Evolve-Knowing-Move criteria has been rewritten for better side-game checks & accuracy.
** Changed: More encounter generator fixes implemented (missed a few properties).
* Fixed: Gen9 Pokédex clearing individual entries now only wipes the entry instead of everything that follows. Thanks @Alexander3a !
* Fixed: Gen5 CGear Skin importing now gives the correct error message when too many unique tiles are imported.
'''23.08.23'''
* Legality: Added realtime RNG correlation checks for most SW/SH raids. Thanks @SciresM & @Lusamine !
** Note: Seed details do not trickle out to the verbose legality report at this time since seeds are 64bit (not 32bit).
** Added: The encounter generator / matching API has been refactored for better performance and maintenance.
** Fixed: More evotree edge cases have been resolved since the last update.
** Fixed: Gen4 Move Tutor now permits correctly for alternate forms.
** Fixed: Gen2 Union Cave B2F fishing slots are now recognized correctly.
** Fixed: Gen1/2 SID check no longer indicates "Fishy" when SID is correctly zero.
* Added: Technical Record editor now indicates yellow for record indexes that can be legally learned by a previous evolution.
* Added: Gen9 origin Transfers back to PK9 format now regenerate with legal values that would be sourced from HOME.
* Fixed: Gen9 Hoopa-Unbound no longer sets a FormArgument value of 3 whenever set back to box slots.
* Fixed: Gen7 US/UM relearn moves now properly show in all PK7s when loaded to tabs.
* Fixed: Gen5 CGear Skin handling now behaves correctly for importing & saving skins.
* Fixed: Pokérus strains now indicate correctly again in the PKM Editor GUI.
'''23.06.03'''
* Added: HOME 3.0.0 initial support. Legality analysis is still under research. Thanks @Lusamine & @sora10pls !
** Lacks full support for cross-game transfers involving evolutions and moves. Please be patient, there's a lot of things to handle!
* Added: Tech Record editor GUI has been redesigned for a more visual experience. Can now sort alphabetically, owned, or move type.
* Added: Gen9 S/V clothing "cheats" have been added to the Trainer Editor window. Thanks @pasqualenardiello!
* Fixed: Small regressions in item list permissions.
* Changed: Gen7 Totem Form sprites now display with an Orange-colored glow, similar to Gen3 C/XD shadow purple.
* Changed: DPI scaling adjusted for better appearance on high resolution monitors.
'''23.05.11'''
* Legality:
** Changed: Creating a new PKM from template will set current moves same as the games.
** Changed: Pokérus strains 0 & 8 now permitted due to official implementation errors in Gen2 & Gen3.
** Fixed: Encounters crossing over into Mesagoza (location 8) are no longer permitted (vertical distance).
** Fixed: TSV=0 HOME accounts are now permitted to exist, and antishiny XOR for the fixed PID gifts now behaves correctly.
* Added: Batch Editor filter commands can now reference other property values (aka "property copy") like modify commands.
** To copy a property, specify like so: .Stat_ATK=*Stat_DEF
** To filter based on the value of another property, same way.
* Added: Moves that have changed elemental type over generations will now indicate their type per the save file context.
* Added: Gen9 Player Image visualizer now shows the profile photos in the Trainer Editor. Thanks @pasqualenardiello !
* Added: Gen7 LGPE can now unlock all fashion via the Trainer Editor.
* Added: Gen5 Block editor now shows both roamer objects (Thundurus and Tornadus).
* Fixed: Gen9 scale indicators now reflect the >=1.1.0 patch scale thresholds. Thanks iD3M0N1C!
* Fixed: Gen5 C-Gear Skin no longer retains a file lock on imported skin image files.
* Fixed: Gen3 Memory Cards can now be detected as the latest save file, as well as a backup-file source for the pkmdb.
* Fixed: Gen3 XD un-purified shadow Pokémon no longer flag w/o Ribbon if they have a Shadow Gauge of 0 (ready to purify).
* Changed: Sub-form scaling mode changed to "Inherit" -- added a Display setting to revert back to Form scaling (from Dpi).

[https://github.com/kwsch/PKHeX/releases Release notes.]

==Credits==
PKHeX's QR code generation code is taken from [https://github.com/codebude/QRCoder QRCoder], which is licensed under [https://github.com/msikma/pokesprite/blob/master/LICENSE the MIT license].

PKHeX's shiny sprite collection is taken from [https://github.com/msikma/pokesprite pokesprite], which is licensed under [https://github.com/msikma/pokesprite/blob/master/LICENSE the MIT license].

PKHeX's Pokémon Legends: Arceus sprite collection is taken from the [https://github.com/msikma/pokesprite National Pokédex - Icon Dex project] and its abundance of collaborators and contributors.

==External links==
* GitHub - https://github.com/kwsch/PKHeX
* Project Pokemon Forums - https://projectpokemon.org/home/forums/forum/83-pkhex
* Guide - https://www.reddit.com/r/3dshacks/comments/129qr7z/a_simple_guide_in_bringing_pok%C3%A9mon_from_one/

FlashNX Switch

2026-07-10T03:30:38Z

HydeWing: 1.5.1

{{Infobox Switch Homebrews
|title=FlashNX
|image=FlashNX.png
|description=Homebrew Flash player for Nintendo Switch (.nro). Play your .swf games from the SD card. Powered by Ruffle.
|author=Jonathan8520
|lastupdated=2026/07/09
|type=Other Apps
|version=1.5.1
|license=MIT
|download=https://dlhb.gamebrew.org/switchhomebrews/FlashNX.7z
|website=https://github.com/Jonathan8520/FlashNX
|source=https://github.com/Jonathan8520/FlashNX
}}
FlashNX is a homebrew Flash player for Nintendo Switch.

Run your Flash games (.swf - AS1/AS2, and part of AS3) straight from the SD card. Powered by [https://github.com/ruffle-rs/ruffle Ruffle].

== Installation ==
Modded Switch with Atmosphère required.

Install via [[Homebrew App Store Switch|Homebrew App Store]] (easiest):
* Open the hb-appstore app on your Switch.
* Search for FlashNX, install. Updates follow automatically.

Or manually:
* Download FlashNX.nro from the [https://github.com/Jonathan8520/FlashNX/releases Releases].
* Copy it to <code>sdmc:/switch/FlashNX/FlashNX.nro</code> (the Homebrew Menu also accepts a loose <code>sdmc:/switch/FlashNX.nro</code>).

Either way: copy your .swf files into <code>sdmc:/flashnx/</code>, then launch FlashNX from the Homebrew Menu.

== User guide ==
'''Cover art:''' the library is a grid of covers, 5 per row (cropped to fill). Drop a <code><game>.png</code> or <code>.jpg</code> next to the <code>.swf</code> to set one, or fetch artwork from the Flashpoint Archive in a game's options (pick from thumbnails).

'''Multi-file games:''' some games load companion <code>.swf</code> files (a title screen, a minigame, music). When you download a game from the '''Flashpoint search (X)''', FlashNX fetches these companions automatically into a <code><game>.files/</code> folder. For a game added another way (URL import, hand-copied), put the companions in that folder yourself (so <code>Foo.swf</code> uses <code>Foo.files/</code>, and <code>Foo.swf</code> loading <code>top.swf</code> reads <code>Foo.files/top.swf</code>).

'''Home-menu shortcuts:''' launch FlashNX with a <code>.swf</code> path as its argument and it boots straight into that game (and returns to the Home menu when you quit). With a forwarder tool you can put a single Flash game on your Switch Home menu, with its cover as the icon. '''Sphaira''' users: FlashNX registers a <code>.swf</code> association, so you can select a game in Sphaira's file browser and "Create a Forwarder" > FlashNX.

'''Automatic saves:''' for games that save (SharedObject <code>.sol</code>), on the SD card.

'''Built-in key editor:''' 48 Flash keys, configurable per game, plus a '''global default''' layout in the Settings tab.

'''Languages''': English, French, Spanish, Russian, German, Italian, Portuguese, Chinese (Simplified, rendered from the console's own shared font), auto-detected from the console's system language, switchable from the Settings tab.

'''Tested games:''' (most run at 55-60 fps)
* Super Mario 63
* Super Mario World Flash
* Mario Forever
* Tetris'd
* Flappy Bird
* Pursuit of Hat 2
* Mario 3D Racing…

== Controls ==
=== In the library ===
L/R - Switch tabs (Play/Import/Settings)

D-pad or sticks - Move in the cover gallery

A - Play

Y - Sort (name/added/played/size, X reverses)

Minus - Search (filter by name)

Plus - Game options (favorite, controls, rename, cover, delete).

Favorites stay pinned to the top of the gallery. Quit, plus bug report and suggestions, from the Settings tab.

=== Import tab ===
(A list of your saved URLs.)

A - Launch one

Plus (Add a URL row) - Enter a new one

Plus (on a URL) - Edit or delete it

Accepts archive.org items and direct <code>.swf</code> URLs. X searches the Flashpoint Archive and downloads a game (cover and real title included; Plus key on a result shows its details + download size).

=== In game ===
Left Stick/D-Pad - Arrows

A/B/X/Y - Flash keys (remappable)

Right Stick - Mouse cursor

Minus - Pause menu

ZR/Touch - Left click

ZL - Right click

Clicking a text field opens the keyboard.

The control editor picks any Flash key (letters, digits, arrows, F1-F12, symbols, numpad) or mouse click from a visual keyboard, and can turn the right stick into a d-pad (it also covers SL/SR and the stick presses).

For games that need more inputs than the pad has buttons, a "combo layer" lets you hold one shoulder button (the modifier) so every other button sends a second key, e.g. ZL+A sends F1.

In the editor, L/R move a sub-tab across NORMAL/ZL/ZR/L/R: NORMAL edits the base bindings, and picking a modifier (ZL/ZR/L/R) edits that player's combo layer (rows then read ZL+A, etc.).

X switches the Player 1 / Player 2 tab (each has its own combo layer).

== Screenshots ==
https://dlhb.gamebrew.org/switchhomebrews/images/FlashNX2.png

https://dlhb.gamebrew.org/switchhomebrews/images/FlashNX3.png

https://dlhb.gamebrew.org/switchhomebrews/images/FlashNX4.png

https://dlhb.gamebrew.org/switchhomebrews/images/FlashNX5.png

== Known limitations ==
* '''Heavy games''': frame-rate drops come from '''Ruffle's AVM1/AVM2 interpreter''' (CPU-bound, no JIT) - not from our rendering. Out-of-app lever: CPU overclock (sys-clk).
* '''AS3 compatibility''': partial, inherited from Ruffle (see [https://ruffle.rs/compatibility Ruffle compatibility]). AS3 games show a badge in the library.
* '''No savestate / rewind''': Ruffle does not expose a snapshot of the execution state. Games' native <code>.sol</code> saves do work.
* '''Audio''': occasional light crackle on very dense scenes (to be refined).

== Changelog ==
'''v1.5.1 2026/07/09'''
* Fixes
** '''Games no longer turn to a red screen after a long session''' ([https://github.com/Jonathan8520/FlashNX/issues/62 #62], [https://github.com/Jonathan8520/FlashNX/issues/63 #63]): after playing one game for a while, launching a different one could show a full red screen. The game file is now read in small chunks instead of one large operation that could spuriously fail once memory had fragmented, so the next game loads reliably.
** '''Caps Lock can now be mapped to a button''' ([https://github.com/Jonathan8520/FlashNX/issues/61 #61]): a few games use the Caps Lock key for a mechanic (for example, a stage in ''This Is the Only Level'' that only opens the exit while Caps Lock is held). The visual keyboard in the control editor (TOUCHES) now has a '''Caps''' key you can bind.

'''v1.5.0 2026/07/03'''
* A rework of the control editor, plus new languages and rendering fixes.
* Added
** '''Visual keyboard for remapping''' ([https://github.com/Jonathan8520/FlashNX/issues/55 #55]): pick a key on a full on-screen PC keyboard instead of a scrolling list; keys already in use are highlighted. F1-F12, symbols and numpad operators can now be bound.
** '''Button combos, one layer per modifier''' ([https://github.com/Jonathan8520/FlashNX/issues/57 #57]): hold ZL/ZR/L/R and every other button sends a different key. The four modifiers are independent and work at once, so <code>ZL+A</code> and <code>R+A</code> can differ. Player 1 and Player 2 each have their own layers.
** '''Turkish''', plus a compact '''flag-grid language picker'''.
** '''Show or hide the mouse cursor per game''', and a black outline on the pointer so it stays visible over any art.
** '''Shared control profiles now carry the whole setup''': combos, cursor speed and the show-cursor choice, not just the base bindings.
* Fixes
** '''Very large games no longer go to a white screen''' ([https://github.com/Jonathan8520/FlashNX/issues/56 #56], e.g. the Henry Stickmin titles).
** '''Fewer white screens / out-of-memory on heavy games''' (freed-and-right-sized bitmap layers).
** '''Water and distortion effects render correctly''': displacement-map filters are now supported, and a texture-packing bug that striped these scenes is fixed.
** Smaller fixes: a game no longer appears twice in the shared-profile catalog; cursor-speed-only changes re-enable sharing.

'''v1.4.1 2026/06/28'''
* Fixes
** '''Chinese (and Japanese/Korean) text now shows inside games''': v1.4.0 added Chinese to the app's own menus, but text drawn by a running game still came out blank when the game used a system font for it. Games now fall back to the Switch's built-in fonts for any character a game's own font is missing, so in-game CJK text renders. ([https://github.com/Jonathan8520/FlashNX/issues/54 #54])
** '''Import from Wayback Machine links''': a <code>web.archive.org</code> snapshot URL of a <code>.swf</code> is now accepted and downloads the actual game (it used to be treated as an archive.org item and fail).
*Changed
** The control-profile catalog is now fully community-driven: the one bundled profile (Super Mario 63) was removed, as it only mirrored the default controls anyway. Share and apply profiles from a game's options as before.
'''v1.4.0 2026/06/25'''
* Added
** '''Community control profiles''': share your key bindings for a game and download other players' setups (#20). In a game's options ('''+'''), pick "Share my controls" to publish your profile, or "Apply a profile" to browse what the community has shared for that game and try it; applying a profile is non-destructive and can be reverted. Profiles you shared can be deleted again. Verified and most-applied profiles sort to the top.
** '''More languages''': German, Italian, and Brazilian Portuguese join the menus, plus '''Simplified Chinese''' (#41) rendered from the Switch's own shared font.
** '''Numpad keys in the controls editor''': the editor now offers Num0–Num9 (the numeric keypad), listed first, for games that read keypad keys separately from the top-row digits. Player 2 defaults to the numpad.
* Fixes
** '''Flashpoint games with a non-ASCII title now import and launch''': a game whose file name uses non-Latin characters (for example ''包丁少女幻窓曲'') failed to download with an error -2. Its address is now encoded correctly. (#51)
** '''Flashpoint games that load their assets on the fly now play''': some games build the paths to their data and art files while running, so those files could not be fetched ahead of time and the game stayed on a blank screen (for example ''Racing is Magic''). Missing files are now pulled from the Flashpoint mirror on demand and cached, for games imported from the Flashpoint search. (#51)

'''v1.3.1 2026/06/19'''
* Added
** '''Local two-player (two controllers)''': a second controller now drives Player 2 through its own set of key bindings, for Flash games where two players share one keyboard (for example ''Fireboy & Watergirl'', ''Dragon Ball Z Devolution''). The controls editor has a Player 1 / Player 2 toggle (press X), and both players' keys are saved per game. Player 2 defaults to WASD so it does not clash with Player 1's arrows. Needs two full controllers (a Pro controller or a Joy-Con pair each). (#40)
** '''Touch controls in the launcher''': in handheld mode you can drag the game gallery to scroll, tap a game to select it, and tap it again to launch it.
** '''Flashpoint content filter toggle''': press ZL+ZR in the Flashpoint search results to turn the content filter on or off. Importing a game also fetches its cover automatically. (#33)
** '''Download of non-zipped Flashpoint games''': games served loose (not as a single archive) now download through the htdocs mirror. (#26)
* Fixes
** '''Super Smash Flash''': the announcer now plays, and the game no longer freezes on a blank screen after a fight instead of showing COMPLETE. Its voices and most of its sound effects use the Nellymoser audio format, which was not enabled. (#29)
** '''No more crash when some games save''': a game saving a self-referential object (for example ''Hemp Tycoon'') used to crash the app. The save now completes. (#33)
** '''Color speckle on translucent effects fixed''': semi-transparent effects (for example the smoke in ''Offroaders'') showed cyan and magenta speckle. (#38)
** '''Flashpoint games with a space in their name now launch the right file''' instead of the first one found in the archive.
** '''The "&" character now shows in the menus''': it was missing from the UI font, so titles like "Fireboy & Watergirl" dropped it.

'''v1.3.0 2026/06/14'''
* Added
** '''Multi-file game support''': a game that loads other <code>.swf</code> files at runtime (<code>loadMovie</code> / <code>loadMovieNum</code> into a level) now finds them in a <code><game>.files/</code> folder next to the <code>.swf</code>. Download a game from the Flashpoint search (X) and its companion files are fetched automatically; for a game added another way, drop the companions in that folder yourself. ''Garfield's Scary Scavenger Hunt'' now plays from start to finish.
** '''Multi-file indicator''': the launch screen shows a "MULTI-FILE (N)" label when a game pulls in companion files, so you can tell at a glance.
** '''Flashpoint downloads now bring the whole game''': a download from the Flashpoint search now unpacks the game's full bundled set of files (alternate versions, ad-network stubs, data files) and launches the exact version the archive intends, instead of guessing. Games that used to get stuck on a sponsor or "Download the latest Adobe Flash Player" screen (for example ''Papa Louie 2: When Burgers Attack'') now start and play.
** '''In-game keyboard''': when a Flash game wants text (a player name, a level password, high-score initials, a text adventure), the Switch keyboard opens when you click the text field, pre-filled with its current text and set to the right type (numbers, password, multi-line). Games that were unplayable with a controller alone now work.
** '''Favorites''': in a game's options ('''+'''), mark it as a favorite. Favorites are pinned to the top of the Play gallery with a gold marker, whatever the sort order.
** '''Assignable mouse clicks''': the controls editor now has '''Left click''' and '''Right click''' actions you can bind to any button. By default '''ZR''' is left click and '''ZL''' is right click. The touchscreen still left-clicks.
** '''More mappable inputs''': SL / SR (Joy-Con side buttons), the stick presses (L3 / R3), and the '''right stick as a d-pad''' (bind its directions and it stops being the mouse cursor; the touchscreen stays the cursor).
** '''Much faster Flashpoint downloads''': downloads now batch their writes to the SD card and pump the network harder, turning what used to be a roughly two-minute download into about ten seconds for a large game.
** '''Home-menu shortcuts for a single game''': FlashNX can now be launched straight into one game when its <code>.swf</code> path is passed as a launch argument — it skips the library and returns to the Home menu when you quit. With a homebrew forwarder tool this lets you put a specific Flash game on your Switch Home menu, with its own cover as the icon. If you use '''Sphaira''', FlashNX registers a <code>.swf</code> association on launch, so you can pick a <code>.swf</code> in its file browser, choose "Create a Forwarder", select FlashNX, and the shortcut boots straight into that game.
* Fixes
** '''Buttons mapped to letter or number keys now trigger games that read them as keyboard shortcuts''': a controller button bound to a letter (or a digit or space) now fires a game's keyboard shortcuts, not just its held-key checks. For example ''Scooby-Doo: Mayan Monster Mayhem'' (H for help, S/T to switch the held item) now responds; before, only movement and pickup worked.
** '''Deleting a game also removes its <code><game>.files/</code> companion folder and its favorite mark''', so nothing is left behind on the SD card.
** '''Games that rendered as a blank white screen now display correctly''': very art-heavy games (thousands of on-screen vector shapes at once, for example ''The Binding of Isaac'') exhausted the renderer's geometry buffers, which silently dropped the extra shapes and left most of the game invisible behind a few stray text glyphs. The buffers are now much larger, and a buffer overflow is reported instead of failing silently. (#16, #23)
** '''Large multi-file games now download and run''': big Flashpoint games (over the old 64 MB download limit, loading dozens of companion files by relative path, for example ''Super Brawl 2'') used to show a full download bar and then do nothing, or launch to a black screen. They now extract fully and run. This took a few fixes: a larger download limit, launching the game under its original URL so its relative asset loads resolve, and doing the extraction and asset reads through the C++ filesystem layer (the Rust one drops some files on the Switch).

'''v1.2.1 2026/06/11'''
* Fixes
** '''PixelBender games no longer crash''': some games build a Flash <code>Shader</code> / <code>ShaderFilter</code> at runtime (for example '''The Terminal'''). They used to abort the app the moment the shader was created. They now run normally; the shader's visual effect itself is skipped (this renderer does not run PixelBender), but gameplay and input work. As a bonus, crash messages from the game thread are now captured to the crash log instead of being lost.
* Changes
** '''Clearer bug reports''': a report now includes the game's import URL when it was added from a link, so a game imported under an arbitrary filename can still be identified. The report also reminds you that it opens a public issue on the FlashNX repository, and you can add your GitHub handle if you want a follow-up.

'''v1.2.0 2026/06/10'''
* Features
** '''Tabbed navigation''': a top navbar switched with '''L / R''' between '''Play''' (your games), '''Import''', and '''Settings'''.
** '''Cover gallery''': the Play tab is a grid of cover art, 5 per row (covers are cropped to fill the tile). Games with no cover get a generated tile (color + initials).
** '''Your own covers''': drop a <code><game>.png</code> or <code>.jpg</code> next to the <code>.swf</code> and it shows up as the cover.
** '''Flashpoint covers''': a game's options has a '''Cover''' action that searches the Flashpoint Archive by name and shows the candidates as thumbnails to pick from. The search name is cleaned up automatically (download-id suffixes such as <code>game-15938d603</code> are dropped), and '''−''' lets you retype the title when the filename does not match the catalog (for example <code>catmario</code> to <code>cat mario</code>).
** '''Download games from Flashpoint''': in the Import tab, '''X''' searches the Flashpoint Archive and shows the results as a cover grid; '''A''' downloads a game's <code>.swf</code> directly. Its cover is fetched automatically, and its real title is kept even when the filename cannot hold characters like <code>:</code>. Press '''+''' on a result to see its full title, developer, publisher, release date and download size.
** '''Import as a list''': the Import tab is a list of your saved URLs. Press '''A''' to launch one, use the '''+ Add a URL''' row to enter a new one, and '''+''' on a URL to edit or delete it. It accepts archive.org items and direct <code>.swf</code> URLs.
** '''Sort your library''' ('''Y''' in the Play tab): by name, date added, last played, most played, or size. '''X''' reverses the order, and the choice is saved.
** '''Playtime''': each game tracks how long you have played it (shown under the selected game, and used by the "most played" sort).
** '''Report a bug or send a suggestion''' (Settings tab): flag a game that renders or plays wrong, or send a feature idea. It opens an issue on the FlashNX repository, with no account and no login.
* Changes
** '''Controls''': '''−''' is search, '''+''' is the selected game's options; default controls, language, bug report, suggestion and '''Quit''' all live in the Settings tab. Switching tabs is '''L / R''' only, and '''B''' always just backs out of a modal (the redundant "Back" rows were removed).
** '''Audio level''': the in-app sound now matches the rest of the Switch (it used to be noticeably louder).
* Fixes
** '''Large backgrounds no longer turn white''': games whose backdrop or floor is a bitmap wider or taller than 2048px (for example Mario Combat's sky and ground) used to render as solid white blocks. They now draw correctly.
** '''Deleting a game cleans up everything''': removing a game now also deletes its cached online cover and the cover sidecars saved under the plain game name (on top of the <code>.swf</code> and its keymap/rename/save files), and clears the leftover Import-list "downloaded" badge and the on-screen cover, so re-importing the same game later starts fresh.
** '''Flashpoint cover grids no longer freeze the UI''': logos load in the background, so a broad search with dozens of results stays responsive while the thumbnails fill in.
** '''Missing accents''' restored on several labels (the sort options, "edit", "download").
* Notes
** Covers and downloads use the public Flashpoint Archive APIs (metadata, logos, GameZIP). Downloading a game is always something you choose, one game at a time.
** Bug reports and suggestions are anonymous: they go through a small relay that opens a GitHub issue, so you never need an account or to log in.

'''v1.1.1 2026/06/05'''
* Fixes
** '''URL history no longer disappears in applet mode''': history (and saves, settings, renamed-game sidecars) is now read with a bounded reader and committed to the SD card after every write, so it survives switching between applet (album takeover) and full title-takeover modes. Previously the history could read empty in applet mode, or get overwritten by the next change.
** '''HTTPS import errors are now readable''': a failed import shows the real cause (libcurl code and message, HTTP status) instead of an opaque "code -2", so you can tell whether it is the console clock, DNS, the certificate bundle, or a blocked link.
* Features
** '''Search the local library''': press '''X''' to filter the game list by name (empty input clears the filter), the same way the archive.org screen already works.
** '''Clear applet-mode notice''': trying to launch a game without the full app memory now shows a readable message ("launch via title takeover") instead of a red screen.
* Changes
** '''More consistent controls''': '''X''' is search on every list, and '''ZL''' manages the selected item (game options in the library, delete URL in the import history). The on-screen footers reflect the new layout.
** The default example URL is now a neutral placeholder.

'''v1.1.0 2026/06/04'''
* Features
** '''Settings modal (<code>+</code> in the library)''': a new global settings screen with two entries — '''default controls''' (edit the global default keymap used by every game without a per-game override) and '''language'''.
** '''URL history management''': in the archive.org import screen, '''X''' removes the currently-shown URL from the history (with a confirmation modal).
** '''Quit returns to the right row''': leaving a game (pause menu → QUIT) lands the cursor back on the game you were playing, instead of jumping to the top of the list.
** '''Pause menu shows the game's name''' under "PAUSE" (like the OPTIONS modal).
** '''Library shows 8 games''' at once (was 6).
* Notes
** The chosen language is persisted to <code>sdmc:/flashnx/settings.json</code>.
** Flash key names (<code>Space</code>, <code>Shift</code>, <code>A</code>…<code>Z</code>) are technical identifiers and remain untranslated; only UI labels and messages are localized.
** Opening the settings modal returns to the previously-selected game row (like the OPTIONS modal).

'''v1.0.0 2026/05/31'''
* First official release. FlashNX runs AS1/AS2 Flash games (and part of AS3) straight from your Switch's SD card.

== Credits ==
FlashNX is only a '''Switch integration layer''' on top of remarkable projects - all credit for the Flash emulation goes to '''Ruffle'''.

'''Core'''
* '''[https://github.com/ruffle-rs/ruffle Ruffle]''' — ''Apache-2.0 / MIT'' — Flash engine (SWF parsing + AVM1/AVM2 interpreter). FlashNX embeds <code>ruffle_core</code>, <code>ruffle_render</code>, <code>swf</code>.
* '''[https://devkitpro.org/ devkitPro] / libnx''' — ''ISC'' — Switch toolchain + Horizon API (audio '''audren''', input '''hid''', threads, exception handler).
* '''[https://github.com/devkitPro/pacman-packages switch-mesa]''' — ''MIT'' — OpenGL/GLES via Nouveau, the graphics backend.

'''Game & cover data'''
* '''[https://flashpointarchive.org/ Flashpoint Archive]''': the Flash game preservation project. FlashNX uses its public APIs (search, logos, GameZIPs) so you can find cover art and download the games you choose. All preserved games stay the property of their original creators, and FlashNX only fetches what you explicitly request.

'''Network (archive.org import over HTTPS)'''
* [https://curl.se/ libcurl] · [https://github.com/Mbed-TLS/mbedtls Mbed-TLS] · [https://zlib.net/ zlib] · [https://curl.se/docs/caextract.html Mozilla] CA certificate bundle.

'''Rust libraries'''
* [https://github.com/image-rs/jpeg-decoder jpeg-decoder] (fork patched for newlib) · <code>png</code> · <code>serde</code> / <code>serde_json</code> · <code>tracing</code> · <code>flate2</code> · <code>getrandom</code> · + Ruffle's transitive dependencies (<code>gc-arena</code>, <code>dasp</code>…).

'''Acknowledgements''' - Switch homebrew ecosystem projects consulted during the port's R&D (no code reused): [https://www.scummvm.org/ ScummVM] (<code>OSystem</code> port pattern), the PPSSPP Switch port (switch-mesa GL reference), [https://github.com/ticohq/tico Tico], [https://github.com/dantiicu/dawn-switch dawn-switch] ''(the WebGPU alternative we evaluated)'', and the devkitPro / GBAtemp community.

'''License''': the FlashNX integration code is distributed under the '''MIT''' license (see [https://github.com/Jonathan8520/FlashNX/blob/main/LICENSE <code>LICENSE</code>]). Ruffle and the other dependencies keep their respective licenses.

== External links ==
* GitHub - https://github.com/Jonathan8520/FlashNX

DBI Switch

2026-07-10T03:30:37Z

HydeWing:

{{Infobox Switch Homebrews
|title=DBI
|image=dbinx.png
|description=The ultimate solution for NSP, NSZ, XCI and XCZ installation along with many advanced features.
|author=rashevskyv
|lastupdated=2026/06/19
|type=Utilities
|version=902 - 898
|license=N/A
|downloadraw=[https://github.com/rashevskyv/DBIPatcher/releases Multi Languages] - [https://github.com/Morce3232/DBIPatcher/releases EN Download]
|website=https://github.com/rashevskyv/dbi
|source=https://github.com/rashevskyv/dbi
}}

DBI is the ultimate solution to install NSP, NSZ, XCI and XCZ files along with many advanced features.

==Features==
*Install NSP, NSZ, XCI and XCZ files.
*Support installation over MTP, USB, http (from your personal server), external USB and more.
*View images in jpg, png and psd formats and work with zip and rar archives as well as with cbr/cbz containers.
*View text files in plain text or hex view.
*File manager that can copy, move or delete files and folders or create new folders.
*Save manager (including backup and restore).
*Displays activity charts in games by dates for all available users for each specific game.
*And more.

== Installation ==
Download DBI.nro (Patched/Compatible version) from [https://github.com/rashevskyv/DBIPatcher/releases release].

Download the translation_XX.bin file for your desired language.

Rename the translation file to exactly translation.bin.

Place both DBI.nro and translation.bin into the /switch/DBI/ folder on your SD card.

== User guide ==
{| class="wikitable"
! style="width:15%;"|Browse SD Card
| Install NSP/NSZ/XCI/XCZ files from the memory card.
|-
! Browse USB0 Drive
|Install NSP/NSZ/XCI/XCZ files from an external exFAT/FAT32 USB drive, such as a flash drive, hard drive, etc.
|-
! Install title from DBIbackend
|Install NSP/NSZ/XCI/XCZ files from a PC via USB 2.0 or 3.0 cable using the included program dbibackend (Hotkey for this option: Y button).
|-
! Install title from Gamecard
|This option appears when a game card is inserted into the Switch and allows for the installation of a game from the game card to the console's microSD card or internal NAND memory.
|-
! Home server
|Since v150, it is possible to install games over the network (HTTP) via WiFi without wires or a LAN-USB adapter. More details [https://github.com/rashevskyv/dbi/blob/main/README_ENG.md#home-server here].
|-
! Browse installed applications
|View installed games, the total number of games installed, view time spent on a game and the number of times it has been launched, check for errors, transfer game data between internal memory, memory card, and back, selectively or continuously delete games and accompanying LayeredFS mods, view the presence of updates and DLC, manually remove DLC/updates/LayeredFS (LFS) mod, and the Reset Required version function to reset the system update check for a selected game (Hotkey for this option: L button).
|-
! Cleanup orphaned files
|Automatic cleaning of unnecessary deleted game files, if any.
|-
! Browse tickets
|View and manually delete game system tickets.
|-
! Browse saves
|View and delete game saves.
|-
! Run MTP responder
|Enable the internal MTP server to connect the Switch to a PC or Android device (phone/tablet/etc., tested with Pixel 3, Xiaomi Mi A1, Lenovo Tab 4 7" TB-7304X), where you can view and work with the memory card (1: External SD Card) and internal console memory, view installed games (4: Installed games), backup game saves to a PC (7: Saves), and dump a game card (full/trimmed/certificate) to a PC/Android with an inserted game card (9: Gamecard) (Hotkey for this option: X button).
|-
! Run FTP server
|Enable the DBI FTP server for accessing microSD files through port 5000 or installing files through port 6000.
|-
! Exit
|Exit the program (Hotkey for this option: + button).
|}

The bottom left corner of DBI displays the total amount of data currently on your SD card along with the full capacity. The bottom right corner gives you the same information for your NAND's usable space in HOS.

Bottom center (dbi: XXX) is the DBI version number - you should always use the most recent version.

==Screenshots==
'''Browse SD card/USB0 drive''' 
https://dlhb.gamebrew.org/switchhomebrews/dbinx.png

'''Install options''' 
https://dlhb.gamebrew.org/switchhomebrews/dbinx2.png

'''Browse installed titles''' 
https://dlhb.gamebrew.org/switchhomebrews/dbinx3.png

'''Title context menu''' 
https://dlhb.gamebrew.org/switchhomebrews/dbinx4.png

'''Detailed game menu''' 
https://dlhb.gamebrew.org/switchhomebrews/dbinx5.png

'''Running MTP responder''' 
https://dlhb.gamebrew.org/switchhomebrews/dbinx6.png
==Media==
'''WHAT IS DBI AND HOW TO USE IT ([https://www.youtube.com/watch?v=N_SlBDdkIfo sthetix])''' 
<youtube>N_SlBDdkIfo</youtube>

==Credits==
Thanks to [https://github.com/SciresM SciresM] for [https://github.com/SciresM/hactool hactool] (licensed under [https://en.wikipedia.org/wiki/ISC_license ISC]) - DBI uses some data struct definitions from there.

== External links ==
* GitHub - https://github.com/Morce3232/DBIPatcher
* GitHub - https://github.com/rashevskyv/DBIPatcher
* GitHub - https://github.com/rashevskyv/dbi

COLD START Switch

2026-07-10T03:30:37Z

HydeWing: 3.5.0

{{Infobox Switch Homebrews
|title=COLD START
|image=COLDSTARTSwitch2.png
|description=A roguelike top-down shooter survival game.
|author=etonedemid
|lastupdated=2026/07/04
|type=Shooter
|version=3.5.0
|license=GPL-3.0
|download=https://github.com/etonedemid/cold-start-nx/releases
|website=https://github.com/etonedemid/cold-start-nx
|source=https://github.com/etonedemid/cold-start-nx
|donation=ko-fi.com/etonedemid
}}
{{#seo:
|title=Switch Homebrew Games (Shooter) - GameBrew
|title_mode=append
|image=COLDSTARTSwitch.png
|image_alt=COLD START
}}

Cold Start is a roguelike survival game featuring bombs, upgrades, parrying, and a console that allows players to spawn a car and run enemies over. It runs on PC, Nintendo Switch homebrew, and Android.

The project is licensed under the GNU GPL, except for its music, for which authors should be consulted before distributing. Sounds are sourced from Pixabay.

== Features ==
* PC, Switch, and Android builds from the same codebase.
* Arena, co-op, deathmatch, team deathmatch, playlist, and custom-map play modes.
* Host-authoritative online multiplayer (ENet) with full mod sync.
* In-game map editor, character creator, and built-in texture editor.
* Mod system: maps, packs, characters, sprites, sounds, gamemodes, items (soon).
* Resizable window with automatic letterboxing; 4:3 mode on square/portrait displays.

== Controls ==
Left Stick - Move

Right Stick - Aim

RT - Shoot

ZL - Parry

LT - Bomb

ZR - Melee

Start - Pause

== Modding ==
Mods live in the <code>mods/</code> directory and are discovered at startup. A mod folder has the following structure:
<pre>
mods/mymod/
mod.cfg
characters/ (.cschar)
maps/ (.csm)
packs/ (.cspack)
sprites/
sounds/
gamemodes/
items/
</pre>
Example <code>mod.cfg</code>:
<pre>
[mod]
id=mymod
name=My Mod
version=1.0

[content]
characters=true
maps=true
sprites=true
sounds=true

[overrides]
player_speed=600
enemy_hp=5
</pre>
Multiplayer mod sync ships all enabled mod content to clients before the match starts (cap: 64 MB). Character bundles sync separately (cap: 10 MB per player). Synced files land in <code>mods/_mp_sync/</code> and are rebuilt each session.

== Changelog ==
'''v3.5.0'''
* Map loading screens, a CRT power-on transition, and multiplayer readiness sync.

'''v3.4.0'''
* Endless mode: a storage-free, seeded infinite world (set Endless + Seed in the Play menu).
* Giant maze buildings, chained-room buildings, tiled-floor rooms.
* New enemies: Bomber (suicide rusher), Spitter (acid spread), Warden (armored tank) - placeable in the editor.
* Telegraphed bombings: static barrages and AVI plane flyovers that crater and scorch terrain.
* Tactical/military in-game HUD, heavier damage-impact feedback, off-screen enemy arrows.
* Combo system + game-feel juice, reworked car physics, player-centered minimap for huge maps, maps up to 1000 tiles.
* Fixes: stuck soft-keyboard breaking parry/weapon-switch, numeric input fields, supply-crate spawn distance, softer gunfire.

'''v3.3.1'''
* Wii U: ENet networking ported (online/LAN multiplayer).
* Android: on-screen controls baked to textures (big framerate win).
* Dialog: gamepad choice navigation; choices can branch on a variable.
* Fix: enemies and upgrade boxes no longer spawn inside collision zones.
* PC: GLES2 renderer + batching on Linux; smaller/translucent gamepad crosshairs.

'''v3.3.0'''
* Enabled batching on switch (maybe improved frametimes) and wii U (15 fps -> ~46 fps)
* Fixed software keyboard, gamepad mapping, and loggoff issues for wii U
* gamepad cursor is smaller and transparent now

'''v3.2.0'''
* New: Wii U homebrew support (WUHB).

'''v3.1.0'''
* Timeline bug fix; dragging now works

'''v3.0.0 - cutscenes'''
* Cutscene editor and dialog system officially opened
* Added better enemy pathfinding
* Editor improvements; updated icons
* Workshop closed

'''v2.5.1 - Multiplayer PvE Hotfix'''
* Multiplayer PvE: bullets and melee now correctly damage enemies in online co-op (host authority race condition resolved)
* Multiplayer PvE: melee kill events no longer broadcast on non-lethal hits

'''v2.5.0 - Old friend'''
* Many UI fixes; character-to-mod is fixed
* Sprite editor returns, but will be remade in the new UI style next update

'''v2.4.0 - switch workshop opening!'''
* Switch workshop opening

'''v2.3.2 - Android mod detection fix'''
* Android: mods now correctly detected and installed; mod paths now use CWD-relative <code>mods/</code> instead of the read-only romfs assets directory
* Android: first-run setup now creates <code>mods/</code>, <code>maps/</code>, and <code>characters/</code> subdirectories so content can be added before launch

'''v2.3.1'''
* Android folder picker: first-run setup lets you choose where game data and mods are stored — External (Shared, default), Internal (Private), or Browse for folder via the native picker
* Android workshop: HTTP downloads and ZIP extraction now use Android native Java APIs instead of curl/shell
* Known bug: Android does not detect mods/characters

'''v2.3.0'''
* Workshop on Switch: browse and install mods from the workshop directly on Switch (previously crashed due to missing curl init)
* Multiplayer & splitscreen fixes: 3-player splitscreen black panel fixed, lives scale correctly in local co-op, spectator mode no longer freezes, shared-lives death transition fixed
* Custom map save state fixed: exiting a custom map or pack no longer carries over vehicles, boss waves, or crates
* Character editor: saving an invalid character falls back to default instead of loading garbage sprites
* Switch UI: main menu Workshop / Log Off indices fixed, weather text no longer clips, lobby chat opens the Switch system keyboard

'''v2.2.0'''
* Release notes link to the full changelog comparison (v2.1.0...v2.2.0)

'''v2.1.0'''
* Vehicle system alpha
* Added support for two-layered editor mode

'''v2.0.0'''
* Chat Enter key no longer starts/readies the game; typing in chat now works after clicking the field
* Lobby <code><</code> <code>></code> spinner buttons no longer double-fire
* Floating windows (browser, media player, credits) no longer let clicks pass through to menu buttons underneath
* Chat cursor no longer shows both <code>|</code> and <code>_</code> at the same time

'''v1.9.0'''
* Android Beta
* Visuals: letterbox / unrendered area is now pure black instead of dark gray
* Build & Platform: Android Gradle build fully integrated; Switch build fixed (PKG_CONFIG_PATH-aware invocation + <code>--static</code>); <code>touchcontrols</code> compiled only on Android

'''v1.8.0'''
* Blood/scorch decals fade over time with permanent tile tint
* All bool upgrades now stack with scaled effects
* Map editor Props panel (game mode, abilities, HP/bombs/speed/damage)
* Post-last-boss endless mode: 1.3x enemies/wave, half spawn interval
* Removed Piercing upgrade

'''v1.7.0'''
* Boss Overhaul: bosses enrage at 50% HP (+30% speed, faster attacks); enraged BossBrute charge, BossSniper 3-shot burst, BossGunner 12-round burst
* Enemy Changes: all enemy base speeds ×1.5, melee enemies overhauled, enemies deal contact damage, parried bullets travel at sniper speed
* Progression: milestone spawns (Brute wave 40, Sniper wave 60, Gunner wave 80); boolean upgrades not re-offered until wave 25+
* Dev Console: press <code>~</code> in single-player; commands <code>wave N</code>, <code>hp N</code>, <code>god</code>, <code>clear</code>, <code>spawn TYPE [N]</code>, <code>give NAME</code>, <code>bombs N</code>, <code>help</code>

'''v1.6.0'''
* Music player overhaul: sequential track advance, .ogg support alongside .mp3, artist name in pause player, fixed loop toggle
* Low-HP vignette: screen fades to red below 40% HP, pulses at ≤20% HP, reverts on healing
* Editor Win98 UI: toolbar and palette converted to Win98 style; config defaults to 50×50 maps; direct keyboard input for width/height
* HUD cleanup: timer removed from STATUS panel; GAME panel widened

'''v1.5.1'''
* Release notes refer to the README changelog

'''v1.5.0'''
* Release notes refer to the README changelog

'''v1.4.1'''
* Release notes refer to the README changelog

'''v1.4.0'''
* Upgrade rarity tiers: Common 50%, Uncommon 30%, Rare 15%, Epic 4%, Cursed 1%; added <code>UpgradeQuality</code> enum
* Three new upgrades: Auto Reloader (Uncommon), Vampire (Rare), Last Stand (Epic)
* Multi-bomb: holding the bomb button with multiple bombs queued launches them in rapid succession
* PvE kills now always credited per co-op slot on the scoreboard
* Discord Rich Presence: zero-dependency IPC client on Linux and Windows; stubs cleanly on Switch and dedicated server
* AmmoUp fix: now correctly grants +5 max ammo
* Split-screen visual improvements: HP bars, invulnerability blink, parry tint, box-fragment fade

'''v1.3.0'''
* P1 hotfix: the gamepad that opened host/join stays assigned to P1 during multiplayer splitscreen
* Multiplayer splitscreen PvP hotfix: networked subplayers receive bullet damage and melee targeting as distinct local slots
* Splitscreen presentation cleanup: post-processing shader composite disabled during local and multiplayer splitscreen
* Primary controller routing fix
* Gamepad crosshair expansion across singleplayer, custom maps, packs, and multiplayer
* Fresh media pass: README and HB App Store screenshots updated

'''v1.2.0'''
* Controller rumble support via SDL_GameControllerRumble (PC, Switch, Android)
* Automatic update checker: checks GitHub API on startup; UPDATE button appears in main menu when a newer version is available
* Unified menu + creator overhaul: shared visual style supporting keyboard, controller, mouse, and touch; character creator gains walking preview, frame stepping, click-to-place muzzle offsets, save-local/save-to-mod
* Multiplayer character sync completed: remote players render their selected default or modded characters; hosts resend bundles to late joiners
* Full multiplayer mod sync: maps, packs, tiles, sprites, sound and music overrides with runtime asset resolution
* Mod sync hardening: payloads chunked, capped at 64 MB, validated before install, written through sanitized IDs and relative paths into <code>mods/_mp_sync/</code>

'''v1.1.1'''
* Security: mod sync path traversal fix — <code>deserializeAndInstallMods</code> validates mod ID and each file's relative path; crafted payloads with <code>..</code>, absolute paths, backslashes, or null bytes are rejected

'''v1.1.0'''
* Character creator rebuilt with visual preview (IDLE, SHOOT, LEGS, DEATH, DETAIL), 10 FPS playback, keyboard navigation
* PNG sprite import: new "LOAD SPRITES" button scans mod folders, loads sprites into the preview, shows color-coded completion status
* Enhanced parry system: parry now triggers a dash (1050 speed, 0.15s duration)
* Player sprites upscaled from 32×32 to 64×64, render scale 1.5×
* Texture editor removed in favor of external PNG workflow and character creator preview

'''v1.0.6'''
* Network: instant disconnect notification — clients send an app-level <code>Disconnect</code> packet before tearing down the ENet connection; guarded against double-calling <code>onPlayerLeft</code>

'''v1.0.4'''
* Linux bundle: stop bundling glibc — <code>ld-linux-x86-64.so.2</code>, <code>libc.so.6</code>, and <code>libm.so.6</code> no longer copied into <code>libs/</code>; <code>run.sh</code> uses <code>LD_LIBRARY_PATH</code> instead, fixing a SIGSEGV on launch from incompatible glibc versions

'''v1.0.3'''
* Version string sync across <code>GAME_VERSION</code>, Switch <code>APP_VERSION</code>, and Android <code>versionName</code>
* Linux bundle: loader execute permission fix (<code>chmod +x</code> after copy)
* Android CI temporarily disabled while vendored codec dependency issues are resolved

'''v1.0.2'''
* Parry kills sync over network
* Robust spawn position fallback in <code>pickSpawnPos()</code>
* Enemy HP tint safety (clamped <code>hpRatio</code>, guarded against zero <code>maxHp</code>)
* Audio shutdown fix
* Ceiling render guard against out-of-bounds reads
* CSM security hardening: map loader validates dimensions (≤ 4096) and trigger count (≤ 10 000)
* Network protocol hardening with bounds-checked string readers
* UPnP thread safety mutex
* Mod file sync read check
* Android build fix (excluded <code>server_main.cpp</code> from JNI sweep; header-only minimp3)
* Windows CI DLL bundling fix using an iterative <code>objdump</code> worklist
* Linux bundle: <code>libminiupnpc.so</code> always included

'''v1.0.1'''
* Fixed IP Connect UI labels/status coloring and saved-server highlighting
* Updated in-game title/version strings to v1.0.1
* Cross-platform build fixes for the dedicated entrypoint (Windows/Switch)

'''v1.0.0'''
* Shooter enemies now always face their target with smoother movement updates
* Dedicated server and lobby-host authority improvements from the 0.9.x line
* Version metadata fully synced to 1.0.0 across build files

'''v0.9.9'''
* Dedicated server is no longer counted as a player
* First joining client becomes lobby host on dedicated servers
* Lobby host migrates to another player if the current host disconnects
* Lobby host permissions can be transferred to another player
* Host/admin/start permissions now follow lobby-host ownership

'''v0.9.8'''
* Added dedicated server mode: <code>--dedicated</code>, <code>--port</code>, <code>--max-players</code>, <code>--password</code>, <code>--name</code>
* Added DigitalOcean deploy assets: systemd service and install helper
* Fixed lobby primary-controller behavior; carried previous networking/menu improvements

'''v0.9.7'''
* Fixed multiplayer lobby input that could create an unintended local sub-player
* Added lobby primary-controller handling for correct confirm/ready behavior
* Version bump to 0.9.7

'''v0.9.6'''
* Join menu: IP CONNECT address field supports text hostnames (letters, numbers, dot, dash, colon)
* Increased address input length for real-world server endpoints
* Version bump to 0.9.6

'''v0.9.5 — Splitscreen in Multiplayer'''
* Release notes contain a "What's New" heading without further detail

'''v0.9.1'''
* Release notes refer to the README changelog

'''v0.9.0'''
* Release notes refer to the README changelog

'''v0.7.1'''
* Release notes refer to the README changelog

'''v0.7.0'''
* Release notes refer to the README changelog

'''v0.6'''
* Map selector in lobby settings: host can cycle Generated / custom maps; selection sent to all clients
* Mod maps included in the lobby map list
* Map Width / Height disabled for custom maps
* Ceiling tiles in map editor write to <code>map_.ceiling[]</code>
* Undo / Redo in map editor: 64-level undo stack (Ctrl+Z / Ctrl+Y / Ctrl+Shift+Z; L3 / R3)
* Custom tile textures bundled with maps
* Editor direct re-save: Ctrl+S writes directly to the existing path
* Wayland-first display driver (<code>SDL_VIDEODRIVER=wayland,x11</code>)
* Bomb explosions leave scorch marks (<code>DecalType::Scorch</code>)

'''v0.5.8'''
* Release notes refer to the README changelog

'''v0.5.7'''
* Release notes refer to the README changelog

== External links ==
* GitHub - https://github.com/etonedemid/cold-start-nx
* Homebrew App Store - https://hb-app.store/switch/COLDSTART

PleNx Switch

2026-07-10T03:30:37Z

HydeWing: 0.1.14

{{Infobox Switch Homebrews
|title=pleNx
|image=pleNxSwitch.png
|description=Plex client for Switch.
|author=thcolin
|lastupdated=2026/07/05
|type=Media Players
|version=0.1.14
|license=Apache-2.0
|download=https://dlhb.gamebrew.org/switchhomebrews/pleNxSwitch.7z
|website=https://thcolin.github.io/pleNx/
|source=https://github.com/thcolin/pleNx
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Media Players) - GameBrew
|title_mode=append
|image=pleNxSwitch.png
|image_alt=pleNx
}}
pleNx (/plɛn.ɛks/, "Plex × NX") is a third-party, native, controller-first Plex client for the Nintendo Switch. It lets you browse and play the movies and shows from your Plex Media Server through a fully native interface designed for the gamepad.

pleNx is a fork of [[Switchfin]] (a Nintendo Switch Jellyfin client) fully migrated to the Plex API, with a redesigned interface. It is a third-party project, not affiliated with or endorsed by Plex.

== Features ==
* Sign in with Plex - enter a 4-character code on plex.tv/link, then choose your server and your Plex Home profile (PIN-protected profiles supported).
* Home mirrors your server - Continue Watching followed by every hub configured on your Plex, in the order your server returns them.
* Libraries in the sidebar - one entry per library, each with Home, Suggestions, Collections and Genres views, and server-side sorting.
* Rich detail pages - full-bleed backdrop with the title logo, cast with full person pages (filmography), and related rows pulled from your server.
* Season pages - artwork, episode count and synopsis, with one-tap full-season download.
* Quick actions on any poster - go to show, go to season, mark watched, download.
* Plex Watchlist - browse your account watchlist in the sidebar, add or remove any movie or show from its detail page or the quick actions menu.
* Playback with MPV - direct play and universal transcode (HLS), resume, chapters, external and embedded subtitles, audio track selection.
* Offline downloads for playback without a connection (original quality).
* Remote file browser for WebDAV / Apache / Nginx / FTP / SFTP servers.
* Available in 14 languages.
* MPV decodes H.264, H.265, VP8, VP9 and AV1 video; Opus, FLAC, MP3, AAC, AC-3, E-AC-3, TrueHD and DTS audio; and SRT, VTT, SSA/ASS and DVDSUB subtitles.

== Installation ==
Requires a Nintendo Switch running Atmosphère CFW (full-memory mode is required for playback).

Copy <code>pleNx.nro</code> to <code>sdmc:/switch/</code> and launch it from the homebrew menu.

On first launch in applet mode, pleNx offers to install a HOME menu tile: press the button, confirm, and the app relaunches as a regular title with full memory (required for video playback). Alternatively, hold R while launching any game (title takeover).

Sign in with your Plex account at plex.tv/link.

Video playback needs full-memory mode. Applet mode is fine for browsing, but install the HOME tile (or use title takeover) before starting a movie.

== Controls ==
'''During playback:'''

A - Play, Pause

B - Stop

Y - Toggle OSD

X - Menu

R/L - Seek forward/back

Plus - Video profile

Right Stick - Video quality

Left Stick - Playback speed

==Screenshots==
{| style=""max-width:80%; margin-left:0em;""
|
https://dlhb.gamebrew.org/switchhomebrews/images/pleNxSwitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/images/pleNxSwitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/images/pleNxSwitch-03.png
https://dlhb.gamebrew.org/switchhomebrews/images/pleNxSwitch-04.png
|}

== Changelog ==
'''v0.1.14'''
* '''PS Vita'''
** '''The in-app updater now installs the new version directly instead of opening a broken browser page.''' When an update was available, the Vita opened the GitHub release page in the system browser — a page its ageing WebKit cannot render, so it hung and the download never showed up. The Vita now self-updates in place like the Switch does: it downloads the VPK, unpacks it and installs it through the system package installer, then drops you back to the LiveArea to relaunch the updated bubble. (The VitaDB "downgrade to 0.1.4" prompt reported alongside this is a stale VitaDB store entry, not a pleNx bug; see <code>RELEASING.md</code>.)

'''v0.1.13'''
* '''Interface'''
** '''Series and movie logos no longer smear.''' The transparent title logos on detail pages are drawn in "fit" mode, so the image is smaller than its box and sits letterboxed inside it. The empty area around it was still being painted with the image, which sampled outside the texture and — because edge pixels are clamped — dragged vertical streaks down from every shape. The image now fills only its own fitted area, so logos render cleanly. Affects every platform (the fix is in the shared image renderer).

'''v0.1.12'''
* '''Player'''
** '''Changing the audio or subtitle track no longer stops playback with a "playback error" on PS Vita.''' In transcode mode a track change reloads the stream, but the reload happened in place and never released the hardware decoder, so it stalled and then failed. The reload now resets the player first (like episode navigation) and tears the previous transcode session down on the server instead of leaving it orphaned.
** '''Audio and subtitle tracks are now selectable during local playback from the file browser.''' The player showed the track buttons but had no handler wired, so they appeared to do nothing.
** '''A failed transcode now falls back to direct play once''', instead of going straight to an error — a smoother recovery on constrained hardware.
** '''Playback errors now show the underlying mpv reason''' (e.g. "unrecognized file format") instead of a bare "playback error", making bug reports actionable.
* '''Fixes'''
** '''PS Vita: the transcoder height is capped at 1080p''', the hardware decoder's limit, so a 4K source at a high bitrate no longer produces a stream the Vita cannot decode.

'''v0.1.11'''
* '''Fixes'''
** '''PS Vita: servers reached by a hostname no longer stall with an endless "timeout reached".''' libcurl was built with the synchronous name resolver, so a DNS lookup issued from a background thread could not be bounded by any timeout — the synchronous resolver can only abort a slow <code>getaddrinfo()</code> via <code>SIGALRM</code>, which libcurl arms on the main thread alone. A slow-to-resolve hostname (e.g. a duckdns address) therefore hung every request indefinitely, and raising the request-timeout setting had no effect; only a raw LAN IP, which skips name resolution, worked. curl is now built with the threaded resolver so lookups run in a worker thread the timeout can abandon, and <code>CURLOPT_NOSIGNAL</code> keeps libcurl off signals on its background threads.

'''v0.1.10'''
* '''Fixes'''
** PS Vita: movie logos no longer render sheared or with a torn vertical strip. GPU texture compression always extracted a full 4×4 pixel block, so for images whose width or height isn't a multiple of 4 the edge blocks pulled in the next row's pixels (the visible vertical corruption) or read past the decoded image. Edge blocks are now clamped to the valid pixels, with the border replicated into the padding for a clean edge.

'''v0.1.9'''
* '''Fixes'''
** Self-hosted servers on your LAN are reachable again when <code>plex.direct</code> DNS is blocked. Server discovery only probed the <code>plex.direct</code> hostname, whose public DNS record points at a private IP — which routers and resolvers with DNS-rebinding protection (Fritz!Box, Pi-hole, AdGuard…) refuse to resolve. A server sitting on the same network then reported "unreachable" even though it answered directly, while the official clients connected fine. pleNx now also probes the raw IP address for private, CGNAT and VPN endpoints, bypassing <code>plex.direct</code> entirely — and re-discovers a working address on reconnect when the server changes IP (e.g. a new DHCP lease)

'''v0.1.8'''
* '''Downloads'''
** The download card now shows transfer speed and ETA. While a download is running, the progress line reads <code>123 MB / 456 MB · 5.2 MB/s · 12:30 left</code>; the rate is a smoothed average (EMA) so the estimate stays steady instead of jumping on every tick
* '''Library'''
** Movie and show pages show critic and audience ratings with their official icons. Plex's rating sources are mapped to the Rotten Tomatoes tomato (fresh/rotten), the audience popcorn (upright/spilled), and the IMDb and TMDb marks, each sized to its own aspect; a plain star is kept as a fallback when the source is unknown
* '''Changelog'''
** The changelog is now readable in the app, from Settings ▸ Changelog — the full history, scrollable
** The update prompt shows the new version's release notes instead of just its number, so you can see what changed before updating

'''v0.1.7'''
* '''Sign-in'''
** Selecting a server no longer looks frozen. Picking a server (or profile) during Plex sign-in blocked all input while probing the server's connections — several seconds, with nothing on screen — so the dialog just vanished and the app seemed dead. A loading overlay now sits over the pairing screen for the whole wait, with a reassurance line that fades in if it runs long
** Account linking survives a transient network hiccup. A single timeout or TLS blip (common on Vita) no longer aborts the whole PIN flow; only an expired/consumed code is terminal, and the 2-minute deadline stays the real give-up
* '''Player'''
** Direct-access OSD. The speed control is replaced by icon buttons for audio track, subtitle track and quality. Subtitles get a live, translucent sub-delay overlay (LEFT/RIGHT) on top of the video; audio, subtitle and sub-sync leave the settings panel. Video quality is now remembered and defaults to a 4 Mbps transcode on Vita (its decoder chokes on heavy direct play), staying Auto everywhere else
** Marking watched is now a targeted card refresh instead of reloading the whole view (heavy on the home screen): the single card updates optimistically
* '''Fixes'''
** The synopsis no longer collapses to a single line when returning from a person page — a relayout had cut the text at an intermediate width. The action row also gains a little breathing room below the title/meta block
** The splash logo no longer shows a flat colored band along its edges — an edge-clamp artifact from letterboxing the non-square asset, fixed by re-exporting it square with a transparent margin
** Deleting the last card in a grid no longer leaves a ghost highlight, and emptying the downloads list hands focus back to the sidebar

'''v0.1.6'''
* '''Fixes'''
** PS Vita: transparent images no longer render as opaque black blocks. Images with real transparency now use DXT5 (8-bit alpha) instead of DXT1, which has no alpha channel; opaque images keep DXT1.

'''v0.1.5'''
* '''Fixes'''
** Controller navigation no longer breaks after closing the player; focus now returns to the first home row.
** Docking the Switch mid-playback now switches the video to fullscreen 1080p instead of leaving it small in a corner.
* '''Player'''
** Focused controls now show a translucent orange background instead of the border halo.
** The close button is a round, properly centered icon.
** Up/down wake the OSD and focus the play/pause button.
** The progress bar is focusable, with accelerating left/right seek (TV-style OSD is now the default, still toggleable).
** Removed the always-on bottom progress bar and its settings.

'''v0.1.4'''
* '''Fixes'''
** Every truncated row now ends with a "+" card opening the full list (the home rows and the Suggestions tabs of movie and show libraries previously lacked it). The card shows whenever the server reports more content than displayed.

'''v0.1.3'''
* '''Breaking'''
** New Switch title ID for the HOME menu tile (<code>0104201312000000</code>). Migration: delete any old tile ("Switchlex" or a previous pleNx) from the HOME menu, replace <code>pleNx.nro</code> on the SD card, then reinstall the tile from the app.
** The forwarder NPDM <code>program_id</code> is now generated from the single <code>PROJECT_TITLEID</code> source of truth.
* '''Fixes'''
** Branding harmonized across every derived asset (app icons, forwarder wordmark, scalable icon wrapper, website favicons / social image). The Android launcher icons and the PS4 / PS Vita system images now ship pleNx branding (Vita assets kept 8-bit indexed as the firmware requires).
* '''Website'''
** The hero opens with the app icon presented as a homebrew-menu tile next to the wordmark, and the floating nav no longer flashes before first paint.

'''v0.1.2'''
* '''Fixes'''
** Translations completed and corrected across all 13 languages (cs, de, es, fr, ja, ko, pt, ru, tr, uk, vi, zh-Hans, zh-Hant), now at full key parity with English. Filled missing strings, translated Plex sign-in and HOME-tile hint screens left in English in several locales, fixed mistranslations and typos, and restored the French "current speed" overlay placeholder.

'''v0.1.1'''
* '''Features'''
** Working in-app self-update on Nintendo Switch: pleNx offers to update itself (checked at startup and from Settings ? "Check for updates"), downloads the NRO with a live progress dialog, verifies the file size against the GitHub release asset, then replaces itself and prompts to relaunch. On other platforms the dialog opens the release page in the browser.
* '''Fixes'''
** The app now replaces the NRO it was actually launched from (<code>argv[0]</code>). Updating from 0.1.0 via the in-app dialog may appear to have no effect depending on NRO location; 0.1.0 users with the NRO at <code>sdmc:/switch/pleNx.nro</code> should replace it manually once.
** The release-asset download URL and expected size are now taken from the GitHub API response.
** The startup update check now honors its intended delay.
** All references to the repository now use its new name <code>thcolin/pleNx</code>.
** The Arch package version is now derived from <code>CMakeLists.txt</code>.

'''v0.1.0'''
* First release of pleNx, a third-party native Plex client for Nintendo Switch, macOS, Windows, Linux, Android, PS4 and PS Vita; a fork of Switchfin (a Jellyfin client) fully migrated to the Plex API with a complete UI overhaul.
* '''Features'''
** Full migration from the Jellyfin API to the Plex API: plex.tv PIN sign-in (link code), server discovery and connection selection, libraries, home hub, movies, shows, collections, search, and playback (direct play and transcode) backed by mpv.
** Complete UI overhaul with the new pleNx branding: icon-only sidebar, full-bleed detail pages, scrollable season / playlist / collection views, redesigned search, quick-actions side panel on any poster, guaranteed 2:3 poster ratios, skeletons and empty states, pill-shaped toasts.
** Plex Watchlist with provider-backed sorting and filters, add/remove from detail pages and the quick-actions menu.
** Offline downloads with storage gauge, active/completed sections, one-tap season or whole-show download, local playback.
** Remote file servers (WebDAV, FTP, SFTP, HTTP(S)) managed from the UI with a mandatory connection test before saving.
** Genre cards illustrated with Kometa default posters, playlists, collection pages, person pages, "Play again" on fully-watched shows.
** Available in 14 languages.
** Nintendo Switch specifics: applet-mode warning screen with HOME tile (forwarder) installation flow, system Standard font by default, USB drives via libusbhsfs.
* '''Fixes'''
** Fixed an infinite relayout loop, ghost focus on recycled views, NaN yoga measurements on empty text, and scroll-edge focus traps; included borealis framework patches.
* '''Build'''
** Local Nintendo Switch build via Docker; continuous delivery via GitHub Actions building all platforms (Switch NRO, macOS DMG, Windows, Linux Flatpak/Arch, Android APK, PS4 PKG, PS Vita VPK) on each <code>v*</code> tag.
* Documentation
** Jellyfin ? Plex migration plan, UI redesign reference, refreshed README.

== External links ==
* Official website - https://thcolin.github.io/pleNx/
* GitHub - https://github.com/thcolin/pleNx

Nx.js Switch

2026-07-10T03:30:37Z

HydeWing: 1.0.0-beta.6

{{Infobox Switch Homebrews
|title=nx.js
|image=nxjsswitch.png
|description=JavaScript runtime for Nintendo Switch homebrew applications.
|author=TooTallNate
|lastupdated=2026/07/09
|type=Developments
|version=1.0.0-beta.6
|license=MIT
|download=https://dlhb.gamebrew.org/switchhomebrews/nxjsswitch.7z
|website=https://nxjs.n8.io/
|source=https://github.com/TooTallNate/nx.js
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Developments) - GameBrew
|title_mode=append
|image=nxjsswitch.png
|image_alt=nx.js
}}
{{lowercase title}}
nx.js is a framework for building Nintendo Switch homebrew applications using JavaScript. Powered by the [https://bellard.org/quickjs/ QuickJS] engine, nx.js offers a streamlined and user-friendly environment for crafting homebrew apps on the Nintendo Switch console.

With nx.js, developers can harness their JavaScript skills and tools to create captivating and interactive experiences for the Nintendo Switch platform. The framework abstracts the complexities of low-level operations and presents a high-level JavaScript API that simplifies the development workflow.

nx.js is designed in accordance with Web standards, ensuring compatibility with familiar APIs such as setTimeout(), fetch(), new URL(), Canvas, and much more. If you're familiar with web development, you'll feel right at home with nx.js.

For setup and usage instructions, please visit https://nxjs.n8.io/

==Features==
* Write homebrew applications for the Nintendo Switch using JavaScript, a popular and widely supported programming language.
* Benefit from a high-level JavaScript API designed specifically for the Nintendo Switch platform, providing easy access to console-specific features and functionality.
* Capture and process user input with ease, including buttons, touch screen, and motion controls, to create engaging gameplay experiences.
* Create visually appealing and interactive user interfaces using the web [https://developer.mozilla.org/docs/Web/API/Canvas_API Canvas] API.
* Integrate audio playback and sound effects into your applications using the web [https://developer.mozilla.org/docs/Web/API/HTMLAudioElement/Audio Audio] API.
* Support for executing code compiled to [https://developer.mozilla.org/docs/WebAssembly WebAssembly (WASM)].

== External links ==
* Official website - https://nxjs.n8.io/
* GitHub - https://github.com/TooTallNate/nx.js
* GBAtemp - https://gbatemp.net/threads/nx-js-javascript-runtime-for-nintendo-switch-homebrew-applications.639171/

TKMM-NX Switch

2026-07-10T03:30:34Z

HydeWing: 2.1.4

{{Infobox Switch Homebrews
|title=TKMM-NX
|image=TKMMNXSwitch.png
|description=Lightweight OS for the Nintendo Switch.
|author=TKMM-Team
|lastupdated=2026/07/06
|type=Operating Systems
|version=2.1.4
|license=Mixed
|download=https://tkmm.org/downloads/index.html?tabs=switch
|website=https://tkmm.org/index.html
|source=https://github.com/TKMM-Team/TKMM-NX
|donation=
}}
{{#seo:
|title=Switch Homebrew Apps (Operating Systems) - GameBrew
|title_mode=append
|image=TKMMNXSwitch.png
|image_alt=TKMM-NX
}}
TKMM-NX is a mod manager for Tears of the Kingdom (TKMM) that runs directly on the Nintendo Switch.

Developed by the TKMM Team, TKMM-NX is a Linux-based operating system built upon [https://github.com/libretro/Lakka-LibreELEC Lakka (a lightweight Linux distribution focused on emulation)].

==Installation==
Download the OS Image from [https://github.com/TKMM-Team/TKMM-NX/releases Releases].

Copy the tkmm and bootloader folders to the root directory of the SD card.

Boot into RCM (Recovery Mode) on the Nintendo Switch.

Inject the Hekate payload using a compatible method.

In the Hekate menu, navigate to "More Configs" and select "TKMM" to boot into the TKMM-NX environment.

==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-01.png

https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-02.png

https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-03.png

https://dlhb.gamebrew.org/switchhomebrews/images/TKMMNXSwitch-04.png

==Changelog==
'''v2.1.3'''
* Bump OS version.
'''v2.1.2'''
* Bump OS version.
'''v2.1.1'''
* Bump OS version.
'''v2.1.0'''
* Change OS versioning scheme.
'''v2.0.3'''
* dotnet-runtime: Updated to 10.0.9
* dotnet-sdk: Updated to 10.0.301
'''v2.0.2'''
* Adjust workflow.
'''v2.0.1'''
* Revert "Temp fix for dotnet runtime".
'''v2.0.0-rev-nx1'''
* Temp fix for dotnet runtime.
'''v2.0.0'''
* Merge remote-tracking branch 'origin/main' into upfs-support.
'''v2.0.0-beta3'''
*Enabled eMMC in boot script.
'''v2.0.0-beta2'''
* Update game dump error messages.
* Disable optimizer by default.
* Use direct index merging for game__component__ConditionParam (*).
* Delete UltraCam config when optimizer is disabled.
* Bind the home button to reboot popup.
* Remove manual setup from NX setup wizard.
* Fix auto-updater checksum parser.
* Fix process name resolver.
* Fix BYML change tracking mergeable addition resolver.

(* Requires changelog rebuild)

'''v1.0'''
* First Release.

== Credits ==
The Team:
* [https://github.com/ArchLeaders Arch Leaders]: Lead TKMM Developer
* [https://github.com/LordBubblesDev Lord Bubbles]: TKMM-NX Developer
* [https://github.com/AsteroidPizza39 Aster]: Co-Founder, Artist, & Operations Manager
* [https://github.com/The5thTear The5thTear]: Co-Founder & Developer
* [https://github.com/okmika Mikachan]: Developer

Special Thanks:
* The [https://switchroot.org/ Switchroot] community for pioneering open-source development on the Nintendo Switch.
* The [https://www.lakka.tv/ Lakka] team, for its work that allowed us to create a custom OS for TKMM on Switch.
* The [https://libreelec.tv/ LibreELEC] team for creating the Linux distribution upon which all of this is built.

== External links ==
* Official Website - https://tkmm.org/index.html
* GitHub - https://github.com/TKMM-Team/TKMM-NX
* Homebrew App Store - https://hb-app.store/switch/TKMM-NX
* GameBanana - https://gamebanana.com/tools/19164

NooDS Switch

2026-07-10T03:30:32Z

HydeWing: 20260710

{{Infobox Switch Homebrews
|title=NooDS
|image=noodsnx.png
|description=A multiplatform NDS emulator.
|author=Hydr8gon
|lastupdated=2026/07/10
|type=Handheld
|version=Rolling Release
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/switchhomebrews/noodsnx.7z
|website=https://gbatemp.net/threads/noods-a-nintendo-ds-emulator-for-the-nintendo-switch.563900/
|source=https://github.com/Hydr8gon/NooDS
|donation=http://paypal.me/Hydr8gon
}}
NooDS aims to be a fast and portable Nintendo DS emulator. It's not quite there speed-wise, but it offers most other features that you might expect from a DS emulator. It even supports GBA backwards compatibility.

NooDS is available on Android, Linux, iOS, macOS, Switch, [[NooDS_Vita|Vita]] and Windows. Automatic builds are provided via GitHub Actions; you can download them on the [https://github.com/Hydr8gon/NooDS/releases releases page].

==Installation==
NooDS should be able to run most things without additional setups.

DS BIOS and firmware files must be provided to boot from the DS menu, which can be dumped from a DS with [https://archive.org/details/dsbf-dumper DSBF Dumper]. The firmware must be dumped from an original DS; DSi and 3DS dumps don't have any boot code.

A GBA BIOS file must be provided to run GBA games, which can be dumped from many systems with [https://github.com/mgba-emu/bios-dump this dumper]. The BIOS and firmware file paths can be set in the settings.

Although not always accurate, save types are automatically detected. Manual alteration of the save type is needed if you load a new game and saving does not work.

== External links ==
* Author's website - https://hydr8gon.github.io/
* GitHub - https://github.com/Hydr8gon/NooDS
* GBAtemp - https://gbatemp.net/threads/noods-a-nintendo-ds-emulator-for-the-nintendo-switch.563900/
* Discord - https://discord.gg/JbNz7y4

PSV Cleaner Vita

2026-07-10T03:30:31Z

HydeWing: 1.14

{{Infobox Vita Homebrews
|title=PSV Cleaner
|image=PSVCleanerVita.png
|description=A powerful and user-friendly temporary files cleaner.
|author=theheroGAC
|lastupdated=2026/07/08
|type=Utilities
|version=1.14
|license=N/A
|download=https://github.com/theheroGAC/PSV-Cleaner/releases
|website=https://theherogac00.itch.io/psv-cleaner-playstation-vita-temporary-files-cleaner
|source=https://github.com/theheroGAC/PSV-Cleaner
|donation=
}}
{{#seo:
|title=Vita Homebrew Apps (Utilities) - GameBrew
|title_mode=append
|image=PSVCleanerVita.png
|image_alt=PSV Cleaner
}}
A powerful and user-friendly temporary files cleaner for the PS Vita. It can help you free up valuable storage space by safely removing temporary files, cache data, and system dumps that accumulate over time.

== Features ==
* Removes 90+ types of temporary files including system cache, homebrew logs, and application data.
* Only deletes temporary files, never touches your games, saves, or important data.
* Safely interrupt cleaning operations at any time with the Circle button.
* See exactly which files will be deleted before cleaning with detailed list view.
* Choose what to clean with an intuitive options menu.
* See exactly how much space you can free before cleaning with recursive calculation.
* Clean, professional UI with smooth animations and scrollable file list.
* Designed to prevent crashes and ensure stable performance.

== Installation ==
Download the VPK file.

Install using VitaShell or PKGi.

== User guide ==
===What it cleans===
* System Files:
** System temporary files and cache
** System logs and SQLite temporary databases
** System update and patch temporary files
** Shader compilation logs
* File Managers & Package Installers:
** VitaShell file manager cache, logs, and trash
** PKGi package installer temporary files and cache
** Package installation temporary files
** App metadata temporary files
* Emulators:
** RetroArch emulator cache, logs, and shader cache
** Adrenaline PSP emulator cache and crash dumps
** PSP emulator temporary files
* Homebrew Applications:
** VitaGrafix, reF00D, NoNpDrm cache
** Autoplugin 1 & 2 cache and logs
** PSVshell, SaveManager logs
** VitaCheat, rinCheat, TropHAX logs
** Henkaku, TAI, 0syscall6 cache
** Moonlight streaming cache
* Media & Web:
** Browser and WebKit cache
** Picture, video, music thumbnails (regenerable)
** Network temporary files
* Other:
** Crash dump files (<code>psp2core</code>, <code>psp2dmp</code>)
** USB/SD card storage temporary files
** Background download temporary files
** License temporary files

===Important notes===
* Backup important data before first use (though it's safe, it's always good practice).
* Works best with regular use to maintain optimal performance.
* Compatible with all major PS Vita homebrew applications.

===How to use===
*Launch the application.
*View how much space can be freed (calculated recursively).
*Press Cross to preview all files that will be deleted.
*Review the detailed file list with sizes.
*Press Cross again to confirm and start cleaning.
*Watch the progress bar complete.
*See results and updated space available.

Optional: Press Triangle on main screen to access selective cleaning options.

==Screenshots==
[[image:PSVCleanerVita.png|640px|link=]]

==Changelog==
'''1.14'''
* Crash Bug Fix (Cache Buffer Overflow)
* Add Precise & Responsive Progress Bar (UI Freeze Fix)
* Typo Fixes & Config Enforcement (ONEMenu & Helper Filter)
* .PKG File Cleaning support
'''1.13'''
* Fixed crashes when navigating cleaning profiles in the main menu.
* Improved UI alignment in Advanced Configuration to prevent selection bars from overlapping.
* Added dynamic color feedback for checkboxes (Active vs Inactive).
* Enhanced path validation to support multiple partitions (ux0:, ur0:, uma0:).
* Improved TitleID validation to prevent accidental deletion of installed app data.
'''1.12'''
* Added new folders and orphaned files for cleaning.
* We now have a more thorough control of temporary files additional options inserted.
'''1.11'''
* Speeded up the home screen.
'''1.10'''
* What's New
** Folders checked for each installed app:
*** ux0:data/[TITLEID]/ - The app's main data folder
*** ux0:patch/[TITLEID]/ - The app's patches folder
*** ux0:addcont/[TITLEID]/ - The app's DLC/addons folder
*** What is cleaned in each folder:
*** Subfolders: cache/, temp/, tmp/, logs/, log/
*** Temporary files in the root with extensions: .tmp, .temp, .log, .cache, .bak, .old, .swp
*** Files with names containing: "temp", "tmp", "cache", "log"
*** Folders NOT touched (for security):
*** ux0:user/00/savedata/[TITLEID]/ - Saved files (never touched)
*** ux0:app/[TITLEID]/ - Files from the app itself (never touched)
*** The feature now scans all three folders for each app installed, finding more temporary files and freeing up more space.
** Implemented feature: Selective cleaning for individual apps: Press SELECT in the main menu to open the app list.
*** The list shows all installed apps with occupied space.
*** Navigate with the D-Pad, clean with X, go back with O.
*** How it works:
*** Press SELECT in the main menu.
*** A list of all installed apps is displayed.
*** Each app displays its TITLE ID and the space occupied by temporary files.
*** Navigate with the D-Pad ↑↓ to select an app.
*** Press X to clean that app's temporary files.
*** A confirmation message appears with freed space.
*** The list updates automatically after cleaning.
'''1.09'''
* What's New
** Enhanced User Experience
*** Intuitive navigation: Up/Down profile selection with arrows
*** Optimized menu: Texts and elements repositioned
*** Now you have the ability to delete temporary files if a game or app is uninstalled from the livearea
** Advanced Features
*** Direct flow: "Complete Clean" skips to file preview
*** Extended orphan cleanup: License and patch directories beyond apps
'''1.08'''
* What's New
** Support for storage uma0!
** Selective Cleaning
** Removed unnecessary plugin cleaning!
* Fixes
** Fixed some wrong folder paths that were in there
** Better multi-partition support
** More accurate file detection
'''v1.07'''
* New Stuff
** Smart Preview Mode: You can now see all files before deleting them, sort by name or size, and filter by file type (tmp, log, cache, etc.). Super helpful for knowing exactly what you're cleaning!
** VitaDB Support: Added full support for cleaning VitaDB's cache and temp files. You can choose to exclude VitaDB cache if you want to keep it fast.
** Better Exclusions: Added options to exclude picture folders and VPK files from cleaning. More control over what gets deleted.
* Improved Controls
** Preview Screen: Use △ to sort files, □ to filter by type, D-Pad to navigate, X to clean, O to cancel
** Menu Scrolling: Long menus now scroll properly with a visual scrollbar
** Better Feedback: Everything feels more responsive and clear
** Expanded cleanup to cover even more temp files and caches
'''v1.06'''
* Codebase Cleanup
** Removed ALL comments - Completely comment-free codebase for cleaner, more professional code
** Streamlined structure - Minimalist C code with zero unnecessary documentation
* Critical Bug Fixes
** Fixed VPK file deletion - Now properly deletes <code>.vpk</code> files from <code>ux0:/</code> root directory
** Fixed UI button labels - Corrected duplicate and inaccurate button descriptions in advanced options
** Fixed wildcard pattern handling - VPK files now use proper directory scanning instead of broken wildcards
* Enhanced User Experience
** Animated progress bars - Added particle effects and smooth animations during cleaning
** Improved button labels - X button shows "Toggle", Triangle shows "Back", O shows "Preview"
** Better visual feedback - Enhanced UI with pulsing effects and animated borders
* Expanded Cleanup Coverage
** VPK files - Complete support for Vita app installation files
** RetroArch temp files - Comprehensive cleanup of emulator cache, logs, and temp data
** Crash dump files - Enhanced <code>.psp2dmp.tmp</code> and related file detection
** Screenshot cleanup - Automatic removal of <code>ux0:picture/SCREENSHOT/</code> files
** Package temp files - Added <code>pkgj</code> temporary file cleanup
* Performance & Features
** Intelligent caching system - <code>scan_cache.bin</code> speeds up subsequent scans
** Emergency stop functionality - Safe interruption with O button during cleaning
** Profile-based cleaning - Quick, Complete, and Selective cleaning modes
** Preview before delete - See exactly what files will be removed
* UI/UX Improvements
** Particle effects - Animated progress bars with flying particles
** Better color scheme - Improved contrast and readability
** Responsive controls - Clear button mappings for all screens
** Status indicators - Real-time feedback during operations
'''v1.05'''
* Added
** Intelligent Caching System - Revolutionary performance improvement for file scanning
*** Smart Cache Storage - Saves scan results to avoid rescanning unchanged directories
*** Directory Change Detection - Automatically detects when directories have been modified
*** Cache Expiration - 24-hour cache validity with automatic refresh
*** Instant Loading - Up to 5x faster startup times for subsequent app launches
*** Memory Efficient - Optimized cache structure with validation and error handling
** Code Optimization & Cleanup - Streamlined codebase for better maintainability
*** Removed Legacy Code - Eliminated CloneDVD sound references and unused functions
*** Splash Screen Removal - Removed unnecessary splash screen for faster app startup
*** Comment Cleanup - Removed obsolete comments and improved code documentation
*** Resource Optimization - Eliminated unused assets and reduced package size
* Performance Improvements
** Intelligent Scanning - Cache-based directory scanning with change detection
** Faster Startup - Reduced initialization time through caching system
** Memory Optimization - Better memory management for large file operations
** I/O Reduction - Minimized disk access through intelligent caching
* Technical Enhancements
** Cache Management - Automatic cache invalidation after cleaning operations
** Error Handling - Robust cache validation and fallback mechanisms
** Version Control - Cache versioning for future compatibility
** Resource Cleanup - Proper cleanup of cache files and temporary resources
* UI/UX Improvements
** Faster Response - Instant app responsiveness through caching
** Cleaner Interface - Removed visual clutter and unnecessary elements
** Improved Performance - Smoother operation with reduced loading times
'''v1.04'''
* Added
** Emergency Stop System - Safe interruption of cleaning operations
*** Real-time Stop - Press Circle button during cleaning to stop safely
*** Operation Tracking - Monitors active operations and cleanup state
*** Emergency Screen - Clear feedback when operation is interrupted
*** Partial Results - Shows statistics of files actually deleted before interruption
*** Safe Cleanup - Proper resource cleanup when stopping mid-operation
*** Visual Feedback - Progress bar shows "Stopping operation..." when stopping
** Enhanced User Safety - Improved operation control
*** Graceful Interruption - Handling of operation interruption with user feedback
*** System State Preservation - Recovery options after emergency stop
*** Informative Emergency Screen - Details about what happened during interruption
* Technical
** Emergency Stop Flags - Global flags for operation state tracking
** Safe Operation Lifecycle - Start/end/cleanup operation management
** Improved Progress Bar - Visual feedback for emergency stop requests
** Resource Cleanup Functions - Proper cleanup when operations are interrupted
* UI & UX Improvements
** Operation Management - Better handling of long-running operations
** Emergency Stop Request Handling - Safe state transitions during interruptions
** User Confirmation for Interrupted Operations - Clear messaging about operation status
'''v1.03'''
* Added
** Cleaning Profiles System - Three intelligent cleaning modes
*** Quick Profile - Only safe cache files (VitaShell, PKGi, RetroArch, Browser, etc.)
*** Complete Profile - All temporary files and system cleanup (default mode)
*** Selective Profile - User manually chooses which categories to clean
** Profile Selection Screen - Elegant initial screen at app startup
*** Navigate profiles with D-Pad Up/Down
*** Detailed descriptions for each profile mode
*** One-time selection that configures the entire session
** Cleanup Counter System - Persistent statistics tracking
*** Saves total number of cleaning sessions
*** Displays "Cleanup #X" on completion screen
*** Persistent storage in ux0:data/PSV_Cleaner/counter.txt
** Additional Cleaning Paths - Extended coverage
*** ux0:download/ and ux0:downloads/ complete directory scanning
*** Enhanced download temporary file detection
* Improved
** User Interface Centering - Professional text positioning
*** All main titles perfectly centered on screen
*** Consistent button alignment and spacing
*** Improved visual hierarchy
** Profile-Based Menu Initialization - Dynamic menu configuration
*** Menu options automatically set based on selected profile
*** Quick mode: only cache categories enabled by default
*** Complete mode: all cleaning options enabled
*** Selective mode: nothing pre-selected for manual choice
** Navigation Experience - Enhanced user flow
*** Square Button: Change cleaning profile anytime
*** Seamless switching between profile modes
*** Persistent profile memory during session
* Technical
** Added PROFILE_QUICK, PROFILE_COMPLETE, PROFILE_SELECTIVE enum system
** Dynamic menu initialization with profile parameter
** Persistent counter file management
** Enhanced download path coverage (now 95 cleaning paths total)
** Improved text positioning calculations for perfect centering
'''v1.02'''
* Added
** File Preview System - View all files that will be deleted before cleaning with detailed list
*** Scrollable file list supporting thousands of files
*** Individual file sizes displayed
*** Total files count and size summary
*** Navigate with D-Pad Up/Down
*** Confirm with X or cancel with O
** Enhanced File Detection - Added 40+ new cleaning paths
*** VitaGrafix cache and logs
*** reF00D cache
*** NoNpDrm temporary files
*** 0syscall6 cache
*** TAI plugin system cache
*** PSVshell logs and cache
*** SaveManager logs
*** VitaCheat, rinCheat, TropHAX logs
*** WebKit cache and localstorage
*** Network temporary files
*** SQLite temporary databases
*** Package installation temp files
*** Media thumbnails (picture, video, music)
*** RetroArch shader cache
*** Background download temp files
*** And more...
** Statistics Display - Detailed completion screen showing:
*** Total space freed
*** Number of files deleted
*** Visual success indicator
** Dump File Detection - Special scanning for crash dump files
*** Detects .psp2dmp files in ux0:data/
*** Detects .psp2core files in ux0:data/
*** Shows in preview list before deletion
* Improved
** Recursive Space Calculation - Fixed space calculation to scan subdirectories
*** Now correctly calculates all temporary files in nested folders
*** More accurate space estimation before cleaning
** Auto-Refresh After Cleaning - Space available automatically recalculates after each cleaning session
*** No more stuck at zero after cleaning
*** Fresh calculation on every app launch
** Memory Management - Dynamic file list with automatic expansion
*** Efficient memory allocation for large file lists
*** Proper cleanup to prevent memory leaks
* Fixed
** Space calculation showing zero after cleaning
** Missing files in subdirectories during scan
** Crash dump files not appearing in preview
* Technical
** Total cleaning paths increased from 54 to 94
** Added global file counter for deletion tracking
** Improved recursive directory scanning algorithm
** Enhanced preview system with scrollbar for large lists
'''v1.01'''
* Bug fix and other features.
'''v1.0'''
* First Release.

== External links ==
* itch.io - https://theherogac00.itch.io/psv-cleaner-playstation-vita-temporary-files-cleaner
* GitHub - https://github.com/theheroGAC/PSV-Cleaner

Snes9x 3DS (Updated Fork)

2026-07-10T03:30:30Z

HydeWing:

{{Infobox 3DS Homebrews
|title=Snes9x Fork
|image=snes9xfork3ds.png
|description=SNES9x Port for 3DS / 2DS.
|author=bubble2k16, willjow, matbo87, Xeddius-Network
|lastupdated=2026/06/28
|type=Console
|version=1.61
|license=[https://github.com/matbo87/snes9x_3ds/blob/master/LICENSE.md LICENSE]
|download=https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds.7z
|website=https://github.com/matbo87/snes9x_3ds
|source=https://github.com/matbo87/snes9x_3ds
|donation=
}}
{{#seo:
|title= (Console) - GameBrew
|title_mode=append
|image=snes9xfork3ds.png
|image_alt=Snes9x Fork
}}
This project is a fork of the legacy [[SNES9x 3DS|snes9x_3ds]] codebase by [https://github.com/bubble2k16/snes9x_3ds bubble2k] and continues that work with a modernized architecture and improved user experience. It builds with current devkitARM, libctru and citro3d releases (as of June 2026). Optional assets are available in the dedicated asset repository: [https://github.com/matbo87/snes9x_3ds-assets snes9x_3ds-assets].

It works on all 2DS and 3DS models. Old 2DS/3DS mainly struggle with Super FX and SA-1 games, but most SNES titles run well.

== Features ==
* Improved rendering for HDMA-heavy games and mosaic effects.
* SNES refresh rate matching (60.1 Hz for NTSC, 50 Hz for PAL).
* NDSP audio output.
* Rich visual customization with thumbnails, themes, per-game backgrounds and overlays.
* Crop and overscan.
* Improved cheat management.
* Extended hotkey options and screen swap support.
* Directory caching for faster ROM list loading.

==Installation==
'''Instructions:'''
* A modded 3DS is required.
* Install via [[Universal-Updater 3DS|Universal Updater]], or install the latest .cia from [https://github.com/matbo87/snes9x_3ds/releases Releases].
* Optional: download asset packs from [https://github.com/matbo87/snes9x_3ds-assets/releases snes9x_3ds-assets releases].
* ROMs can be stored in any folder. ZIP files are not supported.

'''3DSX version:'''
* Copy snes9x_3ds.3dsx to sd:/3ds/snes9x_3ds
* Start it from the Homebrew Launcher

'''Supported ROM formats:'''
* .smc
* .sfc
* .fig
* .bs
* .bsx

Configs, saves and imported assets are stored in sd:/3ds/snes9x_3ds.

==User guide==
=== Assets (images and cheats) ===
Assets are provided in dedicated asset repository: [https://github.com/matbo87/snes9x_3ds-assets matbo87/snes9x_3ds-assets]

Notes:
* The repository follows a 1G1R-style selection.
* Naming is strict No-Intro style for matching.

Folder structure:
<pre>
3ds/
└── snes9x_3ds/
├── backgrounds/
│ ├── game_screen/
│ │ ├── _default.png
│ │ ├── Super Mario World.png
│ │ └── ...
│ └── second_screen/
│ ├── _default.png
│ ├── Super Mario World.png
│ └── ...
├── cheats/
│ └── Super Mario World.chx
│ └── ...
├── overlays/
│ ├── _default.png
│ ├── Super Mario World.png
│ └── ...
└── thumbnails/
├── boxart.cache
├── gameplay.cache
└── title.cache
</pre>

=== .CHX Cheat file format ===
The .CHX is a cheat file format that you can create with any text editor. Each line in the file corresponds to one cheat, and is of the following format:

<pre> [Y/N],[CheatCode],[Name]</pre>

* [Y/N] represents whether the cheat is enabled. Whenever you enable/disable it in the emulator, the .CHX cheat file will be modified to save your changes.
* [CheatCode] must be a Game Genie or a Pro Action Replay code.
** A Game Genie code looks like this: F38B-6DA4.
** A Pro-Action Replay code looks like this: 7E00DC04.
* [Name] is a short name that represents this cheat. Since this will appear in the emulator, keep it short (< 30 characters).

The .CHX must have the same name as your ROM. This is an example of a .CHX file:

Filename: Gradius III (U) [I].CHX

Y,F38B-6DA4,Start with 31 lives
Y,7E00DC04,Constant Megacrush (enemies die)

You can only have either .CHT or .CHX in your ROM folder for the same ROM. If you have both, only the .CHX file will be effective.

=== FAQ ===
'''Q. A game runs slow. How can I improve performance?'''

* Increase <code>Frameskips</code> (more than 2 isn't recommended)
* Set <code>Frame Sync Method</code> to <code>Sleep Sync</code>
* Set <code>In-Frame Palette Changes</code> to <code>Disabled Style 1</code> or <code>Disabled Style 2</code>
* Set <code>SRAM Auto-Save Delay</code> to 60 seconds or disable it
* Disable 3D and/or on-screen display settings

'''Q. A game looks or sounds wrong. What can I try?'''

* Set <code>In-Frame Palette Changes</code> to <code>Enabled</code>
* Increase <code>Audio Buffer Size</code> if audio crackles, skips or stutters
* Enabled cheats can break visuals or gameplay; disable cheats and reload the game
* Check if your ROM is valid (No-Intro is highly recommended; ROM hacks may have issues)
* Check the [https://github.com/matbo87/snes9x_3ds/blob/master/KNOWN_ISSUES.md Known Issues]

'''Q. Cheats are not working properly'''

* Cheat support is only lightly tested and some codes may not work correctly
* Use cheats with caution: broken codes can affect gameplay or damage save data

'''Q. Satellaview (BS-X) games'''

Satellaview games are supported, but compatibility is hit-or-miss. See [https://github.com/matbo87/snes9x_3ds/blob/master/KNOWN_ISSUES.md Known Issues] for details and per-game status.

==Controls==
Touchscreen - Menu

Up/Down - Choose option

A - Confirm

X+D-Pad Up/Down - Page Up/Page Down)

Left/Right - Change between ROM selection and emulator options

You can quit the emulator to your homebrew launcher/your CFW's home screen.

==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-01.png
https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-02.png

https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-03.png
https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-04.png

== Changelog ==
'''v1.61'''
* Features
** Added 3D depth strength setting and refined splash/background depth effects ([https://github.com/matbo87/snes9x_3ds/issues/65 #65])
*** Custom game-screen backgrounds are now ideally 448x256 instead of 400x240; 400x240 images can expose edges at higher 3D depth settings.
*** Updated 448x256 game-screen backgrounds are available in the [https://github.com/matbo87/snes9x_3ds-assets/releases/tag/v1.1.0 snes9x_3ds-assets v1.1.0] release.
** Added save-state screenshot previews
** Added per-game crop/overscan control ([https://github.com/matbo87/snes9x_3ds/issues/55 #55])
** Added scanlines
** Added Mode 7 bilinear smoothing (thanks to f4mrfaux) ([https://github.com/matbo87/snes9x_3ds/pull/68 #68])
** Added Frame Sync setting with VBlank/Sleep pacing options
*** Sleep Sync can make games run smoother when they stutter or won't hold full speed, e.g. DKC2 on Old 3DS.
* Rendering & Compatibility
** Improved HDMA/in-frame palette compatibility for games with mid-frame palette changes ([https://github.com/matbo87/snes9x_3ds/pull/73 #73])
*** Helps games such as Top Gear and Super Turrican.
** Added mosaic rendering support (thanks to f4mrfaux) ([https://github.com/matbo87/snes9x_3ds/pull/70 #70])
** Fixed stale core data after switching ROMs
** Fixed several game-specific rendering/timing issues
*** Includes fixes for Sim City intro, Jurassic Park transparency and Super Bases Loaded 2 crash.
** Optimized Mode 7 tile 0 blit (thanks to f4mrfaux) ([https://github.com/matbo87/snes9x_3ds/pull/67 #67])
* Audio
** Migrated audio output from CSND to NDSP and improved audio scheduling/stability (thanks to f4mrfaux) ([https://github.com/matbo87/snes9x_3ds/pull/58 #58], [https://github.com/matbo87/snes9x_3ds/commit/7ff81cc18ee599792788765641c46d07ad427c4a 7ff81cc])
** Added audio buffer size setting
*** Lower values reduce latency; higher values reduce the chance of crackling.
* Documentation
** Added [https://github.com/matbo87/snes9x_3ds/blob/v1.61/KNOWN_ISSUES.md KNOWN_ISSUES.md] with compatibility notes for problematic games, Satellaview (BS-X) titles and common visual/audio issues.
'''v1.60.2'''
* Bug Fixes
** Fixed in-game freeze after toggling "Disable 3D" in menu ([https://github.com/matbo87/snes9x_3ds/issues/54 #54]) ([https://github.com/matbo87/snes9x_3ds/commit/52519966952f147694331be0f372f52deab4c3fb 5251996])
** Fixed SNES core regressions introduced by earlier cleanup commits ([https://github.com/matbo87/snes9x_3ds/commit/14af4191c13a28ac5b4fad388b62c22de39dd791 14af419], [https://github.com/matbo87/snes9x_3ds/commit/fb200abbcad6aa3012486172f08b7d92a9c318db fb200ab])
* Other Improvements
** Reintroduced fast-forward hold hotkey and preserved legacy config compatibility ([https://github.com/matbo87/snes9x_3ds/issues/23 #23]) ([https://github.com/matbo87/snes9x_3ds/commit/ce600fc1fe10a4f4fb59d3b0ac3c9444795ffe64 ce600fc])
** Minor UI adjustments ([https://github.com/matbo87/snes9x_3ds/commit/e097bb6dd31886a552e91714a4e283233b727c2b e097bb6], [https://github.com/matbo87/snes9x_3ds/commit/5b6188aab0e94bd37f6a188714d1b7b7c71193db 5b6188a])
'''v1.60.1'''
* Bug Fixes
** Fixed VRAM read control flow regression ([https://github.com/matbo87/snes9x_3ds/issues/46 #46]) ([https://github.com/matbo87/snes9x_3ds/commit/c32c5ab569ef104397b1ae861547ff71ff2bc27e c32c5ab])
** Fixed WindowLR overlap tagging when trimming black scanlines ([https://github.com/matbo87/snes9x_3ds/issues/46 #46]) ([https://github.com/matbo87/snes9x_3ds/commit/d536983fca3191096a1a91ee9110fdeb89230cc0 d536983])
* Reintroduced Features
** Reintroduced optional screen smoothing for stretched modes ([https://github.com/matbo87/snes9x_3ds/issues/51 #51]) ([https://github.com/matbo87/snes9x_3ds/commit/432d202495a751453bd1506366ec800547bb1ea2 432d202])
** Reintroduced per-game framerate override (Auto or Force 60 FPS) ([https://github.com/matbo87/snes9x_3ds/issues/50 #50]) ([https://github.com/matbo87/snes9x_3ds/commit/b4f45e83d9f3c52a02838da009584cffac622b01 b4f45e8])
* Maintenance
** Documented bundled makerom sources for provenance ([https://github.com/matbo87/snes9x_3ds/issues/47 #47]) ([https://github.com/matbo87/snes9x_3ds/commit/4cae63094ec24ec13fecb0a36643b24f7c023682 4cae630])
** CI/tooling updates for GitHub Actions compatibility ([https://github.com/matbo87/snes9x_3ds/commit/475042a9d49e7545f55a97ae69b043b07a049e71 475042a], [https://github.com/matbo87/snes9x_3ds/commit/7e1a91a4ed1859b81dd30b87de22362943a7f342 7e1a91a])
'''v1.60'''
* Major Changes
** '''Rendering backend migration''': move from legacy GPU code to citro3d
** '''Draw-call batching overhaul''': fewer draw calls via batched rendering and XOR-based packed render-state diffing
** '''GPU decoupling''': separate <code>gfxhw</code> state preparation from the GPU submission path for a cleaner rendering pipeline
* Performance
** '''Rendering throughput''':
*** layer/section collection and merged backdrop/color-math passes to reduce redundant draws
*** uniform upload and render-state update optimizations (including patched citro3d max-dirty behavior)
** '''I/O and memory''':
*** faster save/config writes and improved file I/O architecture
*** reduced heap fragmentation pressure
*** menu/file navigation streamlined, with snappier behavior on old 2DS/3DS models
*** improved ROM list caching
** '''Asset handling''':
*** background assets on 16-bit texture formats (RGB565) to reduce memory bandwidth/footprint
*** replace <code>stb_image</code> with a <code>libpng</code>-based path that uses a shared file scratch buffer (<code>g_fileBuffer</code>) and an aligned shared stream buffer (<code>g_streamBuffer</code>) to reduce heap churn/fragmentation
* Features
** '''Thumbnail system''':
*** replace fragile thumbnail background-thread loading with on-demand reads from one cache file per thumbnail type
*** removes shared-state race issues and keeps thumbnail loading fast and stable for large ROM folders
** '''SNES-accurate refresh-rate matching''':
*** when gameplay starts/resumes, 3DS LCD timing is set to the game's native SNES rate (NTSC ~60.1 Hz / PAL 50 Hz)
** '''On-Screen Display''':
*** bezel overlay with auto-fit support
*** FPS overlay option
*** GPU-accelerated notifications
** '''Stereoscopic 3D additions''':
*** basic 3D support for splash screen, in-game scene background, and pause overlay
* Stability & Code Quality
** '''Code-quality cleanup''': broad typing, const/sign correctness, return-path, warning cleanup across both 3DS frontend and SNES core
** '''Build warning policy upgrade''': remove old global warning suppression (<code>-w</code>) and move to enabled warnings enforcing <code>-Werror</code> by default
* Breaking Changes
** '''Config migration''': <code>settings.cfg</code> may not migrate cleanly in all cases; defaults can be applied
** '''Thumbnail assets''': legacy per-image thumbnail folders are obsolete; thumbnails now load from <code>*.cache</code> files (<code>boxart.cache</code>, <code>gameplay.cache</code>, <code>title.cache</code>)
** '''Background asset paths''':
*** <code>snes9x_3ds/borders</code> -> <code>snes9x_3ds/backgrounds/game_screen</code>
*** <code>snes9x_3ds/covers</code> -> <code>snes9x_3ds/backgrounds/second_screen</code>

'''v1.52'''
* Improved thread safety to prevent crashes from concurrent ROM list access.
* Enhanced shutdown stability by fixing resource cleanup issues.
* Added display options.

'''v1.51.1'''
*Bug Fixes:
** Old 3DS, Old 2DS: fix crash on O3DS/O2DS when user opens menu after game has loaded ([https://github.com/matbo87/snes9x_3ds/issues/11 #11]) ([https://github.com/matbo87/snes9x_3ds/commit/71ed471f3f9bfea74f42105ddbbbf3b9e9a94c07 71ed471])

'''v1.51'''
*Features:
** Theme option: add Dark mode and RetroArch theme ([https://github.com/matbo87/snes9x_3ds/issues/2 #4]) ([https://github.com/matbo87/snes9x_3ds/commit/d343ca60fb0e380fa9b4239c7ebf346e0ff86e6c d343ca6]).
** File menu: adjust navigation pattern + provide more options in file menu tab ([https://github.com/matbo87/snes9x_3ds/issues/2 #4] [https://github.com/matbo87/snes9x_3ds/commit/d343ca60fb0e380fa9b4239c7ebf346e0ff86e6c d343ca6], [https://github.com/matbo87/snes9x_3ds/commit/ea2cd3fa970f81a4384ebf0c7b014b429d4d7d34 ea2cd3f])
*** Going up a directory by pressing B.
*** Option to set a default starting folder.
*** Delete game option.
*** Random game option.
** Pause screen: show a decent pause screen when menu is open during gameplay ([https://github.com/matbo87/snes9x_3ds/commit/4c9f3ecb333eaf23da85e9199bdbbfa3511312dd 4c9f3ec])
*Bug Fixes:
** O2DS: fix crash on O2DS (and probably O3DS as well) when saving SRAM ([https://github.com/matbo87/snes9x_3ds/issues/2 #2] ([https://github.com/matbo87/snes9x_3ds/commit/02788b17d038e30e612dcbf0719ec45a8fc54a43 02788b1])
*Code Refactoring:
** Menu: reduce redundant code + preserve selected item index per tab ([https://github.com/matbo87/snes9x_3ds/commit/493c1a22b3975c7cb39a55dbd38140e5e3cd2a14 493c1a2], [https://github.com/matbo87/snes9x_3ds/commit/4d6378a507cb77571e4444abb6fbd0df3ff5f555 4d6378a])
** Dialogs: remove unnecessary animations for a snappier appearance ([https://github.com/matbo87/snes9x_3ds/commit/2bb82c69512a2ef894ee5bb049be13ba567b6e89 2bb82c6])
** Second screen content: clean up + prevent flickering when info dialog appears/disappears ([https://github.com/matbo87/snes9x_3ds/commit/c1899df01828b9653c3c635695e61d1ce4fbeaee c1899df])

'''v1.50'''
*Features:
** Game preview option: boxart, title or gameplay.
** Improved cheat menu: now with available/activated indicator.
** Updated Banner: based on SNES VC banner.
** Menu clean up:
*** Reset config(s) option.
*** Autosave is now game-specific.
*** Show saving dialog instead of freezed menu.
*Bug Fixes:
** Cheats: Fix cheats not loaded/saved properly.
** Default button mappings: Fix missing default controls.
** Home menu button: make emulator quit properly when user exits via home menu button.
** Pixel perfect mode: Fix blurry image (mentioned [https://github.com/asdolo/snes9x_3ds_forwarder/pull/1 here]).
** Long game lists: Fix app crash on exit.
*Code Refactoring:
** Makefile & app.rsf: use TricksterGuy's [https://github.com/TricksterGuy/3ds-template 3ds-template], update compiler options.
** Image loading/rendering: use stb_image instead of lodepng for faster image decoding, unify image rendering logic.
** Second screen content: improve performance.
*Breaking changes:
** Folder structure: All game related files are now in "3ds/snes9x_3ds", similar to RetroArch folder structure.

'''v1.45'''
* Buffered file writer for faster config saves (thanks to [https://github.com/willjow/snes9x_3ds willjow]).

'''v1.42'''
* Fixed screen tearing.
* Added option to disable 3D Slider (thanks to ramzinouri).

'''v1.41'''
* Fixed hotkey for making screenshot.
* Fixed quick save/load (no data abort exceptions anymore).
* Fixed Errors if cover image is missing.
* Updated assets (icon, banner, border, cover).

'''v1.40'''
* Added Swap Game Screen option.
* Added switch controller option like in official Virtual Console (SF2 "Training Mode", Konami cheat, ...).
* Custom second screen image and border for every game (thanks to ramzinouri and Asdolo).
* Game Info option for second screen.
* Provide more Hotkeys (Quick Save/Load, Swap Controllers).
* Disable Analog to Digital Type option which allows you to use circle pad for hotkeys as well.
* All game related files like cheats or save states are now in a single folder (folder name = rom name).
* Screenshots are now in PNG format (thanks to ramzinouri).
* Removed BlargSNES DSP Core, updated dsp-1, added dsp-2 -3 and -4 (thanks to ramzinouri).

=== bubble2k versions ===
'''v1.30'''
* Improved sound synchronization.
* Added BlargSNES DSP Core (experimental) for performance. The original Snes9X DSP core (default) suffers from sound skipping in some games like Aladdin and Gradius 3. You can choose which DSP core to use from the Options menu. The BlargSNES DSP Core sounds similar to the Snes9x Core for most games. Sounds like Final Fantasy 3's the howling wind sound different.
* Added support for Tengai Makyou Zero English Patch (for hopefully all future versions).

'''v1.21'''
* Fixed the ZL/ZR button problem when installing the CIA version.

'''v1.20'''
* Fixed slider problem in New 3DS (where one of the eyes always sees a black screen).
* Added button mappings and rapid fire settings like VirtuaNES / TemperPCE 3DS (thanks to AdmiralCurtiss).
* Added button configuration to open emulator menu and fast-forward (thanks to AdmiralCurtiss). Use with care, though. In some games, fast-forwarding can freeze/corrupt your game.
* Added a frame rate option to v-sync with the 60Hz 3DS refresh rate (thanks AdmiralCurtiss).
* Added an option to auto-save state when exiting and loading when starting a new game. (thanks AdmiralCurtiss).
* Added an option to force saving of SRAM, required by Yoshi's Island. (thanks AdmiralCurtiss).
* Show 3DS battery level in the bottom right of the menu (thanks ramzinouri).
* Increased scrolling speed in menu when holding down the D-pad.
* Added memory mapper support for Tengai Makyou Zero English Patch (version 1.0 released 22 Oct 2017).
* Supports most original BS Zelda (1-4, Map 2 1-4, Ancient Stone Tablets 1-4), except for the Remix version which still boots into black screen (thanks ramzinouri).
* And other text changes (thanks FateForWindows).

'''v1.11'''
* Fixed crashing bug when loading CHX cheat files.

'''v1.10'''
* Implemented SA-1 sleep speed-hacks on the following games. These games run faster and some are able to run at 60 fps on the Old 3DS when things on-screen aren't too busy. Super Mario RPG; Kirby’s Dreamland; Jikkyou Oshaberi Parodius; Kirby Super Star; Marvelous; Super Robot Taisen; Panic Bomber World; Dragon Ball Hyper Dimension; SD Gundam Next; Power Rangers Zeo; Daisenryaku Expert 2; Masters New Augusta 3; Bass Fishing; J96 Dream Stadium; Shining Scorpion; Pebble Beach New; PGA European Tour; SD F1 Grand Prix;
* Fixed mode 7’s CLIP_10_BIT_SIGNED formula to use the original Snes9x’s formula. This fixes Super Chase HQ’s mode 7 intro.
* Imported SPC7110 decompressor chip code from Snes9x 1.52. Now Tengai Makyou Zero (Far East of Eden Zero) can boot after 2 restarts, and in-game graphics appears without problems.
* Fixed important bug in cheat engine so that it doesn't not increment the 65816 processor's clock cycles when enabling/disabling cheats.
* Fixed the problem of the menu not using the correct font when the emulator first boots up.
* Added one more mode when using the 3D slider for a sharper image.
* Major refactoring of code.
* Fixed SA1 MMC's memory map code by copying it from Snes9x 1.54.2. Now Super Mario World hack VLDC 9 boots.
* Fixed Mode 0 rendering bug. The original bug was there since day 1 and with this fix, Lagoon's title screen looks right.

'''v1.00'''
* Transplanted the full SPC700 + DSP source codes from Snes9x v1.51 into this emulator. As a result, the sound emulation now supports Gaussian Interpolation, and has better accuracy. This fixes some sound problems in Clay Fighter and Mortal Kombat I and II.
* Fixed Mode 7 priorities in games that use this: Contra III's stage 1 (at the loss of some color fidelity). Implementing this required the use of some crazy math hacks and hardware tricks to pull this off.
* Implemented some experimental speed hacks for Super Mario RPG and Kirby's Dreamland. Runs slightly faster (still not full speed) on Old 3DS.
* Implemented hi-res translucency. We get non-flickering emulation of hi-res screens (Secret of Mana, Seiken Densetsu 3, A.S.P. Air Strike Patrol) now as a bonus. As a result, Kirby's Dreamland is now playable.
* Invented a new cheat file format .CHX (text file) so that players can add cheats by using any text editor.
* Centralized the SNES output screen vertically on the top screen.
* Overhauled the user interface to give a more modern look as well as provide additional fonts.
* Added more screen stretch options as requested by many users.
* Added 3D slider support. Pushing up the 3D slider doesn't create any 3D effect, but may create a better viewing experience.
* Removed unnecessary debug messages during start up / shut down of the emulator.
* Fixed a bug when the SRAM still saves randomly when it is set to Disabled.
* Reduced memory footprint for storing texture position caches.
* Made this version buildable with libctru v1.2.0 (thanks to Maki-chan) [Note: Building with devkitARM r46 and libctru v1.2.0 will cause a bug where the emulator cannot utilize the full clock speed of the New 3DS.]

'''v0.80'''
* Fixed NMI interrupt for specific games such as Cu-On-Pa. This allows Cu-On-Pa to get past the selection screen.
* Fixed ROM size calculation for Wonder Project J (English Patch). The game no longer hangs at the menu.
* Implemented optimized rendering for offset-per-tile modes. This gives many games a major performance boost. Games such as Strike Gunner STG, Tetris Attack, Kirby's Avalanche, Contra's Stage 1 Boss, Super Mario All-Stars' Super Mario 2 all benefit from this improvement.
* Implemented optimized rendering for sprites for modest performance boost.
* Used SPC700 core from Snes9x v1.51.
* Re-implemented an moderately optimized SA-1 core. Now games like Kirby Super Star, Super Mario RPG can boot. It will NOT run well on the old 3DS currently, but it will run smooth on a new 3DS with full clock speed.

'''v0.71'''
* Fixed nasty bug that breaks loading of the second ROM, if the first ROM was loaded from a directory path that has spaces in it.
* Added feature to allow users to page up/down the options in the menu while holding down X.
* Minor optimizations.

'''v0.70'''
* Fixed sprites priority issues. This fixes sprites problems of Shadowrun, Chrono Trigger, Super Mario All Stars' (and possibly other games too).
* The newly implemented rendering engine also provides some modest speed improvements in some games.
* Added feature to save the directory of the previously loaded ROM.

'''v0.63'''
* Fixed bug in DMA when the source address comes from Save RAM. This fixes a number of Super Mario World Hacks so that text is readable on BG layer 3.
* Fixed menu key lock issue to improve usability when exiting from menu back into the game.
* Fixed DKC tile corruption issue. This probably also fixes most (if not all) tile corruption issues in other games, if you play a game for too long in a single sitting.
* Fixed sound problems when auto-saving SRAM. Somehow the hardware or the library doesn't like us stopping and starting the CSND too often. Not too sure what the problem is.
* Added an auto-save SRAM option to tell the emulator when to save SRAM (1 second, 10 seconds, 60 seconds, or disable auto-save). Note that regardless of the setting, the emulator will always save any modified SRAM every time you touch the bottom screen to activate the menu.

'''v0.62'''
* Improved Mode 7 zoomed-in textures. Games like Seiken Densetsu, ActRaiser 1/2 look better when viewing the Mode 7 textures near to the ground. Thanks for Discostew for the motivation.
* Improved sound handling to ensure that the left speaker plays at the same volume as the right speaker.
* Added option to change in-frame palette handling. There are three options to choose from:
** Enabled. (Slow, accurate, but never as accurate as software)
** Disabled Style 1 (faster, less accurate)
** Disabled Style 2 (faster, less accurate) works a little differently from Style 1 Most games are by default Disabled Style 2.
** Bahamut Lagoon and Front Mission Gun Hazard are by default Disabled Style 1. Wild Guns, Judge Dredd, Batman Forever are by default Enabled.
* Fixed Clock Tower to boot properly again.
* Fixed Star Fox flickering problem when there are frameskips.
* Fixed outside-of-track texture problem with Super Mario Kart’s Bowser Castle stages.
* Fixed Final Fantasy V Intro logo cutout problem.
* Fixed Donkey Kong Country's tile colour corruption bug.

'''v0.61'''
* Fixed DSP bug that causes some games like Dragon Ball - Super Budoten 3, Umihara Kawase to mute.
* Fixed bug that doesn't stop sound from playing when saving to SRAM.

'''v0.6'''
* Default sound amplification to 2x …
* Reduced GPU freezing problem after loading new ROMs / resetting too many times.
* Resynchronise sound when you go into the menu (you can reset the sync this way after waking your 3DS from sleep mode).
* Improved sound sample rate to 32 KHz, and added echo and interpolation. The result is overall better sound quality.
* Improved sync between SPC700 emulation and the DSP.
* Fixed Contra III Mode 7 EXTBG colors again.
* Enabled the SPC700 Envelope Height reading.
* Fixed Chrono Trigger music not resuming after any battle music or “sealed by mysterious force” music.

'''v0.51'''
* Implemented pseudo hi-res mode 5 using alternate frame flickering to achieve the pseudo hi-res mode. Games that use this mode include: Secret of Mana, Seiken Densetsu 3, Air Strike Patrol, and a number of others.

'''v0.5'''
* Implemented major graphic rendering optimizations for color handling, transparency and window effects. Although codes from BlargSNES was not used directly, ideas came from BlargSNES. Some games that use windowing effects should see some / significant performance increase. F-Zero (US / EUR versions) run full speed. Super Mario Kart (EUR) runs full speed. Axelay (US) runs at a playable speed. Breath of Fire 2 battle transition effects are smooth. Super Mario World circular window fade-in/out effects are smooth. etc.
* Fixed sprite flickering problems in Yoshi's Island and DKC2.
* Fixed 256-color background problems. DKC1/2 and Earthworm Jim 2 intro shows up correctly.
* Fixed Mode 7 BG2 problems. Now Super Star Wars - Empire Strikes Back (snowspeeder stage) works correctly.

'''v0.42'''
* Minor optimisation to GPU drawing.
* Increased maximum number of cheats to 200.
* Fix the crashing problem if there are too many cheats in the .CHT file.
* Fixed the too many sprites on screen problem (fixes Shadowrun freezing).

'''v0.41'''
* Fixed some transparency issues with Saturday Night Slam Master and Ghost Chaser Densei.
* Updated SRAM saving timing.
* Minor optimisation for SuperFX emulation.
* First implementation of speed hacks (experimental for F-Zero, Axelay, Super Mario Kart, Yoshi’s Island)
* Modified some debugging stuff.
* Fixed some mode 7 glitches when a mode 7 game (like Super Mario Kart has been running for more than a few minutes).
* Implemented palette flickering hack for Front Mission Gun Hazard, Bahamut Lagoon.
* Implemented hack for Power Rangers Fighting Edition to prevent graphical glitches
* Implemented hack for delayed SRAM (per 1 minute) saving for Star Ocean
* Fixed the problem of loading up too many different ROMs once after another, causing the loading to finally fail.
* When loading a game without settings, reset the frame rate setting to be based on the game's region.

'''v0.4'''
* Experimental cheat feature. Requires you to have the .CHT file (May corrupt your save game, use at your own risk).
* Added settings to enable turbo buttons (per game).
* Added settings to allow user to amplify volume (per game) (beware of sound clipping that results in terrible sounds).
* Palette hack for Secret of Mana to ensure that the dialog borders are blue (the bottom status window still behaves oddly due to palette changes).
* Transparency fixes: o Legend of Zelda's prologue's dark room o Reported dark tints on several games like Doremi Fantasy, Bomberman, Secret of Mana, Chrono Trigger o Gradient shading on dialog boxes for Chrono Trigger and Final Fantasy III (battles) appear correct.
* Fixed window clip problems.
* Fixed mode 7 glitches causing mode 7 bugs in Secret of Mana, NHL 94, Magical Quest 3.
* Fixed a number of sprite clipping problems o Megaman 7's Dr Wily's spaceship in the intro now pans in from the left correctly o Tales of Phantasia's trainee's sprites (after the intro) now clips correct.
* Fixed color inconsistency causing some white sprites to be visible on a white background (eg. in NHL's EA Sports intro screen).
* Added speed hack for games that use the WAI instruction (esp Donkey Kong Country 1, 2, 3 should see a good speed increase).
* Added hack to avoid hiding sprites even if they exceed the maximum number the real hardware can display. Apparently, this fixes the missing cursor in Final Fantasy III.
* And other bugs.

'''v0.35'''
* Fixed Super Mario Kart grass area texture outside of the track. This fix should work for all cases.
* Some minor performance and UI adjustments.

'''v0.34'''
* Mode 7 minor performance improvements and update to draw Super Mario Kart's grass outside of the racing track. (some it works only under some conditions).
* Taking of screenshot now only captures the upper screen.
* Option of forcing frame rate to 50 FPS / 60 FPS / or based on the selected ROM's region.
* Additional screen scaling option to 320x240.
* Fixed the crashing problem when selecting options without any ROM running.
* Fixed DKC1 piracy problem. The wrong mask logic was used when writing to SRAM.
* Improved the logic to save SRAM to SD card about 1-2 seconds after your game was saved in the emulator.

== Credits ==
* The Snes9x team for the SNES emulator core, and the libretro Snes9x core maintainers for ongoing reference work
* bubble2k, original author of [https://github.com/bubble2k16/snes9x_3ds snes9x_3ds], for creating the excellent base this fork builds on
* Wyatt-James for his [https://github.com/Wyatt-James/snes9x_3ds snes9x_3ds fork]; this fork adapts a few safety, audio and stability fixes from his work
* ramzinouri's [https://github.com/ramzinouri/snes9x_3ds snes9x_3ds fork] inspired the image border/background and theme support
* willjow's [https://github.com/willjow/snes9x_3ds snes9x_3ds fork] revived the project after development had gone quiet
* The Citra/Azahar teams for making 3DS emulator testing and debugging practical
* Everyone reporting issues, testing games and suggesting improvements

== External links ==
* GitHub - https://github.com/Xeddius-Network/snes9x_3ds
* GitHub - https://github.com/matbo87/snes9x_3ds
* Universal-DB - https://db.universal-team.net/3ds/snes9x-updated-fork

Mono-nx Switch

2026-07-10T03:30:30Z

HydeWing:

{{Infobox Switch Homebrews
|title=mono-nx
|image=monoNXSwitch.png
|description=An unofficial port of the mono runtime as a switch homebrew.
|author=exelix11
|lastupdated=2026/07/03
|type=Developments
|version=1
|license=MIT
|download=https://github.com/exelix11/mono-nx/releases
|website=https://www.reddit.com/r/dotnet/comments/1ks83mq/i_ported_the_mono_runtime_as_a_switch_homebrew/
|source=https://github.com/exelix11/mono-nx
|donation=
}}
{{#seo:
|title=Switch Homebrew PC Tools (Developments) - GameBrew
|title_mode=append
|image=monoNXSwitch.png
|image_alt=mono-nx
}}{{lowercase title}}

This is an unofficial port of the mono runtime to the Switch homebrew toolchain. It can run dotnet 9.0 applications using the mono interpreter by loading the dll or exe files directly on console. It can also build .NET assemblies as static libraries using mono AOT.

The mono-interpreter.zip release contains the mono interpreter, all the dotnet runtime libraries and the file .dll/.exe file association for hbmenu allowing you to copy .net dll programs to your Switch folder and running them directly. To build and use mono-nx, please follow the detailed step-by-step instructions provided in the [https://github.com/exelix11/mono-nx GitHub repository].

'''What works:'''
* Common BCL classes such as <code>List</code>, <code>StringBuilder</code> and so on.
* P/Invoke, but only with libraries that were statically linked beforehand.
* Threads and async.
* Most of filesystem APIs.
* Sockets and http-only support for <code>HttpClient</code>.
* .NET wrappers for SDL2 and [https://github.com/ocornut/imgui dear imgui] which are included as static libraries.
* The interpreter seems rather stable even when running more complex programs, I did not test the AOT builds as much.
* Unit tests with XHarness (some dotnet repo tests are even passing!).

'''What does not work:'''
* HTTPS and most of <code>System.Security</code> doesn't work because we have no openssl port on Switch.
* Arbitrary P/Invoke doesn't work due to the lack of dynamic linking, all native function entrypoints must be defined beforehand and statically linked.
* Any other OS-dependant API that was not mentioned previously will likely not work because it was not explicitly implemented. Examples are <code>Console.Read</code>, <code>Console.Clear</code>, <code>Process</code>, <code>WinForms</code> and many more.
* Also, exiting the interpreter and launching another dll or sometimes homebrew in the same hbmenu session will eventually crash. I'm not sure why this happens, historically mono has had problems [https://github.com/mono/mono/issues/20191 cleaning up resources] but it could also be an issue related to the homebrew environment. I tried to do [https://github.com/exelix11/mono-nx/blob/master/notes/writeup.md#the-smoke-test some debugging] but ultimately my workaround is to just terminate the process on exit.

'''Included demos:'''
* aot_example.nro is a fully self-contained AOT-complied C# application. It generates a random number and asks you to guess it.
* (*) pad_input.dll is a C# program that reads the controls with the native libnx api.
* (*) example.dll is a C# program that shows most of the APIs that are currently implemented.
* (*) explorer_demo.dll is a C# program that shows a file explorer-like GUI using imgui and SDL2. This will also work on windows and linux with no code changes if you use [https://github.com/exelix11/CimguiSDL2Cross/releases/tag/r2 the author's cimgui fork].
* (*) guess_number.exe is the source from aot_example built with plain csc.exe on a windows vm to show off loading exe files as well. I'm not aware of any way to build this on linux so there's no build script for it.

(*) These will add the dll and exe file association to the hbmenu allowing you to launch them directly.

==Changelog==
'''v1'''
* This build fixes various stability issues, including one related to thread local storage that would crash mono at random.
* I'm also providing an "sdk build" of the toolchain, that is, the final binaries, header files and static libraries needed to build the interpreter without having to build the whole dotnet runtime on your own. To use the sdk zip extract it in the root of the repo, it contains all the correct paths where all the icu and mono artifacts should be. At this point you should be able to build <code>native/interpreter</code> or <code>native/aot</code> directly. I don't expect this setup to survive libnx/gcc/portlibs updates via dkp-pacman so only use it with the monobuild docker container at the commit of this release, as of writing it is based on <code>devkitpro/devkita64:20260219</code>.

'''v0'''
* First Release.

== External links ==
* GitHub - https://github.com/exelix11/mono-nx
* GBAtemp - https://www.reddit.com/r/dotnet/comments/1ks83mq/i_ported_the_mono_runtime_as_a_switch_homebrew/

StellaDS Phoenix Edition

2026-07-10T03:30:30Z

HydeWing: /* Champ Games Support */

{{Infobox DS Homebrews
|title=StellaDS Phoenix Edition
|image=stelladsphoenix4.png
|description=Atari VCS 2600 emulator for DS and DSi, an improved version of StellaDS by Alekmaul.
|author=Dave Bernazzani (wavemotion-dave)
|lastupdated=2026/06/28
|type=Console
|version=8.4a
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew2/stelladswav.7z?8.4a
|website=https://github.com/wavemotion-dave/StellaDS
|source=https://github.com/wavemotion-dave/StellaDS
|donation=https://ko-fi.com/wavemotiondave
}}
StellaDS is an Atari 2600 console emulator for the DS/DSi improved based on AlekMaul's [[StellaDS|StellaDS]].

This Phoenix Edition brings greater speed, compatibility and accuracy to the emulation on the DSi. It also added new features such as instruction manuals and high score support.

==Features==
* Full console emulation including Reset, Select, Difficulty Switches, TV Type as touch-screen switches.
* Virtually all popular bankswitching is supported up to 512K of ROM and 32K of RAM (similar to the Harmony Encore specifications).
* Wide range of controllers including joystick, paddles, driving controller, booster grip, keypad, Genesis 2-button and more.
* Savekey Support with backing 32K EEPROM.
* DPC+ Arm-Assisted games supported! (DSi or above needed for full speed).
* CDF/CDFJ/CDFJ+ Arm-Assisted games supported! (DSi or above needed for full speed).
* FA2 and Cherity supported with backing EEPROM support.
* High score support with up to 10 scores for each game.
* Manuals included for more than 100 of the common games.
* Keypad overlay for Star Raiders.
* Frame Blending to help smooth out flicker and make the games shine.
* Ability to set Favorites on your game collection - press SELECT to mark a game as 'LIKE' or 'LOVE'.
* Save/Restore state for all game carts.

==Installation==
[[DLDI|DIDL]] patch the StellaDS.nds file depending on the flash card (if it does not have auto-patching).

Copy it into a directory of your flash/(micro)SD/MMC card.

Put the a26/bin files where you want on your flashcard. If you are using Twilight Menu++, you will need to need to rename the .bin to .a26 in order to use.

==User guide==
When the emulator starts, click on the cartridge slot to choose a file.

Use Up/Down to select a file, then use A to load it.

===Game Autodetection===
The Atari 2600 utilizes a growing number of bankswitching scheme. StellaDS currently supports 36 different bank switching schemes (refer to the [https://github.com/wavemotion-dave/StellaDS/blob/master/README.md readme] for the full list) - and it usually will auto-detect the right one. If for some reason it does not, you can go into the configuration (gear icon) and manually select a new scheme.

Be sure to hit START to save your config and then try re-loading the game (the bank switching requires a reload of the game). In the catastrophic event that the detected bankswitching scheme causes the emulation to crash, you can try loading the game using the Y (instead of A) button which will load the game but NOT start it running... this should let you go in and adjust the back switching scheme and other settings (PAL vs NTSC, etc).

===Configuration===
The gear icon on the main screen allows you to set a number of configuration parameters related specifically to the game you are running. In addition to the parameters shown, the difficulty switches (Left/Right A/B) are also saved on a per-game basis. If you change any configuration settings, you really should re-load the game after saving out your configuration - some settings such as Bank Switching and NTSC vs PAL are only applied when the game is first loaded.

Here is a description of the configuration items you can adjust. Be sure to press the START button to save out your configuration after making changes:

* Controller - Most games use the Left-Joystick (with a Savekey in the right port) but you can change this.
* Bankswitch - The system tries to auto-detect the correct bankswitching scheme but you can override that here if needed.
* Frame Blend - Normal is fastest. Flicker free combines even/odd frames and it's pretty fast (10% hit to emulation speed which is no problem on most games) and effective at eliminating flicker. Background/Black mode is the slowest and will help with games that show background/black on one frame and sprites on the other (a simple blending will cause the sprites to disappear - Missile Command is one such game).
* TV Type - NTSC vs PAL. Reload your game after saving this setting.
* Palette - Three different palette types are supported. One optmized for the DS (default), the mainline Stella palette and the Z26 palette. You can also set the global palette for loading up all future games (page 2 of options).
* Sound - Four different levels including the new WAVE DIRECT if you're using a game that does direct sound output (such as Quadrun, Stay Frosty 2, Mappy or Draconian). Most games should auto-detect this correctly. You can also set the global sound for loading up all future games (page 2 of options).
* ABXY Button - Default to FIRE button but you can change this. You can now set to Screen Pan UP or Screen Pan DN to scroll the screen for more complex games. See Screen Settings below.
* HBLANK Zero - Whether system clears pixels on horizontal blanks. Turn off at your own risk (it will speed up emulation which helps with older DS-LITE)
* VBLANK Zero - Whether system clears pixels on vertical blanks. Turn off at your own risk (it will speed up emulation which helps with older DS-LITE)
* Analog Sens - Default is 10 (1.0x speed). You can ajust how the paddle emulation responds.
* Start Scanline - Starting Scanline setting. When the TV first starts output of scanlines.
* Num Scanlines - Number of scanlines to display. Don't touch if you don't understand this.
* Offset/Scale - You can ajust the screen scaling and offset positions for the game. If you scale down, be aware that some pixel lines will not render - such is life with a very small 256x192 pixel DS screen.
* ARM THUMB - SAFE and Optimized are roughly the same - Optmized is preferred as is slightly faster and recommended for ARM-assisted games. Optimized-No-Collisions is generally fine for most of the new CDF/CDFJ/CDFJ+ games that don't need TIA hardware collision detection. One final experimental setting is to enable some level of frameskip for the really hard-hitting newest ARM games (e.g. Elevator Agent).
* BUS Mode - For the DSi and above, this will default to 'Accurate' and for the older DS hardware (or running in DS compatibility mode on an R4 cart) it will be set to 'Optimized' to gain speed. If you encounter a glitch with a game, try setting this to 'Accurate'.
* RAM Clear - Normally set to 'Random' but you can force the Atari VCS RAM to all zeros. A few games might care - but most won't.

These options are spread across two (2) pages, use the L/R shoulder buttons to switch pages. This gets you access to some global settings for sound quality and default color palette (after saving, new games loaded will use the global settings by default and you can tweak individual games as desired).

===Screen settings===
If you are only running Classic games - the default screen settings should be fine. But if you're running some of the newer homebrews created over the past decade, you will want to configure your screen properly. For many games, you simply can't fit all the content on the 192 pixel lines of a DS/DSi. For these you can either cut off the top, bottom or scale the screen.

When these options aren't enough, you can set your Y offset so that some of the screen is cut-off top or bottom and then you can map one of the DS buttons to 'SCREEN PAN UP' or 'SCREEN PAN DOWN' which will momentarily pan up or down. This works great for Champ Games offerings where the score display is normally off-screen while you play and then you can tap a button to briefly see it.

===Backing files used by StellaDS===
In the /data directory of your SD card you will see some files auto-created by StellaDS. You are free to delete or back these files up as you see fit. If you delete a file, it will be re-created 'clean' on the next boot of the emulator.

*StellaDS.DAT - this contains the per-game settings (basically when you press START on the Configuration screen and it saves out your settings for the current game). The easiest way to set all your games back to default settings is to remove this file.
*StellaDS.HI - this is the high-score file on a per-game basis. Up to 10 scores are saved per game by pressing the little Golden Chalice icon on the main screen.
*StellaDS.EE - this is the SaveKey 32K EEPROM file for games that utilize a SaveKey. If you remove it, a new clean blank copy will be created.
*StellaDS.FAV - this is the 4K favorites file where up to 1024 favorites (like/love - using the SELECT key on the file menu) are stored.
*Various .SAV files - these are the Save State / Restore files (one per game with the same base name as the game ROM).

===Champ Games Support===
StellaDS supports all current Champ Games offerings through June 2026 (Zaxxon Demo is the latest release). These games represent the cutting edge of what is possible on the Atari 2600 using an ARM co-processor to help move data through the system. These games push the limits of the emulator. To run these advanced arm-assisted games, you will need a DSi or greater running either Twilight Menu++ or Unlaunch to unlock the 2X CPU (134MHz). The original DS (or the DSi/2DS/3DS running with an R4 cart) will only run in DS compatibility mode (67MHz) which is too slow to render these games full speed.

It is also recommended that you use an XL/LL model - these larger screens have a slower LCD fade resulting in a picture that more closely resembles an old TV. This means less flicker overall.

Be aware that most of these games utilize a significant amount of overscan. The DS/DSi/XL/LL only has 192 pixels of vertical resolution and this means the extra 16-20 pixels of game information will render-off screen. StellaDS will always show the main gameplay portion of the screen and utilizes a screen pan UP/DN to shift in the score or status (non-gameplay) information. For example, in GORF, you will not see the score at the top normally... but if you press the X button (pan UP), the screen will momentarily shift up to show you the score and then automatically pan back down. It's quite smooth and is very serviceable in normal gameplay.

All Champ Games should run at or near full speed with the exception of the two most complex games: Turbo Arcade (which dips framerate slightly for some complex rendering scenes but is generally not noticeable for gameplay) and Elevator Agent which runs at 57+ (often up to full speed) but is variable enough that you will hear some slight wavering in the music output (but still quite playable and enjoyable). Try the DEMO roms first to be sure you're happy with the emulation quality here. Be aware that any performance issues related to these cutting-edge games is a reflection of my emulation and not the superior craftsmanship of the games themselves. You can see a full set of Champ Games offerings at https://champ.games

==Controls==
D-Pad - the Joystick

A,B,X,Y - Fire button (configurable)

SELECT - SELECT switch

START - START switch

R+D-Pad - Shift display offset in the D-PAD direction

L+D-Pad - Change Scaling of the Y-Screen (UP/DOWN scaling only)

L+R+A - Swap LCD top/bottom

Hold L+R shoulder buttons for ~1 second to take a snapshot of the screen (written to SD card as a .BMP file).

Use stylus on buttons for other icon-based actions on bottom screen.

==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/stelladsphoenix2.png

https://dlhb.gamebrew.org/dshomebrew/stelladsphoenix3.png

==Compatibility==
For the older DS-LITE and DS-PHAT, many of the simple 8k, 4k and 2k games will play perfectly. More sophisticated bank-switching schemes really require the DSi for the best experience.

If you're a fan of classic emulators on the DS/DSi, a DSi XL (USA) or LL (Japan) version is strongly recommended. Or a 2DS/3DS if you can get homebrews to run on those. The reason is that the original DSi has a fast LCD fade and as such some of the games will be a little hard to see or appear to flicker due to the way the original Atari game is coded. For a real TV or a slow LCD fade, this looks much better.

StellaDS includes an option to reduce the flicker - in configuration you can turn on Blending (recommend try Half Blend Mode as it's the least CPU intensive). This comes at a performance pentaly - for many games, the DSi can handle that penalty. For the ARM-Assisted games (DPC+, CDF/CDFJ/CDFJ+) that penalty will be too great which is why the full gammut of Atari games will always render best on an XL/LL screen.

==Known issues==
Please refer to https://github.com/wavemotion-dave/StellaDS/blob/master/README.md#known-issues-

==Changelog==
'''v8.4a 2026/06/28'''
* Fix for cart detection so SB carts don't detect as CDFJ. Fixes Rescue from Poseidon's Gate.
'''v8.4 2026/06/27'''
* Fix for TIA rendering that fixes Aardvark and probably others.
* Fix for banking on Squish-Em-Deluxe (F8) so dummy read on RTI properly hits the hotspot.
* Hotfix for PAL rendering which was causing the LCD to misbehave. True-sync is NTSC only for now.
* Full cleanup of ARM Thumbulator. I've decided to peel back on some of the 'unsafe' code that I've been using to gain speed. In the end, the speed optimizations and the improved accuracy have balanced themselves out - so 8.4 is still a bit faster than 8.3 in terms of raw speed but has a improved ARM Thumb emulation for a nice gain of accuracy.
* Lots of cleanup and both ARM and 6502 optimizations as time permitted. Better accuracy and improved speed all-around.

'''v8.3b 2026/06/23'''
* Hotfix for PAL rendering which was causing the LCD to misbehave.
* After another round of ARM Thumbulator optimizations, I've decided to peel back on some of the 'unsafe' code that I've been using to gain speed. In the end, the speed optimizations and the improved accuracy have balanced themselves out - so 8.3a is roughly equivalent to 8.3 in terms of raw speed but has a improved ARM Thumb emulation for a nice gain of accuracy. Just hoping there are no bugs :)

'''v8.3 2026/06/21'''
* Improved CDFJ+ driver to eek out another frame or two.
* Optimized for the new Zaxxon Arcade from Champ Games so it runs full speed on DSi or above.

'''v8.2 2026/04/12'''
* New NTSC (60Hz) and PAL (50Hz) 'True-Sync' to reduce tearing and other video artifacts from screen rendering on the DS/DSi.
* Improved accuracy on SB (SuperBanking) carts.

'''v8.1 2025/12/14'''
* Added new Favorites system so you can LIKE/LOVE any game - press SELECT on the Game ROM loading screen.
* TIA optimizations for another frame of improved performance.
* CPU optimizations for another frame of improved performance.
* Thumbulator optimizations for the LDR3 instruction to help some CDFJ games.
* Most VBLANK and HBLANK optimizations now removed in favor of improved accuracy (improved performance allows us to ditch most of this).
* Refactor memory to buy back almost 250K of DS RAM for future expansion.
'''v8.0 2024/12/09'''
* Added music fetchers for more complete Chetiry (CTY) emulation. Save state works with CTY. Use the 60K Chetiry rom for music.
* Fixed holding RESET (DS Start button) and SELECT (DS Select Button) when loading a game. This allows you to do things like the Double-Shot trick in Space Invaders.
'''V7.9 2024/12/04'''
* Fix so holding shoulder buttons on Bumper Bash does NOT invoke the screen snapshot.
* Fix for bumper bash right bumper position so it now shows correctly.
* Improved GI Joe Cobra Strike snake graphics so it's much closer to the way a real TIA chip would draw it.
* Fix for Labyrinth (AR) graphical glitches at top/bottom of walls.
* Improved difficulty switch handling so startup values for games like Asteroids works correctly.
* Improved RIOT timer emulation - Acid Drop, Panda Chase, Zoo Fun and a few other PAL roms now work.
* Improved keyboard/keypad emulation so games like Alpha Beam with Ernie, Oscar's Trash Can Race and Magicard now work.
* Improved emulation of Starpath Supercharger (AR) games (Dragonstomper is random) and support smaller game loads (Cubis now runs).
* Fixed Casino paddles (correct paddle emulation so you can select all card positions in game variation 4).
* Internal cart database updated to Romhunter v19 (full NTSC with select PAL titles).
* Fix for save/load states on CDFJ+ carts (Gorf and Turbo Arcade will now save/load correctly).
* Wave Direct improvements - applying the same logic for all games that utilize digital speech and improving sounds.
* Added new Stretch-X config option to stretch the screen horizontally (you can use offset/stretch to fill the screen for some Activision games which purposely hide the HMOVE blanks on the left side of the screen).
* Pressing and holding the Game Select and Game Reset buttons now keeps them depressed until you let up your finger.
'''V7.8 2024/11/30'''
* Further tweaks to the improved 'Wave Direct' to prevent audio gaps.
* First pass at allowing 'Wave Direct' for DS-Phat/Lite (only for simple games like Quadrun, Berzerk VE and Open Sesame).
* Tweaks to the DPC audio driver for improved Pitfall II music.
* Added support for some of the Voice Enhanced Berzerk hacks such as DrVsDaleks.
* Improved Meltdown emulation - added hack for NUSIZ0/1 to improve screen rendering. Not perfect but closer...
* Fixed Pole Position speedometer zero so it shows correctly and other minor graphical fixes (HMOVE timing)
* Fixed Grand Prix graphical glitch on rocks/scenery (HMOVE timing).
* Fixed Moon Patrol graphical glitch on right side of screen (HMOVE timing).
* Fixed Double Dragon graphical glitch on strength meter (HMOVE timing).
* Apply RSYNC improved TIA handling across the board (was only being applied to select games).
'''V7.7 2024/11/24'''
* Improved 'Wave Direct' sound to help with digitized speech effects of Quadrun, Berzerk VE, Open Sesame, Pitfall II, etc.
* Tweaked handling of the new Champ Games - Tuthankham.
* Version 7.7a - hotfix to support DrVsDalek hack with voice support and improved voice timing to eliminate gaps.
'''V7.6 2024/08/25'''
* Fixed config setting of RAM randomized vs clear.
* Fixed AR (Starpath/Supercharger) games to prevent memory overwrite.
* Big improvement to Starpath Supercharger (AR) cart rendering for 3-6 frames of improvement.
* Numerous comment cleanups and other minor refactors to improve the codebase.
'''V7.5a 2024/08/24'''
* Fixed config setting of RAM randomized vs clear.
* Fixed AR (Starpath/Supercharger) games to prevent memory overwrite.
'''V7.5 2024/08/23'''
* Overhaul and refactor of cart/device handling to gain a 3-4% speed boost across the board.
* Improved memory handling to use a bit less of the precious DS resources.
* Fixed multi-load Starpath Supercharger (AR) carts so they work again (broken for almost a year!)
* Cleanup as time permitted
'''V7.4 2024/08/19'''
* Adding adding save/restore state handling for all games. Use the new down-arrow icon in the lower left.
* Added 03E0 banking for Parker Bros. Brazilian carts.
* Added 0FA0 banking for Fotomania Brazilian carts.
'''V7.3 2024/06/05'''
* Added wF8 banking scheme for the new dump of Smurf and Zaxxon.
* Added JANE banking scheme for the new Tarzan prototype release.
* Added support for Champ Games Tutankham Arcade.
'''V7.2 2024/01/01'''
* Updated copyright as we cross into the new year!
* Another partial frame of performance on CDFJ/+ games.
* Cleanup this readme file to reflect latest changes in the emulator.
'''V7.1b 2023/12/25'''
* Squeezed out one extra frame of performance on CDFJ/+ games.
* New light frameskip applied to Draconian for a performance boost.
* Minor fixes and tweaks to make all the latest homebrew games look and play their best.
* Version 7.1b eeks out another partial frame on the hardest hitting ARM-assisted games.
'''V7.0 2023/12/10'''
* Champ Games Edition! Major overhal to the CDFJ/+ driver to squeeze out ever bit of performance.
* Fix for Genesis gamepad emulation (detection now works).
* Other minor cleanups and tweaks as time permitted.
'''V6.9 2023/12/06'''
* Improved the ARM Thumb driver and the CDFJ driver to squeeze out two more frames of performance.
* Fixed PAN UP / PAN DOWN handling on the A-button and you can now pan even if another button is pressed (useful for Turbo Arcade).
* Minor cleanups as time permitted.
'''V6.8 2023/07/01'''
* Improved RSYNC so Extra Terrestrials (1984 by Skill Screen Games) works.
* Improved keypad handling so Magicard and similar keypad/keyboard game work.
* Added a few of the ultra-rare games discovered in the last decade to the internal database.
* Updated internal database to ROMHUNTER v18 for the classic-era games.
* Starpath Supercharger (AR) carts now clear RAM by default (prevent lock-ups).
* Added Dual Keypad/Keyboards for the few game that need them (BASIC, Magicard mostly).

'''V6.7 2023/06/24'''
* Fix for Sword of Surtr so it runs correctly.
* Hold L+R shoulder buttons for ~1 second to take a snapshot of the screen (written to SD card)
* DSi now defaults to the 'Accurate' BUS MODE for maximum compatibility.
* Improved data bus handling for undriven pins in Tia::Peek() for improved compatibility.
* A few more tweaks to a few more games to make them as accurate as possible.

'''V6.6b 2023/06/21'''
* DSi now defaults to the 'Accurate' BUS MODE for maximum compatibility.
* Improved data bus handling for undriven pins in Tia::Peek() for improved compatibility.
* A few more tweaks to a few more games to make them as accurate as possible.

'''V6.6 2023/06/20'''
* Fix for Meltdown prototype so it doesn't crash.
* Fix for Pleiades to fix graphical glitches.
* Fix for Atom Smasher prototype so it doesn't crash on start (wrong bank scheme detected).
* Fix for E7 banking so it handles 8K, 12K and 16K roms.
* Fix for Flash Gordon to eliminate graphical glitches.
* Fix for Elf Adventure prototype so it runs.
* Fix for Star Gunner so it doesn't glitch.
* Fix for Warlords graphical glitches.
* Fix for Worm War I graphical glitches.
* Fix for A-Star not starting.
* Fix for Hugo Hunt graphical glitches.
* Improved random() generator for more robust RAM clear / handling on startup and added config to either randomize RAM or clear it at start.
* Added new option to use the 'Compatible' BUS driver which will handles things like invalid reads and drives unused TIA bits (a few games rely on this - but it does slow down emulation slightly).

'''V6.5 2022/12/21'''
* Polished release - a few more tweaks, a few more optimizations and everything is running as fast science allows on the DS/DSi.
* Removed "ghost read" and "ghost writes" on the 6502 emulation for a bit more speed.
* Use of gcc "likely/unlikely" in a few key spots to help the compiler optimize.

'''V6.4 2022/12/16'''
* Reduced stack memory so we don't crash when first creating a Savekey EE file.
* Improved 6502 handling to localize the PC for a bit of a performance boost.
* Added the 3E+ banking scheme.
* New global palette and sound options on the Configuration Menu page 2 (use L/R keys).
* Other small improvements as time permitted.

'''V6.3 2022/12/11'''
* Improved performance across the board. More games play at the right speed even on the older DS-Lite/Phat.
* New QuadTari support - for now it's just Dual Joysticks + SaveKey which is useful for games like Robotwar.

'''V6.2 2022/12/05'''
* New WAVE DIRECT sound handling for fast-fetching music. Draconian, Mappy, Stay Frosty 2, Stella's Stocking, Pitfall II and Quadrun have much improved sound.
* New palette options to tweak the colors to your liking.
* Memory re-org for a bit more speed but also to recover some valuable resources so more features can be added in the future.
* Added a 2nd page (not yet populated) for possible future options. This requires a new configuration file format - your old one will be reset. Sorry!
* Fixed CDFJ+ fetchers causing problems (including incorrect handling of SaveKey).
* Other small improvements as time permitted.

'''V6.1 2022/12/01'''
* CDFJ+ games are now supported up to 256K of ROM and 32K of RAM. Turbo Arcade is playable but isn't yet full speed.
* More speedup in ARM Thumb processing.
* New Screen Pan Up and Pan Down handling - this can be mapped to any DS button (XYAB) to help with games that use more than 192 pixel lines (really useful for CDFJ games from Champ Games).

'''V6.0 2022/11/27'''
* CDF/CDFJ games are now supported (but not CDFJ+)
* Big speedup in ARM Thumb processing to render all DPC+ games full-speed on the DSi or above.

'''V5.9 2022/11/21'''
* Minor fixes for some games to render them more accurately including the new Chaotic Grill homebrew.
* Improved ARM Thumbulator for another frame of performance.
* Minor cleanups and optimizations across the board.

'''V5.8 2022/10/21'''
* Fixed colors in Medieval Mayhem (and a few other games).
* Fixed stars to show properly in Stay Frosty and Rabbit Transit.
* Streamlined DPC+ so Space Rocks and Stay Frosty 2 are full speed.
* Minor cleanups and optmizations across the board.

'''V5.7 2022/10/18'''
* Fixed Sword of Surtr so it plays properly.
* Added TWIN STICK controller so games like Rail Slider are playable!
* More DPC+ optimizations... Space Rocks is almost full speed!

'''V5.6 2022/10/14'''
* Massive speedup improvement for DPC+ games. Most play full speed on the DSi.
* Fixed graphical glitches on Space Rocks homebrew.
* Other cleanups and optimizations across the board to shine things up.

'''V5.5 2022/10/12'''
* Added DPC+ with ARM Thumbulator to provide some preliminary support for ARM-assisted games.
* Improved execution speed of the emulator and improved the frame blending algorithm.

'''V5.4 2022/10/07'''

* Added DF bank switching scheme (missed when DFSC was added).
* New core execution loop that gives us another 2 frames of performance.
* Optimized F4 driver to make some of the 32K games playable on DS-Lite.
* Cleanup across the board.

'''V5.3 2022/10/03'''

* Added Chetiry (CTY) bank switching scheme with EEPROM support (but no music fetchers).
* Improved memory handling across the board for another frame of performance.
* Fixed SP+ so it runs properly again.
* Improved driver for Midnight Magic and Realsports Tennis so both now run at 60FPS!

'''V5.2 2022/09/30'''

* Fixed goof in F6, F4 and related F6SC and F4SC drivers!
* Another frame of increased performance
* More accurate AR cart handling for Supercharger games
* V5.2a: 3E and related fix

'''V5.1 2022/09/29'''

* Improved all bankswitching for more speed and greater copatibility.
* New F6 driver for DS-LITE to support 16K games - many at full speed!
* Cleanups across the board.

'''V5.0 2022/09/27'''

* Added new bankswitching scheme: X07 (Stella's Stocking).
* Improved 4K/2K driver to squeese out a couple more frames of performance.
* New special F8 driver to support more 8K games on the DS-Lite.
* Lots of cleanup across the board in the database to make more games playable.
* Updated to 5.0c with another frame of improvement for 4K and 8K games!

'''V4.9 2022/09/18'''
* Added new bankswitching schemes: TVBOY, UASW and 0840 (Econobanking).
* Fixed UA bankswitching scheme to allow more games to run.

'''V4.8 2022/09/11'''
* Fixed Super Bank (SB) scheme.

'''V4.7 2022/03/24'''
* Added per-game configuration settings.
* Fixed 3E/3F and UA bankswitching schemes.

'''V4.6 2022/03/20'''
* Added SaveKey support - standard games will have a virtual SaveKey in the right controller jack and will be auto-backed to a 32K /data/StellaDS.EE file.
* Added EF, EFSC, DFSC and SB (SuperBank) support for games as large as 256K!

'''V4.5 2021/11/05'''
* New sound output core - no more zingers.

'''V4.4 2021/08/22'''
* Minor cleanups across the board. Improved AR cart speed by ~1FPS.
* Added horizontal stretch - use the Left Shoulder + L/R D-Pad.
* The Y button is now auto-fire.

'''V4.3 2021/08/09'''
* Massive overhaul of the non-bank-switched engine so now the older DS-Lite and DS-Phat will run many games at full speed.

'''V4.2 2021/08/02'''
* New overlay graphic for Star Raiders (plus manual).
* A half dozen odd games got their controllers straightened out.
* About 100 graphical tweaks for various games to make them look as good as possible.

'''V4.1 2021/07/28'''
* Found another 1-2% speed up in TIA rendering.
* Bumper Bash now plays correctly (you can use the shoulder buttons too).
* Kool-Aid-Man now plays correctly.
* Meltdown graphics improvements (but not fixed... but playable).
* Alpha Beam, Big Bird and Cookie Monster games all work with joystick controls now.

'''V4.0 2021/07/24'''
* Found another 3-5% speed up in TIA rendering! Official Frogger now at 60FPS.
* Press and hold L+R+A to swap LCD screens.
* Other minor cleanups and polish.

[https://github.com/wavemotion-dave/StellaDS/releases Release notes.]

==Credits==
Thanks and credits:
* To Bradford W. Mott and Stephen Anthony and various contributors for Stella (http://stella.sourceforge.net/)
* To Robz for Twilight-Menu++ which rekindled emulation on the classic handheld (https://github.com/DS-Homebrew/TWiLightMenu)
* To Wintermute for devkitpro and libnds ([http://www.devkitpro.org/ http://www.devkitpro.org])
* To Alekmaul and The Chuckster for porting Stella to the DS.
* To John Champeau for his support in helping me optimize the emualtor for his advanced arm-assisted games.

==External links==
* GitHub - https://github.com/wavemotion-dave/StellaDS
* GBAtemp - https://gbatemp.net/threads/stella-ds-improved.577691

Butano GBA

2026-07-10T03:30:30Z

HydeWing: 21.7.1

{{Infobox GBA Homebrews
|title=butano
|image=Butano2.png
|description=Modern C++ high level GBA engine.
|author=GValiente
|lastupdated=2026/07/06
|type=Development
|version=21.7.1
|license=Zlib
|download=https://github.com/GValiente/butano/releases
|website=https://github.com/GValiente/butano
|source=https://github.com/GValiente/butano
}}
{{#seo:
|title= (Development Libraries) - GameBrew
|title_mode=append
|image=butano2.png
|image_alt=butano
}}
Butano is a modern C++ high level engine for the Game Boy Advance.

==Features==
*Create and display sprites, backgrounds, text, raster effects and more with only one line of C++ code.
*Custom standard library without heap allocations nor exceptions, based on [https://www.etlcpp.com/ ETL].
*Import and use your own assets [https://gvaliente.github.io/butano/import.html with ease].
*Multiple development tools like [https://gvaliente.github.io/butano/group__assert.html asserts], [https://gvaliente.github.io/butano/group__log.html emulator logging] and [https://gvaliente.github.io/butano/group__profiler.html code profiling].
*Based on modern C++ concepts like shared ownership and RAII.
*Detailed [https://gvaliente.github.io/butano documentation].
*Multiple [https://gvaliente.github.io/butano/examples.html examples] of most aspects of the engine.
*The source code and assets of two full games ([https://github.com/GValiente/butano#made-with-butano-butano-fighter Butano Fighter] and [https://github.com/GValiente/butano#made-with-butano-varooom-3d Varooom 3D]) are provided with this project.

==User guide==
Butano is built on top of the [https://devkitpro.org/ devkitARM toolchain], so it supports Windows, macOS and Unix-like platforms.

The best way to get started is to read the [https://gvaliente.github.io/butano/getting_started.html download, install and start using Butano guide].

Homebrew projects made with Butano:

{| class="wikitable"
! style="width: 50%;"|Title
! style="width: 50%;"| Author
|-
| [[Butano Fighter GBA|Butano Fighter]]||GValiente
|-
| [[Varooom 3D GBA|Varooom 3D]]||GValiente
|-
| [[Feline GBA|Feline]]||foopod
|-
| [[Symbol Merged GBA|Symbol★Merged]]||copyrat90
|-
| [[LRO - Luggage Retrieval Officer GBA|LRO - Luggage Retrieval Officer]]||foopod
|-
| [[Bridge Quest GBA|Bridge Quest]]||fixxiefixx
|-
| [[Advance - Adventures Of The Math And Logic Club GBA|Advance! Adventures Of The Math & Logic Club]]||kvh64
|-
| [[Knight Owls GBA|Knight Owls]]||blaise-rascal
|-
| [[Tremblay Island GBA|Tremblay Island]]||cinemint
|-
| [[Frost Princess GBA|Frost Princess]]||squishyfrogs
|-
| [[GBA-NICCC|GBA-NICCC]]||GValiente
|-
| [[gba-free-fonts|gba-free-fonts]]||laqieer
|-
| [[GBA Microjam 23|GBA Microjam '23]]||Various authors
|-
| [[Nuclear Love GBA|Nuclear Love]]||Jono Shields
|-
| [[Sips GBA|sips]]||Jono Shields
|-
| [https://neofidstudios.itch.io/demons-of-asteborg-dx Demons of Asteborg DX]||NeofidStudios
|-
| [https://afska.itch.io/beat-beast BeatBeast]||Afska, LaChia, Synthenia
|-
| [https://tardigrade-nx.itch.io/discrete-orange Discrete Orange]||Tardigrade
|-
| [https://staticlinkage.itch.io/sleep-paradox Sleep Paradox]||staticlinkage, ReyOruga, Nikku4211
|-
| [https://jeremyelkayam.itch.io/globlins Globlins!]||Jeremy Elkayam
|-
| [https://eragnarok.itch.io/detective-monroe-murder-at-sea Detective Monroe: Murder at Sea]||eragnarok, HummusHustler
|-
| [https://jeffzzq.itch.io/work-life Work Life]||jeffzzq
|-
| [https://fralacticus.itch.io/bata-dubnos Bata Dubnos]||Fralacticus
|-
| [https://drkylstein.itch.io/syscrusher Sys*Crusher]||OutOfSync
|-
| [https://jenkalab.itch.io/toll-runner Toll Runner]||Jenka Lab
|-
| [https://luife.itch.io/happy-dawn Happy Dawn]||Luife
|-
| [https://fixxiefixx.itch.io/space-evangelion Space Evangelion]||fixxiefixx
|-
| [https://github.com/chrislewisdev/gba-pseudo-3d GBA Pseudo-3D demo]||Chris Lewis-Hou
|}

==Screenshots==
https://dlhb.gamebrew.org/gbahomebrews/butano3.gif
https://dlhb.gamebrew.org/gbahomebrews/butano4.gif
https://dlhb.gamebrew.org/gbahomebrews/butano5.gif

==Credits==
Third party libraries:
* GBA hardware access and more provided by [https://www.coranac.com/projects/#tonc Tonclib], [https://github.com/AntonioND/libugba Universal GBA Library] and [https://github.com/felixjones/agbabi agbabi].
* Music and sound effects provided by [https://blocksds.skylyrac.net/docs/maxmod/index.html Maxmod], [https://github.com/stuij/apex-audio-system Apex Audio System], [https://github.com/AntonioND/gbt-player GBT Player] and [https://github.com/copyrat90/gbadev-ja-test VGM player].
* Fast number to string conversion provided by [http://danposluns.com/danposluns/gbadev/posprintf/index.html posprintf].
* Fast math routines provided by [https://github.com/JoaoBaptMG/gba-modern gba-modern] and [https://github.com/AntonioND/libugba Universal GBA Library].
* Fast decompression routines provided by [https://github.com/Cult-of-GBA/BIOS Cult-of-GBA BIOS].
* Multiplayer support provided by [https://github.com/rodri042/gba-link-connection gba-link-connection].
* Pool containers provided by [https://www.etlcpp.com/ ETL].
* Unique type ID generation without RTTI provided by [https://github.com/Manu343726/ctti CTTI].
* Stateless random number generator provided by [https://github.com/velipso/whisky whisky].

==External links==
* GitHub - https://github.com/GValiente/butano

Balatro3DS

2026-07-10T03:30:27Z

HydeWing: Alpha 1.1.5

{{Infobox 3DS Homebrews
|title=Balatro3DS
|image=Balatro3DS.png
|description=A fanmade Balatro clone for the 3DS.
|author=idkhan
|lastupdated=2026/07/10
|type=Card
|version=Alpha 1.1.5
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/3dshomebrews/Balatro3DS.7z
|website=https://www.reddit.com/r/3dshacks/comments/1sliqql/version_01_of_balatro3ds_released/
|source=https://github.com/idkhan/Balatro3DS
}}
Balatro3DS is a fan-made port/implementation of the game Balatro targeting the Nintendo 3DS, built with Lua and LÖVE.

== Installation ==
Requires a Nintendo 3DS with homebrew capabilities (for running custom software).

Download the [https://github.com/idkhan/Balatro3DS/releases latest release].

Copy the Balatro3DS.3dsx file into the 3ds folder on the root of your SD Card.

Open with the Homebrew launcher.

== Controls ==
R or Y - Play

L or X - Discard

D-Pad Left - Sort by Rank

D-Pad Right - Sort by Suit

D-Pad Up - Show Jokers

D-Pad Down - Hide Jokers

== Changelog ==
'''Alpha 1.1.5'''
* Features
** Added the Collection to view all Cards, Blinds, Enhancements, etc
** Added More Gamepad Controls, check the How to Play menu to learn more
** Boss Blinds no longer repeat
** Added the Diet Cola Joker (it was missing before)
** Added a sneaky little cheat to unlock everything (Konami Code)
* Bugfixes
** Astronomer Joker now works
** Shop prices are recalculated after buying the discount vouchers
** Main Menu is now aligned properly
** Hitting New Run in a game saves the last run
** There's a bunch more I cant remember

'''Alpha 1.1.3 (Fixed)'''
* Features:
** Menu Animation finally added
* Bugfixes:
** Fixed no price being shown on the Sell drop zone
** Fixed Tags and Spectral debuffs carrying over from previous runs
** Undiscovered cards now show their tooltips, just not their names

'''Alpha 1.1.2'''
* Features
** Adds Deck and Stake Unlocks
** Allows Discovering Jokers, Tarot, Spectral and Planet Cards
** Deck View now shows Deck, Stake and Blind Information
* Bugfixes
** Fixed the Invisible Joker bug (probably)
** Fixed Ankh not working
** Fixed incorrect Blind colors in the TopUI
** Vagabond not spawning tarot cards at $4
** Gros Michel was still in the shop pool after going extinct
** Changes made to the hand were not copied to the deck properly

'''Alpha 1.1.1 (Hotfix)'''
* Fixed the volume slider not working and freezing the game
* Fixed skip tags not rerolling after defeating a boss blind

'''Alpha 1.1.0'''
* Features:
** REVAMPED THE SHOP CONTROLS - drag and drop functionality similar to the Mobile UI
** Added a Win Screen for Ante 8 - Still no progression tracking
* Bugfixes:
** Negative, Foil, Holo, Polychrome Tags were not working. Fixed
** The voucher tag didn't do anything

'''Alpha 1.0.2'''
* Skip tags were crashing the game because I used a lua keyword as the name for a function parameter [https://github.com/idkhan/Balatro3DS/issues/31 #31]
* All Special Decks were being scored as Plasma deck because I missed a bracket [https://github.com/idkhan/Balatro3DS/issues/31 #31]

'''Alpha 1.0.1'''
* Now you can hold L to start Card Selection mode and use the DPAD to navigate through your hand.
* While in Card Selection Mode, pressing Up allows you to toggle a card and holding R and moving right or left lets you batch select cards
* Features:
** Added a Settings Menu ([https://github.com/pixelkat5 @pixelkat5])
** Improved Menu ([https://github.com/Promaster2007 @Promaster2007]) and new How to Play screen
** Added Gamepad support for card selection and navigation:
** New Icon ([https://github.com/Promaster2007 @Promaster2007])
* Bug Fixes ([https://github.com/idkhan @idkhan]):
** Fixed issue with card rendering in deck view.
** Fixed cards disappearing after opening a Booster Pack
** Fixed bad collisions in deck view
** Fixed an infinite loop caused by Brainstorm and Blueprint pointing at each other
** Fixed Cavendish being spawnable without Gros Michel going extinct

'''Alpha 1.0.0'''
* Features Added:
** Added a Deck View, now you can press Select to view your deck and owned vouchers
** Added all the Decks
** Added all Stakes
* Bug Fixes:
** Fixed Legendary Jokers not showing up properly
** Fixed multiple jokers like the Mail-in Rebate on syncing up
** Fixed some Jokers not triggering properly
** Grabber and Nacho Tong vouchers are in the game, apparently they were just missing from the catalog, so now they are in the game and can be obtained
** Some other stuff I cannot remember, but I know I fixed a lot of bugs and added a lot of features, so enjoy!

'''Alpha 0.4.0'''
* Bugfixes
** Bigger Buy button
** Fixed the long delay in scoring with many jokers
** I can't remember them all, there's a bunch

'''Alpha 0.3.6'''
* Bugfixes
** Score being too large to fit in the panel now resizes [https://github.com/idkhan/Balatro3DS/issues/15 #15]
** Castle Joker now changes suit and only picks suits present in the deck
** Blue Joker now counts cards in deck, used to count all cards [https://github.com/idkhan/Balatro3DS/issues/21 #21]
** Mr Bones not working properly [https://github.com/idkhan/Balatro3DS/issues/17 #17]
** Green Joker can no longer have negative mult [https://github.com/idkhan/Balatro3DS/issues/7 #7]
** Tarot Cards were not usable on less than the max number of cards, now they work as intended
** Fixed Boss blinds stopped working entirely
** Fixed glass break resetting score and changing hand types
* Noted Problems
** Some Jokers can be invisible, this is because of the 3DS's tiny VRAM cache filling up and not being able to display the texture. The Joker will still work. So if your booster pack comes with just one joker, the second one is probably invisible. Just tap where you expect it to be and the tooltip should show up. This will be fixed when new art assets are introduced.

'''Alpha 0.3.5'''
* Bugfixes
** Fixed Cavendish appearing before Gros Michel is Extinct
** Fixed Oops joker not counting correctly
** Fixed Music pitch
** Fixed Tooltip drawing
** Fixed Popcorn not destroying itself
** Fixed Suit order in hand
** Fixed Wheel of Fortune not rolling chances properly
* Noted Problems
** Some Jokers may be invisible in the shop or in booster packs, they're still intractable and can be bought. The sprites will appear when bought.
** Boss Blind may appear as empty

'''Alpha 0.3.4'''
* Bugfixes
** Fixed cards being debuffed after Boss Blinds [https://github.com/idkhan/Balatro3DS/issues/6 #6]
** Fixed Booster Pack layout in the shop
** Fixed Endless Mode (After Ante 8) chip scaling

'''Alpha 0.3.2 (Not Fully Tested)'''
* Additions
** Added Vouchers
* Bugfixes
** Fixed Hit the Bus Joker counting not scored cards
** Fixed Hand Levels not resetting
** Fixed Two Pairs not containing Pairs [https://github.com/idkhan/Balatro3DS/issues/5 #5]

'''Alpha 0.2.3'''
* Bugfixes
** Fixed check for Flush with Four Fingers
** Fixed Judgement Tarot card creating Legendary Jokers and implemented proper rarity distribution

'''Alpha 0.2.2'''
* Bugfixes
** Fixed Jokers not being sellable when opening Booster Packs
** Fixed the Fortune Teller and Stuntman Jokers not working
** Fixed check for hands contained in other hands

'''Alpha 0.2'''
* Added a Menu and Pause Screen
* You can now save and continue runs
* Bugfixes
** Wild cards work now (completely forgot about them on the first release, oops)
** Fixed a bug with Booster Packs triggering Red Card even when the pack wasn't skipped
** Fixed Steel cards not scoring properly

'''Alpha 0.1.0'''
* 150 Jokers
* All Tarot, Planet, Spectral Cards
* All Boss Blinds
* No Menu or Pause Screen
* No Vouchers and Tags

== External links ==
* itch.io - https://thegazpacho.itch.io/balatro3ds
* GitHub - https://github.com/idkhan/Balatro3DS
* Reddit - https://www.reddit.com/r/3dshacks/comments/1sliqql/version_01_of_balatro3ds_released/

PocketCompiler 3DS

2026-07-10T03:30:26Z

HydeWing: 0.43

Vitacompanion Plugin

2026-07-10T03:30:26Z

HydeWing: 1.02

{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|image=vitacompanion2.png
|image_alt=vitacompanion
}}
{{Infobox Vita Homebrews
|title=vitacompanion
|image=vitacompanion2.png
|description=Development helper plugin.
|author=devnoname120
|lastupdated=2026/07/09
|type=Plugins
|version=1.02
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/vitacompanion.7z
|website=https://github.com/devnoname120/vitacompanion
|source=https://github.com/devnoname120/vitacompanion
}}
vitacompanion by devnoname120 is a user module which makes developing homebrews for the PS Vita device easier. It does two things:
*Open a FTP server on port 1337.
*Listen to commands on port 1338.

==Installation==
Run [[VitaShell]] on your PS Vita, press Select to activate the FTP server and copy vitacompanion.suprx to ur0:tai/.

Finally, add the following line to ur0:tai/config.txt

*main
ur0:tai/vitacompanion.suprx

==User guide==
=== FTP server ===
You can upload stuff to your vita by running:

curl -T somefile.zip <nowiki>ftp://IP_TO_VITA:1337/ux0:/somedir/somefile.zip</nowiki>

Or you can use your regular FTP client. The server accepts both Vita-style paths such as <code>ux0:/somedir/</code> and FTP absolute paths such as <code>/ux0:/somedir/</code>. It also supports <code>EPSV</code>, <code>PASV</code>, <code>LIST</code>, <code>NLST</code>, and <code>MDTM</code> for compatibility with generic FTP clients.

If you want curl to send the full FTP path directly instead of changing directories first, use the double-slash URL form:

curl --ftp-method nocwd <nowiki>ftp://IP_TO_VITA:1337//ux0:/somedir/</nowiki>

=== Command server ===
Send a command by opening a TCP connection to the port 1338 of your Vita.

For example, you can reboot your vita by running:

echo reboot | nc IP_TO_PSVITA 1338

Note that you need to append a newline character to the command that you send. <code>echo</code> already adds one, which is why it works here.

=== Available commands ===
{| class="wikitable"
|-
! dir="ltr"| Command
! dir="ltr"| Arguments
! dir="ltr"| Explanation
|-
| dir="ltr"| <code>help</code>
| dir="ltr"| none
| dir="ltr"| display the help screen
|-
| dir="ltr"| <code>destroy</code>
| dir="ltr"| none
| dir="ltr"| kill all running applications
|-
| dir="ltr"| <code>launch</code>
| dir="ltr"| <code><TITLEID></code>
| dir="ltr"| launch an application by id e.g. <code>launch VHBB00001</code> to launch the [https://github.com/devnoname120/vhbb Vita Homebrew Browser]
|-
| dir="ltr"| <code>kill</code>
| dir="ltr"| <code><TITLEID></code>
| dir="ltr"| kill an application by id
|-
| dir="ltr"| <code>nosleep</code>
| dir="ltr"| <code>on</code>, <code>off</code> or <code>status</code>
| dir="ltr"| enable or disable automatic suspend prevention. This is enabled by default at boot
|-
| dir="ltr"| <code>reboot</code>
| dir="ltr"| none
| dir="ltr"| reboot the console
|-
| dir="ltr"| <code>screen</code>
| dir="ltr"| <code>on</code> or <code>off</code>
| dir="ltr"| turn screen on or off
|}

'''Note''': Commands are defined in [https://github.com/robsdedude/vitacompanion/blob/master/src/cmd_definitions.c <code>src/cmd_definitions.c</code>], you can add new commands there.

===Integration in IDE's===
VSCode - https://github.com/imcquee/vitacompanion-VSCODE

== Changelog ==
'''1.02'''
* Fixed a regression where no-argument FTP commands such as LIST were parsed as their own path argument.
* Restored plain LIST support for clients such as lftp and FileZilla after changing into a directory.
* Bumped module metadata to version 1.02.
'''1.01'''
* Added help output, application kill-by-title-id support, and command-controlled no-sleep mode.
* Hardened command server input handling.
* Fixed startup behavior when Wi-Fi is already connected.
* Expanded FTP compatibility with uma0/imc0 drive support, vendored libftpvita path handling fixes, EPSV, NLST, and MDTM.

==Credits==
Thanks to xerpi for his [https://bitbucket.org/xerpi/vita-ftploader/src/87ef1d13a8aa/plugin/?at=master vita-ftploader] plugin, I stole a lot of his code (with his permission).

Thanks to cpasjuste for [[PSP2SHELL Vita]], it inspired me to create this tool.

== External links ==
* GitHub - https://github.com/devnoname120/vitacompanion
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/488

EQVita

2026-07-10T03:30:25Z

HydeWing: 1.14.0

{{Infobox Vita Homebrews
|title=EQVita
|image=EQVita2.png
|description=System-wide EQ kernel plugin and app for PS Vita.
|author=shev0k
|lastupdated=2026/07/07
|type=Utilities
|version=1.14.0
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/vitahomebrews/EQVita.7z
|website=https://github.com/shev0k/EQVita
|source=https://github.com/shev0k/EQVita
|donation=
}}
{{#seo:
|title=Vita Homebrew Apps (Utilities) - GameBrew
|title_mode=append
|image=EQVita.png
|image_alt=EQVita
}}
EQVita is a hobby homebrew project made to give the Vita a richer sound. It ships as a kernel plugin plus a small Vita app.

Install it, open the app, pick a preset, and make the Vita sound less flat. Nerd version: the plugin hooks <code>sceAudioOutOutput</code>, while the app handles presets, route hints, themes, logs, and boot state.

== Features ==
* 10-band graphic EQ from <code>31 Hz</code> to <code>16 kHz</code>.
* Simple EQ mode for bass, mids, treble, and preamp.
* Advanced EQ mode for every band and preamp.
* Built-in <code>STOCK Depth</code> and <code>MOD Switch</code> presets.
* Preset slots with save/load support.
* Music Preview for playing a local <code>OGG</code>, <code>MP3</code>, or <code>WAV</code> while tuning EQ.
* Speaker-only mode or all-output mode for wired/Bluetooth too.
* Optional HPF (Bass guard), which cuts very low rumble.
* Safe, Loud, and Direct headroom modes.
* Vita-style app UI with themes. <code>Crimson Vita</code> is the default.
* Boot persistence through <code>ur0:data/eqvita/boot.eqbs</code>.
* App log at <code>ur0:data/eqvita/app.log</code>.

== Installation ==
Copy <code>eq_speaker.skprx</code> to <code>ur0:tai/</code>.

Add to <code>ur0:tai/config.txt</code> under <code>*KERNEL</code>:
<pre>*KERNEL
ur0:tai/eq_speaker.skprx</pre>

Reboot, install <code>EQVita.vpk</code> through [[VitaShell]].

Open EQVita and pick a preset.

'''Note:''' Keep the app and plugin from the same release. Mixed versions can fail or behave weirdly.

== User guide ==
=== Presets And Data ===
EQVita stores data in: <code>ur0:data/eqvita/</code>

Files you may see there:
* <code>preset0.eqvp</code>, <code>preset1.eqvp</code>, <code>preset2.eqvp</code> - preset slots.
* <code>boot.eqbs</code> - boot state.
* <code>theme.cfg</code> - selected app theme.
* <code>app.log</code> - useful log for bug reports.

There are three preset slots. EQ changes apply live, and saving writes the current settings into the selected slot.

The built-in presets are starting points. Applying <code>STOCK Depth</code> or <code>MOD Switch</code> saves that preset into the active slot and startup state.

Small warning: every Vita, speaker mod, headphone, and Bluetooth setup is different. Blindly copying my bass-heavy presets can cause clipping or ugly distortion on your setup. If that happens, lower preamp first.

If you make a preset that sounds nice, please share it in this repo's [https://github.com/shev0k/EQVita/discussions Discussions]. Over time, it would be cool to build a small preset library from real user setups instead of pretending one preset fits everything.

The boot state is what lets the plugin load your saved sound after reboot, before you open the app again.

Old raw <code>preset%d.bin</code> files are imported read-only when a matching <code>.eqvp</code> file does not exist.

=== Music Preview ===
The app can play a local song while you tune EQ.

Put an <code>OGG</code>, <code>MP3</code>, or <code>WAV</code> file somewhere on your Vita, open <code>Music Preview</code>, choose the file, then adjust EQ like normal.

Notes:
* No music is bundled in the VPK.
* <code>ux0:music/</code> is shown as a shortcut in the file picker when available.
* Preview playback stops and releases the audio port when you stop it or close EQVita.
* This is only for tuning. It is not trying to replace your normal music player.

=== Output Modes ===
<code>Vita speakers</code> mode applies EQ only to the Vita speakers.

<code>All outputs</code> mode also allows wired headphones and Bluetooth output.

If EQ is bypassed, the app tries to show why. Common reasons are:
* EQ is turned off.
* The selected output mode does not match the current route.
* The output port is unknown or busy.
* The audio format is unsupported.
* The app and plugin ABI do not match.

Short bypasses can happen when the Vita opens, closes, or reconfigures audio ports. If it is quick and does not sound bad, it is usually fine.

== Controls ==
D-Pad/Left Analog - Move through rows

Left/Right - Adjust selected value

L/R - Bigger EQ value changes

Cross - Select, toggle, or activate

Circle - Back, Exit from main menu

Start - Quick EQ on/off

Triangle - Help

Touch - Tap rows or drag lists

EQVita follows the Vita enter-button setting for Cross/Circle.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/EQVita3.png

https://dlhb.gamebrew.org/vitahomebrews/images/EQVita4.png

https://dlhb.gamebrew.org/vitahomebrews/images/EQVita5.png

==Compatibility==
Hardware Tested:
* Vita model - PS Vita 1000
* Firmware - 3.65 Enso
* Output - Vita speakers, Bluetooth
* Games/apps tested - Persona 4 Golden, God of War, VitaShell, Vita home screen
* Known limits - heavy games can still stress Vita audio; short bypasses during port changes can happen.

==Changelog==
'''v1.14.0'''
* What's New
** App/plugin ABI bumped to <code>1.14.0</code>.
* Fixed
** Fixed audio port tracking when different apps reuse the same Vita port ids.
** Fixed recovered BGM ports being tracked with the wrong port type.
** Improved handling for games and apps that open, release, or reconfigure audio ports often.

'''v1.13.0'''
* What's New
** New Vita-style app UI with themes, cleaner pages, and better controls.
** New Music Preview screen for playing a local <code>OGG</code>, <code>MP3</code>, or <code>WAV</code> while tuning EQ.
** New preset flow with save prompts, discard behavior, and active preset persistence.
** Better logs and telemetry for audio/debug reports.
** Proper full system-wide equalizer support. The plugin should now affect all audio ports.
* Fixed
** Fixed preset saving/loading and active slot persistence.
** Fixed compatibility with the official Music Player; the plugin now affects it correctly.
** Fixed compatibility with the music_premium.skprx plugin.
** Improved app exit, theme switching, and Music Preview cleanup.
** Improved audio stability and reduced timing spikes on stock Vita clocks.
** Fixed Windows/WSL script and source-test release checks.

'''v1.10'''
* First Release.

==Credits==
UI images adapted from VitaShell.

== External links ==
* GitHub - https://github.com/shev0k/EQVita
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1353

PleNx Vita

2026-07-10T03:30:24Z

HydeWing:

{{Infobox Vita Homebrews
|title=pleNx
|image=pleNxVita.png
|description=Plex client for PS Vita.
|author=thcolin
|lastupdated=2026/07/05
|type=Media Players
|version=0.1.14
|license=Apache-2.0
|download=https://dlhb.gamebrew.org/vitahomebrews/pleNxVita.7z
|website=https://github.com/thcolin/pleNx
|source=https://github.com/thcolin/pleNx
|donation=
}}
{{#seo:
|title=Vita Homebrew Apps (Media Players) - GameBrew
|title_mode=append
|image=pleNxVita.png
|image_alt=pleNx
}}
pleNx (/plɛn.ɛks/, "Plex × NX") is a third-party, native, controller-first Plex client that lets you browse and play the movies and shows from your Plex Media Server through a fully native interface designed for the gamepad.

pleNx is a fork of [[Switchfin]] (a Nintendo Switch Jellyfin client) fully migrated to the Plex API, with a redesigned interface. It is a third-party project, not affiliated with or endorsed by Plex.

== Features ==
* Sign in with Plex - enter a 4-character code on plex.tv/link, then choose your server and your Plex Home profile (PIN-protected profiles supported).
* Home mirrors your server - Continue Watching followed by every hub configured on your Plex, in the order your server returns them.
* Libraries in the sidebar - one entry per library, each with Home, Suggestions, Collections and Genres views, and server-side sorting.
* Rich detail pages - full-bleed backdrop with the title logo, cast with full person pages (filmography), and related rows pulled from your server.
* Season pages - artwork, episode count and synopsis, with one-tap full-season download.
* Quick actions on any poster - go to show, go to season, mark watched, download.
* Plex Watchlist - browse your account watchlist in the sidebar, add or remove any movie or show from its detail page or the quick actions menu.
* Playback with MPV - direct play and universal transcode (HLS), resume, chapters, external and embedded subtitles, audio track selection.
* Offline downloads for playback without a connection (original quality).
* Remote file browser for WebDAV / Apache / Nginx / FTP / SFTP servers.
* Available in 14 languages.
* MPV decodes H.264, H.265, VP8, VP9 and AV1 video; Opus, FLAC, MP3, AAC, AC-3, E-AC-3, TrueHD and DTS audio; and SRT, VTT, SSA/ASS and DVDSUB subtitles.

==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/images/pleNxVita-01.png

https://dlhb.gamebrew.org/vitahomebrews/images/pleNxVita-02.png

https://dlhb.gamebrew.org/vitahomebrews/images/pleNxVita-03.png

https://dlhb.gamebrew.org/vitahomebrews/images/pleNxVita-04.png

== Changelog ==
'''v0.1.14'''
* '''PS Vita'''
** '''The in-app updater now installs the new version directly instead of opening a broken browser page.''' When an update was available, the Vita opened the GitHub release page in the system browser — a page its ageing WebKit cannot render, so it hung and the download never showed up. The Vita now self-updates in place like the Switch does: it downloads the VPK, unpacks it and installs it through the system package installer, then drops you back to the LiveArea to relaunch the updated bubble. (The VitaDB "downgrade to 0.1.4" prompt reported alongside this is a stale VitaDB store entry, not a pleNx bug; see <code>RELEASING.md</code>.)

'''v0.1.13'''
* '''Interface'''
** '''Series and movie logos no longer smear.''' The transparent title logos on detail pages are drawn in "fit" mode, so the image is smaller than its box and sits letterboxed inside it. The empty area around it was still being painted with the image, which sampled outside the texture and — because edge pixels are clamped — dragged vertical streaks down from every shape. The image now fills only its own fitted area, so logos render cleanly. Affects every platform (the fix is in the shared image renderer).

'''v0.1.12'''
* '''Player'''
** '''Changing the audio or subtitle track no longer stops playback with a "playback error" on PS Vita.''' In transcode mode a track change reloads the stream, but the reload happened in place and never released the hardware decoder, so it stalled and then failed. The reload now resets the player first (like episode navigation) and tears the previous transcode session down on the server instead of leaving it orphaned.
** '''Audio and subtitle tracks are now selectable during local playback from the file browser.''' The player showed the track buttons but had no handler wired, so they appeared to do nothing.
** '''A failed transcode now falls back to direct play once''', instead of going straight to an error — a smoother recovery on constrained hardware.
** '''Playback errors now show the underlying mpv reason''' (e.g. "unrecognized file format") instead of a bare "playback error", making bug reports actionable.
* '''Fixes'''
** '''PS Vita: the transcoder height is capped at 1080p''', the hardware decoder's limit, so a 4K source at a high bitrate no longer produces a stream the Vita cannot decode.

'''v0.1.11'''
* '''Fixes'''
** '''PS Vita: servers reached by a hostname no longer stall with an endless "timeout reached".''' libcurl was built with the synchronous name resolver, so a DNS lookup issued from a background thread could not be bounded by any timeout — the synchronous resolver can only abort a slow <code>getaddrinfo()</code> via <code>SIGALRM</code>, which libcurl arms on the main thread alone. A slow-to-resolve hostname (e.g. a duckdns address) therefore hung every request indefinitely, and raising the request-timeout setting had no effect; only a raw LAN IP, which skips name resolution, worked. curl is now built with the threaded resolver so lookups run in a worker thread the timeout can abandon, and <code>CURLOPT_NOSIGNAL</code> keeps libcurl off signals on its background threads.

'''v0.1.10'''
* '''Fixes'''
** PS Vita: movie logos no longer render sheared or with a torn vertical strip. GPU texture compression always extracted a full 4×4 pixel block, so for images whose width or height isn't a multiple of 4 the edge blocks pulled in the next row's pixels (the visible vertical corruption) or read past the decoded image. Edge blocks are now clamped to the valid pixels, with the border replicated into the padding for a clean edge.

'''v0.1.9'''
* '''Fixes'''
** Self-hosted servers on your LAN are reachable again when <code>plex.direct</code> DNS is blocked. Server discovery only probed the <code>plex.direct</code> hostname, whose public DNS record points at a private IP — which routers and resolvers with DNS-rebinding protection (Fritz!Box, Pi-hole, AdGuard…) refuse to resolve. A server sitting on the same network then reported "unreachable" even though it answered directly, while the official clients connected fine. pleNx now also probes the raw IP address for private, CGNAT and VPN endpoints, bypassing <code>plex.direct</code> entirely — and re-discovers a working address on reconnect when the server changes IP (e.g. a new DHCP lease)

'''v0.1.8'''
* '''Downloads'''
** The download card now shows transfer speed and ETA. While a download is running, the progress line reads <code>123 MB / 456 MB · 5.2 MB/s · 12:30 left</code>; the rate is a smoothed average (EMA) so the estimate stays steady instead of jumping on every tick
* '''Library'''
** Movie and show pages show critic and audience ratings with their official icons. Plex's rating sources are mapped to the Rotten Tomatoes tomato (fresh/rotten), the audience popcorn (upright/spilled), and the IMDb and TMDb marks, each sized to its own aspect; a plain star is kept as a fallback when the source is unknown
* '''Changelog'''
** The changelog is now readable in the app, from Settings ▸ Changelog — the full history, scrollable
** The update prompt shows the new version's release notes instead of just its number, so you can see what changed before updating

'''v0.1.7'''
* '''Sign-in'''
** Selecting a server no longer looks frozen. Picking a server (or profile) during Plex sign-in blocked all input while probing the server's connections — several seconds, with nothing on screen — so the dialog just vanished and the app seemed dead. A loading overlay now sits over the pairing screen for the whole wait, with a reassurance line that fades in if it runs long
** Account linking survives a transient network hiccup. A single timeout or TLS blip (common on Vita) no longer aborts the whole PIN flow; only an expired/consumed code is terminal, and the 2-minute deadline stays the real give-up
* '''Player'''
** Direct-access OSD. The speed control is replaced by icon buttons for audio track, subtitle track and quality. Subtitles get a live, translucent sub-delay overlay (LEFT/RIGHT) on top of the video; audio, subtitle and sub-sync leave the settings panel. Video quality is now remembered and defaults to a 4 Mbps transcode on Vita (its decoder chokes on heavy direct play), staying Auto everywhere else
** Marking watched is now a targeted card refresh instead of reloading the whole view (heavy on the home screen): the single card updates optimistically
* '''Fixes'''
** The synopsis no longer collapses to a single line when returning from a person page — a relayout had cut the text at an intermediate width. The action row also gains a little breathing room below the title/meta block
** The splash logo no longer shows a flat colored band along its edges — an edge-clamp artifact from letterboxing the non-square asset, fixed by re-exporting it square with a transparent margin
** Deleting the last card in a grid no longer leaves a ghost highlight, and emptying the downloads list hands focus back to the sidebar

'''v0.1.6'''
* '''Fixes'''
** PS Vita: transparent images no longer render as opaque black blocks. Images with real transparency now use DXT5 (8-bit alpha) instead of DXT1, which has no alpha channel; opaque images keep DXT1.

'''v0.1.5'''
* '''Fixes'''
** Controller navigation no longer breaks after closing the player; focus now returns to the first home row.
** Docking the Switch mid-playback now switches the video to fullscreen 1080p instead of leaving it small in a corner.
* '''Player'''
** Focused controls now show a translucent orange background instead of the border halo.
** The close button is a round, properly centered icon.
** Up/down wake the OSD and focus the play/pause button.
** The progress bar is focusable, with accelerating left/right seek (TV-style OSD is now the default, still toggleable).
** Removed the always-on bottom progress bar and its settings.

'''v0.1.4'''
* '''Fixes'''
** Every truncated row now ends with a "+" card opening the full list (the home rows and the Suggestions tabs of movie and show libraries previously lacked it). The card shows whenever the server reports more content than displayed.

'''v0.1.3'''
* '''Breaking'''
** New Switch title ID for the HOME menu tile (<code>0104201312000000</code>). Migration: delete any old tile ("Switchlex" or a previous pleNx) from the HOME menu, replace <code>pleNx.nro</code> on the SD card, then reinstall the tile from the app.
** The forwarder NPDM <code>program_id</code> is now generated from the single <code>PROJECT_TITLEID</code> source of truth.
* '''Fixes'''
** Branding harmonized across every derived asset (app icons, forwarder wordmark, scalable icon wrapper, website favicons / social image). The Android launcher icons and the PS4 / PS Vita system images now ship pleNx branding (Vita assets kept 8-bit indexed as the firmware requires).
* '''Website'''
** The hero opens with the app icon presented as a homebrew-menu tile next to the wordmark, and the floating nav no longer flashes before first paint.

'''v0.1.2'''
* '''Fixes'''
** Translations completed and corrected across all 13 languages (cs, de, es, fr, ja, ko, pt, ru, tr, uk, vi, zh-Hans, zh-Hant), now at full key parity with English. Filled missing strings, translated Plex sign-in and HOME-tile hint screens left in English in several locales, fixed mistranslations and typos, and restored the French "current speed" overlay placeholder.

'''v0.1.1'''
* '''Features'''
** Working in-app self-update on Nintendo Switch: pleNx offers to update itself (checked at startup and from Settings ? "Check for updates"), downloads the NRO with a live progress dialog, verifies the file size against the GitHub release asset, then replaces itself and prompts to relaunch. On other platforms the dialog opens the release page in the browser.
* '''Fixes'''
** The app now replaces the NRO it was actually launched from (<code>argv[0]</code>). Updating from 0.1.0 via the in-app dialog may appear to have no effect depending on NRO location; 0.1.0 users with the NRO at <code>sdmc:/switch/pleNx.nro</code> should replace it manually once.
** The release-asset download URL and expected size are now taken from the GitHub API response.
** The startup update check now honors its intended delay.
** All references to the repository now use its new name <code>thcolin/pleNx</code>.
** The Arch package version is now derived from <code>CMakeLists.txt</code>.

'''v0.1.0'''
* First release of pleNx, a third-party native Plex client for Nintendo Switch, macOS, Windows, Linux, Android, PS4 and PS Vita; a fork of Switchfin (a Jellyfin client) fully migrated to the Plex API with a complete UI overhaul.
* '''Features'''
** Full migration from the Jellyfin API to the Plex API: plex.tv PIN sign-in (link code), server discovery and connection selection, libraries, home hub, movies, shows, collections, search, and playback (direct play and transcode) backed by mpv.
** Complete UI overhaul with the new pleNx branding: icon-only sidebar, full-bleed detail pages, scrollable season / playlist / collection views, redesigned search, quick-actions side panel on any poster, guaranteed 2:3 poster ratios, skeletons and empty states, pill-shaped toasts.
** Plex Watchlist with provider-backed sorting and filters, add/remove from detail pages and the quick-actions menu.
** Offline downloads with storage gauge, active/completed sections, one-tap season or whole-show download, local playback.
** Remote file servers (WebDAV, FTP, SFTP, HTTP(S)) managed from the UI with a mandatory connection test before saving.
** Genre cards illustrated with Kometa default posters, playlists, collection pages, person pages, "Play again" on fully-watched shows.
** Available in 14 languages.
** Nintendo Switch specifics: applet-mode warning screen with HOME tile (forwarder) installation flow, system Standard font by default, USB drives via libusbhsfs.
* '''Fixes'''
** Fixed an infinite relayout loop, ghost focus on recycled views, NaN yoga measurements on empty text, and scroll-edge focus traps; included borealis framework patches.
* '''Build'''
** Local Nintendo Switch build via Docker; continuous delivery via GitHub Actions building all platforms (Switch NRO, macOS DMG, Windows, Linux Flatpak/Arch, Android APK, PS4 PKG, PS Vita VPK) on each <code>v*</code> tag.
* Documentation
** Jellyfin ? Plex migration plan, UI redesign reference, refreshed README.

== External links ==
* GitHub - https://github.com/thcolin/pleNx
* VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1411