Skip to content

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

Notifications You must be signed in to change notification settings

tderflinger/libretranslate-ts

Repository files navigation

logo

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

About

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

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published