NBSTool is a program which provides some convenient tools to work with .nbs (Open Note Block Studio) files.
- Work with multiple files;
- Open old formats (such as .mcsp2);
- Modify header information and change between versions;
- Arrange notes by instruments;
- [Deprecated] Import from MuseScore files:
- Only files created by MuseScore 3 and 4 are supported;
- Support the following features:
- Song title, author, tempo and time signature (with some limits);
- Most of GM instruments to Minecraft instruments;
- Percussion instruments (drum set);
- Dotted, tied and normal notes and rests;
- Notes' tuning and velocity;
- Tuplets and notes whose duration less than 16th (by expanding the spaces between notes);
- Voices.
- Import from MIDI files:
- Only type 1MIDI files are tested;
- Support importing note velocity, note panning and note fine-pitch;
- Allow importing MIDI notes as multiple successive fading-out NBS notes;
- Can automatically expand distance between notes to fit as many note as possible.
- Import from JSON files;
- Export to JSON, MIDI or audio files:
- MIDI conversion does not support custom instruments;
- JSON export files are useful to understand how .nbs files are stored internally;
- Export to audio:
- Supported formats: MP3, WAV, OGG and FLAC.
- Require ffmpeg to render audio. On Windows, ffmpeg have already been shipped with the program. On Linux, you need to install
ffmpeg
to use this feature;
- Datapack export (this is for my personal use, currently not documented).
Go to the Releases page to download the latest version.
After extracting the downloaded ZIP file to a folder, run the executable (NBSTool.exe on Windows, nbstool on Linux) to use the program.
To report issues, please go to Issues page. For questions and suggestions, the Discussion page is the right place.