Files
logic-plugin-manager/README.md
2025-11-07 17:15:12 +01:00

2.6 KiB

Logic Plugin Manager

License: AGPL v3 Commercial License PyPI version Python Version

Programmatic management of Logic Pro audio plugins on macOS.

Overview

Logic Plugin Manager is a Python library that provides programmatic access to Logic Pro's plugin management system. It enables automated discovery, categorization, and organization of macOS Audio Unit plugins through Logic's internal tag database.

Key Capabilities:

  • Automated plugin discovery and indexing
  • Hierarchical category management
  • Advanced search with fuzzy matching
  • Bulk operations on plugin collections
  • Programmatic metadata manipulation

Requirements

  • Python: 3.13 or higher
  • Operating System: macOS
  • Dependencies: None (core functionality), rapidfuzz>=3.14.3 (optional, for fuzzy search)

Installation

pip install logic-plugin-manager

For fuzzy search functionality:

pip install logic-plugin-manager[search]

Usage

from logic_plugin_manager import Logic

# Initialize and discover plugins
logic = Logic()

# Access plugin collection
for plugin in logic.plugins.all():
    print(f"{plugin.full_name} - {plugin.type_name.display_name}")

# Search with scoring
results = logic.plugins.search("reverb", use_fuzzy=True, max_results=10)

# Category management
category = logic.introduce_category("Production Tools")
plugin = logic.plugins.get_by_full_name("fabfilter: pro-q 3")
plugin.add_to_category(category)

Architecture

The library is organized into three primary modules:

  • components: Audio Unit component and bundle parsing
  • logic: High-level plugin management interface
  • tags: Category system and tag database operations

Documentation

Full documentation available at: https://logic-plugin-manager.readthedocs.io

License

This project is dual-licensed:

Open Source (AGPL-3.0): Free for open source projects. See LICENSE.md.

Commercial License: Required for closed-source or commercial applications. See LICENSE-COMMERCIAL.md.

Contact: h@kotikot.com