bentroen / poketchvideoplayer

Video player for the 'Dot Artist' Pokétch app from Pokémon DPPt.

Pokétch Video Player

Video player for the 'Dot Artist' Pokétch app from Pokémon DPPt. It works by generating DeSmuME Lua scripts for manipulating the memory region corresponding to the app's screen data.

The app's screen is composed of a 24x20 pixel grid of 8x8 pixel tiles. Each tile can have four different colors, which alternate by touching each pixel.

(Demo video)

Usage

This script currently only works on Pokémon Platinum, US version. It may work on other versions, but it's unlikely due to different memory mappings.

Prerequisites

• DeSmuME (tested with 0.9.13)
• Python 3
• Poetry
• OpenCV
• Pillow

Generating the script

1. Get a copy of the video.

2. Make sure to have poetry installed, and run:

   $ poetry install

3. To generate the script, run:

   $ python3 poketch <source> <output>

   with <source> being the input video file and <output> being the name of the generated script, ending in .lua.

Tip: A number of options are available during generation. Run python3 poketch --help to see them.

Running

1. Install DeSmuME.
2. Download Lua binaries for DeSmuME from here (make sure to match the architecture of your DeSmuME installation).
3. Move lua51.dll and lua5.1.dll to the same folder as the DeSmuME executable.
4. Open DeSmuME and load Pokémon Platinum.
5. Open the 'Dot Artist' Pokétch app.
6. Open the Lua scripting menu (Tools > Lua Scripting > New Lua Script Window...).
7. Open the generated script and click 'Run'.
8. Watch the magic happen!