Claude RTL Responder

إضافة ذكية لدعم اللغة العربية في Claude.ai
Smart Arabic RTL Support for Claude.ai

Features  •  Screenshots  •  Installation  •  Usage  •  Developer

---

📖 Introduction / المقدمة

Claude RTL Responder is a comprehensive browser extension (Firefox & Chrome) that enhances the Claude.ai experience for Arabic-speaking users. It automatically detects Arabic text and applies the correct RTL direction, while preserving LTR for code blocks, technical content, and English terms within Arabic contexts. Built on the browser's native Unicode Bidirectional Algorithm with intelligent mixed-content handling, the extension offers full customization of font size, line spacing, and visual indicators through a dedicated settings page.

Claude RTL Responder إضافة متصفح متكاملة (Firefox و Chrome) تُحسِّن تجربة استخدام Claude.ai للمستخدمين الناطقين بالعربية. تكتشف الأداة النصوص العربية تلقائياً وتُطبِّق اتجاه RTL الصحيح، مع الحفاظ على اتجاه LTR لكتل الكود والمحتوى التقني والمصطلحات الإنجليزية داخل السياق العربي. تعتمد الإضافة على خوارزمية Unicode ثنائية الاتجاه المدمجة في المتصفح مع معالجة ذكية للمحتوى المختلط، وتوفر تخصيصاً كاملاً لحجم الخط، وتباعد الأسطر، والمؤشرات البصرية عبر صفحة إعدادات مخصصة.

---

📸 Screenshots / لقطات الشاشة

🚀 Extension in Action / الإضافة أثناء العمل

🔧 Loading Extension / تحميل الإضافة	📦 Extension Installed / الإضافة مُثبَّتة
⚙️ Advanced Settings Page / صفحة الإعدادات المتقدمة

---

🎬 Demo Video / فيديو توضيحي

فيديو توضيحي شامل — يعرض كيفية استخدام الإضافة لتحسين تجربة Claude.ai بالعربية Full demo video — showcasing how to use the extension to enhance Claude.ai experience in Arabic

🎥 Watch on YouTube

---

📑 Table of Contents / جدول المحتويات

Section Link Features ✨ Features Screenshots 📸 Screenshots Installation 📥 Installation Usage 🚀 Usage Technical Details 🔧 Technical Details Project Structure 📁 Project Structure Privacy 🔒 Privacy Compatibility 🌐 Compatibility Contributing 🤝 Contributing Changelog 📋 Changelog License 📄 License Developer 👨‍💻 Developer

القسم الرابط المميزات ✨ المميزات لقطات الشاشة 📸 لقطات الشاشة التثبيت 📥 التثبيت طريقة الاستخدام 🚀 طريقة الاستخدام التفاصيل التقنية 🔧 التفاصيل التقنية هيكل المشروع 📁 هيكل المشروع الخصوصية 🔒 الخصوصية التوافق 🌐 التوافق المساهمة 🤝 المساهمة سجل التغييرات 📋 سجل التغييرات الترخيص 📄 الترخيص المطور 👨‍💻 المطور

---

✨ Features / المميزات

