Net 3DS Soundtrack Converter 3DS: Difference between revisions

Revision as of 12:14, 3 September 2021

.Net 3DS Soundtrack Converter is a tool that can convert the game files of a 3DS game into an MP3 soundtrack.

Usage

Usage of console app:

Usage: SoundtrackConsole.exe <Source> <SoundtrackDefinition> <OutputDirectory>

Source can be either a directory containing the raw files of a 3DS ROM, or a compatible decrypted 3DS ROM.
SoundtrackDefinition is the path to the soundtrack definition file.
OutputDirectory is where the soundtrack files will be generated.

Creating New Soundtrack Definitions

A soundtrack definition file is a text file structured as follows. Comments are not allowed in the actual file, but will be added below using the # character.

system=3DS #System of the game this is for
gameid=00040000000(BA8|BA9|950)00 #Regular expression matching the game ID of the game this is for.
album=Pokemon Mystery Dungeon: Gates to Infinity
artist=Spike Chunsoft
year=2013
path=romfs/sound/stream #The directory the raw files are stored in
extension=bcstm #The file extension of the raw files
end #marks the end of the header
BGM_SYS_MENU=001 Main Menu #Converts `romfs/sound/stream/BGM_SYS_MENU.bcstm` to `001 Main Menu.mp3`
#Add more lines like the above

Adding New Soundtrack Definitions

While soundtrack definitions can be supplied externally, automatic selection is currently only available for internal definitions. Steps to add a soundtrack definition to the program: 1. Add the soundtrack definition file to DotNet3dsSoundtrackConverter/Soundtracks/[culture]/ 2. Add the soundtrack definition file to the appropriate SoundtrackDefinitions.resx file corresponding to the culture used in step 1. The default culture is en-US. 3. Add the soundtrack definition to DefinitionSelector.Soundtracks as shown in DefinitionSelector’s constructor.

Assuming the soundtrack definition is properly formatted, once the above steps are completed the soundtrack definition can then be used with auto-detecting conversion methods.

Credits

All the people who are credited on the .Net 3DS Toolkit
kode54 for vgmstream
AydinAdn for MediaToolkit (which I forked to allow asynchronous processing)
IC#Code for SharpZipLib

@@ Line 7: / Line 7: @@
 | author = evandixon
 | website = https://gbatemp.net/threads/net-3ds-soundtrack-converter-create-soundtracks-from-your-3ds-games.446493/
-| download = https://dlhb.gamebrew.org/3dshomebrew/Net3DSSoundtrackConverter.rar
+| download = https://dlhb.gamebrew.org/3dshomebrew/DotNet3dsSoundtrackConverterv1.1.1.7z
-| source = https://dlhb.gamebrew.org/3dshomebrew/Net3DSSoundtrackConverter.rar
+| source = https://github.com/evandixon/DotNet3dsSoundtrackConverter
 }}
 <youtube>hlklmUyMgTM</youtube>
-Some games have amazing music.�For some, I like to have the music in a form that can be played on any device (like a bunch of MP3's).�Downloading them from the internet is an option, but why do that when you can create it from the game you own?�This tool can turn the raw files of decrypted 3DS games into an MP3 soundtrack.
+.Net 3DS Soundtrack Converter is a tool that can convert the game files of a 3DS game into an MP3 soundtrack.
-Usage of console app: SoundtrackConsole.exe &lt;Source&gt; &lt;SoundtrackDefinition&gt; &lt;OutputDirectory&gt;
+== Usage ==
-- Source can be either a directory containing the raw files of a 3DS ROM, or a compatible decrypted 3DS ROM.
-- SoundtrackDefinition is the path to the soundtrack definition file.
-- OutputDirectory is where the soundtrack files will be generated.
-A class library is in the works, but is not yet available (a perfectly stable dependency is marked as a pre-release, preventing the full release from being made).
+Usage of console app:
-In order to use this, you'll need some sort of definition of the soundtrack.�I've included definitions for Pokémon Mystery Dungeon: Gates to Infinity and Pokémon Super Mystery Dungeon.�There are short instructions on how to make your own in the GitHub Readme, but I welcome any questions.�The only current limitation is that [https://gitlab.kode54.net/kode54/vgmstream/ VGM Stream] must be able to play the raw files (which means definitions can be made for Pokemon X/Y/OR/AS/Sun/Moon).
+<pre>Usage: SoundtrackConsole.exe &lt;Source&gt; &lt;SoundtrackDefinition&gt; &lt;OutputDirectory&gt;</pre>
+* Source can be either a directory containing the raw files of a 3DS ROM, or a compatible decrypted 3DS ROM.
+* SoundtrackDefinition is the path to the soundtrack definition file.
+* OutputDirectory is where the soundtrack files will be generated.
-[https://github.com/evandixon/DotNet3dsSoundtrackConverter/releases/tag/1.0.0 Release/Download]
+== Creating New Soundtrack Definitions ==
-[https://github.com/evandixon/DotNet3dsSoundtrackConverter Source]
-<div class="messageTextEndMarker">
-�
+A soundtrack definition file is a text file structured as follows. Comments are not allowed in the actual file, but will be added below using the <code>#</code> character.
-</div>
+<pre>system=3DS #System of the game this is for
+gameid=00040000000(BA8|BA9|950)00 #Regular expression matching the game ID of the game this is for.
+album=Pokemon Mystery Dungeon: Gates to Infinity
+artist=Spike Chunsoft
+year=2013
+path=romfs/sound/stream #The directory the raw files are stored in
+extension=bcstm #The file extension of the raw files
+end #marks the end of the header
+BGM_SYS_MENU=001 Main Menu #Converts `romfs/sound/stream/BGM_SYS_MENU.bcstm` to `001 Main Menu.mp3`
+#Add more lines like the above</pre>
+== Adding New Soundtrack Definitions ==
+While soundtrack definitions can be supplied externally, automatic selection is currently only available for internal definitions. Steps to add a soundtrack definition to the program: 1. Add the soundtrack definition file to DotNet3dsSoundtrackConverter/Soundtracks/[culture]/ 2. Add the soundtrack definition file to the appropriate SoundtrackDefinitions.resx file corresponding to the culture used in step 1. The default culture is en-US. 3. Add the soundtrack definition to <code>DefinitionSelector.Soundtracks</code> as shown in <code>DefinitionSelector</code>’s constructor.
+Assuming the soundtrack definition is properly formatted, once the above steps are completed the soundtrack definition can then be used with auto-detecting conversion methods.
+== Credits ==
+* All the people who are credited on the [https://github.com/evandixon/DotNet3dsToolkit .Net 3DS Toolkit]
+* kode54 for [https://gitlab.kode54.net/kode54/vgmstream/ vgmstream]
+* [https://github.com/AydinAdn AydinAdn] for MediaToolkit (which I forked to allow asynchronous processing)
+* [http://www.icsharpcode.net/ IC#Code] for SharpZipLib