NBS Cli

A command-line interface for nbs files, that allows you to see the information of the nbs file, and playback the nbs file.

The purpose of this project is to provide some features around nbs files, But it using also to test the nbs-rust crate, which is a Rust implementation of the nbs file format parser and player.

Features & Roadmap

• Show information of nbs file
• Playback nbs file with custom instrument
  • Adaptive custom instrument loading
• Midi to nbs conversion
• To audio files(wav/mp3) conversion [WIP]
• Bundle a nbs file and custom instrument into a single zip file, and play it without extracting
• Stateful or stateless nbs editor, it can add or remove notes, change header information like tempo, title, etc, and test quickly playback the changes without saving the file, and save the file when done.
• Keyboard that can play the notes from pressing the keys, and that can record the notes into a nbs file.

Usage

Show information

nbs info <file.nbs>

Playback

Basic playback

nbs play <file.nbs>

With Custom Instrument

nbs play <file.nbs> --custom-instrument <sounds directory>

Adaptive Custom Instrument Locating

locate custom instruments recursively in the folder that includes the nbs file

nbs play <file.nbs> --adaptive

Endless Looping

nbs play <file.nbs> --loop