tderflinger / libretranslate-ts

TypeScript library for the LibreTranslate API. With TypeScript type definitions. Can also be used with JavaScript.

libretranslate-ts

A simple and easy to use TypeScript library for LibreTranslate. Can also be used with JavaScript.

LibreTranslate is a free and open source translation application that also offers an API. This library connects to the API.

If you are looking for instructions on how to deploy your own LibreTranslate instance you can find them here.

Installation

npm i libretranslate-ts --save

Example Usage

In this example, I connect to a LibreTranslate instance on localhost:5000. When your instance is different, you need to change this.

app.mjs

import { libreTranslate } from "libretranslate-ts";

const LIBRETRANSLATE_ENDPOINT = "http://localhost:5000";

libreTranslate.setApiEndpoint(LIBRETRANSLATE_ENDPOINT);
libreTranslate.setApiKey("");
const resultDetect = await libreTranslate.detect("Hola, cómo estás?");
console.log("Detected language: ", resultDetect);
const result = await libreTranslate.translate(
    "There is a tiger in the house nearby the barn.",
    "en",
    "es"
);

if (result?.status >= 400) {
    console.log("Status: ", result?.status);
    console.error("Error: ", result?.error);
    process.exit(1);
}

console.log(result?.translatedText);

Bugs

Please file any issues and enhancement ideas under the "Issues" tab.

Roadmap

• Add possibility to translate whole files

License

MIT License