Shadowgraph
TrendingBuzzAbout
Sign in

Morteza-NW/rtl-zcode

Persian & Arabic RTL support for ZCode Desktop — smart per-paragraph detection, always-accessible Fa toggle, no setup.

JavaScript

0

3 commits

updated Oct 4, 2026

See the code

See what people are saying

SourceMessageScoreDate

I built RTL support for ZCode Desktop — smart "any-rtl" that only flips Persian/Arabic text, never your code (r/coolgithubprojects)

ZCode renders Persian and Arabic left-to-right, which gets messy fast with mixed text. So I made a patch that adds smart RTL: every paragraph gets its own direction based on whether it actually contains Persian/Arabic — English and code stay untouched. There's a toggle in the composer to turn it…

0

Oct 4, 2026

README

rtl-zcode

RTL for ZCode Desktop — done right. Smart any-rtl: any text block containing an RTL character (Persian, Arabic, Hebrew, …) flows right-to-left; English text, code, tables and all UI chrome stay left-aligned.

🎬 Demo

Persianالعربية

✨ Features

  • Any-rtl detection — decided per text block by RTL-character presence, not the first word. ZCode یه ابزار خوبیه → RTL, English paragraphs → LTR. Code, tables, math, inputs and diffs are never touched.
  • App-wide — chat, task list, sidebar, dialogs.
  • RTL toggle — an RTL-symbol icon in the composer toolbar, right of the mode selector. Click to turn RTL on/off; the choice persists. The button never disappears and never shows on the welcome screen.
  • Vazirmatn font — embedded (~100 KB, no install, no internet), applied only to RTL text.
  • Live — directions fix themselves while responses stream.
  • One-click install & uninstall — no terminal needed.

🚀 Install

Prerequisite: Node.js.

  1. Download or clone this repo.
  2. Double-click install.bat — it finds ZCode, closes it, patches its app.asar and keeps pristine backups.
  3. Start ZCode normally. Done.

Re-run install.bat after every ZCode update.

🗑 Uninstall

Double-click uninstall.bat. It surgically removes the two injected snippets from app.asar — no backup needed, works even if ZCode updated since. Pristine backups (kept in %LOCALAPPDATA%\rtl-chat-zcode\app.asar.bak and asar-work\app.asar.bak) are restored automatically if the surgical path ever fails.

🎛 The RTL toggle

Sits in the composer toolbar next to the permission mode selector:

  • On — bright, like every other control.
  • Off — dimmed. RTL is fully disabled, the toggle stays reachable.
  • Tooltip shows the current state.

❓ Troubleshooting

ProblemFix
node not foundInstall Node.js, reopen the terminal.
EPERM while patchingRun PowerShell as Administrator.
anchor missingYour ZCode version changed the internals — the patch needs an update.
Toggle missing after updateRun install.bat again.
Everything still LTRCheck the RTL toggle (dimmed = off).
🇮🇷 راهنمای فارسی

راست‌چین هوشمند برای ZCode Desktop

هر متنی که حرف فارسی/عربی دارد راست‌چین میشود؛ متن انگلیسی، کد و رابط برنامه دست‌نخورده میماند.

✨ قابلیتها

  • تشخیص any-rtl — جهت هر پاراگراف از روی وجود حتی یک حرف فارسی/عربی در همان پاراگراف؛ نه از روی کلمه اول. متن انگلیسی، کد، جدول، فرمول و فیلدهای ورودی هرگز تغییر نمیکنند.
  • کل محیط — چت، لیست تسکها، سایدبار و پنجرهها.
  • دکمه راست‌چین (نماد RTL) — در نوار ابزار جعبه پیام، سمت راستِ انتخابگر حالت دسترسی. کلیک = خاموش/روشن؛ انتخاب در حافظه میماند و دکمه هیچوقت ناپدید نمیشود.
  • فونت وزیرمتن — داخل پچ جاسازی شده؛ بدون نصب و بدون اینترنت، فقط برای متنهای راست‌چین.
  • بهروزرسانی زنده — جهت متنها موقع استریم شدن جواب فوراً درست میشود.

🚀 نصب

پیشنیاز: Node.js.

  1. این ریپو را دانلود یا clone کنید.
  2. روی install.bat دوبار کلیک کنید — ZCode را پیدا میکند، میبندد، پچ میزند و بکاپ سالم نگه میدارد.
  3. ZCode را عادی باز کنید.

بعد از هر آپدیت ZCode یک بار دیگر install.bat را اجرا کنید.

