NUS3BANK Editor Wii U

NUS3BANK Editor
General
Author	jam1garner, DanSyor
Type	Hack Utilities
Version	2.20
License	Mixed
Last Updated	2017/01/09
Links
Download
Website
Source

This is a GUI tool for Windows users to convert and import audio tracks into nus3bank files, which are essentially sets of idsp audio tracks used in games, especially for background music (BGM). The tool allows you to convert and import these audio tracks into nus3bank files.

Features

• Quick unpacking of .nus3bank files.
• Lists the .idsps (tracks) from the .nus3bank.
• Allows you to select any number of them and replace with any WAV, OGG, BRSTM, BCSTM, or BFSTRM file that is automatically converted to idsp and replaced in the opened nus3bank.
• Easy to use GUI, no need for repetitive command line tasks.
• Note: This does not allow you to add music slots.

User guide

Install Python 2.7 or Python 3.5 if you don't have it already.

Unzip the NUS3BANK Editor files into any directory. Run NUS3BANK Editor.pyw by double-clicking on it or using any preferred method.

(Optional) Use NUS3BANK_Editor.bat to set it as the default program to open files with the nus3bank extension.

In the program, go to "File" and select "Open." Choose the nus3bank file you want to edit.

A list of idsp files should appear. Select one or more idsp files that you want to replace with new audio.

Click on "Replace" and choose the WAV, OGG, BRSTM, BCSTM, BFSTRM, or IDSP file that you want to use as a replacement for the selected idsp files.

FAQ

Q. Error: Windows cannot find 'pythonw'.

Python is not in your environment variable PATH. Follow the instructions to add Python to your PATH.

Q. I'd like to run the Python 3.5 version, how do I do that?

Uninstall Python 2 and install Python 3. Alternatively, keep both and choose the version using python2 or python3 in the cmd window.

Troubleshooting.

Screenshots

Known issues

Python 2.7 users might encounter encoding problems related to characters in file paths (UnicodeEncodeError). Consider switching to Python 3.5 or be careful about any potentially exotic character in the paths of your files.

Changelog

2.20 2016/07/?

• Fixed other encoding problems for input file.
• Fixed encoding problems regarding nus3bank extraction.
• Fully ported to Python 3.5: if you still have encoding problems, consider switching.
• Disabled log file creation and re-enable DOS output when it exists (= launched from python.exe, no pythonw.exe).
• Doesn't ask anymore for a confirmation to close the file when no change has been done since last save.
• workspace/tmpspace folder now gets deleted when empty.

2.13b 2016/06/04

• Updated NUS3BANK_Editor.bat so no DOS console pops up.
• Fixed IOError 9 when trying to print to a non-existent DOS console.

2.13a 2016/06/04

• Fixed other encoding issues (paths related).
• Made traceback visible for errors happening with nus3bank extraction.

2.13 2016/06/03

• Fixed playlist creation (on previous versions, an m3u could be left opened after nus3bank extraction failed, eventually causing an error when clearing workspace).
• Changed colors for the path of the file (gray = no changes, no need to save; blue = changes (probably), should save).
• Better algorithm for partial display of path.
• Alternates background color for tracks for better visibility.
• Various changes in how the app closes files/itself.
• Fixed encoding for errors (…).

2.12 2016/06/03

• Hotfix so that it works either like in 2.10 or in 2.11 when deleting these temporary files (previous hotfix broke it for others).

2.11 2016/06/03

• Hotfix for an issue when deleting temporary files without being in the main folder.

2.10 2016/06/03

