ChatGPT/Codex Smart RTL & UI Patcher

A smart RTL (Right-to-Left) patcher for the ChatGPT desktop app with Codex, as well as legacy standalone Codex installations. It brings polished support for Persian (Farsi), Arabic, Hebrew, and other RTL languages.

Codex Smart RTL injects an RTL engine into the app, fixes mixed-direction typing issues, and adds a small settings panel for fonts, line height, and layout preferences.

Features

• Smart Auto-Direction: Automatically detects if a paragraph is RTL or LTR and aligns it perfectly.
• Force RTL Mode: Want everything aligned to the right? Just toggle the switch.
• Custom Typography: Define different fonts for RTL text, English text, and code blocks.
• Line Height Control: A precise slider to adjust the line height for better readability.
• Persian Keyboard Fix: Maps Shift + 2 to type @ instead of ٬ on Persian keyboards.
• Beautiful Settings Panel: A floating, non-intrusive UI widget at the bottom right corner.
• Vazirmatn Built-in: Comes with the beautiful Vazirmatn variable font by default.
• Theme Compatibility: Seamlessly adapts colors based on Codex's active theme, using native color variables.

Installation

You don't need to download any files manually. Install Node.js first, then run the command for your operating system.

The patcher automatically prefers the current /Applications/ChatGPT.app Codex bundle and falls back to a legacy Codex.app. ChatGPT Classic.app is not a patch target because it does not use an Electron app.asar archive.

macOS

Before running the patcher, make sure Node.js is installed. You can install it from the official website, or if you already use Homebrew:

brew install node

Simply run:

npx codex-rtl

Quit ChatGPT/Codex before running the command. To patch a non-standard installation explicitly:

npx codex-rtl --asar "/full/path/to/app.asar"

First time? If you get a "Permission Denied" error, the tool will automatically open the App Management settings page for you. Just enable the toggle for your terminal app, then run the command again. No sudo needed!

You can also grant permission manually: System Settings > Privacy & Security > App Management.

Linux

sudo apt install nodejs npm # Skip this line if Node.js is already installed.
sudo npx codex-rtl

Windows

Open PowerShell as Administrator (Right-click -> Run as Administrator), then run:

winget install OpenJS.NodeJS.LTS # Skip this line if Node.js is already installed.
npx codex-rtl

[!WARNING] App Updates: Since updating ChatGPT/Codex overwrites its internal files, the RTL patch will be removed. You will need to run the installation command again after each update to re-apply the patch.

Restoring to Original (Uninstall)

If you ever want to revert ChatGPT/Codex back to its original state (before the patch), quit the app and run the command with the --restore flag:

npx codex-rtl --restore

(On Linux, run with sudo. On Windows, run in an Administrator terminal)

How it works

This CLI tool:

1. Locates the current ChatGPT/Codex or legacy Codex installation.
2. Stores a versioned backup outside the signed application bundle in ~/.codex-rtl/backups/.
3. Reads the real Electron entry point from package.json instead of assuming a fixed bootstrap filename.
4. Preserves native app.asar.unpacked metadata while injecting the Smart RTL Engine.
5. On macOS, updates ElectronAsarIntegrity to match the repacked archive header.
6. On macOS, preserves the official bundle files needed for restore, re-signs only the outer app bundle ad-hoc, and verifies the complete bundle. An already broken or ad-hoc app must be reinstalled before patching.

Contributing

Feel free to open issues or submit pull requests. Let's make Codex accessible and beautiful for everyone!

اصلاح‌کنندهٔ هوشمند راست‌به‌چپ در ChatGPT/Codex

یک پچر هوشمند راست‌به‌چپ (RTL) برای اپ جدید ChatGPT که Codex در آن ادغام شده است، و نسخه‌های مستقل قدیمی Codex؛ با پشتیبانی از فارسی، عربی، عبری و دیگر زبان‌های RTL.

Codex Smart RTL یک موتور RTL را به برنامه تزریق می‌کند، مشکل تایپ و نمایش متن‌های ترکیبی راست‌به‌چپ/چپ‌به‌راست را بهتر مدیریت می‌کند، و یک پنل کوچک برای تنظیم فونت، فاصلهٔ خطوط و چیدمان در اختیار شما می‌گذارد.

امکانات

