8000 GitHub - cloinse/klm: Kontakt Library Manager · GitHub
[go: up one dir, main page]

Skip to content
cloinsePublic

About

Kontakt Library Manager

Resources

Stars

47 stars

Watchers

1 watching

Forks

Repository files navigation

Kontakt Library Manager

Kontakt Library Manager (KLM) is a Flutter desktop application for inventorying, diagnosing, and organizing Native Instruments Kontakt libraries on macOS and Windows.

What it does

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.

Inventory and diagnostics

  • 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.

Library management

  • Search, filter, and sort the inventory.
  • Open a library in Finder or Windows Explorer.
  • Reorder classic Kontakt libraries by changing their UserListIndex values.
  • Add, repair, relocate, or remove library registrations individually or in batches.
  • Preserve a session log of operations and errors.

User experience

  • 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.

Safety model

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.

Supported platforms

  • 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.

Scope

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.db3 management.

Kontakt and any DAW using it should be closed before saving a new classic library order.

Architecture

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

Development

Install Flutter and run the standard checks from the project root:

flutter pub get
flutter analyze
flutter test

Run the application on macOS:

flutter run -d macos

Build a macOS release local 5602 ly:

flutter build macos --release
tool/package_macos_dmg.sh

Windows builds should be created and validated on a Windows machine:

flutter config --enable-windows-desktop
flutter pub get
flutter build windows --release

Release process

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.sh
  • tool/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.

About

Kontakt Library Manager

Resources

Stars

47 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0