Retro‎ > ‎Nintendo Wii‎ > ‎


Thwimp Utility

    Thwimp is a Windows utility which allows users easily to view, to rip, and to encode Nintendo THP video files for Mario Kart Wii (and for other GCN/Wii games, to an extent). Written in Visual Basic (from Visual Studio 2010 IDE), the Thwimp application calls some FOSS and other command line tools (not included) "from arms length" via the Command Prompt to perform its tasks.

Specifically, Thwimp uses:

  • FFmpeg for video processing
  • FFplay for THP playback
  • Irfanview for image conversion
  • THPConv (definitely not included) for encoding JPG frames + wav file into THP videos

    Thwimp can show the hard-coded information about how each THP file is formatted in Mario Kart Wii, Thwimp can also view MKWii's THP files, as well as convert them to everyday video files. It can crop the THP video files, and then convert them to MP4 (H.264 codec) video files, to WAV files (for videos with audio), and padding to BMP files.

    The THP video files in Mario Kart Wii tend to be an array of multiple subvideo cells inside, with each cell playing back several other videos (multiplicities). As required by the file format specification, THP video files must have their dimensions be a multiple of 16px. Often times the size of the subvideo array will not be enough to meet the specification, so padding is added to the bottom of the THP video. This padding is not only used to meet the specification, but used for control information. For example, some of the videos shown during menus will have a white rectangle move at integer positions at each multiplicity. This white rectangle controls which row in a menu is highlighted during THP playback.

    Thwimp can intelligently handle audio, subvideo array, multiplicity, and padding/control information when encoding THP files to replace ones in-game. It does this by accepting appropriately named, input mp4 video files for each subvideo cell in the array, and for each multiplicity. It will also accept a WAV audio file, and BMP image frames for each multiplicity padding/control signal as needed. After reading the input files, Thwimp will intelligently process and splice all of the files together appropriately in order to create a high-quality, properly formatted THP video replacement file!

    Please watch the YouTube video for sample usage of the application.


Options Tab, About Box

THP Tab, THP Playback

Example set of input files for battle_cup_select.THP
(Array of 2x1 videos, each video has multplicity of 5,
with control padding frames at bottom)

Thwimp v1.1 Update!

Thwimp: Mario Kart Wii THP Utililty

Mario Kart Wiiki article


Thwimp v1.1 (01/07/2019), Source Code

User's Manual


Irfanview 32-bit

Tamkis K,
Jan 7, 2019, 3:49 PM
Tamkis K,
Jan 7, 2019, 3:49 PM
Tamkis K,
Jan 7, 2019, 3:56 PM
Tamkis K,
Oct 25, 2018, 12:14 AM
Tamkis K,
Oct 25, 2018, 12:13 AM