Embeddable Widget

Add translation to any website with a single script tag. The widget provides a floating translate button that expands into a full translator UI.

Quick Start

Add this to your HTML:

<script src="https://translator.trooply.in/static/widget.js"
        data-target-lang="hi"
        data-theme="dark">
</script>

Options

Attribute	Default	Description
`data-api-key`	—	Your API key (optional for basic use)
`data-target-lang`	hi	Default target language code
`data-source-lang`	auto	Source language ("auto" for detection)
`data-position`	bottom-right	bottom-right, bottom-left, top-right, top-left
`data-theme`	dark	dark or light
`data-button-text`	Translate	Custom FAB button text
`data-expanded`	false	Start expanded (true/false)

JavaScript API

// Open the widget programmatically
TroopolyWidget.open();

// Translate specific text
TroopolyWidget.translate("Hello world", "hi");

// Set languages
TroopolyWidget.setLanguages("en", "fr");

// Close
TroopolyWidget.close();

SDKs

Python SDK

pip install trooply-translate

from trooply_translate import TroopolyTranslator

tr = TroopolyTranslator(api_key="tr_live_...")
result = tr.translate("Hello", target="hi")
print(result.translated)

JavaScript SDK

npm install @trooply/translate

import { TroopolyTranslator } from '@trooply/translate';

const tr = new TroopolyTranslator({ apiKey: 'tr_live_...' });
const r = await tr.translate('Hello', { target: 'hi' });
console.log(r.translated);