Note An UnRTF v0.19.3 Windows binary is included with this module which, due to its age, has several issues, such as the inability to convert RTF documents generated from 2007 onwards, and a bug in the noPictures option that still generates pictures. It is recommended that whatever application is using the node-unrtf module is run in a Linux environment using the latest available UnRTF binaries, which do not have these bugs.

Asynchronous node.js wrapper for the UnRTF RTF conversion program

UnRTF is a CLI program that allows for the manipulation and extraction of data from RTF documents such as converting RTF files to HTML or TXT.

The node-unrtf module provides an asynchronous node.js wrapper around said CLI program for easier use.

Install using npm:

npm i node-unrtf

For Linux and Mac users, you will need to download the unrtf binary separately.

An example of downloading the binary on a Debian system:

sudo apt-get install unrtf

For macOS, the binary can be installed with Homebrew:

brew install unrtf

Please refer to the JSDoc comments in the source code or the generated type definitions for information on the available options.

Example of an async await call to convert an RTF file to HTML in an ESM environment:

import { UnRTF } from "node-unrtf";

const file = "test_document.rtf";
const unRtf = new UnRTF();
const options = {
	outputHtml: true,
};

const res = await unRtf.convert(file, options);
console.log(res);

Example of calling unRTF.convert with a promise chain in a CJS environment:

const { UnRTF } = require("node-unrtf");

const file = "test_document.rtf";
const unRtf = new UnRTF("/usr/bin");
const options = {
	outputHtml: true,
};

unRTF
	.convert(file, options)
	.then((res) => {
		console.log(res);
		return res;
	})
	.catch((err) => {
		console.error(err);
		throw err;
	});

Contributions are welcome, and any help is greatly appreciated!

See the contributing guide for details on how to get started. Please adhere to this project's Code of Conduct when contributing.

node-unrtf is licensed under the MIT license.