TGAHz Parsing

What is this?

So, HzMod is a 3DS image capturing system that is entirely software-based. It can stream the 3DS top screen to a PC like NTR CFW. Development is a little strange... Archives of builds are hosted on this website: https://chainswordcs.com/horizon-by-sono.html

So, older builds (February 2018) can stream in a TARGA image format. The capability is available for all games I believe, but for some games it is required (such as Mario Kart 7, Super Smash Bros. for Nintendo 3DS, Yoshi's New Island, and Pokemon Yellow Version)

The TARGA image format streamed by HzMod is non-standard, so this repository is to document our reverse engineering efforts. Eventually we plan to push some changes to Snickerstream to add support to TARGA streams: https://github.com/RattletraPM/Snickerstream

Running the Script

This script is written in Python 3. It requires the 'pillow' module.

This is not a generic TARGA reader. It is only designed to interpret HzMod TGAs, so certain header information is hard-coded as it is constant for HzMod.

There are several available command-line arguments:

-log: Log each packet and some metadata to the console
-logcolor: Color-code log output as RGB, with purple for the attribute bit
-noimage: Don't output an image
-txt: Take input from a text file containing a hex string on the first line
-txtanim: Create an animated image with input from a text file containing a hex string on each line
-tga or -bin: Take input from a binary file
-hex: Take input from a hex string

All input, raw or as a file, is at the end of the command. For example, python TGAHzParse.py -txt -log input.txt takes input as a hex string in input.txt.

Output images are saved as TGAHZ.png for single frames or TGAHZ.gif for animations.