🗑 حذف

روی uninstall.bat دوبار کلیک کنید — دو قطعه تزریقشده را به روش جراحی از app.asar برمیدارد و به بکاپها هم نیاز ندارد. بکاپهای سالم در %LOCALAPPDATA%\rtl-chat-zcode\app.asar.bak نگه داشته میشوند و در صورت نیاز خودکار بازیابی میشوند.

🛠 نصب دستی

$env:ZCODE_ASAR = "C:\Users\YOU\AppData\Local\Programs\ZCode\resources\app.asar"
node asar-work\patch-asar.mjs --apply    # باید ببینید: APPLY DONE
🇸🇦 الدليل بالعربية

محاذاة من اليمين إلى اليسار لـ ZCode Desktop

أي فقرة تحتوي على حرف فارسي أو عربي تُعرض من اليمين إلى اليسار، بينما يبقى النص الإنجليزي والشيفرات وواجهة البرنامج كما هي.

✨ الميزات

  • كشف any-rtl: يُحدَّد اتجاه كل فقرة بحسب وجود أي حرف RTL فيها، وليس بحسب الكلمة الأولى. الشيفرات والجداول والمعادلات وحقول الإدخال لا تُمَس أبداً.
  • على مستوى التطبيق كله: المحادثات وقائمة المهام والشريط الجانبي والحوارات.
  • زر RTL (رمز المحاذاة يميناً): في شريط أدوات صندوق الكتابة، يمين محدد صلاحيات الوصول؛ نقرة واحدة للتفعيل أو التعطيل، والاختيار محفوظ، والزر لا يختفي أبداً.
  • خط وزيرمتن (Vazirmatn): مضمّن داخل الإضافة (~100 كيلوبايت) بلا تثبيت ولا إنترنت، ويُطبق على النصوص RTL فقط.
  • تحديث فوري: تُصحَّح الاتجاهات أثناء توليد الردود مباشرة.

🚀 التثبيت

المتطلب: Node.js.

  1. حمّل هذا المستودع أو استنسخه.
  2. شغّل الملف install.bat بالنقر المزدوج — يجد ZCode، يغلقه، يعدّل ملف app.asar ويحفظ نسخاً احتياطية سليمة.
  3. افتح ZCode كالمعتاد.

أعد تشغيل install.bat بعد كل تحديث لـ ZCode.

🗑 الإزالة

شغّل uninstall.bat — يزيل الجزأين المُدرجين جراحياً من app.asar دون الحاجة إلى نسخة احتياطية، حتى لو تحدّث ZCode بعد التثبيت. تُحفظ نسخة احتياطية أصلية في %LOCALAPPDATA%\rtl-chat-zcode\app.asar.bak وتُستعاد تلقائياً عند الحاجة.

🛠 التثبيت اليدوي

$env:ZCODE_ASAR = "C:\Users\YOU\AppData\Local\Programs\ZCode\resources\app.asar"
node asar-work\patch-asar.mjs --apply    # يجب أن ترى: APPLY DONE

🙏 Credits

📜 License

MIT — see LICENSE. The original work this project builds on remains credited to its author.

Similar repos

AaronGIG/pdf2zh-desktop

📖 开箱即用的 PDF 学术翻译神器 | Win + Mac 双平台 | 公式排版完美保留 · Zotero 深度联动 · 35 种语言 · 20+ AI 翻译引擎 · 表格/OCR/术语库 ·…

475

guaguastandup/zotero-pdf2zh

PDF2zh for Zotero | Zotero PDF中文翻译插件

7,082

ucx0204/CarrotMangaTranslator

Open-source desktop OCR, AI translation, editing and inpainting tool for user-provided manga and…

79

readest/readest

Readest is a modern, feature-rich ebook reader designed for avid readers offering seamless…

24,848

xd2333/GalTransl

支持GPT/Claude/Deepseek/Sakura等大语言模型的Galgame自动化翻译解决方案 Automated translation solution for visual…

2,299

functoreality/rime-flypy-zrmfast

打字不翻页——Rime 输入法 双拼+辅助码方案

175

thiagotigaz/ocr-it

Chrome extension: pin a screen region once, then hotkey your way through a paginated document. OCR…

413

artamrj/shakesp-ai-re

Select. Shortcut. ShakespAIre it. Universal AI-powered proofreading for macOS, Windows, and Linux.

3

Languages

JavaScript

83.3%

Batchfile

