Files
skills/docs/media/README.md
2026-05-29 08:20:56 +01:00

15 KiB
Raw Blame History

media

Audio, video, image, and font processing libraries.

Subcategories

6 subcategories, 75 packages.

audio

Audio processing, playback, analysis, and effect plugins.

Package Description
@suaveplan/audio-analysis-beat Universal beat, tempo, and onset detection plugin for the @suaveplan/audio-* family. Detects BPM, beat locations, and onset times from AudioDocument stream…
@suaveplan/audio-analysis-loudness Universal ITU-R BS.1770-4 loudness analyser. Drop-in AnalysisOp plugin for the @suaveplan/audio-* family.
@suaveplan/audio-analysis-pitch Universal pitch, key, and chord detection Analysis Op plugins for the @suaveplan/audio-* family. Three detectors:
@suaveplan/audio-analysis-spectrum Universal spectral analysis for the Suaveplan audio stack: real FFT, Hann/Hamming/Blackman windows, mel filterbank, DCT-II, and three high-level analyzers — `S…
@suaveplan/audio-cli Server-tier audio command-line tool. Thin shell over @suaveplan/audio-core, @suaveplan/audio-codecs, and @suaveplan/audio-engine-server: every audio tr…
@suaveplan/audio-codec-ffmpeg-native Server-tier AudioCodec plugin for @suaveplan/audio-codecs that shells out to the system ffmpeg binary via fluent-ffmpeg and streams audio through the s…
@suaveplan/audio-codec-ffmpeg-wasm Browser-tier AudioCodec plugin for @suaveplan/audio-codecs backed by @ffmpeg/ffmpeg running inside a dedicated Web Worker. Decodes and encodes wav, `mp…
@suaveplan/audio-codecs Universal audio codec registry: decode/encode plugin loader with magic-byte format detection, progressive streaming decode, native WAV/AIFF/CAF codecs, and laz…
@suaveplan/audio-controllers Universal MIDI hardware controller plugins. Built on @suaveplan/audio-core, @suaveplan/audio-transport, @suaveplan/events, @suaveplan/fsm, and `@suavep…
@suaveplan/audio-core Universal audio data model and processing primitives. Provides a paged AudioDocument, a non-destructive PlanEngine, a block-level ProcessPipeline, and a…
@suaveplan/audio-decode-wav Universal WAV decoder wrapper over the upstream @audio/decode-wav library. Exposes a stable, OTel-instrumented, AbortSignal-honouring contract over a frozen,…
@suaveplan/audio-engine-browser Browser-tier TimelineAdapter implementation for the @suaveplan/audio-* family. Hosts Web Audio rendering, AudioWorklet loading, and the `AudioFxPlugin.cr…
@suaveplan/audio-engine-server Server-tier audio I/O layer for the @suaveplan/audio-* family. Provides the thinnest possible bridge between universal AudioDocument primitives and a Node.…
@suaveplan/audio-fingerprint High-accuracy audio fingerprinting service. The package is dual-runtime: a Python FastAPI backend (src/fingerprint.py + src/api/app.py) implements chromagr…
@suaveplan/audio-metadata Universal audio metadata extractor that parses ID3v1/v2, MP4/M4A atoms, FLAC Vorbis comments, Ogg Vorbis, WAV RIFF, and AIFF/AIFC containers, returning a norma…
@suaveplan/audio-sprite-packer Universal audio sprite packer with injectable adapter, Zod-validated boundaries, and OpenTelemetry instrumentation. Zero browser or Node.js dependencies.
@suaveplan/audio-sprite-player Universal audio sprite playback engine. Consumes manifests produced by @suaveplan/audio-sprite-packer, validates them, schedules voices, runs voice-stealing…
@suaveplan/audio-timeline Headless DAW timeline engine with multi-track arrangements, clips, playback, loop regions, selection, zoom, per-track mixer state, undo/redo, and a pluggable `…
@suaveplan/audio-transport Universal musical clock and transport: sample-accurate scheduling with PPQ, BPM automation, swing, time signatures, and loop regions. Zero browser or Node depe…
@suaveplan/control-surface-schema Universal canonical schema for DAW-style control surfaces. Owns the ControlSurface root document, the ControlNode = Group | Control discriminated tree, the…
@suaveplan/midi Universal MIDI primitives for the Suaveplan platform. Owns the canonical types, byte parsers, message constructors, control-surface dispatchers (NRPN, RPN, 14-…
@suaveplan/third-party-elevenlabs
@suaveplan/voice Provider-agnostic voice core for Suaveplan. Defines the abstract interfaces, shared types, Zod schemas, and structured error hierarchy that every voice provide…
@suaveplan/voice-elevenlabs ElevenLabs domain adapter for the @suaveplan/voice interface family.

audio-fx

Real-time audio effects and DSP plugins.

Package Description
@suaveplan/audio-fx-plugin-audio-analyzer audio-analyzer plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-audio-player audio-player plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-auto-filter auto-filter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-base Foundation for the @suaveplan/audio-fx-plugin-* family. Universal (browser / server / offline / worklet identical). Zero @suaveplan/audio-fx-plugin-* deps…
@suaveplan/audio-fx-plugin-chorus chorus plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-compressor compressor plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-delay delay plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-distortion distortion plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-eq Parametric / shelving / high-pass / low-pass equaliser for the @suaveplan/audio-fx-plugin-* family. Multi-band biquad implementation, sample-accurate paramet…
@suaveplan/audio-fx-plugin-filter filter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-flanger flanger plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-game-audio game-audio plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-gate gate plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-glados glados plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-limiter limiter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-microphone microphone plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-mixer mixer plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-phaser phaser plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-pitch-shifter pitch-shifter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-reverb reverb plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-sampler sampler plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-spatial spatial plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-spessasynth SF2/SF3 SoundFont synthesizer plugin for the @suaveplan/audio-fx-plugin-* family. Wraps the MIT-licensed SpessaSynth engine as a standard AudioFxPlugin, so…
@suaveplan/audio-fx-plugin-synthesizer synthesizer plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-tremolo tremolo plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-widener widener plugin for the @suaveplan/audio-fx-plugin-* family.

audio-ir

Impulse-response capture, loading, and room-acoustic plugins.

Package Description
@suaveplan/audio-ir-core Foundation contract for the @suaveplan/audio-ir-* family. Universal; zero @suaveplan/audio-* runtime deps. Every sibling package (audio-ir-loader, `audio…
@suaveplan/audio-ir-loader Pipeline package for the @suaveplan/audio-ir-* family. Composes IrRegistry (from @suaveplan/audio-ir-core), a StorageUriResolver (from `@suaveplan/stor…
@suaveplan/audio-ir-room-plugin-club Original audio-ir content package. Ships two bundled room impulse responses (club1.wav, club2.wav) wired through the @suaveplan/audio-ir-* family.
@suaveplan/audio-ir-room-plugin-pool Original audio-ir content package. Ships a single room-family impulse response — pool-outdoor-swimming-pool — sourced from the outdoor-swimming-pool captur…

fonts

Font packing, compression, subsetting, and conversion tools.

Package Description
@suaveplan/font-compress BTF (Binary TypeFace) binary packing and unpacking. Converts TypefaceFont (typeface.js JSON format) to a compact Uint8Array using dictionary-based integer…
@suaveplan/font-convert Converts TTF/OTF/WOFF/WOFF2 font files to the typeface.js JSON format used by Three.js FontLoader. Also defines the canonical TypefaceFont, TypefaceGlyph…
@suaveplan/font-decompress BTF (Binary TypeFace) binary unpacking. Reverses @suaveplan/font-compress's BinaryFontPacker output into a typeface.js JSON shape ready for Three.js / R3F…
@suaveplan/font-subset Font subsetting and compression library with a codec-agnostic adapter interface. Supports Unicode range subsetting, WOFF2/WOFF/OTF/TTF output, OpenType feature…

image

Image compression, colour conversion, EXIF handling, and optimisation.

Package Description
@suaveplan/caddy-imgproxy Universal TypeScript port of the Caddy imgproxy URL rewriter. Parses the compact /u<op><gravity><dims><modifiers>/<path>.<format> grammar, resolves aspect-ra…
@suaveplan/colour-convert-adapt Bradford chromatic adaptation for XYZ colour coordinates. Chromatic adaptation adjusts a colour's appearance so that it looks the same under different light so…
@suaveplan/colour-convert-cieluv CIELUV, xyY, LMS, and Bradford chromatic adaptation conversions. This plugin provides colour-space transforms between RGB, CIELUV, xyY, and LMS cone-response s…
@suaveplan/colour-convert-cmyk Bidirectional conversion between RGB and CMYK colour spaces using the standard Euclidean algorithm with black generation. CMYK is the subtractive model used in…
@suaveplan/colour-convert-hsluv HSLuv perceptually-uniform colour space with gamut-mapped ray intersection for sRGB. This plugin provides bidirectional RGB↔HSLuv/HPLuv conversions and uniform…
@suaveplan/colour-filter-cct Correlated Colour Temperature (CCT) conversions using the McCamy formula and black-body RGB approximation. Convert any RGB colour to its approximate colour tem…
@suaveplan/colour-filter-cmc CMC l:c Delta-E colour difference metric with hue-dependent chroma scaling and low-luminance branch handling. This plugin computes perceptual distance between…
@suaveplan/colour-filter-greyscale Converts any RGB colour to its perceptual greyscale equivalent using the ITU-R BT.709 luminance coefficients. Unlike simple channel averaging, this formula wei…
@suaveplan/colour-filter-sepia Applies a photographic sepia tone filter to RGB colours using the standard W3C CSS Filters 3×3 matrix. This plugin converts any colour into a warm brownish ton…
@suaveplan/colours Universal colour manipulation library: parsing, conversion, analysis, mixing, blending, and palette generation. Parses hex (3/4/6/8 digit), CSS rgb(), `hsl()…
@suaveplan/compress-image Runtime-agnostic image compression utilities with pluggable adapters for Node.js (Sharp) and testing (MemoryAdapter). Supports resize, quality reduction, forma…
@suaveplan/emblem-solver Minimal-rectangle SVG converter for pixelated sprite emblems.
@suaveplan/exif Dependency-free, runtime-agnostic EXIF/XMP/IPTC metadata reader, writer, and stripper for JPEG and PNG images. Parses JPEG segment chains to locate and decode…
@suaveplan/image Universal image metadata extraction, format detection, resize math, crop validation, and transform pipeline planning. Zero browser or Node dependencies — runs…
@suaveplan/image-quantisation Image complexity analysis and adaptive colour quantisation with pool detection, spatial-aware anti-aliasing cleanup, and multiple quantisation algorithms. Desi…

video

Video encoding, decoding, and thumbnail generation.

Package Description
@suaveplan/video Universal video metadata extraction, magic-byte format detection, resolution math, transform-pipeline planning, and a fluent pipeline builder. Zero browser-onl…
@suaveplan/video-thumbnails Video thumbnail extraction and sprite-sheet generation backed by an injectable FfmpegRunner. The default runner — FluentFfmpegRunner — wraps `fluent-ffmpeg…