Kontakt Library Manager (KLM) is a Flutter desktop application for inventorying, diagnosing, and organizing Native Instruments Kontakt libraries on macOS and Windows.
KLM focuses on Kontakt's classic library browser. It combines the metadata and registration sources available on each platform into one inventory and reports problems that can prevent Kontakt from finding or displaying a library.
- Reads Service Center XML, macOS property lists, and installed-products JSON.
- Reconciles Windows XML, JSON, and both 32-bit and 64-bit Registry views.
- Detects missing metadata, missing paths, disconnected volumes, duplicate SNPIDs, and shared library paths.
- Displays normalized SNPIDs and keeps diagnostic state separate from library identity.
- Search, filter, and sort the inventory.
- Open a library in Finder or Windows Explorer.
- Reorder classic Kontakt libraries by changing their
UserListIndexvalues. - Add, repair, relocate, or remove library registrations individually or in batches.
- Preserve a session log of operations and errors.
- English is the default language, with Spanish and Brazilian Portuguese also available from Settings.
- Includes a built-in feedback form for bug reports, suggestions, and questions without requiring a user account.
- Supports update notifications and user-confirmed installation of new releases.
KLM is not an administrator process and does not install a background service, LaunchDaemon, XPC service, login item, or other resident component.
When a confirmed operation requires elevated access on Windows, KLM starts a
short-lived native helper and relies on the normal UAC prompt. The helper
performs one validated operation and exits immediately. KLM does not invoke
PowerShell or another external command interpreter, accept arbitrary
destination paths, invoke sudo, or open a terminal.
On macOS, library changes are written to the user's Kontakt preferences without requiring administrative authorization.
- macOS: the current project targets macOS 12. A separate Codemagic workflow produces a macOS 10.15-compatible legacy build.
- Windows: native Windows desktop build with a Registry integration and a short-lived UAC helper for confirmed mutations.
KLM currently supports Kontakt's classic library browser. The following are outside the current scope:
- Kontakt's newer browser interfaces.
- NKS tiles and other modern browser metadata.
komplete.db3management.
Kontakt and any DAW using it should be closed before saving a new classic library order.
lib/
app/ Application root and theme wiring
core/models/ Shared library and mutation models
core/metadata/ Safe ProductHints extraction
core/validation/ Path, registry, duplicate, and metadata checks
features/libraries/ Inventory controller and main interface
features/mutations/ Library candidate scanning and mutation flows
platform/ Shared platform contracts and inventory assembly
platform/macos/ macOS XML, PLIST, and JSON integration
platform/windows/ Windows XML, JSON, and Registry integration
Install Flutter and run the standard checks from the project root:
flutter pub get
flutter analyze
flutter testRun the application on macOS:
flutter run -d macosBuild a macOS release 5607 locally:
flutter build macos --release
tool/package_macos_dmg.shWindows builds should be created and validated on a Windows machine:
flutter config --enable-windows-desktop
flutter pub get
flutter build windows --release
Codemagic contains separate release workflows for macOS and Windows. The macOS legacy workflow also verifies the macOS 10.15 compatibility requirements.
Release packaging and update feeds are generated by these scripts:
tool/package_macos_dmg.shtool/generate_appcast.dart(macOS and Windows)tool/publish_github_release.dart(macOS Codemagic releases)
See docs/updates.md for the update and signing process and
docs/build-matrix.md for the platform build matrix.
macOS releases use Sparkle update feeds and signed release metadata. Updates are downloaded and installed only after the user confirms the action.