CombinedAudioTool 3DS: Difference between revisions

CombinedAudioTool
CombinedAudioTool
General
Author	Cracko298, YT-Toaster
Type	Hack Utilities
Version	2.7.1
License	Apache-2.0
Last Updated	2026/05/01
Links
	Download
	Website
	Source

← Older edit

Latest revision as of 05:02, 1 May 2026

A Tool (GUI/CLI) for CombinedAudio.bin for Minecraft for New Nintendo 3DS Edition (MC3DS) with a plethora of Features.

Only support Windows Platforms Officially, due to being built and made using some Windows API functions (winsound).

View the Documentation of CombinedAudio.bin Here.

Features

Extract All FSB SoundBank Files from CombinedAudio.bin.
Play, Pause, Seek, Restart, Search through Audio Tracks.
Gain information about metadata, the Archive itself, and more.
Convert between formats, including *.wav, *.dsp, *.fsb.
Convert Songs, Add SFX, and Extract Segments/Header information.

Requirements

Requires Python 3.12 (or) Python 3.14 for the Script.

You can use Python 3.10/3.11/3.13, however it will be insanely slow at encoding.
Python STD (Installed alongside Python).
numpy
soundfile (libsoundfile Wrapper for Python).

Screenshots

Changelog

v2.7.1 2026/05/01

Add Stereo support to CombinedAudio.bin directly, I forgor to release this patch oopsies...

v2.7 2026/05/01

Stereo Audio is Fixed.
Bug Fixes, and performance improvements.
Supports every audio format to FSB Music Files.
Huge performance boost (thanks to C-Python and PYD).

v2.6 2026/04/24

Now support(s) *.mp3, *.ogg, *.oga, *.opus, *.flac, *.dsp, *.fsb audio formats.

v2.5 2026/04/23

No longer a CLI, it's now a GUI *gasp*.
Play sounds like Foobar2000's VGMStream.
Seek, Play, Restart, Replace, Extract, Rebuild, and everything else you can think of to CombinedAudio.bin.
Copy developer information, make edits, and more!

v2.4 2024/12/04

Fixed a bug where FSB, DSP wouldn't convert to Wave Files using the --atw or to-wave flag.
Added new MetaData Structuring for more info on CombinedAudio.bin SFX Archive.
Fixed the --gsid flag so it now includes information retaining to which file each sound is tied too.
Other under the hood bug fixes/changes that make no real difference (e.g. removing blank space lines, etc).

v2.3 2024/10/04

Added Interweaving Changes/Functions.

v2.2 2024/08/02

Bug Found in Old Release Causing full Script Lockout.
- Thank you @SpeakerZ-01 for spotting and correcting the bug that wasn't found durring the development of version 2.1.

v2.1 2024/07/25

Get MetaData from the CombinedAudio.bin Archive.
Get alerted when a New Version a CATool is available to Update too!!!
Updated a Few Descriptions of Flags/Args inside of the --help Flag.

v2.0 2024/07/03

Can now fully add your Own Custom Audio into Minecraft Nintendo 3DS Edition!
Updated addPadding Function to update the Length of the File (in the header), reducing the chance for Crashes, among Audio Corruption.
Fixed a bug that stated --gsmc was the correct way to Launch generate-music Function.

v1.9 2024/07/01

Download and FFMPEG Usage.
Convert all Common Audio Formats to Wave (no need for Online Tools).

v1.8 2024/06/30

Feature Update:
- Encode Music for Minecraft 3DS Edition using the generate-music flag (--gmsc).
- Restore now restores your Current Version rather than updating the entire Installation.
- Fixed requests Module installation package not properly installing.

v1.7 2024/06/27

Feature Update:
- Convert *.wav Files into Valid DSADPCM/GCADPCM.
- Can now play *.wav Files using the Windows API.

v1.6 2024/06/23

Added Restore Feature:
- Only use in Emergencies like File integrity is invalid: --rstr.

v1.5 2024/06/23

Support for GCADPCM Extracting:
- Extract audio as you normally would, now with an extra feature-set.

v1.4 2024/06/21

Feature Update:
- Attempt to Extract Audio from FSB Files.
- Update Feature has been updated slightly.
- Make sure to Extract this file when downloading via Script Download Feature.

v1.3 2024/06/19

Added Update Feature:
- No need to download from Latest Releases after this version.
- Update your script using the following Flags: update (--upd).
- Updated Sound ID and Extraction to be again much more accurate.

v1.2 2024/06/19

Feature Update:
- Added 2 new Features and Flags, get-size-seg, and get-size.
- get-size-seg (--gssg) Gets the size of a specific Segment Soundbank FSB File.
- get-size (--gs) Gets the size of all Segment Soundbank FSB Files.

v1.1 2024/06/19

Feature Update:
- New Flags get-soundid, and rename-all.
- Updated name-extract to be much more accurate instead of assuming the Sound Name/ID.

v1.0 2024/06/19

First Release.
Features and docs are provided apon the homepage.

External links

GitHub - https://github.com/Minecraft-3DS-Community/CombinedAudioTool

@@ Line 4: / Line 4: @@
 |description=A tool for CombinedAudio.bin (in-game audio/sounds) for Minecraft for New Nintendo 3DS Edition (MC3DS) with a plethora of features.
 |author=Cracko298, YT-Toaster
