Difference between revisions of "Haxchi"

From WiiUBrew
Jump to navigation Jump to search
(Created a Haxchi page for reference.)
 
(Tiramisu updates)
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Haxchi''' is a homebrew app that can quickly load custom firmware by replacing a real Virtual Console DS game with itself, so to load the custom firmware for the current kernel session, simply open Haxchi from the Wii U Menu.
+
{{Redundant|Tiramisu}}
 +
{{Infobox homebrew
 +
| title      = Haxchi
 +
| image    = [[File:Haxchi logo.png]]
 +
| desc        = Custom firmware available without needing to open [[Homebrew Launcher]]
 +
| author      = [https://github.com/FIX94 FIX94]
 +
| type        = system tool
 +
| version    = 2.5u2_v1.6
 +
| download    = https://www.wiiubru.com/appstore/zips/haxchi.zip
 +
| source = https://github.com/FIX94/haxchi
 +
| hbb = yes
 +
}}
 +
{{WarrantyDisclaimer}}
  
==Coldboot Haxchi==
+
'''Haxchi''' is a homebrew app that can quickly load homebrew using a channel on the [[System Menu]]. It replaces a real Virtual Console DS game with itself, so it is required to download one from the eShop, and this game will not be playable while Haxchi is installed.
'''Coldboot Haxchi''' (also known as '''CBHC''') is another version of Haxchi. It injects code into the boot process to automatically load the Haxchi channel. There are several things here that can be done wrong that result in a [[brick]], due to the dependence on a Coldboot Haxchi channel that is visible on the [[System Menu]]. These include:
+
 
* Moving the Coldboot Haxchi channel out of the NAND
+
==Uninstalling==
* Uninstalling the Coldboot Haxchi channel without properly uninstalling Coldboot Haxchi first.
+
Haxchi can be uninstalled simply by deleting the channel. The DS game can be recovered by downloading it again from the Nintendo eShop.
* Formatting the system
 
* Deleting the user that bought the DS game Haxchi was installed on top of.
 
* Downloading the DS game Haxchi was installed on after Haxchi was installed.
 
* Installing Haxchi again inside CBHC.
 
  
 
==Installation==
 
==Installation==
'''Haxchi Channel'''
+
Note that Haxchi is mostly useless when [[Tiramisu]] is installed, so there is usually no reason to get Haxchi.
 
# Install a Virtual Console DS game if you don't have one already. The cheapest one is "Brain Age" (known as "Brain Training" on PAL consoles).
 
# Install a Virtual Console DS game if you don't have one already. The cheapest one is "Brain Age" (known as "Brain Training" on PAL consoles).
 
# Download Haxchi from the [[Homebrew App Store]] and put it on the SD card.
 
# Download Haxchi from the [[Homebrew App Store]] and put it on the SD card.
Line 18: Line 26:
 
# Press A to accept the disclaimer, or HOME to cancel.
 
# Press A to accept the disclaimer, or HOME to cancel.
 
# Haxchi should now install.
 
# Haxchi should now install.
 
'''Coldboot Haxchi'''
 
# Be sure to read the bricking risks above.
 
# Load up normal Haxchi as a custom firmware is needed for this.
 
# Open the [[Homebrew Launcher]].
 
# Download and open the CBHC installer.
 
# Select the DS game Haxchi was installed on, and install Coldboot Haxchi there.
 
# Coldboot Haxchi will now install, and it will work once you reboot your Wii U.
 
 
==Uninstalling==
 
'''Haxchi'''<br />
 
Haxchi can be uninstalled simply by deleting the channel. The DS game can be recovered by downloading it again from the Nintendo eShop.
 
 
'''Coldboot Haxchi'''<br />
 
Before deleting the CBHC channel, load the CBHC installer, and press the uninstall button. This prevents the Wii U from bricking due to the CBHC channel not loading. After this, it is safe to delete the CBHC channel.
 
  
 
==Usage==
 
==Usage==
The DS game that Haxchi is installed over will be replaced by a new channel, the Haxchi Channel. Launching this channel loads up the Haxchi CFW, although there are also some tools that can be used, such as holding A to load the Homebrew Launcher after the CFW is loaded.
+
The DS game that Haxchi is installed over will be replaced by a new channel, the Haxchi Channel. Launching this channel loads up the Haxchi CFW, although certain buttons can be configured to perform certain actions instead of loading the CFW. For example, many people configure A to load the [[Homebrew Launcher]] to skip the need to run an inconsistent Browserhax exploit.
  
When Coldboot Haxchi is installed, the DS game is instead replaced by a Coldboot Haxchi channel with a red warning sign icon, a reminder not to delete it. It is meant to be put on a screen where it won't be seen, to prevent accidental deletion. For convenience, CBHC also installs a normal Haxchi channel that does not cover up any DS game and does not cause a brick upon deletion, so that remote screen does not need to be located to perform Haxchi-related operations.
+
==How it works==
 +
Haxchi first gains root access using [[Uhshax]]. It then takes advantage of the contenthax bug, which allows every part of a title except the actual code to be modified without invalidating it. In the case of Virtual Console games, this code is the emulator, not the game’s code, which means the game itself can be modified. Haxchi replaces the game’s code with a sequence of bytes that sets up ROP, and therefore can pass code execution to itself. Haxchi also replaces the title and banner of the game, since these are not checked either, to look like a different title.

Revision as of 04:59, 7 January 2022


Haxchi
File:Haxchi logo.png
General
Author(s)FIX94
TypeSystem tool
Version2.5u2_v1.6
Links
Download
Source
Downloadable via the Homebrew App Store
Warning!
This homebrew installs content to your Wii U that is persistent after a reboot, and may void your warranty.

Haxchi is a homebrew app that can quickly load homebrew using a channel on the System Menu. It replaces a real Virtual Console DS game with itself, so it is required to download one from the eShop, and this game will not be playable while Haxchi is installed.

Uninstalling

Haxchi can be uninstalled simply by deleting the channel. The DS game can be recovered by downloading it again from the Nintendo eShop.

Installation

Note that Haxchi is mostly useless when Tiramisu is installed, so there is usually no reason to get Haxchi.

  1. Install a Virtual Console DS game if you don't have one already. The cheapest one is "Brain Age" (known as "Brain Training" on PAL consoles).
  2. Download Haxchi from the Homebrew App Store and put it on the SD card.
  3. Run Haxchi from the Homebrew Launcher.
  4. Select the game you want to use. You won't be able to play this game while Haxchi is installed, so choose wisely.
  5. Press A to accept the disclaimer, or HOME to cancel.
  6. Haxchi should now install.

Usage

The DS game that Haxchi is installed over will be replaced by a new channel, the Haxchi Channel. Launching this channel loads up the Haxchi CFW, although certain buttons can be configured to perform certain actions instead of loading the CFW. For example, many people configure A to load the Homebrew Launcher to skip the need to run an inconsistent Browserhax exploit.

How it works

Haxchi first gains root access using Uhshax. It then takes advantage of the contenthax bug, which allows every part of a title except the actual code to be modified without invalidating it. In the case of Virtual Console games, this code is the emulator, not the game’s code, which means the game itself can be modified. Haxchi replaces the game’s code with a sequence of bytes that sets up ROP, and therefore can pass code execution to itself. Haxchi also replaces the title and banner of the game, since these are not checked either, to look like a different title.