Skip to content

kenshln47/TRANSLATION-BRIDGE

Repository files navigation

Translation Bridge Banner



⚡ Translation Bridge — جسر الترجمة

ترجم بسرعة البرق وأنت تلعب


GitHub release License Python Platform


Stars Forks Issues Last Commit


اكتب بلغتك → يوصل بأي لغة ثانية. بدون لاق، بدون تعقيد.

🇸🇦 🇬🇧 🇹🇷 🇪🇸 🇫🇷 🇧🇷 🇷🇺 🇩🇪 🇰🇷 🇯🇵 🇮🇳 🇨🇳 +المزيد


📥 تحميل مجاني · 🌐 الموقع · 🐛 بلّغ عن مشكلة




🎯 الفكرة

تطبيق ويندوز يترجم لك وأنت تلعب. تضغط اختصار، تكتب بلغتك، يرسل بلغة الشخص الثاني. يدعم 14+ لغة ويفهم العامية والسلانق. مو ترجمة قوقل حرفية.


✨ المميزات

⚡ Zero-Lag Hotkeys

اختصارات مربوطة مباشرة بـ Windows API. 0% CPU وبدون أي drop بالفريمات

🌍 14+ لغة

اختار أي لغة مصدر وأي لغة هدف. عربي، إنجليزي، تركي، كوري، ياباني وغيرها

🧠 AI يفهم السياق

يستخدم Grok 4.1 Fast. يفهم العامية والجنس من تصريف الفعل

🎮 Game Presets

قواميس جاهزة لـ GTA RP، Valorant، FIFA، LoL، Fortnite وغيرها

👻 Ghost UX

نافذة الإدخال تدمر نفسها فوراً. ترجع للعبة بأجزاء من الثانية

🤬 4 أنماط ترجمة

Gamer عادي • Chill مريح • Formal رسمي • Rage Mode 🔥


🔧 كيف يشتغل؟

الخطوة الوصف
1️⃣ اضغط Ctrl+Shift+T تطلع نافذة صغيرة شفافة فوق اللعبة
⬇️
2️⃣ اكتب بلغتك عربي، تركي، كوري — أي لغة تبيها
⬇️
3️⃣ اضغط Enter يترجم ويلصق ويرسل بالشات تلقائياً ⚡

📊 هيكلية التطبيق

graph TD
    A["إدخال المستخدم"] -->|"اختصار لوحة مفاتيح (Native OS)"| B["نافذة الإدخال السريعة"]
    B -->|"نص خام"| C["محرك الترجمة (Background Thread)"]
    
    subgraph معالجة البيانات المحلية
    D["config.json"] -->|"تحميل في الذاكرة"| E["مدير الإعدادات"]
    E -->|"الاختيار النشط"| F["قاموس اللعبة (Game Preset)"]
    E -->|"الاختيار النشط"| G["شخصية الذكاء الاصطناعي (AI Tone)"]
    E -->|"ملفات نصية مستوردة"| H["قواعد المستخدم المخصصة"]
    end
    
    F --> C
    G --> C
    H --> C
    
    C -->|"حزمة البيانات + النص"| I["واجهة OpenRouter: نموذج Grok 4.1 Fast"]
    I -->|"استجابة غير متزامنة"| J["مدير الحافظة (Clipboard)"]
    J -->|"نظام الحقن الشبح (Ghost UX)"| K["واجهة اللعبة النشطة"]
Loading

🎮 الألعاب المدعومة

اللعبة المصطلحات المتخصصة
🚗 GTA V RP VDM, RDM, NVL, OOC, كود 10
🔫 Valorant / CS2 Peek, Rotate, Eco, Flash, Clutch
EA FC (FIFA) Through ball, Finesse, SBC, TOTS
🧙 LoL / Dota 2 Gank, Dive, Feed, Baron, FF
🦸 Overwatch / Apex Ult, Crack, Knock, Third-party
🏗️ Fortnite Box, Crank, Edit, Storm, Rotate
⛏️ Minecraft / Roblox Grief, Raid, Enchant, Obby

📁 بنية المشروع

TRANSLATION-BRIDGE/
├── 📄 chat_bridge.py              ← نقطة الدخول
├── 📦 chat_bridge/                ← الحزمة الرئيسية
│   ├── __main__.py               ← Entry + Logging + Single Instance
│   ├── app.py                    ← التطبيق الرئيسي (UI + Logic)
│   ├── translator.py             ← محرك الترجمة (OpenRouter API)
│   ├── config.py                 ← إدارة الإعدادات + المفاتيح
│   ├── hotkey.py                 ← اختصارات Win32 الأصلية
│   ├── tray.py                   ← System Tray
│   ├── constants.py              ← الثوابت والـ Prompts
│   └── 🎨 ui/
│       ├── theme.py              ← ألوان التصميم
│       ├── setup_screen.py       ← شاشة الإعداد الأولي
│       ├── settings.py           ← نافذة الإعدادات
│       ├── toast.py              ← إشعارات Toast
│       └── history.py            ← سجل الترجمات
├── 🖼️ assets/                     ← الأصول (logo, icon, banner)
├── 🌐 docs/                       ← صفحة الموقع (GitHub Pages)
├── 📋 requirements.txt
├── 🔨 build.bat                   ← بناء ملف EXE
└── 📜 LICENSE                     ← MIT License

🚀 التثبيت والتشغيل

الطريقة السريعة (EXE)

حمّل الملف التنفيذي من صفحة التحميل وشغّله مباشرة. ما يحتاج تثبيت.

من الكود المصدري

# 1. استنسخ المشروع
git clone https://github.com/kenshln47/TRANSLATION-BRIDGE.git
cd TRANSLATION-BRIDGE

# 2. ثبّت المتطلبات
pip install -r requirements.txt

# 3. شغّل
python chat_bridge.py

بناء الـ EXE بنفسك

.\build.bat
# الملف النهائي: dist/Translation Bridge.exe

⚙️ المتطلبات

المتطلب التفاصيل
نظام التشغيل Windows 10 / 11
Python 3.10+ (للتشغيل من الكود)
API Key OpenRouter (فيه باقة مجانية)

🔒 الخصوصية والأمان

  • 🔑 مفاتيح الـ API تُحفظ محلياً في %APPDATA%/TranslationBridge/
  • 🚫 لا تتبع، لا تحليلات، لا بيانات تُرسل لأي طرف ثالث
  • 📡 النصوص تروح مباشرة للـ API وما تنحفظ
  • 🔓 مفتوح المصدر بالكامل

🤝 تبي تساعد؟؟؟

لو عندك فكرة أو لقيت بق، افتح Issue أو سوي Pull Request.


📄 الرخصة

MIT License



Star the repo if you find it useful

About

Real-time gaming translator — type in your language, it sends in theirs. 14+ languages, zero lag, built for gamers.

Topics

Resources

License

Stars

Watchers

Forks

Contributors