lolhop/vitamania

vitaMania is an unofficial homebrew rhythm game for the PlayStation Vita handheld console. It plays 4-column beatmaps from osu!mania, a free PC rhythm game. The project is not affiliated with osu! or Sony, it is a fan-made compatibility player that runs on a homebrewed Vita. To play, you install the VPK package file on your PS Vita using VitaShell, create a data folder on the memory card, and drop in beatmap archives downloaded from the osu! website. The beatmaps come as OSZ files, which are archives that bundle the song audio, background image, and notes together. On first launch, the game scans the folder, extracts the archives, and presents a song selection screen. You scroll through songs, pick a difficulty level, and start playing with four buttons acting as the four lane columns. Controls during gameplay use the L shoulder button, D-pad Down, X, and R for the four lanes, with Start to pause. The song select screen lets you scroll through your library, choose from the available difficulties for each song, and rescan for newly added beatmaps. You can also toggle background preview images on or off. The game is built with C++ and CMake. To compile it yourself, you run two CMake commands and the output is the installable VPK file. The README notes that AI tools were used during coding and debugging but not for creating game assets. The game ships with no music or beatmaps. You must download beatmaps separately from the official osu! website.