DTXPlayer README for android

DTXFileConverter v0.3

* Overview
Batch converting DTX score into a format readable by iOS/Android application "DTXPlayer".


* Target OS
Operation confirmed on Windows 10, Mac OS X 10.13(High Sierra).


* Change log
2018/05/20 v0.3 Supported on Mac
2018/05/19 v0.2 Fixed link
2016/10/22 v0.1 Release


* Description of file

- DTXFiles
Folder that stores the DTX score of the conversion source.

- DTXFiles.android
- DTXFiles.ios
Folder where the converted DTX score is stored.

- DTXFileConverter.bat
- DTXFileConverter_android.bat
- DTXFileConverter_ios.bat
Converter. (for Windows)

- DTXFileConverter.sh
- DTXFileConverter_android.sh
- DTXFileConverter_ios.sh
Converter. (for Mac)

- work
Conversion-time working folder.

- README en.txt
This file.


* What you need (@Windows)
Please try to use the version that is as close as possible to.
If you are using Mac, skip this step.

- FFmpeg
https://ffmpeg.zeranoe.com/builds/
Save and decompress "ffmpeg-20180518-16b4f97-win64-static.zip" from "Download Build".
Move bin¥ffmpeg.exe into the work folder.

- ImageMagick
http://www.imagemagick.org/script/download.php#windows
Save "ImageMagick-7.0.7-33-Q16-x64-dll.exe" from "download", and install.
!!! It does not work with ImageMagick-6.x series.

- nkf
http://www.vector.co.jp/soft/win95/util/se295331.html
Save and decompress "nkfwin.zip" from "Download here".
Move vc2005¥win32(98,Me,NT,2000,XP,Vista,7)Windows-31J¥nkf32.exe into work folder.

- WAV to XA
http://dtxmania.net/wiki.cgi?page=qa_xa
Save and decompress "xa122.lzh" from "WAV to XA".
Move xa.exe into the work folder.

- Nero AAC Codec
http://www.free-codecs.com/nero_aac_codec_download.htm
Save "NeroAACCodec -1.5.1.zip" from "Download", and decompress.
Move win32¥neroAacEnc.exe into the work folder.

- LAME
http://www.rarewares.org/mp3-lame-bundle.php
Save "lame3.100-64.zip" from "Download (xxxkB)" and extract it.
Move lame_enc.dll and lame.exe into the work folder.

- oggenc2
http://www.rarewares.org/ogg-oggenc.php
Save and decompress "oggenc2.88-1.3.5-x64.zip" from "x64 Only (xxx kB)".
Move oggenc2.exe into the work folder.


After this steps, the following execution file exists in the work folder.
work
├─nkf32.exe
├─xa.exe
├─neroAacEnc.exe
├─lame_enc.dll
├─lame.exe
├─oggenc2.exe
...


* What you need (@Mac)
Please execute the following command at the Terminal.
If you are using Windows, skip this step.

# install homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# install packages
brew install lame libvorbis vorbis-tools ffmpeg imagemagick nkf nodebrew

# setup nodebrew
mkdir -p ~/.nodebrew/src
nodebrew install-binary latest
nodebrew list
nodebrew use latest
touch ~/.bash_profile
echo 'export PATH=$PATH:$HOME/.nodebrew/current/bin' >> ~/.bash_profile
source ~/.bash_profile

# install xa-dtx
npm install -g xa-dtx


* Conversion method

1. Place the folder "DTXFileConverter" containing this README.txt in the appropriate place.

It must be placed in a path that does not contain double-byte characters / half-width spaces.


2. Store the DTX score you want to convert to DTXFileConverter¥DTXFiles.

DTXFiles
├─Title1
│ ├─bgm.mp3
│ ├─se.xa
│ └─Title1.dtx
├─Title2
│ └─Title2.dtx
...


3. (@Windows) Execute DTXFileConverter_android/ios.bat.
(@Mac) Execute DTXFileConverter_android/ios.sh.

Multiple windows stand up and convert.
When the conversion is completed, the DTX score converted to DTXFiles.android/ios is stored.


4. Transfer converted DTX score to application.

In the case of iOS, please use the iFunbox etc. to transfer the DTX score into the application.

DTXPlayer (application)
├─Title1
│ ├─bgm.m4a
│ ├─se.caf
│ └─Title1.dtx
├─Title2
│ └─Title2.dtx
...

In the case of Android, create a DTXPlayer folder directly under the SD card/Internal storage and transfer it into it.

SD card/Internal storage
├─DTXPlayer
│ ├─Title1
│ │ ├─bgm.mp3
│ │ ├─se.ogg
│ │ └─Title1.dtx
│ ├─Title2
│ │ └─Title2.dtx
...

It is also possible to create subfolders under the name "DTXFiles.xxx". (up to 1 level)

DTXPlayer
├─DTXFiles.Category1
│ ├─Title1
│ │ ├─bgm.m4a
│ │ ├─se.caf
│ │ └─Title1.dtx
│ ├─Title2
│ │ └─Title2.dtx
...


* Playable format in DTXPlayer
Even without using a converter, if you convert it to the format below you can play it.

BGM (iOS): AAC(m4a), MP3
BGM (Andriod): MP3
SE (iOS): CAF, WAV
SE (Andorid): OGG, WAV
Video: H.264 (mp4)
Images: PNG, JPG
Text: UTF-8/LF
File name: Half size alphabets are lowercase letters only.