Lingva Translate

Alternative front-end for Google Translate, serving as a Free and Open Source translator with over a hundred languages available

How does it work?

Inspired by projects like NewPipe, Nitter, Invidious or Bibliogram, Lingva scrapes through GTranslate and retrieves the translation without using any Google-related service, preventing them from tracking.

For this purpose, Lingva is built, among others, with the following Open Source resources:

TypeScript, the JavaScript superset, as the language.
React as the main front-end framework.
Next.js as the complementary React framework, that provides Server-Side Rendering, Static Site Generation or serverless API endpoints.
ChakraUI for the in-component styling.
Jest, Testing Library & Cypress for unit, integration & E2E testing.
Apollo Server for handling the GraphQL endpoint.
Inkscape for designing both the logo and the banner.

Deployment

As Lingva is a Next.js project you can deploy your own instance anywhere Next is supported.

The only requirement is to set an environment variable called NEXT_PUBLIC_SITE_DOMAIN with the domain you're deploying the instance under. This is used for the canonical URL and the meta tags.

Optionally, there's another environment variable available called DEFAULT_DARK_THEME for selecting dark as the default page theme on the first load. The theme will be light by default unless this variable is set to true.

Docker

An official Docker image is available to ease the deployment using Compose, Kubernetes or similar technologies. Remember to also include the environment variables (simplified to site_domain and dark_theme) when running the container.

Docker Compose:

version: '3'

services:

  lingva:
    container_name: lingva
    image: thedaviddelta/lingva-translate:latest
    restart: unless-stopped
    environment:
      - site_domain=lingva.ml
      - dark_theme=false
      - default_source_lang=auto
      - default_target_lang=en
    ports:
      - 3000:3000

Docker Run

docker run -p 3000:3000 -e site_domain=lingva.ml -e dark_theme=false -e default_source_lang=auto -e default_target_lang=en thedaviddelta/lingva-translate:latest

Vercel

Another easy way is to use the Next.js creators' own platform, Vercel, where you can deploy it for free with the following button.

Instances

These are the currently known Lingva instances. Feel free to make a Pull Request including yours (please remember to add [skip ci] to the last commit).

Domain	Hosting	SSL Provider
lingva.ml (Official)	Vercel	Let's Encrypt
translate.alefvanoon.xyz	Vercel	Let's Encrypt
translate.igna.rocks	Vercel	Let's Encrypt
lingva.pussthecat.org	Hetzner	Let's Encrypt
translate.datatunnel.xyz	Hetzner	Let's Encrypt
lingva.esmailelbob.xyz	Kimsufi	Let's Encrypt
translate.plausibility.cloud	Hetzner	Let's Encrypt
lingva.lunar.icu	Lansol	Cloudflare

Public APIs

Nearly all the Lingva instances should supply a pair of public developer APIs: a RESTful one and a GraphQL one.

Note: both APIs return the translation audio as a Uint8Array (served as number[] in JSON and [Int] in GraphQL) with the contents of the audio buffer.

REST API v1

GET /api/v1/:source/:target/:query

{
    translation: string
}

GET /api/v1/audio/:lang/:query

{
    audio: number[]
}

GET /api/v1/languages/?:(source|target)

{
    languages: [
        {
            code: string,
            name: string
        }
    ]
}

In addition, every endpoint can return an error message with the following structure instead.

{
    error: string
}

GraphQL API

/api/graphql

query {
    translation(source: String target: String query: String!) {
        source: {
            lang: {
                code: String!
                name: String!
            }
            text: String!
            audio: [Int]!
        }
        target: {
            lang: {
                code: String!
                name: String!
            }
            text: String!
            audio: [Int]!
        }
    }
    audio(lang: String! query: String!) {
        lang: {
            code: String!
            name: String!
        }
        text: String!
        audio: [Int]!
    }
    languages(type: SOURCE|TARGET) {
        code: String!
        name: String!
    }
}

Related projects

SimplyTranslate - Very simple translation front-end with multi-engine support
LibreTranslate - FOSS translation service that uses the open Argos engine
Lentil for Android - Unofficial native client for Android that uses Lingva's public API
Arna Translate - Cross-platform client that uses Lingva's public API