-|lastupdated=2024/07/03
+|lastupdated=2026/05/01
 |type=Hack Utilities
-|version=2.0
+|version=2.7.1
 |license=Apache-2.0
 |download=https://github.com/Minecraft-3DS-Community/CombinedAudioTool/releases
@@ Line 13: / Line 13: @@
 }}
 <!--combinedaudiotool3ds-->
-CombinedAudioTool (CATool) is a tool for manipulating CombinedAudio.bin for Minecraft for New Nintendo 3DS Edition (MC3DS). It allows the original CombinedAudio.bin file to be extracted, modified, and rebuilt with vustom audio for modding and romhacking.
+A Tool (GUI/CLI) for CombinedAudio.bin for Minecraft for New Nintendo 3DS Edition (MC3DS) with a plethora of Features.
-Only support Windows platforms officially, due to being built and made using some Windows API functions.
+Only support Windows Platforms Officially, due to being built and made using some Windows API functions (<code>winsound</code>).
-'''Note:''' Requires <code>Python 3.8+</code> and <code>Python STD</code> (installed alongside Python).
+View the Documentation of CombinedAudio.bin [https://github.com/Cracko298/CombinedAudioTool/blob/main/COMBINED_ADUIO_HEADER_TOC.md Here].
 == Features ==
-* Extract All FSB Soundbank Files in the Archive.
+* Extract All FSB SoundBank Files from CombinedAudio.bin.
-* Extract a FSB Soundbank File by Name/Sound-ID.
+* Play, Pause, Seek, Restart, Search through Audio Tracks.
-* Get File name(s) from Soundbank Files for easier recognition.
+* Gain information about metadata, the Archive itself, and more.
-* Rename Extracted files to original filename(s).
+* Convert between formats, including *.wav, *.dsp, *.fsb.
-* Rebuild <code>CombinedAudio.bin</code> with new Custom Audio Files.
+* Convert Songs, Add SFX, and Extract Segments/Header information.
-* Extract Header from <code>CombinedAudio.bin</code>.
-* Add padding to files automatically (Requires Original Extracted File).
+== Requirements ==
-* Collect all Sound Names/ID's.
+Requires <code>Python 3.12</code> (or) <code>Python 3.14</code> for the Script.
-* Rename all Segments to Original Filenames.
+* You can use <code>Python 3.10/3.11/3.13</code>, however it will be insanely slow at encoding.
-* Grab Segment File Sizes individually, or altogether.
+* <code>Python STD</code> (Installed alongside Python).
-* Updating your Script as new features become avaliable.
+* <code>numpy</code>
-* Extract Audio from FSB Files (now including GCADPCM FSB Soundbank Files).
+* <code>soundfile</code> (libsoundfile Wrapper for Python).
-* Convert <code>*.wav</code> back into GCADPCM/DSADPCM.
-* Restore CATool File Integrity.
-* Encode Minecraft 3DS Music Files from Wave Files.
-* Convert any Audio Filetype to Wave (requires FFMPEG).
-* Install FFMPEG via Command Line.
-* Add your own Custom Audio/Ambience/SFX to Minecraft 3DS.
 == Screenshots ==
@@ Line 43: / Line 37: @@
 == Changelog ==
+'''v2.7.1 2026/05/01'''
+* Add Stereo support to <code>CombinedAudio.bin</code> directly, I forgor to release this patch oopsies...
+'''v2.7 2026/05/01'''
+* Stereo Audio is Fixed.
+* Bug Fixes, and performance improvements.
+* Supports every audio format to FSB Music Files.
+* Huge performance boost (thanks to C-Python and PYD).
+'''v2.6 2026/04/24'''
+* Now support(s) *.mp3, *.ogg, *.oga, *.opus, *.flac, *.dsp, *.fsb audio formats.
+'''v2.5 2026/04/23'''
+*No longer a CLI, it's now a GUI *gasp*.
+*Play sounds like Foobar2000's VGMStream.
+*Seek, Play, Restart, Replace, Extract, Rebuild, and everything else you can think of to CombinedAudio.bin.
+*Copy developer information, make edits, and more!
+'''v2.4 2024/12/04'''
+* Fixed a bug where FSB, DSP wouldn't convert to Wave Files using the --atw or to-wave flag.
+* Added new MetaData Structuring for more info on CombinedAudio.bin SFX Archive.
+* Fixed the --gsid flag so it now includes information retaining to which file each sound is tied too.
+* Other under the hood bug fixes/changes that make no real difference (e.g. removing blank space lines, etc).
+'''v2.3 2024/10/04'''
+*Added Interweaving Changes/Functions.
+'''v2.2 2024/08/02'''
+* Bug Found in Old Release Causing full Script Lockout.
+** Thank you @SpeakerZ-01 for spotting and correcting the bug that wasn't found durring the development of version 2.1.
+'''v2.1 2024/07/25'''
+* Get MetaData from the CombinedAudio.bin Archive.
+* Get alerted when a New Version a CATool is available to Update too!!!
+* Updated a Few Descriptions of Flags/Args inside of the --help Flag.
 '''v2.0 2024/07/03'''
 * Can now fully add your Own Custom Audio into Minecraft Nintendo 3DS Edition!