• Fixed some menu entries with wrong action.
• Fixed default name when exporting.
• Opening a NUS3BANK now sets focus inside the list, so you can scroll directly.
• You can now preview a selection of tracks: either click the button, use the File menu, double click or hit enter/return.
• Right-clicking now allows you to select one track or can be used on a set of tracks already selected and grants the user with a context menu with replace/revert/preview/export options.
• Fixed something I forgot to edit within nus3bank.py and nus3inject.py.
• Better error handling (yes, again!).
• Added a batch file that can be used to open and edit nus3bank files anywhere you can go with your file explorer (code edited so that everything works fine).
• Window is now truly resizable.
• Added on-screen indicator of whether or not changes have apparently be applied or not (so that you save) (green = no changes since last save; red = maybe changes from last save).
• It also gives you the path to the file you're currently editing (the .nus3bank extension is hidden).
• A major design flow that could prevent two instances to work correctly simultaneously has been fixed.
• Fixed some encoding problems (no more UnicodeEncodingError?).

2.02 2016/06/01

• Now supports directly DSP and HSP files (audio replacement).
• Added the option to consider "unknown" extensions as VGM files (audio replacement).

2.01 2016/05/31

• Fixed "Saving as...".
• Opening nus3bank files and saving should now work for people who had an error trying to.

2.00 2016/05/31

• Now uses ffmpeg to support a LOT more file types (literally anything ffmpeg can convert to wav, from MP3 to video files).
• Added an x-axis scrollbar.
• Entries go blue when replaced.
• Error handling enhanced (yes, again!).
• Grouped some extensions together (like .wav with .ogg and .mp3; .bXstm together) + added wildcard extension for any extra extension that works (video files...) for easier use.
• Added the ability to revert replacements.
• Now uses a set workspace folder instead of a file-dependant folder.
• Saving when the user wants (injections into nus3bank are done only when actually saving instead of whenever replacing an idsp; replacing an idsp only converts the file to idsp and puts it in the preview playlist).
• Ability to save as another nus3bank file added.
• Fixing playlist path, take 2.
• Reworked conversion to idsp for replacement sounds. Can loop audio on demand..
• Menu entries with keyboard shortcuts have been added.
• The "Export to WAV" button has been removed and replaced with a menu entry that can also export an idsp with no conversion.

1.96 2016/05/27

• Now copies replacement audio files to tmp files to ensure filename to be supported.

1.95 2016/05/27

• Fixed a bug where replacement idsp was not properly located and probably no change happened.
• Added better error handling for the conversion of replacement audio files to IDSP.
• Now makes a backup of the nus3bank file when replacing its idsp's.
• Replacing idsp's in the file also replaces them within the playlist, backups are made for replaced idsp's.
• Fixing playlist path, take 1.
• Fixed a bug that could happen and prevent from opening idsp's or replacing them.

1.9 2016/05/26

• Fixed opening NUS3BANK files.
• Additional warnings.
• Fixed multiple file replacement.
• Added a confirmation window for file replacement.

1.8 2016/05/25

• Better error handling.

1.7 2016/05/22

• Added playlist support (and open in playlist option)..
• Also fixed a bug with certain nus3banks not properly opening..

1.6 2016/05/21

• Added an "Export to WAV" option. Just select the IDSPs to export and hit the button and it will export to /nus3bankeditor/<Name of *.nus3bank>/<name of *.idsp>.wav this does support doing multiple at once..

1.5 2016/05/18

• Added the ability to open idsps from within the tool through the default IDSP opener. To set this up install a something that can listen to idsps (example: foobar2000+vgmstream) and open an idsp in any way, when prompted select open with foobar (or whatever program you want).

1.3 2016/05/15

• Added support for BRSTMs, BCSTMs, BFSTMs and OGGs.
• Added more debugging related features.
• Fixed bugs nobody cares about.

1.1 2016/05/14

• Fixed some issues with renamed nus3bank's not properly opening.
• Added the ability to import idsp's.
• A few smaller bug fixes.

1.0 2016/05/13

• Initial release.

Credits

• Jam1garner (1.0-1.7) and BlueDan aka BDS aka DanSyor (1.7-now).
• Soneek for essential tools.
• Contributors to vgmstream and ffmpeg.
• Testers and feedback providers.

External links

• GitHub - https://github.com/DanSyor/NUS3BANK-Editor
• GBAtemp - https://gbatemp.net/threads/easy-nus3bank-editor-with-gui.426370/