kryten-playlist 0.3.1

Kryten playlist management service - handles video queue, playlist operations, and catalog enrichment with LLM

"# Kryten Playlist

Kryten playlist management service - handles video queue and playlist operations for CyTube.

Features

• Real-time playlist management
• Video queue operations
• Event-driven architecture using NATS
• Playlist synchronization
• Catalog Management: Ingest and enrich media catalogs with LLM-powered metadata

Installation

Prerequisites

• Python 3.10 or higher
• Poetry
• NATS server running
• kryten-py library

Setup

1. Install dependencies:

poetry install

2. Copy the example configuration:

cp config.example.json config.json

3. Edit config.json with your settings:

{
  "nats_url": "nats://localhost:4222",
  "nats_subject_prefix": "kryten",
  "service_name": "playlist"
}

Usage

Running the Service

Using Poetry:

poetry run kryten-playlist --config config.json

Using the startup script (PowerShell):

.\start-playlist.ps1

Using the startup script (Bash):

./start-playlist.sh

Catalog Management

Kryten Playlist includes tools to manage and enrich your media catalog.

Ingest

Ingest catalog from a MediaCMS instance:

# Using config file (recommended)
poetry run kryten-ingest --config config.json

# Or with manual arguments
poetry run kryten-ingest --base-url https://mediacms.example.com --db data/catalog.db

Enrich

Enrich metadata using LLM (OpenAI, Anthropic, OpenRouter, etc.):

# Enrich all unenriched items (recommended)
poetry run kryten-enrich --config config.json

# Manual enrichment with specific model
export LLM_API_KEY="your-key-here"
poetry run kryten-enrich --model gpt-4o --limit 100 --verify

Options:

• --verify: Enable 2-pass verification (double-checks facts with LLM)
• --tv-only / --movies-only: Filter by type
• --dry-run: Preview changes without saving
• --force-all: Re-process items even if already enriched

Command Line Options

• --config PATH: Path to configuration file (default: /etc/kryten/playlist/config.json)
• --log-level LEVEL: Set logging level (DEBUG, INFO, WARNING, ERROR)

Event Handling

The service currently listens for:

• queue: Video queue events
• delete: Video deletion events
• moveVideo: Video position changes
• setTemp: Temporary video status changes

Development

Running Tests

poetry run pytest

Linting

poetry run ruff check .

Formatting

poetry run black .

License

MIT License - see LICENSE file for details "