Skip to content

Ghostty 1.3.2 RTL (Arabic) — Linux & macOS

Choose a tag to compare

@HMH-3080 HMH-3080 released this 16 Nov 07:38
· 6 commits to main since this release

Warning

This release is superseded by v1.3.2-rtl.3, which keeps LTR prefixes on the left and forces RTL for Arabic rows.

Ghostty 1.3.2 — Arabic/RTL fork (v1.3.2-rtl.2)

Second tagged release of this fork. It adds paragraph-level bidirectional
text
: full sentences that mix Arabic and English are now laid out as RTL
paragraphs with correct word order, right alignment, and LTR islands for
English words, numbers, paths and code.

Based on commandlinetips/ghostty
(commit 653cae7), which in turn forks
ghostty-org/ghostty 1.3.2-dev.

What's new in rtl.2

  • Paragraph direction is auto-detected (FRIBIDI_PAR_ON): a line whose
    first strong character is Arabic/Hebrew is treated as an RTL paragraph, so
    the sentence starts at the right margin and reads right-to-left.
  • Correct mixed-sentence order: English words, numbers and punctuation keep
    their LTR order inside the RTL sentence (no more reversed block order).
  • Right alignment for RTL paragraphs, like other bidi-aware terminals.
  • Decorations follow the visual position: underline, overline and
    strikethrough are drawn under the reordered glyphs.
  • Installer path rewrite: the desktop entry, D-Bus and systemd units now
    point to /usr/local/bin/ghostty even when installing from a repackaged
    tarball (rtl.1 kept the builder's absolute path in those files).
  • macOS CI now uses the macos-26-arm64 runner because the Icon Composer
    (.icon) asset needs the macOS 26 toolchain.

Highlights

  • Arabic/Hebrew RTL — connected letters, correct word/digit order,
    mixed LTR/RTL lines work; the UI itself stays LTR.
  • Build fix for Zig 0.15.2 on modern glibc (Arch/GCC 16):
    the host tools gtk_blueprint_compiler and ghostty-build-data are built
    with the LLVM linker to avoid the crt1.o:.sframe relocation failure.
  • macOS/iOS build fix — the CoreText shaper hooks now return error unions
    like the shared RunIterator interface expects (prepare/finalize), so
    the Apple targets compile with the RTL changes.
  • Installer — install-system.sh keeps exactly one Ghostty on the
    system, installs to /usr/local, and fixes desktop-icon launching under
    dbus-broker.
  • Reproducible build — rebuild.sh (Linux) and a GitHub Actions
    workflow for the macOS app.

Assets

File Platform Notes
ghostty-1.3.2-rtl.2-linux-x86_64.tar.zst Linux x86_64 GTK4 build, includes resources + installer
SHA256SUMS-linux.txt — Checksums for the Linux asset
Ghostty-rtl-v1.3.2-rtl.2-macos-arm64.zip macOS Apple Silicon unsigned app bundle, ad-hoc signed
SHA256SUMS-macos.txt — Checksums for the macOS asset
Source code (zip/tar.gz) — generated by GitHub from the tag

Important

Windows is not supported by Ghostty (no native backend), so there is
no Windows binary. Use WSL2 + WSLg with the Linux build instead.

Quick install

Linux (Arch-tested, GTK4/FriBidi required):

tar --zstd -xf ghostty-1.3.2-rtl.2-linux-x86_64.tar.zst
cd ghostty-1.3.2-rtl.2-linux-x86_64
sudo bash install-system.sh "$PWD"

macOS (Apple Silicon):

unzip Ghostty-rtl-v1.3.2-rtl.2-macos-arm64.zip
mv Ghostty.app /Applications/
xattr -dr com.apple.quarantine /Applications/Ghostty.app

Full instructions: docs/INSTALL.md.

Expected bidi behavior

Line Paragraph direction Display
السلام عليكم، كيف حالك اليوم؟ RTL (first strong char) right-aligned, reads RTL
أنا أستخدم Ghostty على Linux RTL starts right, Ghostty/Linux stay LTR
Hello, أنا اسمي محمد LTR (first strong char) starts left, Arabic block reads RTL

Recommended config

font-family = "CaskaydiaMono Nerd Font Mono"
font-family = "IBM Plex Sans Arabic"
font-size = 14

background = #1a1b26
foreground = #c0caf5

TokyoNight palette and Windows Terminal-style keybindings are documented in
FORK_NOTES.md.

Known limitations

  • Mouse selection across RTL text is still imperfect: dragging across mixed
    runs can be off by a cell.
  • Some Arabic diacritics (tashkeel) can detach from the base letter
    (e.g. the final د in مُحَمَّد). This is a shaping limitation of the
    fork, not of the font.
  • Neutral characters at run boundaries (for example the leading ~ in
    ~/.config) follow the paragraph direction, as required by the Unicode
    Bidirectional Algorithm; browsers display them the same way.
  • The macOS app is unsigned; Gatekeeper needs a one-time approval.

Credits & license

ملخص بالعربية

الإصدار الثاني من الفورك:

  • إصلاح الجمل الكاملة المختلطة (عربي/إنجليزي): اتجاه الفقرة يُكتشف
    تلقائيًا؛ السطر الذي يبدأ بعربي يُعرض RTL ويُحاذى يمينًا، مع بقاء الكلمات
    الإنجليزية والأرقام والمسارات بترتيب LTR داخل الجملة.
  • الخطوط والتسطير تتبع الموضع البصري بعد إعادة الترتيب.
  • حزمة لينكس جاهزة مع سكربت تثبيت نظامي.
  • تطبيق ماك جاهز (Apple Silicon، غير موقّع).
  • ويندوز غير مدعوم لأن Ghostty نفسه لا يملك واجهة ويندوز — استخدم WSL2.