ArabicToEnglishNamesTranslator 1.0.0

ArabicToEnglishNamesTranslator

A .NET 8 library for translating Arabic names to their English phonetic equivalents. It uses a built-in dictionary of over 2,500 common Arabic names for exact matches and falls back to character-by-character transliteration for names not in the dictionary.

Features

• Translates Arabic names to English using a dictionary of 2,500+ common names
• Falls back to phonetic transliteration for unknown names
• Normalizes Arabic diacritical marks (tashkeel) and character variations (e.g. أ / إ / آ → ا)
• Handles compound names, multi-word names, and names with prefixes such as عبد (Abd) and أبو (Abu)
• Supports Microsoft Dependency Injection out of the box

Installation

Install the package from NuGet:

.NET CLI

dotnet add package ArabicToEnglishNamesTranslator

Package Manager Console

Install-Package ArabicToEnglishNamesTranslator

PackageReference (in your .csproj)

<PackageReference Include="ArabicToEnglishNamesTranslator" Version="1.0.0" />

Usage

Without Dependency Injection

Instantiate ArabicNameTranslator directly:

using ArabicToEnglishNamesTranslator.Services;

var translator = new ArabicNameTranslator();

string english = translator.Translate("سامر علي");
Console.WriteLine(english); // Output: Samer Ali

string compound = translator.Translate("عبد القادر");
Console.WriteLine(compound); // Output: Abd Al-Qadir

With Dependency Injection (ASP.NET Core / Generic Host)

Register the translator in your service collection using the provided extension method:

using ArabicToEnglishNamesTranslator.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

// Register the translator as a singleton
builder.Services.AddArabicNameTranslator();

Then inject IArabicNameTranslator wherever you need it:

using ArabicToEnglishNamesTranslator.Abstractions;

public class MyService
{
    private readonly IArabicNameTranslator _translator;

    public MyService(IArabicNameTranslator translator)
    {
        _translator = translator;
    }

    public string GetEnglishName(string arabicName)
    {
        return _translator.Translate(arabicName);
    }
}

You can also resolve the translator directly from an IServiceProvider:

using ArabicToEnglishNamesTranslator.DependencyInjection;

var translator = serviceProvider.UseArabicNameTranslator();
string result = translator.Translate("أحمد محمد");

API Reference

IArabicNameTranslator

namespace ArabicToEnglishNamesTranslator.Abstractions
{
    public interface IArabicNameTranslator
    {
        /// <summary>
        /// Translates an Arabic name to its English phonetic equivalent.
        /// </summary>
        /// <param name="arabicName">The Arabic name to translate.</param>
        /// <returns>The English transliteration of the name.</returns>
        string Translate(string arabicName);
    }
}

ServiceCollectionExtensions

Examples

Requirements

• .NET 8.0 or later

License

This project is licensed under the terms included in the repository. See the LICENSE file for details.