📋 Features

• Tashkeel Removal: Easily remove Tashkeel from Arabic text.
• Tatweel Removal: Remove Tatweel character from Arabic phrases.
• Convert To Old Arabic: Transform Arabic text into old script.
• Convert To Old Arabic And Tashfeer Banned Words: Transform Arabic text into old script and replace Banned Arabic text with visually similar characters for encoding purposes. (Banned words are words that considered as hate speech in social media)
• Tashfeer: Replaces Arabic text with visually similar characters for encoding purposes.
• Tashfeer Banned Words: Replaces Banned Arabic text with visually similar characters for encoding purposes. (Banned words are words that considered as hate speech in social media)
• Remove Arabic Affixes: Removes predefined affixes (prefixes and suffixes) from an Arabic word if it starts or ends with those affixes.
• Word To Letters: Convert Arabic word to its pronounced letters.
• ... and more!

🚀 Getting Started

Arabic-Services was designed to work in both the browser and NodeJS applications.

Browser

We provide both ESM and UMD bundles for use in the browser. You can find it with the latest release files.

<script src="arabic-services.umd.js"></script>
<script>
	console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
	// Output: 'الخيل والليل والبيداء تعرفني'
</script>

NodeJS

Both CommonJS and ES Module libraries are provided.

npm install arabic-services

CommonJS:

const { ArabicServices } = require('arabic-services');
console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
// Output: 'الخيل والليل والبيداء تعرفني'

ES Module:

import { ArabicServices } from 'arabic-services';
console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
// Output: 'الخيل والليل والبيداء تعرفني'

💡 Contributing

Arabic Services is made publicly available to provide a well tested and well documented library for processing and transforming Arabic text to all developers. We accept feature contributions provided that they are properly documented and include the appropriate unit tests.

• 🚀 If you want to contribute to this project and make it better with new ideas, your pull request is very welcomed.
• 📝 If you find any issue just put it in the repository issue section, thank you.

🌟 Star this repository

Please ⭐️ this repo and share it with others

📜 License

This project is licensed under the GPL-3.0 License. See the LICENSE file for more details.

💬 Contact

• 📩 Email: [email protected]
• 🌎 Website