9.3%

HTML

7.5%

Morteza-NW/rtl-zcode

Persian & Arabic RTL support for ZCode Desktop — smart per-paragraph detection, always-accessible Fa toggle, no setup.

JavaScript

0

3 commits

updated Oct 4, 2026

See the code

See what people are saying

SourceMessageScoreDate

I built RTL support for ZCode Desktop — smart "any-rtl" that only flips Persian/Arabic text, never your code (r/coolgithubprojects)

ZCode renders Persian and Arabic left-to-right, which gets messy fast with mixed text. So I made a patch that adds smart RTL: every paragraph gets its own direction based on whether it actually contains Persian/Arabic — English and code stay untouched. There's a toggle in the composer to turn it…

0

Oct 4, 2026

README

rtl-zcode

RTL for ZCode Desktop — done right. Smart any-rtl: any text block containing an RTL character (Persian, Arabic, Hebrew, …) flows right-to-left; English text, code, tables and all UI chrome stay left-aligned.

🎬 Demo

Persianالعربية

✨ Features

  • Any-rtl detection — decided per text block by RTL-character presence, not the first word. ZCode یه ابزار خوبیه → RTL, English paragraphs → LTR. Code, tables, math, inputs and diffs are never touched.
  • App-wide — chat, task list, sidebar, dialogs.
  • RTL toggle — an RTL-symbol icon in the composer toolbar, right of the mode selector. Click to turn RTL on/off; the choice persists. The button never disappears and never shows on the welcome screen.
  • Vazirmatn font — embedded (~100 KB, no install, no internet), applied only to RTL text.
  • Live — directions fix themselves while responses stream.
  • One-click install & uninstall — no terminal needed.

🚀 Install

Prerequisite: Node.js.

  1. Download or clone this repo.
  2. Double-click install.bat — it finds ZCode, closes it, patches its app.asar and keeps pristine backups.
  3. Start ZCode normally. Done.

Re-run install.bat after every ZCode update.

🗑 Uninstall

Double-click uninstall.bat. It surgically removes the two injected snippets from app.asar — no backup needed, works even if ZCode updated since. Pristine backups (kept in %LOCALAPPDATA%\rtl-chat-zcode\app.asar.bak and asar-work\app.asar.bak) are restored automatically if the surgical path ever fails.

🎛 The RTL toggle

Sits in the composer toolbar next to the permission mode selector:

  • On — bright, like every other control.
  • Off — dimmed. RTL is fully disabled, the toggle stays reachable.
  • Tooltip shows the current state.

❓ Troubleshooting

ProblemFix
node not foundInstall Node.js, reopen the terminal.
EPERM while patchingRun PowerShell as Administrator.
anchor missingYour ZCode version changed the internals — the patch needs an update.
Toggle missing after updateRun install.bat again.
Everything still LTRCheck the RTL toggle (dimmed = off).
🇮🇷 راهنمای فارسی

راست‌چین هوشمند برای ZCode Desktop

هر متنی که حرف فارسی/عربی دارد راست‌چین میشود؛ متن انگلیسی، کد و رابط برنامه دست‌نخورده میماند.

✨ قابلیتها

  • تشخیص any-rtl — جهت هر پاراگراف از روی وجود حتی یک حرف فارسی/عربی در همان پاراگراف؛ نه از روی کلمه اول. متن انگلیسی، کد، جدول، فرمول و فیلدهای ورودی هرگز تغییر نمیکنند.
  • کل محیط — چت، لیست تسکها، سایدبار و پنجرهها.
  • دکمه راست‌چین (نماد RTL) — در نوار ابزار جعبه پیام، سمت راستِ انتخابگر حالت دسترسی. کلیک = خاموش/روشن؛ انتخاب در حافظه میماند و دکمه هیچوقت ناپدید نمیشود.
  • فونت وزیرمتن — داخل پچ جاسازی شده؛ بدون نصب و بدون اینترنت، فقط برای متنهای راست‌چین.
  • بهروزرسانی زنده — جهت متنها موقع استریم شدن جواب فوراً درست میشود.

🚀 نصب

پیشنیاز: Node.js.

  1. این ریپو را دانلود یا clone کنید.
  2. روی install.bat دوبار کلیک کنید — ZCode را پیدا میکند، میبندد، پچ میزند و بکاپ سالم نگه میدارد.
  3. ZCode را عادی باز کنید.

بعد از هر آپدیت ZCode یک بار دیگر install.bat را اجرا کنید.

