A game that faithfully recreates the Polyrhythm minigame from Rhythm Tengoku (リズム天国), with a built-in level editor and side modes.

Original Soundtrack on YouTube by GENERIC

• Full re-creation of the Polyrhythm minigame from Rhythm Tengoku, and more!
• A full Story Mode with over 40 levels
• Sort and organize your custom levels using the Library feature
• Create custom levels with a built-in and intuitive level editor
• Level effects such as changing the colour palette, adding text boxes, putting Skill Stars, and more
• Switch between classic GBA, modern HD, and arcade textures, or add your own custom texture pack
• Practice modes to improve your Polyrhythm skills with levels from the original GBA game
• Endless Mode keeps you on your toes with never-ending procedurally generated patterns
• Daily Challenge mode which has a series of patterns not seen in regular Endless Mode, with online leaderboards
• Extra side modes like Polyrhythm: Dunk, Polyrhythm: Assemble, and Built to Scale: Solitaire add more Polyrhythm fun

Check out the v1.2 update trailer on YouTube!
Check out the announcement trailer on YouTube!
Check out the August 2021 features trailer!

Officially supported operating systems: Windows 7 or newer, Linux (x86 and ARM).

macOS is not officially supported (i.e. we don't accept bug reports from macOS) but you can attempt to run it per issue #29.

System Specifications: Similar requirements as Minecraft: Java Edition are used, since the same underlying graphics library (GLFW with OpenGL 4.4) is used.

• CPU: Intel Core i3-3210 3.2 GHz / AMD A8-7600 APU 3.1 GHz or equivalent
• RAM: 4GB
• GPU (Integrated): Intel HD Graphics 4000 (Ivy Bridge) or AMD Radeon R5 series (Kaveri line) with OpenGL 4.4
• GPU (Discrete): NVIDIA GeForce 400 Series or AMD Radeon HD 7000 series with OpenGL 4.4
• HDD: At least 1GB for game and levels
• OS: Windows 7 and up, Linux 64-bit distributions from 2018 onwards
• Display: 1280x720 resolution

• CPU: Intel Core i5-4690 3.5GHz / AMD A10-7800 APU 3.5 GHz or equivalent
• RAM: 8GB
• GPU: NVIDIA GeForce 700 Series or AMD Radeon Rx 200 Series (excluding integrated chipsets) with OpenGL 4.5
• HDD: 2GB (SSD is recommended)
• OS: Windows 10 and newer (64-bit), Linux 64-bit distributions from 2020 onwards (e.g. Ubuntu 20.04)
• Display: 1920x1080 resolution

These instructions are the same if you're downloading the game for the first time or upgrading to a new version. Make sure that you meet the system requirements above.

Windows (64-bit only, no Java installation required):

1. Navigate to the latest release here in a new tab or window.
2. Download the correct version of the game in the Assets section named PolyrhythmMania_VERSION_win64.zip, where VERSION is the release version name. Note the "win64" in the file name. Don't download the "Source code".
3. Find the downloaded zip file in File Explorer. Extract the zip file: right click the downloaded zip file, click "Extract All...", and extract the contents to a folder.
4. Open the newly extracted folder and go into the PolyrhythmMania_win64 folder.
5. Double-click the LaunchPolyrhythmMania.exe executable to start the game! (You don't need the Java Runtime Environment already installed, the game comes with a copy.)
6. If Windows Defender says "Windows Defender SmartScreen prevented an unrecognized app from starting", you can safely ignore it by clicking "More info" and then "Run anyway".

Other platforms (or for advanced users who already have Java installed)

1. (Pre-requisite) Ensure you already have the Java Runtime Environment (JRE 17 recommended, JRE 11 minimum) installed and it is accessible in your path as the java command.
2. Navigate to the latest release here in a new tab or window.
3. Download the correct version of the game in the Assets section named PolyrhythmMania_VERSION.zip, where VERSION is the release version name. Don't download the "Source code".
4. Extract the zip file to a known location.
5. Open the newly extracted directory and go into the PolyrhythmMania_platform_agnostic directory.
6. Run the appropriate launch script: On Windows, double click play_windows.bat. On Linux, run the play_linux.sh file (you may have to chmod +x play_linux.sh first).
7. If you prefer not to use a launch script, you can run java -jar bin/PolyrhythmMania.jar with your preferred settings.

These instructions are for people interested in editing the source code of the game.

1. Ensure JDK 11 or newer (JDK 17 recommended) is installed.
2. chmod +x gradlew
3. ./gradlew :desktop:run

Rhythm Heaven is the intellectual property of Nintendo. This program is NOT endorsed nor sponsored in any way by Nintendo. All used properties of Nintendo (such as names, audio, graphics, etc.) in this software are not intended to maliciously infringe trademark rights. All other trademarks and assets are property of their respective owners. This is a community project and this is available for others to use according to the GPL-3.0 license, without charge.