Skip to content

Arch Problem

Jump to bottom
Míng hàn edited this page May 12, 2026 · 1 revision

🐧 Linux Compatibility Notes

git-tree supports both raw binary and AppImage on Linux. However, due to differences in shared libraries across distributions, some manual setup may be required.

⚙️ Raw Binary Issue Fix

On some systems (e.g. Arch Linux), you may encounter:

error while loading shared libraries: libxdo.so.3: cannot open shared object file

Fix

If your system only has libxdo.so.4, create a compatibility symlink:

sudo ln -s /usr/lib/libxdo.so.4 /usr/lib/libxdo.so.3

This ensures compatibility with binaries built against older libxdo versions.

📦 AppImage Notes

AppImage generally works out of the box, but on some distributions (especially Arch-based systems), WebKitGTK and related libraries may be resolved differently.

If AppImage fails to start, ensure the following dependencies are installed:

  • webkit2gtk
  • gtk3
  • libxdo
  • libgit2

On some systems, WebKitGTK libraries may be expected under paths like /usr/lib/x86_64-linux-gnu/.

🚀 Recommended Installation

For the best experience, use the official installer:

curl -fsSL https://raw.githubusercontent.com/MahiroJV/git-tree/master/install.sh | bash

This automatically installs dependencies, downloads the latest release, and sets up desktop integration.

Clone this wiki locally