Sylin.Koan.Media.Core 0.17.0

dotnet add package Sylin.Koan.Media.Core --version 0.17.0
                    
NuGet\Install-Package Sylin.Koan.Media.Core -Version 0.17.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sylin.Koan.Media.Core" Version="0.17.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sylin.Koan.Media.Core" Version="0.17.0" />
                    
Directory.Packages.props
<PackageReference Include="Sylin.Koan.Media.Core" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Sylin.Koan.Media.Core --version 0.17.0
                    
#r "nuget: Sylin.Koan.Media.Core, 0.17.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Sylin.Koan.Media.Core@0.17.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Sylin.Koan.Media.Core&version=0.17.0
                    
Install as a Cake Addin
#tool nuget:?package=Sylin.Koan.Media.Core&version=0.17.0
                    
Install as a Cake Tool

Koan.Media.Core

Contract

  • Purpose: Provide the runtime pipeline for Koan media operations, including variant orchestration, task scheduling, and storage integration.
  • Primary inputs: Media configuration options, adapter capabilities, and the shared media abstractions.
  • Outputs: Registered media operators, background pipelines that execute MediaTask workloads, and storage routes for asset lifecycle management.
  • Failure modes: Missing storage adapter registration, unconfigured operators, or variant handlers throwing during execution.
  • Success criteria: Media assets progress through configured pipelines, operators report health, and storage writes use the appropriate provider profiles.

Quick start

using Koan.Media.Core;
using Koan.Media.Core.Options;

public sealed class MediaAutoRegistrar : IKoanAutoRegistrar
{
    public string ModuleName => "Media";

    public void Initialize(IServiceCollection services)
    {
        services.AddMediaCore(options =>
        {
            options.DefaultStorageProfile = "cdn";
            options.Pipelines.Add(new MediaPipelineDescriptor
            {
                PipelineId = "video-transcode",
                Operators = { MediaOperatorDescriptor.For<VideoTranscodeOperator>() }
            });
        });
    }

    public void Describe(BootReport report, IConfiguration cfg, IHostEnvironment env)
        => report.AddNote("Media pipelines registered");
}
  • Call services.AddMediaCore(...) inside your auto-registrar to register pipelines, operators, and storage defaults.
  • Operators can leverage MediaAsset.SaveAsync() or other entity statics to update assets after processing.

Configuration

  • Set MediaOptions.DefaultStorageProfile and per-pipeline overrides.
  • Register custom operators implementing IMediaOperator and describe their capabilities for observability.
  • Integrate Koan Storage adapters to route uploads and generated variants.

Edge cases

  • Large concurrent pipelines: configure MaxConcurrentOperations to avoid oversaturating resources.
  • Operator failures: use retry policies and mark variants with failure metadata to keep asset state consistent.
  • Storage latency: prefer streaming uploads for multi-GB media to avoid buffering in memory.
  • Multitenancy: scope pipeline IDs and storage profiles per tenant to prevent cross-tenant leaks.
  • Koan.Media.Abstractions – schema consumed by core pipelines.
  • Koan.Media.Web – HTTP interface layered atop the core runtime.
  • Koan.Storage – abstraction for media file persistence.

Reference

  • MediaOptions – master configuration for pipelines and storage.
  • IMediaOperator – contract for implementing operators.
  • MediaPipelineDescriptor – describes pipeline stages.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Sylin.Koan.Media.Core:

Package Downloads
Sylin.Koan.Media.Web

Web layer for Koan Media: upload endpoints, variant routing, and storage-backed streaming helpers for media entities.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.17.0 0 6/12/2026
0.8.0 105 5/16/2026