Soundtracks - Revision history

KaosEngineer: /* Folder Structure */ soundtrack NNNN named subfolders are created in E:\TDATA\fffe0000\music\.

2021-11-03T03:08:29Z

‎Folder Structure: soundtrack NNNN named subfolders are created in E:\TDATA\fffe0000\music\.

Lycoder: numSongGroups doesn't actually count the amount of song groups, but the amount of songs in the soundtrack, change to numSongs.

2021-08-08T16:36:30Z

numSongGroups doesn't actually count the amount of song groups, but the amount of songs in the soundtrack, change to numSongs.

Root670: /* ST.DB */ Move endianness note to beginning of ST.DB section.

2018-09-16T15:59:49Z

‎ST.DB: Move endianness note to beginning of ST.DB section.

Root670: Clarified endianness for values in main header and structs.

2018-09-16T15:57:37Z

Clarified endianness for values in main header and structs.

JayFoxRox: Marked unicode with FIXME regarding encoding; Marked confusing magic values with FIXME regarding endianess / type

2018-09-09T02:47:50Z

Marked unicode with FIXME regarding encoding; Marked confusing magic values with FIXME regarding endianess / type

Root670: /* ST.DB */ Corrected song storage in the song group struct and type of numSongGroups in the soundtrack struct.

2018-09-07T02:39:25Z

‎ST.DB: Corrected song storage in the song group struct and type of numSongGroups in the soundtrack struct.

Root670: Created page with "The Xbox allows for soundstracks to be stored on the harddrive and played in-game. Music is copied from audio CDs using the dashboard and converted to WMA audio files. The not..."

2018-09-06T03:05:46Z

Created page with "The Xbox allows for soundstracks to be stored on the harddrive and played in-game. Music is copied from audio CDs using the dashboard and converted to WMA audio files. The not..."

New page

The Xbox allows for soundstracks to be stored on the harddrive and played in-game. Music is copied from audio CDs using the dashboard and converted to WMA audio files. The notes gathered here are from decompiling StDB.dll from ''Xbox Soundtrack Manager''.

== Folder Structure ==
All soundtrack related data is stored in E:\TDATA\fffe0000. Songs are organized into groups of folders containing up to 6 WMA files. Zero-padded 4 decimal integers are used for the folder names, and zero-padded 8 decimal integers are used for the WMA file names. Metadata such as song title and which soundtrack a song belongs to is stored in the ST.DB file

== ST.DB ==
The ST.DB file contains information about soundtracks loaded on the Xbox. Up to 100 soundtracks with 500 songs each can be used. Each header and struct described below is padded to 512 bytes.

File Layout:

<pre>(start of file)
0000 Main Header
0200 Soundtrack Struct 1
0400 [Soundtrack Struct 2]
...
CA00 Song Group 1
CC00 [Song Group 2]
...
(end of file)
</pre>
=== Main Header ===
{| class="wikitable"
! Type
! Description
! Comment
|-
| int32
| magic
| always 0x01 0x00 0x00 0x00
|-
| int32
| numSoundtracks
|
|-
| int32
| nextSoundtrackId
|
|-
| int32
| soundtrackIds[100]
|
|-
| int32
| nextSongId
|
|-
| char
| padding[96]
|
|}

=== Soundtrack Struct ===
{| class="wikitable"
! Type
! Description
! Comment
|-
| int32
| magic
| always 0x71 0x13 0x02 0x00
|-
| int32
| id
|
|-
| int32
| numSongGroups
|
|-
| int32
| songGroupIds
|
|-
| int32
| totalTimeMilliseconds
|
|-
| wchar
| name[64]
| Unicode string
|-
| char
| padding[64]
|
|}

=== Song Group Struct ===
{| class="wikitable"
! Type
! Description
! Comment
|-
| int32
| magic
| always 0x73 0x10 0x03 0x00
|-
| int32
| soundtrackId
|
|-
| int32
| id
|
|-
| int32
| padding
|
|-
| Song Struct
| songs[6]
|
|-
| char
| padding[64]
|
|}

=== Song Struct ===
{| class="wikitable"
! Type
! Description
! Comment
|-
| int32
| id
|
|-
| int32
| timeMilliseconds
|
|-
| wchar
| name[64]
| Unicode string
|-
| char
| padding[64]
|
|}

