TaikoPythonTools/TaikoSongConversionTool

Taiko no Tatsujin - Song Conversion Tool

Python based tool that can convert official songs over to some Taiko no Tatsujin games.

Current Version: v2b

Supported Titles

Game Title	Platform	Tag	Game Version	Song Limit	Supported?
Nintendo Switch Version	Nintendo Switch	NS1 (JP/ASIA)	v1.4.13 Only	600	✅
Drum 'n' Fun	Nintendo Switch	NS1 (EU/USA)	v1.4.13 Only	600	✅
Drum Session	PlayStation 4	PS4 (EU/US)	v1.19 Recommended	400	✅
Drum Session	PlayStation 4	PS4 (JP/ASIA)	v1.28 Recommended	400	✅
Pop Tap Beat	iOS, macOS, Apple TV	PTB (N/A)	Any	200	✅
Atsumete★Tomodachi Daisakusen!	Nintendo Wii U	WIIU3 (N/A)	Any	225¹/425²	✅
Tokumori!	Nintendo Wii U	N/A	Any	Unknown	❓ Untested
Wii U Version!	Nintendo Wii U	N/A	Any	Unknown	❓ Untested

¹Song Limit due to texture limitations, assuming no other DLC is installed. Texture Quality set to "high" in config.json.
²Song Limit due to texture limitations, assuming no other DLC is installed. Texture Quality set to "low" in config.json.

Unsupported Titles

Game Title	Platform	Tag	Game Version	Supported?
V Version!	PlayStation Vita	PSV	Any	⭕ PLANNED
Dokodon! Mystery Adventure	Nintendo 3DS	3DS3	Any	⭕ PLANNED
Nijiiro Ver.	Arcade	AC16	N/A	❌ NOT PLANNED
Rhythm Festival	Nintendo Switch	NS2 (JP/ASIA)	N/A	❌ NOT PLANNED
The Drum Master	PC, Xbox One, Series SX	TDMX, XB1 (N/A)	N/A	❌ NOT PLANNED

A version of this tool with all song data can be found elsewhere.

There's 3 options to sort songs by: ID (A-Z), Song Name (A-Z) and Genre

This is still a work in-progress, so please report any issues found to me, along with suggestions for features or game support.

Prerequisites

Python 3.12.3 or newer
tkinter installed through pip / pip install tk
sv_ttk installed through pip / pip install sv_ttk
cryptography installed through pip / pip install cryptography
pillow installed through pip / pip install pillow
pydub installed through pip / pip install pydub
NVIDIA Texture Tools Exporter installed and added to PATH
ffplay installed in PATH.
Song Data properly converted to the format this tool expects, stored in a folder called data or data_custom.

Due to copyright reasons, etc. no song data will be provided with this tool, however you can use TjaBatchConvert to convert custom charts to a format this tool expects.

Known Issues

Atsumete★Tomodachi Daisakusen's song limit is due to it's texture limitations. In theory, if all game textures are also compressed, it could allow for more songs.
Scores may not save on Atsumete★Tomodachi Daisakusen, this is due to save file limitations.

Additional Features

Multi-Language Support. (Can be set in config.json, supports en(English) and jp(Japanese)).
Custom Song Data loading through the "data_custom" folder. (Path can be changed in config.json). Audio Quality for NS1 and PS4 can be set using audio_quality in config.json, high uses the default audio format for said game, while low sets the audio format to BNSF, which is Single Channel Mono.
Texture Quality for Wii U 3 can be set in config.json, high uses DXT5/BC3 while low uses DXT1/BC1a.

Tools Used

at9tool - Used to convert audio to the Sony AT9 format.
DRPRepacker from Pokken-Tools - Used to package Wii U musicInfo.xml files.
VGAudioCli - Used to convert audio to Nintendo IDSP and Nintendo OPUS.
G.722.1 Reference Tool - Used to convert audio to Polycom Siren 14

Special Thanks

Steam User descatal for writing this guide on how to create/encode bnsf files.
korenkonder for compiling the G.722.1 tool used in this project.
Kamui/despairoharmony for some of the Nijiiro .nus3bank template research.
rdbende for the Sun Valley ttk Theme used in this project.
jam1garner for Smash-Forge, which it's code was used as a reference for generating the .nut files.

Related Tools

tja2fumen
TjaOffsetNeutralise
TjaBatchConvert

Taiko no Tatsujin Modding Server

For help, questions inquries feel free to check out my (Taiko Modding Discord Server)[https://discord.gg/HFm37aA5zr]