Ghostty AppImage

This repository provides build scripts to create a Universal AppImage for Ghostty. This unofficial build offers an executable AppImage compatible with any Linux distribution.

Ghostty Source Code: Click Here

🚀 Quick Start

1. Download the latest AppImage from the releases section.
2. Follow the installation instructions below to run the AppImage.

📦 Builds

1. Ghostty AppImages are available for both x86_64 and aarch64 systems.
2. Stable builds are based on upstream releases, with minor fixes and patches released as version+1 tags.
3. Daily nightly builds, based on the upstream tip releases, are available as pre-releases in the releases section.

⚙️ Installation

Command Line (Manual)

Run the following commands in your terminal:

# Download the latest AppImage package from releases
wget https://github.com/psadi/ghostty-appimage/releases/download/${VERSION}/Ghostty-${VERSION}-${ARCH}.AppImage

# Make the AppImage executable
chmod +x Ghostty-${VERSION}-${ARCH}.AppImage

# Run the AppImage
./Ghostty-${VERSION}-${ARCH}.AppImage

# Optionally, add the AppImage to your PATH for easier access

# With sudo for system wide availability
sudo install ./Ghostty-${VERSION}-${ARCH}.AppImage /usr/local/bin/ghostty

# Without sudo, XDG base spec mandate
install ./Ghostty-${VERSION}-${ARCH}.AppImage $HOME/.local/bin/ghostty

# Now you can run Ghostty from anywhere using the command:
# ghostty

Note: By using AM/AppMan, PATH config done automatically when you install appimages with it.

Command Line (Auto)

Ghostty AppImage is also available via Soar which automatically handles the install, upgrade and desktop integration process

# Install
soar install ghostty

# Upgrade
soar update ghostty

# Uninstall
soar remove ghostty

Graphical

1. Download the latest AppImage package from the releases section.
2. Locate the downloaded file in your file explorer (e.g., Nautilus, Thunar, PCManFM).
3. Right-click the downloaded file and select Properties.
4. Navigate to the Permissions tab and check the box that says Allow executing file as program/Executable as Program.
5. Close the properties window and double-click the AppImage file to run it.

⏫ Updating

Since AppImages are self-contained executables, there is no formal installation process beyond setting executable permissions.

Update manually:

1. Download the latest AppImage package from the releases section.
2. Follow the same steps as in the Installation section to make it executable and run it.

Update automatically:

1. Use AppImageUpdate which reads the update information in the AppImage. This is a low level tool.
2. Use a higher level tool that uses AppImageUpdate, like AM or appimaged daemon, these tools also automatically handle desktop integration.

🛠️ Troubleshooting

Known Issues

1. TERMINFO xterm-ghostty not-set/breaks functionality

   Fix: Set the TERMINFO value to xterm-256color at runtime by running the AppImage as follows,

   # Option 1
   ❯ TERM=xterm-256color ./Ghostty-${VERSION}-${ARCH}.AppImage
   
   # Option 2: Add `export TERM=xterm-256color` to your .bashrc or .zshrc and launch the appimage normally

2. Gtk-CRITICAL **: 13:43:27.628: gtk_widget_unparent: assertion 'GTK_IS_WIDGET (widget)' failed

   Fix: Referenced in #3267, reported/resolved at #32

If you encounter any errors, check the terminal for error messages that may indicate missing dependencies or other issues

🤝 Contributing

Contributions & Bugfixes are welcome. If you like to contribute, please feel free to fork the repository and submit a pull request.

For any questions or discussions, please open an issue in the repository.