Repository navigation
Troubleshooting
MΓng hΓ n edited this page May 12, 2026
·
1 revision
This page contains common issues and fixes for git-tree.
error while loading shared libraries: libxdo.so.3: cannot open shared object file
Some Linux distributions (especially Arch Linux) only provide:
libxdo.so.4
while the binary expects:
libxdo.so.3
Create a compatibility symlink:
sudo ln -s /usr/lib/libxdo.so.4 /usr/lib/libxdo.so.3Then try running git-tree again.
- Nothing happens when opening AppImage
- AppImage closes immediately
- GTK/WebKit errors appear
Install required dependencies.
sudo pacman -S webkit2gtk-4.1 gtk3 libgit2 xdotoolsudo apt install \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libgit2-dev \
libxdo-devsudo dnf install \
webkit2gtk4.1-devel \
gtk3-devel \
libgit2-develPermission denied
Make the binary executable:
chmod +x git-tree-linux-x86_64or for AppImage:
chmod +x git-tree-*.AppImage- No internet connection
- Invalid repository URL
- Private repository access denied
- Verify internet connection
- Double-check repository URL
- Ensure repository is public
- Try cloning manually with Git first
Example:
git clone https://github.com/user/repo.gitUsually related to missing GTK/WebKit libraries.
Install required dependencies for your distribution.
See:
π [Linux Compatibility](https://github.com/MahiroJV/git-tree/wiki/Linux-Compatibility)
Very large repositories may cause:
- slower rendering
- increased memory usage
- delayed zoom/pan response
- Use vertical tree layout
- Disable merge commit visibility
- Reduce node spacing
- Close other heavy applications
Usually caused by:
- missing
curl - unsupported distro
- network issues
Install curl manually:
sudo pacman -S curlsudo apt install curlsudo dnf install curlThen retry:
curl -fsSL https://raw.githubusercontent.com/MahiroJV/git-tree/master/install.sh | bashIf your issue is not listed here:
- Open a GitHub issue
- Include your Linux distribution
- Include the full error message
- Include terminal output if possible