Poltergust

From MK8
Revision as of 18:32, 30 June 2022 by Scutlet (talk | contribs) (v.1.1 update)
Jump to navigation Jump to search
Poltergust
Author: Scutlet
Operating systems: Any
Programming language: Python 3
Software type: Viewer
Console: Wii U
File Formats: DAT (Ghost Data)
Version: v1.1
Date of latest version: 2022-06-30
Download: GitHub

Overview

Poltergust is a Python 3 application for visualizing, extracting, and converting data from ghost data files. This includes player ghosts, staff ghosts, and downloaded ghosts, but not MKTV Replays. Currently, there is only active support for Wii U ghost files.

Media

File:Poltergust v1.0 UI Preview.png
A preview of the UI viewing the staff ghost of Sunshine Airport

Features

  • Previewing information such as player name, vehicle combination, and lap splits.
  • Extracting Mii Data.
  • Converting player/downloaded ghosts to staff ghosts.
  • Converting player ghosts to downloaded ghosts.

Installation

Navigate to the GitHub releases and search for the latest one. If you're running Windows, you can grab the executable that's included there. These are automatically and directly built from the source code. Note that you'll likely get a Windows Defender popup when attempting to run the tool for the first time this way.

If you're running MacOS or Linux, or if you don't want to run random executables from the internet, you will have to run the tool directly from source (see below).

Running from Source

  1. Navigate to the GitHub releases, and download the latest source code (either the zip or tar.gz).
  2. Install the latest version of Python 3.10.
  3. Open up a terminal of choice, and navigate to the place where you extracted the source code.
  4. Create a new virtual environment using python -m venv venv.
  5. Activate the newly created virtual environment using venv\Scripts\activate.bat (Windows CMD), venv\Scripts\Activate.ps1 (Windows Powershell), or source venv/bin/activate (MacOS or Linux).
  6. Install the tool's dependencies using pip install -r requirements.txt.
  7. Run the tool using python poltergust.py.

If you ever want to re-run the tool after closing your terminal, you'll need to repeat steps 3, 5 and 7. You can skip the other steps.

Version History

Version Date of release Information
v1.0 2022-06-27 First release
v1.1 2022-06-30 Added an auto-build script that creates a Windows executable.

Various bugfixes related to downloaded ghosts.

By the same author: Scutlet