README.md

Translateer

An unlimited free Google Translate API using Puppeteer.

This service is provided to the public for educational purposes only.

Demo and Usage

Try it out:

curl 'https://t.song.work/api?text=hello&from=en&to=zh-CN'

Visit https://t.song.work/ to see more usage.

This free demo can only serve 5 concurrent requests. It does not collect any data.

Self-Hosted

Option 1: Serve with Docker (Recommended)

1. Clone the repository

   git clone https://github.com/Songkeys/translateer.git

2. Run with Docker-Compose

   docker-compose up -d

Option 2: Serve Locally

1. Clone the repository

   git clone https://github.com/Songkeys/translateer.git

2. Install dependencies and build

   npm install
   npm run build

3. Run the server

   npm run start

Environment Variables

See the markdown table below:

Variable	Description	Default
PORT	Port to listen on	8999
PUPPETEER_WS_ENDPOINT	WebSocket endpoint of the Puppeteer instance	undefined or ws://browserless:3000 in docker
PAGE_COUNT	Number of browser pages to hold for speedup	5

Raycast Extension

An easy-to-use Raycast extension is provided. Check Songkeys/raycast-extension#Translateer for more details.