== Default Encoding Settings ==
These are the encoding settings used by the dashboard when encoding WMA files:

{| class="wikitable"
! Key
! Value
|-
| Format
| WMA Version 2
|-
| Codec Description
| Windows Media Audio V8
|-
| Encoding Tool
| Windows Media Encoding Utility 8.0.0.403
|-
| Bit Rate
| 128 kbps
|-
| Channels
| 2
|-
| Sampling Rate
| 44.1 kHz
|-
| Bit Depth
| 16 bit
|}

The track number is added to the metadata.

@@ Line 64: / Line 64: @@
+|
 |-
-| int32
+| uint32
 | numSongGroups
+|
@@ Line 106: / Line 106: @@
 | padding
+|
 |-
 | int32
-| id
+| songId[6]
+|
 |-
 | int32
-| timeMilliseconds
+| songTimeMilliseconds[6]
+|
 |-
 | wchar
-| name[64]
+| songName[384]
-| Unicode string
+| 6 Unicode strings, each padded to 64 characters
 |-
 | char

@@ Line 2: / Line 2: @@
 == Folder Structure ==
-All soundtrack related data is stored in E:\TDATA\fffe0000. Songs are organized into groups of folders containing up to 6 WMA files. Zero-padded 4 decimal integers are used for the folder names, and zero-padded 8 decimal integers are used for the WMA file names. Metadata such as song title and which soundtrack a song belongs to is stored in the ST.DB file
+All soundtrack related data is stored in E:\TDATA\fffe0000\. Songs are organized into groups of folders containing up to 6 WMA files. Zero-padded 4 decimal integers are used for the folder names stored in a subfolder named music, and zero-padded 8 decimal integers are used for the WMA file names. Metadata such as song title and which soundtrack a song belongs to is stored in the ST.DB file
 == ST.DB ==

@@ Line 13: / Line 13: @@
   Soundtrack Struct 1
   [Soundtrack Struct 2]
-       ...
+       ... (Zero-filled)
 CA00  Song Group 1
 CC00  [Song Group 2]
@@ Line 65: / Line 65: @@
 |-
 | uint32
-| numSongGroups
+| numSongs
+|
 |-
 | int32
-| songGroupIds
+| songGroupIds[84]
+|
 |-
@@ Line 116: / Line 116: @@
 |-
 | wchar
-| songName[384]
+| songName[192]
 | 6 Unicode{{FIXME|reason=Encoding? UCS-2?}} strings, each padded to 64 characters
 |-

@@ Line 5: / Line 5: @@
 == ST.DB ==
-The ST.DB file contains information about soundtracks loaded on the Xbox. Up to 100 soundtracks with 500 songs each can be used. Each header and struct described below is padded to 512 bytes.
+The ST.DB file contains information about soundtracks loaded on the Xbox. Up to 100 soundtracks with 500 songs each can be used. Each header and struct described below is padded to 512 bytes, and all values are stored as little-endian.
-File Layout:
+'''File Layout:'''
 <pre>(start of file)
@@ Line 20: / Line 20: @@
 </pre>
 === Main Header ===
 {| class="wikitable"
 ! Type

@@ Line 20: / Line 20: @@
 </pre>
 === Main Header ===
 {| class="wikitable"
 ! Type
@@ Line 27: / Line 29: @@
 | int32
 | magic
-| always 0x01 0x00 0x00 0x00 {{FIXME|reason=Is this 0x00000001 or 0x01000000 when read as int32_t via CPU? Is the type int32_t or uint8_t[4]?}}
+| always 0x00000001
 |-
 | int32
@@ Line 58: / Line 60: @@
 | int32
 | magic
-| always 0x71 0x13 0x02 0x00 {{FIXME|reason=Is this 0x00021371 or 0x71130200 when read as int32_t via CPU? Is the type int32_t or uint8_t[4]?}}
+| always 0x00021371
 |-
 | int32
@@ Line 93: / Line 95: @@
 | int32
 | magic
-| always 0x73 0x10 0x03 0x00 {{FIXME|reason=Is this 0x00031073 or 0x73100300 when read as int32_t via CPU? Is the type int32_t or uint8_t[4]?}}
+| always 0x00031073
 |-
 | int32