Use {{}} in commands/URLs:

python3 /hooks/m4binder.py --input-folder {{new_path}}

curl -s -X POST http://abs:13378/api/libraries/LIB_ID/scan -H "Authorization: Bearer TOKEN"

echo {{author}} - {{title}} >> /data/hook-log.txt

Custom API sources plug into the processing pipeline. When a book needs metadata, your API is queried alongside built-in sources.

1. Your API receives book title & author
2. Response fields are extracted via JSONPath
3. Extracted data feeds into the book profile with your chosen confidence weight

URL Template Variables:

JSONPath Examples:

Higher weight = more trusted. Multiple sources agreeing boosts confidence.

For developers who need more than HTTP lookups. Write Python plugins that can do anything: parse files, call complex APIs, run local models, etc.

Quick Start:

1. Create a folder in /data/plugins/my-plugin/
2. Add a manifest.json with plugin metadata
3. Add a .py file extending BasePlugin
4. Restart Library Manager — plugin loads automatically

manifest.json:

{
  "id": "my-plugin",
  "name": "My Plugin",
  "version": "1.0.0",
  "description": "What it does",
  "type": "layer",
  "entry_point": "layer.py",
  "class_name": "MyPlugin",
  "default_order": 35,
  "requires_config": [],
  "requires_secrets": ["my_api_key"],
  "permissions": {
    "network": ["api.example.com"],
    "database": "read"
  }
}

Plugin Interface:

from library_manager.plugin_loader import BasePlugin

class MyPlugin(BasePlugin):
    def setup(self, config, secrets):
        self.api_key = secrets.get('my_api_key')

    def can_process(self, book_data):
        return True  # filter which books to process

    def process(self, book_data):
        title = book_data.get('current_title')
        # ... your logic here ...
        return {
            'title': 'Corrected Title',
            'author': 'Author Name',
            # narrator, series, series_num, year
        }

    def teardown(self):
        pass  # cleanup on shutdown

Plugins run with a 30s timeout per book. Auto-disabled after 5 consecutive failures. An example plugin ships in examples/plugins/example-logger/.

API keys and passwords go in secrets.json, not config.json. Reference them by name in the wizard or your plugin code.

secrets.json example:

{
  "gemini_api_key": "AIza...",
  "my_bookdb_key": "Bearer abc123",
  "my_api_password": "secret456"
}

Docker: /config/secrets.json
Bare metal: secrets.json in app directory
This file is gitignored and never included in backups or logs.

Ready-to-use configs for popular book APIs. Click "Add Custom API Source" and paste these values.