A barebones CLI tool for saving custom generated Ghostty icons to file.
Ghostty, a cross-platform terminal emulator, allows for user-specified customization to its macOS app icon. While incredibly cool and unique, because customized icons are compiled and applied at runtime, they're lost on application quit — ghostsmith is for the very small subset of users who might be bothered by this.
ghostsmith enables you to generate the same customized icon and apply it in a more persistent manner, using a tool like Pictogram or the native method.
The logic for generating an icon is largely ripped from Ghostty's source code, allowing for identical icons—as configured in Ghostty—to be generated.1
- Compile ghostsmith or download the pre-compiled latest release.
- To compile, an up-to-date version of Xcode should be used.
- The pre-compiled release is unsigned.2
- Run ghostsmith with the required arguments.
Upon running ghostsmith, your custom icon will be saved to the current working directory as custom-icon.png, or applied directly to Ghostty.app when using the --apply flag.
--screen-color accepts a comma separated list of 1 or more hex color values and/or defined colors
(ex. --screen-color "black,#ff9dfa")
--ghost-color accepts a hex color value and/or defined color
(ex. --ghost-color X11Purple)
--frame accepts one of the following options: aluminum, beige, plastic, chrome
--apply directly applies the icon instead of saving it to the current working directory. ~/Applications/Ghostty.app & /Applications/Ghostty.app are automatically targeted, but a custom path can be supplied
(ex. --apply "/path/to/Ghostty.app")
The list of defined colors can be found here.
Ghostty is developed and maintained by Mitchell Hashimoto.
Ghostty's app icon and its associated assets were designed by Michael Flarup.
ghostsmith carries forward Ghostty's MIT license and claims no further copyrights.
Footnotes
-
Theoretically. Report any issues if this is not the case. ↩
-
Reference: "Open a Mac app from an unknown developer" ↩
