TaikoPythonTools/TaikoSongConversionTool/README.md
2024-07-06 00:41:58 +01:00

6.5 KiB

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.

song conversion tool

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.
ACB Editor from SonicAudioTools - Used to create .acb files for Pop Tap Beat.
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.

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]