vgmstream/doc/TXTP.md

TXTP FORMAT

TXTP is a mini-playlist file for various purposes, mainly to make more playable certain games that use uncommon ways to play their audio.

Simply create a file named (filename).txtp, and inside write the commands described below.

TXTP features

Play separate intro + loop files together as a single track

• Ratchet & Clank (PS2): bgm01.txtp

# define several files to play as one (there is no limit) 
BGM01_BEGIN.VAG
BGM01_LOOPED.VAG

# multi-files must define loops
loop_start_segment = 2 # 2nd file start
loop_end_segment = 2 # optional, default is last

#channel number must be equal, mixing sample rates is ok (uses first)

Minifiles for bank formats without splitters

• Super Robot Taisen OG Saga - Masou Kishin III - Pride of Justice (Vita): bgm_12.txtp

# select subsong 12
bigfiles/bgm.sxd2#12 #relative paths are ok too for TXTP

# single files loop normally by default
# if loop segment is defined it forces a full loop (0..num_samples)
#loop_start_segment = 1

Play segmented subsongs as one

• Prince of Persia Sands of Time: song_01.txtp

# can use ranges ~ to avoid so much C&P
amb_fx.sb0#254
amb_fx.sb0#122~144
amb_fx.sb0#121 #notice "#" works as config or comment

#3rd segment = subsong 123, not 3rd subsong
loop_start_segment = 3

Channel mask for channel subsongs/layers

• Final Fantasy XIII-2: music_Home_01.ps3.txtp

#plays channels 1 and 2 = 1st subsong
music_Home.ps3.scd#c1,2

• Final Fantasy XIII-2: music_Home_02.ps3.txtp

#plays channels 3 and 4 = 2nd subsong
music_Home.ps3.scd#c3,4

# song still has 4 channels, just mutes some

Multilayered songs

TXTP "layers" play songs with channels/parts divided into files as one

• Nier Automata: BGM_0_012_song2.txtp

# mix dynamic sections (2ch * 2)
BGM_0_012_04.wem
BGM_0_012_07.wem

mode = layers

• Life is Strange: BIK_E1_6A_DialEnd.txtp

# bik multichannel isn't autodetectable so must mix manually (1ch * 3)
BIK_E1_6A_DialEnd_00000000.audio.multi.bik#1
BIK_E1_6A_DialEnd_00000000.audio.multi.bik#2
BIK_E1_6A_DialEnd_00000000.audio.multi.bik#3

mode = layers

Channel mapping

TXTP can swap channels for custom channel mappings. Note that channel masking applies after mappings. Format is:

#ch1 = first
file1.ext#m2-3  # "FL BL FR BR" to "FL FR BL BR"

#do note the order specified affects swapping
file2.ext#m2-3,4-5,4-6  # ogg "FL CN FR BL BR SB" to wav "FL FR CN SB BL BR"

Force plugin extensions

vgmstream supports a few common extensions that confuse plugins, like .wav/ogg/aac/opus/etc, so for them those extensions are disabled and are expected to be renamed to .lwav/logg/laac/lopus/etc. TXTP can make plugins play those disabled extensions, since it calls files directly by filename.

Combined with TXTH, this can also be used for extensions that aren't normally accepted by vgmstream.

TXTP combos

TXTP may even reference other TXTP, or files that require TXTH, for extra complex cases. Each file defined in TXTP is internally parsed like it was a completely separate file, so there is a bunch of valid ways to mix them.

Mini TXTP

To simplify TXTP creation, if the .txtp is empty (0 bytes) its filename is used directly as a command.

• bgm.sxd2#12.txtp: plays subsong 12
• Ryoshima Coast 1 & 2.aix#c1,2.txtp: channel mask
• etc

Other examples

Join "segments" (intro+body):

#files must have same number of channels
Song001_intro.ogg
Song001_body.ogg
loop_start_segment = 2

Join "layers" (ex. main+vocals):

#files must have same number of samples
Song001_main.ogg
Song001_vocals.ogg
mode = layers