frenchpythonlover/huawei-doom

huawei-doom is a small, playful hardware hacking project that gets the classic 1993 video game Doom running on a Huawei E5577-321s mobile WiFi modem, and possibly similar Huawei models. It relies on a separate companion project by the same author, called huawei-hw, which provides the underlying tools to gain root access on the modem and run custom code on it in the first place. This repository itself is a set of patches on top of fbDOOM, an existing open source port of Doom that draws directly to a device's framebuffer instead of relying on a full desktop environment. The project includes precompiled binaries, so a person does not necessarily need to build the code themselves. To run the game you point the compiled Doom executable at a WAD file, which is the data file that holds the actual Doom game content, and the author has included the free shareware version of that file directly in the repository. The author notes that the game was hardcoded to expect that specific shareware WAD, so other versions of the file are not guaranteed to work. Setting this up is not plug and play. It requires first following the separate huawei-hw guide to get telnet and root access on the modem, install the clang compiler, and transfer files onto the device, before this project's Makefile and instructions come into play. The author invites people to open an issue if they run into trouble. The project has no stars yet and is a very new, small upload, more of a fun proof of concept than a polished tool, but it comes with a working shareware WAD included so a reader with the right modem and patience could actually reproduce the result. The README does not mention a license for this project.