• راست‌چین هوشمند (Smart Auto-Direction): سیستم به طور خودکار تشخیص می‌دهد که پاراگراف شما با حرف انگلیسی شروع شده یا فارسی، و چیدمان را بر همان اساس تنظیم می‌کند.
• حالت راست‌چینِ اجباری (Force RTL Mode): دوست دارید همه چیز (حتی پیام‌های انگلیسی) کاملاً در سمت راست قرار بگیرند؟ فقط کافیست سوئیچ را روشن کنید!
• تنظیماتِ پیشرفتهٔ فونت: می‌توانید برای متون فارسی، متون انگلیسی و کدهای برنامه‌نویسیِ داخل چت، فونت‌های جداگانه تعریف کنید.
• کنترل فاصلهٔ خطوط (Line Height): با استفاده از اسلایدر می‌توانید فاصلهٔ خطوط را برای خوانایی بهتر متن تنظیم کنید.
• حل مشکل کیبورد فارسی: این ابزار کلید ترکیبی Shift + 2 روی کیبورد فارسی را اصلاح می‌کند تا به جای «٬» علامت @ تایپ شود.
• پنل تنظیمات زیبا: تمام این تنظیمات در یک ویجتِ کوچک، مدرن و شناور در پایینِ صفحه قرار گرفته‌اند.
• فونت وزیرمتن: فونت زیبای Vazirmatn Variable به صورت پیش‌فرض در این افزونه گنجانده شده است.
• همگام‌سازی خودکار با تم (Theme Compatibility): هماهنگی و تغییر پویای رنگ سوییچ‌های پنل با تغییر تم رنگی Codex به صورت کاملاً بومی.

آموزش نصب

نیازی نیست فایل‌های پروژه را دستی دانلود کنید. ابتدا Node.js را نصب کنید، سپس دستور مربوط به سیستم‌عامل خود را اجرا کنید.

پچر ابتدا ChatGPT.app جدید را پیدا می‌کند و سپس به Codex.app قدیمی fallback می‌کند. ChatGPT Classic.app هدف پچ نیست، چون فایل Electron app.asar ندارد.

در مک (macOS)

قبل از اجرای پچر، مطمئن شوید Node.js روی سیستم شما نصب است. می‌توانید آن را از سایت رسمی Node.js نصب کنید، یا اگر از Homebrew استفاده می‌کنید:

brew install node

کافیست دستور زیر را اجرا کنید:

npx codex-rtl

پیش از اجرا، ChatGPT/Codex را کاملاً ببندید. برای مسیر غیرمعمول:

npx codex-rtl --asar "/full/path/to/app.asar"

اولین بار؟ اگر خطای Permission Denied دریافت کردید، ابزار به صورت خودکار صفحهٔ تنظیمات App Management را برای شما باز می‌کند. فقط سوئیچ ترمینال خود (مثلاً Terminal، iTerm2 یا VS Code) را فعال کنید و دوباره دستور را اجرا کنید. نیازی به sudo نیست!

همچنین می‌توانید به صورت دستی به مسیر System Settings > Privacy & Security > App Management بروید.

در لینوکس

sudo apt install nodejs npm # اگر Node.js از قبل نصب است، این خط را رد کنید.
sudo npx codex-rtl

در ویندوز

برنامهٔ PowerShell را در حالت Administrator (راست‌کلیک -> Run as Administrator) باز کنید و دستور زیر را بنویسید:

winget install OpenJS.NodeJS.LTS # اگر Node.js از قبل نصب است، این خط را رد کنید.
npx codex-rtl

[!WARNING] به‌روزرسانی برنامه: آپدیت ChatGPT/Codex فایل‌های داخلی را بازنویسی می‌کند؛ بنابراین پس از هر آپدیت، دستور نصب را مجدداً اجرا کنید.

بازگردانی به حالت اولیه (Uninstall)

اگر زمانی خواستید ChatGPT/Codex را به حالتِ اولیه برگردانید، اپ را ببندید و دستور زیر را اجرا کنید:

npx codex-rtl --restore

(در لینوکس با sudo اجرا کنید. کاربران ویندوز این دستور را در یک ترمینال ادمین اجرا کنند)

این ابزار چگونه کار می‌کند؟

1. محل نصب ChatGPT/Codex را پیدا می‌کند.
2. backup نسخه‌بندی‌شده را بیرون از bundle اپ در ~/.codex-rtl/backups/ نگه می‌دارد.
3. entry point واقعی Electron را از package.json می‌خواند.
4. هنگام repack، metadata ماژول‌های native را حفظ می‌کند.
5. در macOS، مقدار ElectronAsarIntegrity را با hash آرشیو جدید هماهنگ می‌کند.
6. در macOS، فایل‌های لازم برای restore امضای رسمی را نگه می‌دارد، فقط bundle بیرونی را به‌صورت ad-hoc امضا و کل bundle را verify می‌کند. اپی که از قبل امضای خراب یا ad-hoc دارد باید پیش از patch دوباره نصب شود.

مشارکت در توسعه

با کمال میل از نظرات، گزارشِ باگ‌ها و Pull Request های شما استقبال می‌شود.