🗑 حذف

روی uninstall.bat دوبار کلیک کنید — دو قطعه تزریقشده را به روش جراحی از app.asar برمیدارد و به بکاپها هم نیاز ندارد. بکاپهای سالم در %LOCALAPPDATA%\rtl-chat-zcode\app.asar.bak نگه داشته میشوند و در صورت نیاز خودکار بازیابی میشوند.

🛠 نصب دستی

$env:ZCODE_ASAR = "C:\Users\YOU\AppData\Local\Programs\ZCode\resources\app.asar"
node asar-work\patch-asar.mjs --apply    # باید ببینید: APPLY DONE
🇸🇦 الدليل بالعربية

محاذاة من اليمين إلى اليسار لـ ZCode Desktop

أي فقرة تحتوي على حرف فارسي أو عربي تُعرض من اليمين إلى اليسار، بينما يبقى النص الإنجليزي والشيفرات وواجهة البرنامج كما هي.

✨ الميزات

  • كشف any-rtl: يُحدَّد اتجاه كل فقرة بحسب وجود أي حرف RTL فيها، وليس بحسب الكلمة الأولى. الشيفرات والجداول والمعادلات وحقول الإدخال لا تُمَس أبداً.
  • على مستوى التطبيق كله: المحادثات وقائمة المهام والشريط الجانبي والحوارات.
  • زر RTL (رمز المحاذاة يميناً): في شريط أدوات صندوق الكتابة، يمين محدد صلاحيات الوصول؛ نقرة واحدة للتفعيل أو التعطيل، والاختيار محفوظ، والزر لا يختفي أبداً.
  • خط وزيرمتن (Vazirmatn): مضمّن داخل الإضافة (~100 كيلوبايت) بلا تثبيت ولا إنترنت، ويُطبق على النصوص RTL فقط.
  • تحديث فوري: تُصحَّح الاتجاهات أثناء توليد الردود مباشرة.

🚀 التثبيت

المتطلب: Node.js.

  1. حمّل هذا المستودع أو استنسخه.
  2. شغّل الملف install.bat بالنقر المزدوج — يجد ZCode، يغلقه، يعدّل ملف app.asar ويحفظ نسخاً احتياطية سليمة.
  3. افتح ZCode كالمعتاد.

أعد تشغيل install.bat بعد كل تحديث لـ ZCode.

🗑 الإزالة

شغّل uninstall.bat — يزيل الجزأين المُدرجين جراحياً من app.asar دون الحاجة إلى نسخة احتياطية، حتى لو تحدّث ZCode بعد التثبيت. تُحفظ نسخة احتياطية أصلية في %LOCALAPPDATA%\rtl-chat-zcode\app.asar.bak وتُستعاد تلقائياً عند الحاجة.

🛠 التثبيت اليدوي

$env:ZCODE_ASAR = "C:\Users\YOU\AppData\Local\Programs\ZCode\resources\app.asar"
node asar-work\patch-asar.mjs --apply    # يجب أن ترى: APPLY DONE

🙏 Credits

📜 License

MIT — see LICENSE. The original work this project builds on remains credited to its author.

Similar repos

AaronGIG/pdf2zh-desktop

📖 开箱即用的 PDF 学术翻译神器 | Win + Mac 双平台 | 公式排版完美保留 · Zotero 深度联动 · 35 种语言 · 20+ AI 翻译引擎 · 表格/OCR/术语库 ·…

475

guaguastandup/zotero-pdf2zh

PDF2zh for Zotero | Zotero PDF中文翻译插件

7,082

ucx0204/CarrotMangaTranslator

Open-source desktop OCR, AI translation, editing and inpainting tool for user-provided manga and…

79

readest/readest

Readest is a modern, feature-rich ebook reader designed for avid readers offering seamless…

24,848

xd2333/GalTransl

支持GPT/Claude/Deepseek/Sakura等大语言模型的Galgame自动化翻译解决方案 Automated translation solution for visual…

2,299

functoreality/rime-flypy-zrmfast

打字不翻页——Rime 输入法 双拼+辅助码方案

175

thiagotigaz/ocr-it

Chrome extension: pin a screen region once, then hotkey your way through a paginated document. OCR…

413

artamrj/shakesp-ai-re

Select. Shortcut. ShakespAIre it. Universal AI-powered proofreading for macOS, Windows, and Linux.

3

Languages

JavaScript

83.3%

Batchfile

9.3%

HTML

7.5%