مAlmurrib

Open source · AGPL-3.0 · Local-first

Almurrib المعرب

A local-first Arabic game localization toolkit.

Almurrib is an open-source localization system for translating games into Arabic. It handles the engineering around translation that plain text tools ignore: extraction, memory, QA, shaping, fonts, write-back, runtime overlays, and verification inside the real game.

Prototype / Active Development v0.1.0 Python ≥3.11 Windows desktop SQLite

Project snapshot

For technical reviewers: the whole project on one table. Every claim links to evidence below.

What is Almurrib?

Game localization is not only translation. A real workflow may need to:

    Almurrib attempts to unify these steps into one reproducible workflow — and to prove each step instead of assuming it.

    How it works

    Select a stage to see what it does. This mirrors the real pipeline in the repository.

    Architecture

    Verified against the actual source tree (src/almurrib).

    What actually works today

    Each row: the capability, how it was tested, and its current limitation.

    CapabilityStatusEvidenceLimitation

    Current status

    No percentages, no scores — status plus evidence.

    Unity

    Unity hides text in proprietary formats: TextAssets, typetree-serialized MonoBehaviours, UI components, bundles, managed assemblies, IL2CPP binaries. Each needs its own evidence — a parser accepting a version number is not support.

    CapabilityStatusEvidence

    Case study: Hollow Knight

    Independent engineering test on a user-owned copy. Not affiliated with or endorsed by Team Cherry.

    Timeline

      Observed in-game (real screenshots)

      Hollow Knight main menu in Arabic
      Main menu in Arabic (static patch).
      Hollow Knight options menu in Arabic
      Options menu in Arabic (full-run patch).
      Pause menu translated at runtime
      Pause menu translated at runtime on pristine assets.

      What failed (documented, not hidden)

      What does not work yet

      Roadmap (no dates)

      Engine support

      EngineStatusEvidence

      Technical deep dive

      Testing & quality

      A green unit suite proves component contracts. It does not prove every Unity game works — real-game evidence is listed separately above.

      Safety & security

      Worded factually: implemented protections, not certifications. Secrets live in local .env (git-ignored); logs redact keys.

      Open source

      Why Almurrib exists

      Arabic is spoken by hundreds of millions of people, yet translating a game into Arabic involves more than replacing English strings. Text extraction, rendering direction, glyph coverage, font support, placeholders, UI layout, and game-specific resource formats all become part of the problem. Almurrib is an attempt to make that engineering workflow accessible, reproducible, and increasingly automated.

      Links & references

      No project repository URL is published inside the repo, so none is listed. Tool links below are the third-party projects Almurrib interoperates with.