🔄 Automatic RTL Detection كشف RTL تلقائي Automatically detects Arabic text using Unicode BiDi algorithm and first-strong character analysis. No manual intervention needed. يكتشف النصوص العربية تلقائياً باستخدام خوارزمية Unicode ثنائية الاتجاه وتحليل الحرف الأول القوي.	🔀 Mixed-Content Handling معالجة المحتوى المختلط Intelligently handles Arabic text with embedded English terms, code snippets, and technical content. يتعامل بذكاء مع النصوص العربية المتضمنة لمصطلحات إنجليزية ومقتطفات برمجية.
💻 Code Block Preservation الحفاظ على كتل الكود LTR Code blocks, inline code, and technical content always remain left-to-right for proper readability. تبقى كتل الكود والمحتوى التقني بالاتجاه الأيسر-لليمين دائماً للقراءة السليمة.	🔤 Font Size Customization تخصيص حجم الخط Three font size options: Small, Medium, Large. Changes apply instantly to Claude.ai responses. ثلاثة خيارات لحجم الخط: صغير، متوسط، كبير. التغييرات تُطبَّق فوراً.
📏 Line Spacing Customization تخصيص تباعد الأسطر Three spacing options: Compact, Normal, Relaxed. Improves reading comfort for longer responses. ثلاثة خيارات للتباعد: مُدمج، عادي، مريح. يُحسِّن راحة القراءة للردود الطويلة.	🎯 Optional RTL Indicator مؤشر RTL اختياري Visual dot indicator on RTL-applied elements with customizable color picker. مؤشر نقطة بصري على العناصر المُطبَّق عليها RTL مع منتقي ألوان.
⌨️ Keyboard Shortcuts اختصارات لوحة المفاتيح Alt+G toggles Arabic/English mode. Alt+O opens the popup. Alt+G لتبديل الوضع. Alt+O لفتح النافذة.	🌙 Dark Mode Support دعم الوضع الداكن Full dark mode support across popup and options page, following system preferences. دعم كامل للوضع الداكن في النافذة وصفحة الإعدادات حسب تفضيلات النظام.
🌐 Bilingual UI واجهة ثنائية اللغة Complete Arabic and English interface. Switch languages instantly in the options page. واجهة كاملة بالعربية والإنجليزية. تبديل فوري للغة في صفحة الإعدادات.	💾 Persistent Settings إعدادات محفوظة All preferences saved locally and persist across browser sessions. جميع التفضيلات محفوظة محلياً وتستمر عبر جلسات المتصفح.

---

📥 Installation / التثبيت

A. From Firefox Add-ons Store (Recommended) / من متجر Firefox (موصى به)

🔜 قريباً على متجر إضافات Firefox / Coming soon to Firefox Add-ons Store

B. From GitHub (Developer Edition) / من GitHub (نسخة المطور)

Firefox

Installation Steps: Download claude-rtl-responder-firefox-v*.zip from Releases Extract the ZIP to a folder Open Firefox → about:debugging#/runtime/this-firefox Click "Load Temporary Add-on..." Select manifest.json from extracted folder Done!

خطوات التثبيت: حمِّل claude-rtl-responder-firefox-v*.zip من الإصدارات فُكَّ ضغط الملف في مجلد افتح Firefox ← about:debugging#/runtime/this-firefox انقر على "Load Temporary Add-on..." اختر ملف manifest.json من المجلد تم!

Chrome / Edge

Installation Steps: Download claude-rtl-responder-chrome-v*.zip from Releases Extract the ZIP to a folder Open Chrome → chrome://extensions Enable "Developer mode" (top right toggle) Click "Load unpacked" Select the extracted folder Done!

خطوات التثبيت: حمِّل claude-rtl-responder-chrome-v*.zip من الإصدارات فُكَّ ضغط الملف في مجلد افتح Chrome ← chrome://extensions فعّل "Developer mode" (الزر في أعلى اليمين) انقر على "Load unpacked" اختر المجلد المستخرج تم!

⚠️ Note: Temporary/unpacked extensions are removed when the browser restarts. For permanent installation, use the browser store versions (coming soon).

ملاحظة: الإضافات المؤقتة تُحذف عند إعادة تشغيل المتصفح. للتثبيت الدائم، استخدم نسخ المتاجر (قريباً).

---

🚀 Usage / طريقة الاستخدام

A. Mode Switching / تبديل الوضع

Using the Popup: Click the extension icon in the toolbar Choose عربي (Arabic) or English mode Changes apply instantly to claude.ai

باستخدام النافذة: انقر على أيقونة الإضافة في شريط الأدوات اختر وضع عربي أو English التغييرات تُطبَّق فوراً على claude.ai

Keyboard Shortcut: Press Alt+G to toggle between Arabic and English modes without opening the popup.

اختصار لوحة المفاتيح: اضغط Alt+G للتبديل بين الوضعين بدون فتح النافذة.

B. Opening Settings / فتح الإعدادات

• From Popup: Click "إعدادات متقدمة / Advanced Settings" button
• Keyboard: Press Alt+O to open the popup

• من النافذة: انقر على زر "إعدادات متقدمة / Advanced Settings"
• لوحة المفاتيح: اضغط Alt+O لفتح النافذة

