https://github.com/pkgforge-dev/ghostty-appimage
👻 ⚙️ AppImage for Ghostty Terminal Emulator [Maintainer=@psadi]
https://github.com/pkgforge-dev/ghostty-appimage
appimage ghostty terminal
Last synced: 20 days ago
JSON representation
👻 ⚙️ AppImage for Ghostty Terminal Emulator [Maintainer=@psadi]
- Host: GitHub
- URL: https://github.com/pkgforge-dev/ghostty-appimage
- Owner: pkgforge-dev
- License: mit
- Created: 2025-01-06T17:58:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-10T04:27:43.000Z (24 days ago)
- Last Synced: 2026-03-10T10:35:44.279Z (24 days ago)
- Topics: appimage, ghostty, terminal
- Language: Shell
- Homepage: https://appimage.github.io/Ghostty
- Size: 522 KB
- Stars: 138
- Watchers: 3
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ghostty AppImage
This repository provides build scripts to create a Universal AppImage for [Ghostty](https://ghostty.org/). This unofficial build offers an executable AppImage compatible with any Linux distribution (Including musl based).
**Ghostty Source Code:** [Click Here](https://github.com/ghostty-org/ghostty)
## 🚀 Quick Start
1. Download the latest AppImage from the [releases](https://github.com/pkgforge-dev/ghostty-appimage/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.
1. Stable builds are based on upstream releases, with minor fixes and patches released as **version+1** tag(s).
1. Daily nightly builds, based on the upstream [tip releases](https://github.com/ghostty-org/ghostty/releases/tag/tip), are built and released at **00:00 UTC every day** and are available as pre-releases in the [releases](https://github.com/pkgforge-dev/ghostty-appimage/releases/tag/tip) section.
## ⚙️ Installation
Command Line (Manual)
Run the following commands in your terminal:
```bash
# Download the latest AppImage package from releases
wget https://github.com/pkgforge-dev/ghostty-appimage/releases/download/v${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
```
Command Line (Automatic)
Ghostty AppImage can be accessed through [**Soar**](https://github.com/pkgforge/soar) or [**AM**](https://github.com/ivan-hc/AM)/[**AppMan**](https://github.com/ivan-hc/AppMan). These tools automate the installation process, configure the PATH, and integrate with your desktop environment when installing AppImages.
1. Using [**Soar**](https://github.com/pkgforge/soar)
```bash
# Install
soar install ghostty
# Upgrade
soar update ghostty
# Uninstall
soar remove ghostty
```
1. Using [**AM**](https://github.com/ivan-hc/AM) or [**AppMan**](https://github.com/ivan-hc/AppMan) _(Choose one as appropriate)_
```bash
# Install
am -i ghostty
# Upgrade
am -u ghostty
# Uninstall
am -r ghostty
```
_Note: Ensure you have the necessary permissions to run these commands. For more detailed usage, refer to the documentation of each tool._
Graphical (Manual)
1. Download the latest AppImage package from the [releases](https://github.com/pkgforge-dev/ghostty-appimage/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.
Graphical (Automatic)
Ghostty AppImage can easily be managed using graphical tools such as [AppManager](https://github.com/kem-a/AppManager) and [Gear Lever](https://github.com/mijorus/gearlever).
1. **Using [AppManager](https://github.com/kem-a/AppManager)**
- Download the latest AppImage package from the [releases](https://github.com/pkgforge-dev/ghostty-appimage/releases) section.
- Simply drag and drop the files from your file manager into the AppManager application.
- Follow the on-screen instructions to configure the setup as a one-time installation process.
2. **Using [Gear Lever](https://github.com/mijorus/gearlever)**
- Download the latest AppImage package from the [releases](https://github.com/pkgforge-dev/ghostty-appimage/releases) section.
- Simply drag and drop the files from your file manager into the Gear Lever application.
- Follow the on-screen instructions to configure the setup as a one-time installation process.
> **🛈 NOTE**
> Ensure the necessary prerequsites are satisfied for these applications. For more detailed usage, refer to the documentation of each tool
> **🛈 NOTE**
Gearlever does not support delta updates with zsync and you may need to give it the URL to update manually.
> **🛈 NOTE**
Gearlever does not have official AppImage releases. You can use [this one](https://github.com/pkgforge-dev/Gear-Lever-AppImage) however.
## ⏫ Updating
Since AppImages are self-contained executables, there is no formal installation process beyond setting executable permissions.
Update (Manual)
1. Download the latest AppImage package from the [releases](https://github.com/pkgforge-dev/ghostty-appimage/releases) section.
1. Follow the same steps as in the [Installation](#installation) section to make it executable and run it.
Update (Automatic)
1. Use [AppImageUpdate](https://github.com/AppImageCommunity/AppImageUpdate) which reads the update information in the AppImage. This is a low level tool.
1. Use a higher level tool that uses AppImageUpdate, like [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher), [AM](https://github.com/ivan-hc/AM) or [appimaged](https://github.com/probonopd/go-appimage/blob/master/src/appimaged/README.md) daemon, these tools also automatically handle desktop integration.
## 🤝 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.