ImageScript decodes, edits and encodes images in pure TypeScript: no WebAssembly, no native binaries, no dependencies. It runs in Node.js 22.13+, Deno, Bun, browsers and edge runtimes (Cloudflare Workers, Vercel's Edge Runtime, Deno Deploy), works with both import and require(), and ships with type definitions. Large images are encoded and decoded on several threads wherever the runtime supports workers.

npm install imagescript              # Node.js, Bun and bundlers
deno add jsr:@matmen/imagescript     # Deno

Without a bundler, import it from jsDelivr in the browser:

<script type="module">
  import { Image } from 'https://cdn.jsdelivr.net/npm/imagescript@3/+esm';

  const image = await Image.decode(await fetch('photo.jpg').then(r => r.arrayBuffer()));
  image.resize(256, Image.RESIZE_AUTO);
  const url = URL.createObjectURL(new Blob([await image.encode()], { type: 'image/png' }));
  document.body.append(Object.assign(document.createElement('img'), { src: url }));
</script>

Example

import { Image } from 'imagescript';
import { readFile, writeFile } from 'node:fs/promises';

const image = await Image.decode(await readFile('input.jpg'));
image.resize(256, Image.RESIZE_AUTO).roundCorners(16);
await writeFile('output.png', await image.encode());

Features

| Format | Decode | Encode | |---|---|---| | PNG | ✓ | ✓ | | JPEG | ✓ | ✓ | | WebP | ✓ | ✓ (lossless and lossy) | | AVIF | ✓ | ✓ (lossless and lossy) | | JPEG XL | ✓ | ✓ (lossless and lossy) | | GIF, APNG (animations) | ✓ | ✓ | | BMP, QOI, TGA, Netpbm | ✓ | ✓ | | TIFF, ICO/CUR, Radiance HDR | ✓ | |

Animations can be decoded from GIF, APNG, WebP and JPEG XL, and encoded as GIF, APNG or WebP, all at once or frame by frame. Embedded color profiles (Display P3, Adobe RGB, ...) are converted to sRGB when decoding, so images look the way browsers show them.

• Text rendering with TrueType, OpenType and WOFF fonts: all scripts, color emoji, variable fonts
• SVG rendering, including text (with fonts you pass or fonts embedded in the SVG)
• Resizing, cropping, rotating, trimming, rounded corners, ...
• Compositing with opacity and blend modes
• Filters and color adjustments: blur, sharpen, brightness, hueShift, ...

The documentation covers the full API. When upgrading from an older major version, see the changelog. bench/ compares ImageScript's speed and file sizes with Jimp, sharp and other libraries.

Credits

ImageScript builds on fflate, libjpeg, pdf.js, font-rs, libwebp, HarfBuzz, dav1d, libavif, libaom, jxl-oxide and libjxl. The TrueType hinting follows FreeType: portions of this software are copyright © 2026 The FreeType Project (www.freetype.org). All rights reserved. See THIRD_PARTY_NOTICES.md for the licenses.

Questions? Join the Discord server.