C. Customization Options / خيارات التخصيص

Setting	Options	الإعداد
Font Size	Small / Medium / Large	حجم الخط
Line Spacing	Compact / Normal / Relaxed	تباعد الأسطر
RTL Indicator	Toggle + Color Picker	مؤشر RTL

D. Keyboard Shortcuts Reference / مرجع الاختصارات

Shortcut	Action	الإجراء
Alt+G	Toggle Arabic/English mode	تبديل الوضع عربي/إنجليزي
Alt+O	Open extension popup	فتح نافذة الإضافة

---

🔧 Technical Details / التفاصيل التقنية

📋 Click to expand technical specifications

Specification	Value
Manifest Version	MV3 (Manifest V3)
Firefox Minimum	109+
Detection Algorithm	Unicode BiDi + First-Strong Character Analysis
Performance	RAF-debounced MutationObserver, WeakSet tracking
Storage	browser.storage.local (sync-compatible)

Arabic Unicode Ranges Covered

U+0600–U+06FF    Arabic
U+0750–U+077F    Arabic Supplement
U+08A0–U+08FF    Arabic Extended-A
U+FB50–U+FDFF    Arabic Presentation Forms-A
U+FE70–U+FEFF    Arabic Presentation Forms-B

Architecture

The extension uses isolated modules for maintainability:

• detector.js — Arabic text detection with Unicode analysis
• observer.js — MutationObserver for dynamic content
• content.js — Main content script orchestration
• background.js — Service worker for keyboard shortcuts
• popup/ — Mode switcher UI
• options/ — Full settings page with live preview

---

📁 Project Structure / هيكل المشروع

📂 Click to expand file tree

claude-rtl-responder/
├── src/                          # Extension source files
│   ├── manifest.firefox.json     # Firefox manifest (MV3)
│   ├── manifest.chrome.json      # Chrome manifest (MV3)
│   ├── background.js             # Service worker
│   ├── common/
│   │   └── browser-polyfill.js   # Cross-browser API polyfill
│   ├── content/
│   │   ├── detector.js           # Arabic text detection
│   │   ├── observer.js           # DOM mutation observer
│   │   └── content.js            # Main content script
│   ├── popup/
│   │   ├── popup.html            # Popup UI
│   │   ├── popup.css             # Popup styles
│   │   └── popup.js              # Popup logic
│   ├── options/
│   │   ├── options.html          # Settings page
│   │   ├── options.css           # Settings styles
│   │   └── options.js            # Settings logic
│   ├── styles/
│   │   └── rtl.css               # RTL injection styles
│   ├── icons/
│   │   ├── icon-48.png           # Toolbar icon
│   │   └── icon-96.png           # High-DPI icon
│   └── INSTALL.txt               # Quick installation guide
├── scripts/
│   └── build.js                  # Cross-browser build script
├── dist/                         # Build output (gitignored)
├── docs/
│   └── screenshots/              # README screenshots
├── package.json                  # Build configuration
├── README.md                     # This file
├── LICENSE                       # MIT License
├── CHANGELOG.md                  # Version history
├── CONTRIBUTING.md               # Contribution guidelines
├── SECURITY.md                   # Security policy
└── .gitignore                    # Git ignore rules

---

🔒 Privacy / الخصوصية

English ✅ All data stored locally — uses browser.storage.local ✅ No analytics or tracking — zero telemetry ✅ No external network requests — everything runs offline ✅ No user data transmitted — your conversations stay private ✅ Open source — full code available for review

العربية ✅ جميع البيانات محفوظة محلياً — يستخدم browser.storage.local ✅ لا تحليلات أو تتبع — صفر قياس عن بُعد ✅ لا طلبات شبكة خارجية — كل شيء يعمل بدون اتصال ✅ لا بيانات مستخدم تُرسَل — محادثاتك تبقى خاصة ✅ مفتوح المصدر — الكود الكامل متاح للمراجعة

---

🌐 Compatibility / التوافق

