ttf2woff2

Convert TTF files to WOFF2 ones.

This is a NodeJS wrapper for the Google WOFF2 project. If the C++ wrapper compilation fail, it fallbacks to an Emscripten build.

Usage

CLI

Install ttf2woff2 globally, then:

cat font.ttf | ttf2woff2 > font.woff2

On Windows without cat, use (in PowerShell):

Start-Process -NoNewWindow -Wait ttf2woff2.cmd -RedirectStandardInput font.ttf -RedirectStandardOutput font.woff2
# OR
start-process -nnw -wait ttf2woff2.cmd -rsi font.ttf -rso font.woff2

API

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

const input = await readFile('font.ttf');

await writeFile('font.woff2', ttf2woff2(input));

Development

To build the binary, clone the repository and run the following:

## Setup (works for Ubuntu/Linux, may be different on other OS)
apt-get install make g++

## Actual build
npm i
npm run configure
npm run make

To build the Emscripten fallback, install Emscripten and run:

npm run emcc

Finally the build can be tested:

npm run build
npm t

Contributing

Feel free to push your code if you agree with publishing under the MIT license.

Authors

• Nicolas Froidure
• Anders Kaseorg

License

MIT

7.0.0 (2025-05-22)

Bug Fixes

• ci: add Node 22 and 23 to test matrix (d335554)
• core: fix TS errors (7535aa1)

6.0.1 (2024-07-20)

Bug Fixes

• ci: fix CI runs (4650b51)
• core: fix native bindings import (420930f)

6.0.0 (2024-07-20)

chore

• dependencies: update dependencies (4319d41)

Features

• core: better choice between builds (ff54055), closes #22 #46

BREAKING CHANGES

• dependencies: Requires Node20+, use ESM, provide TypeScript types

5.0.0 (2022-12-06)

Chore

• bundle: Update Emscripten builds
• ci: Add Node 19 to test matrix
• dependencies: Update dependencies (jest) and remove unsued dependencies (mocha, mocha-lcov-reporter)

BREAKING CHANGES

• dependencies: Drop Node 12 support

4.0.5 (2022-04-23)

Chore

• bundle: Update Emscripten builds
• ci: Add Node 18 to test matrix
• dependencies: Update dependencies (node-gyp, eslint, prettier) and remove unsued dependencies (babel-eslint, @babel/register)
• readme: Add PowerShell use case (#72)

4.0.4 (2021-05-29)

Chore

• dependencies: Update jest, mocha, node-gyp (#71)

4.0.3 (2021-05-29)

Bug Fixes

• build: support Node 16 (b8a8986)

4.0.2 (2021-03-15)

Bug Fixes

• docs: fix the readme (acb62c5)

4.0.1 (2020-12-22)

Bug Fixes

• bundle: add necessary files to the bundle (fc9bb76)

4.0.0 (2020-12-22)

Chore

• dependencies: update dependencies (0657e8d)

BREAKING CHANGES

• dependencies: Requiring Node12 to work