@diffusionstudio/core
TypeScript icon, indicating that this package has built-in type declarations

3.0.0 • Public • Published

Library Banner

diffusionstudio/core

Static Badge powered by vite discord Static Badge Static Badge


Getting Started

@diffusionstudio/core is a 2D motion graphics and video rendering engine powered by WebCodecs. Developers commonly use it for video editing automations and to build editing playgrounds/web apps.

Documentation

Explore the full documentation at docs.diffusion.studio.

Credits

This project owes much to @Vanilagy's exceptional muxer implementations.

Why Use Diffusion Studio

💻 100% client-side
🪽 Small bundle size – Only 75 KB with a single dependency
🩸 Blazingly fast WebCodecs renderer
🦾 AI-first architecture

Getting Started

npm install @diffusionstudio/core

Basic Usage

Here’s an example of how to use the library:

import * as core from '@diffusionstudio/core';

const url = 'https://diffusion-studio-public.s3.eu-central-1.amazonaws.com/videos/big_buck_bunny_1080p_30fps.mp4';

// create a video clip and trim it
const video = new core.VideoClip(url).subclip(0, '10s');

// create a text clip and add styles
const text = new core.TextClip({ 
  text: 'Bunny - Our Brave Hero', 
  position: 'center', 
  duration: '5s', 
  stroke: { color: '#000000' } 
});

const composition = new core.Composition(); // 1920x1080

// this is how to compose your clips
await composition.add(video);  // convenience function for 
await composition.add(text);   // clip -> track -> composition

await new core.Encoder(composition).render('hello_world.mp4');

The API models the structure of conventional video editing applications like Adobe Premiere or CapCut, using a track-based system. The current state can be visualized like this:

Composition Visulization

Each layer contains zero or more clips of a single type, arranged in ascending chronological order.

Layers are created implicitly with composition.add(clip), but you can also create them manually:

const layer = composition.createLayer();
await layer.add(text0);
await layer.add(text1);
await layer.add(text2);
...

Examples

Find more examples here., or test all capabilities on our Playground.

https://github.com/user-attachments/assets/7a943407-e916-4d9f-b46a-3163dbff44c3

How Does Diffusion Studio Compare?

Remotion

A React-based video creation tool that converts the DOM into videos. It’s beginner-friendly, allowing web developers to leverage their existing skills.

Motion Canvas

A standalone editor designed for high-quality animations. It features an imperative API, adding elements procedurally rather than relying on keyframes, making it ideal for detailed animations.

Diffusion Studio

A video editing library rather than a framework with a visual interface. It’s lightweight, operates entirely on the client-side, and supports WebCodecs without relying on WebAssembly/ffmpeg. Ideal for integration into existing projects.

Contributing

Currently, version ^2.0.0 is invite-only. You can request access on our Discord if you're interested in contributing. The source code for version ^1.0.0 is available in this repository.

Current features

  • Video/Audio trimming and offsets
  • Layering
  • Splitting clips
  • Html & Image rendering
  • Relative units (e.g. 80% clip height)
  • Shapes (e.g., rectangles, circles)
  • Text with multiple styles
  • Audio Visualization
  • High Quality Captions
  • Silence Removal for audio
  • Web & Local Fonts
  • Custom Clips
  • Filters
  • Masks
  • Blending modes
  • Keyframe animations
    • Numbers, Text and Colors
    • Easing (ease in, ease out etc.)
    • Extrapolation 'clamp' | 'extend'
  • Realtime playback
  • Hardware accelerated encoding via WebCodecs
  • Dynamic render resolution and framerate

Background

This project was initiated in March 2023 with the mission of creating a “video processing toolkit for the era of AI.” As someone passionate about video editing for over a decade, the release of WebCodecs and WebGPU without feature flags in Chrome presented the perfect opportunity to build something new.

Traditional browser-based video editors rely on server-side rendering, requiring time-consuming uploads and downloads of large files. With WebCodecs, video processing can now be done directly in the browser, making it significantly faster and more efficient.

I’m excited to contribute to the next generation of video editing technology.

Here’s a more human-readable and clearer license notice for your README that explicitly states that individuals and companies can use the library for free as long as they don’t monetize their project. It also clarifies that projects can later become commercial as long as they obtain a proper license at that time.

License

This library is free to use under the Diffusion Studio Non-Commercial License, as long as your project is not monetized.

✅ You Can Use This Library for Free If:

  • You are an individual or a company and your project is not generating revenue (no sales, ads, donations beyond operational costs, or other forms of monetization).
  • Your project may become commercial in the future, as long as you obtain a commercial license before monetization.

💼 If Your Project Becomes Commercial:

  • If you decide to monetize your project (e.g., through sales, ads, premium features, or enterprise use), you must purchase a commercial license.
  • Visit our website to obtain a license when you’re ready to monetize.

📄 More Details:

  • See LICENSE for the Non-Commercial License.
  • See LICENSE_COMMERCIAL for the Commercial License terms.

For any questions, feel free to contact us.

Version History

v1.x (Released October 2024)

  • Fully open-source (MPL-2.0 license)
  • Relied on Pixi.js for rendering (resulting in a large library size)
  • WebGPU support
  • FFmpeg-compiled demuxer
  • Limited to short-form content

v2.x (Released February 1, 2025)

  • Source code access by invite only (Commercial & Non-Commercial license)
  • Removed Pixi.js, significantly reducing library size
  • Introduced a custom Canvas 2D renderer
  • Continued FFmpeg-based demuxing
  • Still limited to short-form content

v3.x (Released February 18, 2025)

  • Source code access by invite only (Commercial & Non-Commercial license)
  • Removed all FFmpeg dependencies
  • Retained Canvas 2D rendering
  • Introduced pure TypeScript-based muxers/demuxers
  • Added support for long-form content

v4.x (Estimated Release: July 2025)

  • Source code access by invite only (Commercial & Non-Commercial license)
  • Introducing a custom WebGL2 renderer

Package Sidebar

Install

npm i @diffusionstudio/core

Weekly Downloads

188

Version

3.0.0

License

SEE LICENSE IN LICENSE

Unpacked Size

850 kB

Total Files

7

Last publish

Collaborators

  • k9p5