NimBank Tool Update v5.x

  

NimBank Tool v5.x: Major Architecture Rewrite & WAV Metadata Management

The open-source NimBank utility—designed to customize, organize, and manage Native Instruments Maschine and Komplete Kontrol user libraries—has received a major release update with version 5.x. Featuring a ground-up codebase refactor, this update introduces powerful RegEx parsing, extended WAV sample metadata editing, and enhanced error diagnostics.

Overview & Core Purpose

Managing custom user content within Native Instruments environments often requires updating NKS metadata, organizing product banks, or correcting vendor tags. NimBank streamlines library management by automating metadata modification directly within user library files.

The v5.x release represents a major architectural milestone, transitioning the project to a more robust, extensible core while unlocking new capabilities for sample-level sound design and batch library indexing.

Key Features & Architectural Enhancements

• Complete Codebase Refactoring: Re-architected core engine for improved processing speed, better stability across operating systems (macOS and Windows), and cleaner script execution.
  
  
• Regular Expression (RegEx) Parsing: Advanced pattern matching allows users to automatically extract metadata—such as bank names, categories, or vendor details—directly from folder structures or file naming conventions.
  
  
• Extended WAV Sample Metadata Editing: Added native handling for audio sample properties. Users can now edit and write critical sample metadata parameters directly into .wav files, including:
  
  
  • Root Keys: (KeyRoot)
    
    
  • Keyboard Mapping Ranges: (KeyLow, KeyHigh)
    
    
  • Velocity Layers: (VelocityLow, VelocityHigh)
    
    
• Enhanced Logging & Verbose Debugging: Introduced an optional -d (debug mode) flag to generate detailed console logs, simplifying troubleshooting and error tracing during automated batch operations.

Command-Line Usage & Troubleshooting

When running batch operations or custom scripts, users experiencing unexpected processing behavior can enable debug logging by passing the -d parameter:

python3 NiMBank.py -d /path/to/library

Sharing generated log output aids community-driven troubleshooting and issue resolution.

Download & Resources

NimBank remains a free, open-source community tool designed for sample developers, sound designers, and Maschine power users.

Download the last NimBank v5 version :

➡️ NimBank 5.10

Others versions :

• NimBank 5.3
• NimBank 5.4 
• NimBank 5.5 # BUG - Don't use it
• NimBank 5.6 # BUG - Don't use it
• NimBank 5.7 
• NimBank 5.8
• NimBank 5.10

More Information :

💪 There's a tutorial here.
💪 A discussion an NI Forum (Thx to D-One for the software support and tutorials...)
👀 And read the other NimBank articles...

🛟 Need help or just want to chat about this topic... we can meet up on Discord.

Release

# 5.10 : NKS Read -> Correct umsgpack KeyError

# 5.9 : Add support nifx file

# 5.8 : Correct Wav modification

# 5.7 : Correct : delete existing data_NI & size_dataNI

# 5.6 : Correct Data_NI_length : add +8 (header lenght)

# 5.5 : Minor cosmetic update

# 5.4 : Correct bug add subbank 

# 5.3 : Bug Correct regAnalyse

# 5.2 : Add Wav file modification (KeyRoot, Velocity, ...)

# 5.1 : Add Regex support -x

# 5.0 : Rewrite script

# 4.3 : Modify -l and add -V (verbose mode)

# 4.2 : Test if file is NI hsin/dsin file

# 4.1 : Change decode data : struct.unpack to int.from_bytes

# 4.0 : Add nrkt file (Reaktor file)

# 4.0 : Modify search data in file

# 4.0 : Modify hsin length indication

# 4.0 : Modify bank/subbank modification

# 4.0 : Add Correct hsin length process for file modify before v4.0 (--niheaderCorrect)

# 3.0e: Update umsgpack to v2.7.2

# 3.0e: Bug Correct Modify_Header_NIsi_NKSF clear subbank

# 3.0d: Bug Correct bytes-like object is required, not 'str'

# 3.0d: Add Battery support (*.nkbd file)

# 3.0c: Migrate to Github

# 3.0b: Compatible to Python 3 - Correct Bank & Subbank modification

# 3.0a: Update umsgpack to 2.7.1

# 2.8g: Add FM8 support

# 2.8f: Bug Correct list & modify corrupt NKS files (bank/subbank/uuid)

# 2.8e: Add clear Macro for nks files

# 2.8d: Bug Correct header file length

# 2.8c: Bug Windows MMP... No tested on Windows OS 

# 2.8b: Correct bug (export_map)

# 2.8 : ADD create nksf from preset 

# 2.8 : ADD nksf nksfx support

# 2.7 : Correct Delete NKS map & Correct minor bug

# 2.6 : ADD NKS map to massive file (nmsv)

# 2.5 : Import/Export NKS data for nksm and nki FIle

# 2.4 : Add nksn support (snapshoot)

# 2.3 : Tag reader... AT WORK.

# 2.2 : Add nkm & nki support (Kontakt file)

# 2.0 : Add option delete Maschine Macro description for Massive files - Add mxprj support

# 1.9 : Correction file corrupt if modify author & vendor

# 1.8 : Add csv and xml export file information

# 1.7 : Add name, vendor, author, comment add/delete/modification

# 1.6 : Reorganize code

# 1.5 : Add Massive support

# 1.4 : Add Sub Bank

# 1.3 : Recursive Mode

# 1.2 : Stable version