Browser / Platform	Support	الدعم
Firefox 109+	✅ Fully Supported	مدعوم بالكامل
Firefox Developer Edition	✅ Supported	مدعوم
Firefox ESR (109+)	✅ Supported	مدعوم
Chrome 88+	✅ Fully Supported	مدعوم بالكامل
Edge (Chromium)	✅ Supported	مدعوم
Safari	❌ Not Supported	غير مدعوم
claude.ai	✅ Target Site	الموقع المستهدف
Other websites	❌ Not Affected	غير متأثرة

💡 Both Firefox and Chrome/Edge are fully supported with Manifest V3.

يدعم المتصفحان Firefox و Chrome/Edge بالكامل مع Manifest V3.

---

🤝 Contributing / المساهمة

Contributions are welcome! Here's how you can help: 🐛 Report bugs — open an issue 💡 Suggest features — share your ideas 🔧 Submit PRs — code contributions reviewed See CONTRIBUTING.md for detailed guidelines.

المساهمات مرحب بها! إليك كيف يمكنك المساعدة: 🐛 الإبلاغ عن الأخطاء — افتح issue 💡 اقتراح ميزات — شارك أفكارك 🔧 إرسال PRs — مساهمات الكود تُراجَع راجع CONTRIBUTING.md للإرشادات التفصيلية.

---

📋 Changelog / سجل التغييرات

v0.1.0 — Initial Release / الإصدار الأول

• ✨ Automatic Arabic RTL detection
• ✨ Mixed-content intelligent handling
• ✨ Code block LTR preservation
• ✨ Font size customization (3 options)
• ✨ Line spacing customization (3 options)
• ✨ Optional RTL indicator with color picker
• ✨ Keyboard shortcuts (Alt+G, Alt+O)
• ✨ Dark mode support
• ✨ Bilingual UI (Arabic/English)
• ✨ Persistent settings storage

See CHANGELOG.md for full version history.

---

📄 License / الترخيص

MIT License

Copyright © 2026 MONER INTELLIGENCE SYSTEMS

See LICENSE for the full license text.

---

👨‍💻 Developer / المطور

M.O.N.E.R

Application Developer & AI Specialist
مطوّر تطبيقات ومتخصص في الذكاء الاصطناعي

MONER INTELLIGENCE SYSTEMS

Other Projects / مشاريع أخرى

Project	Description	الوصف
Ghost Protocol Helpdesk	Enterprise incident management system	نظام إدارة حوادث للمؤسسات
DeadBYTE	Smart system analysis & cleanup for Windows	أداة تحليل وتنظيف ذكية لـ Windows
MyWorld Password Manager	Secure local password manager	مدير كلمات مرور محلي آمن
Professional Label Design Print	Professional label design & printing	تصميم وطباعة ملصقات احترافية

---

🔨 Building from Source / البناء من المصدر

# Clone the repository git clone https://github.com/moner-dev/Claude-RTL-Responder.git cd Claude-RTL-Responder # Build for Firefox node scripts/build.js firefox # Build for Chrome node scripts/build.js chrome # Build both node scripts/build.js all Output: dist/firefox/ — Unpacked Firefox extension dist/chrome/ — Unpacked Chrome extension dist/claude-rtl-responder-firefox-v*.zip dist/claude-rtl-responder-chrome-v*.zip

# استنساخ المستودع git clone https://github.com/moner-dev/Claude-RTL-Responder.git cd Claude-RTL-Responder # البناء لـ Firefox node scripts/build.js firefox # البناء لـ Chrome node scripts/build.js chrome # بناء الاثنين node scripts/build.js all المخرجات: dist/firefox/ — إضافة Firefox غير مضغوطة dist/chrome/ — إضافة Chrome غير مضغوطة dist/claude-rtl-responder-firefox-v*.zip dist/claude-rtl-responder-chrome-v*.zip

Requirements: Node.js 14+ | المتطلبات: Node.js 14+

---

🙏 Acknowledgments / شكر وتقدير

Anthropic — for creating Claude.ai Mozilla — for the Firefox WebExtensions platform Open Source Community — for inspiration and tools

Anthropic — لإنشاء Claude.ai Mozilla — لمنصة إضافات Firefox مجتمع المصادر المفتوحة — للإلهام والأدوات

---

Claude RTL Responder v0.1.0

© 2026 MONER INTELLIGENCE SYSTEMS

Crafted with precision and passion for Arabic-speaking developers