bangla-to-banglish

Convert Bangla text to natural Banglish with smart, rule-based transliteration. Also includes a built-in slug generator for URLs, SEO, and CMS usage.

✨ Features

• Natural Banglish output (not robotic)
• Handles complex Bangla rules (যুক্তাক্ষর, কার, etc.)
• Generate SEO-friendly slugs
• Works in Node.js and browser (CDN)
• Lightweight and dependency-free

📦 Installation

npm install bangla-to-banglish

🚀 Usage

Node / ESM

import { banglaToBanglish, slugifyBanglish } from "bangla-to-banglish";

console.log(banglaToBanglish("আমরা সবাই পরশুদিন ঘুরতে যাব"));
// amra sobai porshudin ghurte zabo

console.log(slugifyBanglish("আমরা সবাই পরশুদিন ঘুরতে যাব"));
// amra-sobai-porshudin-ghurte-zabo

CommonJS

const { banglaToBanglish, slugifyBanglish } = require("bangla-to-banglish");

Browser (CDN)

<script src="https://cdn.jsdelivr.net/npm/[email protected]"></script>

<script>
  banglaToBanglish("বাংলায় গান গাই");
  // banglay gan gai

  slugifyBanglish("তোমার মুক্তকেশের পুঞ্জমেঘে লুকায় অশণি");
  // tomar-muktokesher-punjomeghe-lukay-oshoni
</script>

🔧 API

banglaToBanglish(text: string): string

Convert Bangla text into natural Banglish.

slugifyBanglish(text: string): string

Convert Bangla text into a URL-friendly slug.

🧪 Examples

| Bangla | Banglish | | --------- | ---------- | | আমরা সবাই | amra sobai | | পরশুদিন | porshudin | | আদম | adom | | পরীক্ষা | porikkha |

🎯 Use Cases

• Blog and CMS slug generation
• SEO-friendly URLs
• Search normalization
• Bangla content processing

💡 Why this exists

Most transliteration tools produce unnatural or overly literal output. This library focuses on how people actually write Banglish in real life.

🌐 Demo

Try it live: 👉 https://hasinhayder.github.io/bangla-to-banglish/

🔗 REST API Endpoint

You can also use the hosted REST API to convert Bangla text to Banglish without installing the package.

Endpoint

GET

https://banglish-api.tyropress.net/?text=তোমার%20জন্য%20প্রতীক্ষা%20তাই%20সময়ের%20সাথে%20আড়ি

POST

curl -X POST https://banglish-api.tyropress.net/ \
  -H "Content-Type: application/json" \
  -d '{"text": "তোমার জন্য প্রতীক্ষা তাই সময়ের সাথে আড়ি"}'

Response

{
  "input": "তোমার জন্য প্রতীক্ষা তাই সময়ের সাথে আড়ি",
  "banglish": "tomar jonno protikkha tai somoyer sathe ari",
  "slug": "tomar-jonno-protikkha-tai-somoyer-sathe-ari",
  "version": "1.1.9"
}

Parameters

| Parameter | Required | Description | | --------- | -------- | --------------------------------- | | text | Yes | Bangla text to convert to Banglish |

Response Fields

| Field | Description | | ---------- | ------------------------------------------ | | input | Original Bangla text | | banglish | Banglish transliteration | | slug | URL-friendly slug version | | version | Library version used by the API |

📄 License

MIT