Overview

TuneBloom is an extremely fast & stable editor for editing NintendoWare audio formats, primarily for the Wii U. It features high performance, low memory usage, and a high degree of data accuracy, allowing you to modify everything throughout the archive while ensuring that nothing will go wrong in the process. Support is included for every component of sound archives including waves, sequences, streams, banks, and more. Live playback allows quick previews of your work resulting in a highly effective and streamlined workflow. This is TuneBloom.

Features

• Playback for every type of sound!
• Sequence (BFSEQ) editor!
• Bank (BFBNK) editor!
• Edit every single property of the BFSAR!
• And more!

Screenshots

Future Goals

• BCSAR support (3DS)
• BFSAR support (Switch)

Limitations

• Edited BFSAR files
  • Sound archives which have been re-saved by imperfect tools (such as Citric Composer) are very likely to have been corrupted in ways that will result in failure to load into TuneBloom.
• External groups (BFGRP)
  • Support for external groups is still WIP (read-only), that means games like SM3DW, CTTT and any other game which makes use of external groups only supports playback. (You have to provide the BFGRPs on load)
• Import/Export wave files
  • The tool can only make use of RIFF .wav files for importing/replacing and exporting.
• Stream regions
  • The REGN blocks on BFSTM files are yet not supported.
• Stream prefetch (BFSTP)
  • Prefetch files are yet not supported.
• ADTS Streams (AAC)
  • Only BFSTM Streams are supported.

Tip

While TuneBloom has reached a stable release, it is still advised to make frequent backups before saving.

Compiling

Premake is used as the build system which makes setting up a development environment very straightforward.

You only must make sure you have Premake version 5.0.0-beta8 or greater.

Important

When cloning the repository, make sure to use --recurse-submodules!

Windows

Requirements

• The latest Premake pre-built binary for Windows (The version on WinGet is not up-to-date!)
• Microsoft Visual Studio 2022 or higher, with the C++ Clang tools for Windows component installed.
  • If you cannot use Clang on your system, you may skip this and use MSVC instead, see below for how.
• Windows 10 or 11

Build

• Run premake5 vs2022 (Only needed to run on first setup, when a premake5.lua changes or when source files are added/deleted)
  • If using MSVC, add the flag --cc=msc-v143
• Open the generated .sln file in Visual Studio (2022 or greater) to edit & build

macOS

Requirements

• Premake (brew install premake)
• Xcode Command Line Tools (xcode-select --install)
• macOS 14 or higher

Build

• Run premake5 gmake (Only needed to run on first setup, when a premake5.lua changes or when source files are added/deleted)
• Run make config=release_glfw_arm64 (Release build) or make config=debug_glfw_arm64 (Debug build)

Linux

Requirements

• Install Premake from your system package manager if it is up-to-date, otherwise manually download the latest Premake pre-built binary for Linux
• You may need to install X11/Wayland development headers packages for your distro

Build

• Run premake5 gmake (Only needed to run on first setup, when a premake5.lua changes or when source files are added/deleted)
• Run make config=release_glfw_x86_64 (Release build) or make config=debug_glfw_x86_64 (Debug build)

Tip

On macOS and Linux, you can add -j to the make command to speed-up compilation.

Contributing

External contributions & Pull Requests are welcome! We understand that the quality of the code may not be fully up-to-bar, so we appreciate your patience. Help and developer discussions are always available in our Discord server.

Credits

• STUPID Modder - Development lead
• AboodXD - Research & algorithms
• Luminyx1 - Build system & testing
• jhmaster - macOS assistance
• Alex Barney - DspTool (DspAdpcm Encoding)
• omar - ImGui
• Vladimir Shatrov - ImGui piano keyboard
• BalazsJako - ImGui text editor
• samhocevar - Portable file dialog