PHPackages                             yafet/amharic-transliteration - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. yafet/amharic-transliteration

ActiveLibrary[Utility & Helpers](/categories/utility)

yafet/amharic-transliteration
=============================

A Laravel package for Amharic to English and English to Amharic transliteration.

v1.0.2(4w ago)0133↑150%MITPHPPHP ^8.2

Since May 11Pushed 4w agoCompare

[ Source](https://github.com/yafetphilipos/amharic-transliteration)[ Packagist](https://packagist.org/packages/yafet/amharic-transliteration)[ RSS](/packages/yafet-amharic-transliteration/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (2)Versions (4)Used By (0)

Amharic Transliteration Laravel Package
=======================================

[](#amharic-transliteration-laravel-package)

[![Latest Version on Packagist](https://camo.githubusercontent.com/34b198fbac07233308fdf352fbeaa353ca4248365a01715f66286fad9a7f6e17/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f79616665742f616d68617269632d7472616e736c697465726174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/yafet/amharic-transliteration)[![Total Downloads](https://camo.githubusercontent.com/1dc01882bdee994941b5a1db97b16306800534214bb01c900571f2162d0d9926/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f79616665742f616d68617269632d7472616e736c697465726174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/yafet/amharic-transliteration)

A Laravel package for dual-way Amharic to English transliteration. Effortlessly convert Amharic script to English phonetics and back.

Features
--------

[](#features)

- **Amharic to English**: Converts Amharic characters to English with smart suffix handling (removes 'i' at word endings).
- **English to Amharic**: Reverse conversion using the longest-match algorithm for complex phonetics (e.g., `she`, `gn´e`).
- **Laravel Integration**: Facades, Traits, and Service Providers included.
- **Customizable**: Publish and modify the letter mapping as needed.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require yafet/amharic-transliteration
```

For local development or if the package is in a private folder:

```
"repositories": [
    {
        "type": "path",
        "url": "./packages/amharic-transliteration"
    }
],
"require": {
    "yafet/amharic-transliteration": "*"
}
```

Usage
-----

[](#usage)

### 1. Using the Facade

[](#1-using-the-facade)

The simplest way to use the package is via the `Amharic` facade.

```
use Yafet\AmharicTransliteration\Facades\Amharic;

// Amharic to English
$english = Amharic::transliterate("ላም"); // Result: "lam"

// English to Amharic
$amharic = Amharic::reverseTransliterate("lam"); // Result: "ላም"
```

### 2. Using the Trait in Models

[](#2-using-the-trait-in-models)

Add the `Transliteratable` trait to your Eloquent models to easily convert attributes.

```
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Yafet\AmharicTransliteration\Traits\Transliteratable;

class Post extends Model
{
    use Transliteratable;

    protected $fillable = ['title_am'];

    // Get English transliteration of the title
    public function getTitleEnAttribute()
    {
        return $this->transliterateAttribute('title_am');
    }
}
```

### 3. Manual Service Injection

[](#3-manual-service-injection)

```
use Yafet\AmharicTransliteration\TransliterationService;

public function __construct(TransliterationService $service)
{
    $this->service = $service;
}

public function convert()
{
    return $this->service->transliterate("ሀሎ");
}
```

Configuration
-------------

[](#configuration)

If you want to modify the character mapping, you can publish the resources:

```
php artisan vendor:publish --tag="amharic-transliteration-resources"
```

The mapping will be available at `resources/json/amharicLetters.json`.

Development & Testing
-------------------------

[](#development--testing)

To run tests, ensure you have dev dependencies installed:

```
composer install
vendor/bin/phpunit
```

### Running Tests via PHP script

[](#running-tests-via-php-script)

A lightweight test script is provided in the root:

```
php test.php
```

Changelog
---------

[](#changelog)

### v1.0.0

[](#v100)

- Initial release.
- Support for Amharic to English transliteration.
- Support for English to Amharic (reverse) transliteration.
- Laravel Facade and Trait support.
- PHPUnit test suite.

Credits
-------

[](#credits)

- [Yafet Philipos](mailto:yafetbabi@gmail.com)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance94

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

29d ago

PHP version history (2 changes)v1.0.0PHP ^8.1

v1.0.2PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/8c143996e6996f282bcfc2fbdb059060258f8613b6c761daa9359f290698fad1?d=identicon)[yafetphilipos](/maintainers/yafetphilipos)

---

Top Contributors

[![yafetphilipos](https://avatars.githubusercontent.com/u/37532562?v=4)](https://github.com/yafetphilipos "yafetphilipos (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/yafet-amharic-transliteration/health.svg)

```
[![Health](https://phpackages.com/badges/yafet-amharic-transliteration/health.svg)](https://phpackages.com/packages/yafet-amharic-transliteration)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pipeline

The Illuminate Pipeline package.

9348.3M264](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10533.5M984](/packages/illuminate-pagination)[illuminate/redis

The Illuminate Redis package.

8314.4M356](/packages/illuminate-redis)[spatie/laravel-export

Create a static site bundle from a Laravel app

670139.5k6](/packages/spatie-laravel-export)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)