0.0.6 • Public • Published

webframes NPM Version Build Status Dependency Status

Animated images for the web.

Create full-color, SVG-based animated images for every browser.

WebFrames images:

  • can contain bitmap and/or vector artwork
  • can be lossy (bitmap only) or lossless
  • do not have the quality limitations of GIF
  • do not have the browser limitations of APNG, MNG, WebP or video
  • do not require JavaScript or a plugin
  • use technology already present in current web browsers

Import an image sequence in any of these formats: GIF, JPEG, PNG ... (soon SVG)

Visit the svachon.com/webframes website for more information and examples.

Getting Started

Node.js ~0.10 and graphicsmagick are required. There're two ways to use it:

Command-Line Usage

To install, type this at the command line:

npm install webframes -g

After that, check out webframes -? for available options. Typical usage might look like:

webframes --input sequence/ --output sequence.svg -Ccm

Programmatic API

To install, type this at the command line:

npm install webframes --save-dev

Typical usage might look like:

var webframes = require("webframes");
    contain: true,
    css: true,
    export: true,
    input: ["path/to/image1.png", "path/to/image2.png"],
    minify: true
}, function(error, result) {
    if (!error) console.log(result); //=> [Buffer]


  • try putting CSS at bottom to see if it prevents the need for --contain, which will add support for Safari
  • switch from smil2css to manually writing css, retain smil version for --css false
  • switch from gm to node-imagick
  • import SVG sequences
  • localize stored image paths so that tests pass on travis-ci
  • merge --input and --input-project

Release History

  • 0.0.5 options reorganized
  • 0.0.4 friendlier non-CLI option names
  • 0.0.3 removed node-imagemagick-native
  • 0.0.2 avoid race conditions on import/open
  • 0.0.1 initial release

Package Sidebar


npm i webframes

Weekly Downloads






Last publish


  • stevenvachon