Wiki · TJA & simulators
YataiDON: Open-Source Taiko Simulator for Windows, Mac, Linux, Android and iOS
YataiDON is an open-source taiko simulator written in C++ with raylib (GPL-3.0) that runs on Windows, macOS, Linux, Android and iOS. Installing it, the Songs folder and tja_path in config.toml, box.def genres, fixing audio latency, and notes for TaikoForge charts.
YataiDON is an open-source (GPL-3.0), arcade-style taiko simulator by Yonokid, written in C++ with raylib. It isn't a TJAPlayer3 fork—it was written from scratch—and its standout feature is that it's cross-platform: the same game runs on Windows, macOS, Linux, Android and iOS.
This page is based on the official GitHub README and the TJADB community guide as of November 2026.
Platforms
| Platform | Requirements and install |
|---|---|
| Windows | Windows 10 or later. Install Microsoft's Visual C++ Redistributable, then run YataiDON.exe |
| macOS | Built automatically, but the project notes it's largely untested |
| Linux | Ubuntu 24.04 or later (needs glibc 2.39+); run YataiDON.bin |
| Android | Android 10 or later; install YataiDON-Android.apk (allow installs from unknown sources) |
| iOS | iOS 16.3 or later, as a beta through TestFlight |
| PS5, Switch | Experimental homebrew builds |
Download the desktop builds from the GitHub Releases page.
Features
- Chart formats: TJA, plus osu! .osu/.osz
- Branches (Normal, Advanced, Master), Dan dojo, and a practice mode where you can scrub freely through a song
- 1 or 2 players, controller support
- Background video, song search and favorites, multi-language interface
- Several built-in skins, switchable in the game settings or config.toml
- Online scores: once enabled, you get an access code in config.toml for logging in at yataidon.tjadataba.se. Only songs from one specific community pack are tracked for now, so your own charts don't upload scores
Adding charts
- Open the Songs folder inside the YataiDON folder
- Put your song folders (.tja plus audio) inside
- Press F5 on the song select screen to refresh
To keep songs somewhere else, change the song path in config.toml—you can list several:
tja_path = ['Path1', 'Path2']
To sort songs into genres, use box.def, just like the TJAPlayer3 family.
Handy keys
- F1: quick restart during play
- Esc: go back from any screen
- Space: favorite a song on the song select screen
- Left/Right Ctrl: skip 7 songs at a time on song select
- F5: refresh the song list on song select
High audio latency
If latency feels high on Windows, the official FAQ suggests changing device_type in the game settings to WDM-KS, WASAPI or ASIO, whichever your PC supports. If the notes are still consistently early or late after that, adjust OFFSET—see Adjusting OFFSET and BPM.
TaikoForge charts in YataiDON
- Drop it into Songs: unzip the download and put the folder into Songs. All difficulties are in the one .tja.
- Branched charts: the "main chart name_branch.tja" from the advanced tools plays as-is; YataiDON supports Normal, Advanced and Master branches.
- Many songs at once: the paid simulator song pack bundles several songs into one folder with a box.def—unzip it into Songs and they're already sorted.
- Audio and encoding: the official docs don't list supported audio formats or text encodings. Uploading OGG is the safe choice; if Japanese titles come out garbled, re-save the .tja as UTF-8 with BOM. See TJA format explained.
- Check in the browser first: before copying charts to a phone, make sure the chart lines up with the music in the browser player—problems are much easier to track down there.
Other simulators
To compare simulators, see Simulator comparison.