GHOSTTY(5) Ghostty terminal emulator configuration file GHOSTTY(5) (NAME) ghostty - Ghostty (DESCRIPTION) Ghostty . (GUI) . $XDG_CONFIG_HOME/ghostty/config.ghostty XDG ~/.config/ghostty/config.ghostty . macOS $HOME/Library/Application Support/com.mitchellh.ghostty/config.ghostty . macOS . XDG . : # The syntax is "key = value". The whitespace around the equals doesn't matter. background = 282c34 foreground= ffffff # Blank lines are ignored! keybind = ctrl+z=close_surface keybind = ctrl+d=new_split:right # Colors can be changed by setting the 16 colors of `palette`, which each color # being defined as regular and bold. # # black palette = 0=#1d2021 palette = 8=#7c6f64 # red palette = 1=#cc241d palette = 9=#fb4934 # green palette = 2=#98971a palette = 10=#b8bb26 # yellow palette = 3=#d79921 palette = 11=#fabd2f # blue palette = 4=#458588 palette = 12=#83a598 # purple palette = 5=#b16286 palette = 13=#d3869b # aqua palette = 6=#689d6a palette = 14=#8ec07c # white palette = 7=#a89984 palette = 15=#fbf1c7 ghostty +show-config --default --docs . (pager) . : font-family = . ( ) . +show-config . Config . . Ghostty . (Configuration Errors) Ghostty . . (Debugging Configuration) (debug) Ghostty . ( ) . macOS (GTK) . Ghostty . Ghostty ghostty +show-config . --help . (Logging) Ghostty . stderr . Ghostty stderr . Ghostty systemd journald Ghostty : journalctl --user --unit app-com.mitchellh.ghostty.service. macOS macOS . log Ghostty : sudo log stream --level debug --predicate 'subsystem=="com.mitchellh.ghostty"'. Ghostty . Ghostty . Ghostty Debug stderr . Ghostty stderr . Ghostty GHOSTTY_LOG . . Ghostty : o stderr - stderr. o macos - macOS ( macOS ). . no- . . GHOSTTY_LOG true . GHOSTTY_LOG false . (CONFIGURATION OPTIONS) language Ghostty . : language = de Ghostty . Ghostty . . Ghostty - . : . Ghostty . GTK. 1.3.0 . font-family . : ghostty +list-fonts (fallback) . . : macOS Ghostty Apple Color Emoji Noto Emoji . . (/bold /italic /bold italic) . (font-family) . Ghostty . bold . . font-family-bold = FooBar "FooBar" Ghostty font-family bold . (synthesized) . italic italic Ghostty italic . font-style . font-style . font-style . "" ( ) . : font-family = "" font-family = "My Favorite Font" --font-family="" . . font-family-bold font-family-italic font-family-bold-italic font-style . . "Iosevka Heavy" "Heavy" . . false . . font-family . font-family font-style . font-style-bold font-style-italic font-style-bold-italic font-synthetic-style Ghostty font-family . Ghostty bold italic bold italic . bold (outline) . italic . bold italic . . . "false" "true" . "no-bold" "no-italic" "no-bold-italic" . "no-bold,no-italic". : bold italic bold-italic. . . : bold italic bold-italic . bold italic bold-italic . bold-italic . bold-italic . . font-feature (font feature). . feat : o : feat +feat feat on feat=1. o : -feat feat off feat=0. o : feat=2 feat = 3 feat 4. o CSS font-feature-settings . . Ghostty . . (ligatures) -calt . fontdrop.info . -calt, -liga, -dlig . font-size . () . (high DPI) 1pt = 2px . 13.5pt @ 2px/pt = 27px ( ). . . GTK ( GNOME). font-variation (variable font). -VF.ttf -VF.otf . . id=value id . wght. . . 100 700 wght=800 ( 700 ). . : wght () slnt () ital () opsz ( ) wdth () GRAD () . font-variation-bold font-variation-italic font-variation-bold-italic font-codepoint-map . . codepoint=fontname codepoint . U+ABCD . U+ABCD-U+DEFG . U+ABCD-U+DEFG,U+1234-U+5678=fontname. font-family . . . clipboard-codepoint-map . . (paste) . font-codepoint-map : - : U+1234=U+ABCD U+1234=replacement_text - : U+1234-U+5678=U+ABCD : - clipboard-codepoint-map = U+2500=U+002D ( -> ) - clipboard-codepoint-map = U+2502=U+007C ( -> ) - clipboard-codepoint-map = U+03A3=SUM ( -> "SUM") . . : (URL). font-thicken . macOS . font-thicken-strength font-thicken . 0 255 . 0 . font-thicken false . macOS . font-shaping-break (run). "" (run) . "" (Shaping) ( ) ( ) . (ligatures) . "!=" "!" "=" run . run . "!" run "=" run . Ghostty run . Ghostty run . . . "no-" . . : o cursor - run . : 1.2.0 . alpha-blending (). . . macOS native linear-corrected . : o native - . macOS Display P3 sRGB . o linear - . ( / ) . " " . o linear-corrected - linear native . : 1.1.0 . adjust-cell-width . (1 -1 ) (20% -15% ) . . 1 1 1 . 20% 20 . ( -100%) . . (clamped) . . *-thickness 1px . adjust-cell-height : o . o adjust-cursor-height . o Powerline . adjust-cell-height adjust-font-baseline (baseline). . adjust-cell-width . adjust-underline-position (underline). . adjust-cell-width . adjust-underline-thickness . adjust-cell-width . adjust-strikethrough-position (strikethrough). . adjust-cell-width . adjust-strikethrough-thickness . adjust-cell-width . adjust-overline-position (overline). . adjust-cell-width . adjust-overline-thickness . adjust-cell-width . adjust-cursor-thickness (bar) (outlined rect). adjust-cell-width . adjust-cursor-height . : . adjust-cell-width . adjust-box-thickness . adjust-cell-width . adjust-icon-height Nerd Font. () () . : . Powerline . adjust-cell-width . : 1.2.0 . grapheme-width-method (grapheme cluster). unicode . ( /shells) wcswidth . : o legacy - wcswidth. . "legacy" . wcswidth libc . o unicode - . 2027 unicode . 2027 . . . freetype-load-flags FreeType . . no- . . true false . Ghostty FreeType . . macOS CoreText . : o hinting - (hinting). . o force-autohint - freetype . . o monochrome - . (anti-aliasing) . . o autohint - freetype. . o light - . GTK Ghostty . monochrome . . : hinting no-hinting force-autohint no-force-autohint theme () . . Ghostty (light) (dark) . . Ghostty . . . . . themes Ghostty . $XDG_CONFIG_HOME/ghostty/themes ~/.config/ghostty/themes . themes Ghostty . Ghostty . macOS Ghostty.app/Contents/Resources/ghostty/themes . share/ghostty/themes ( "share" ) . ghostty +list-themes . Ghostty . . . . . . theme config-file . Ghostty . background foreground palette . : light:theme-name,dark:theme-name. : light:Rose Pine Dawn,dark:Rose Pine. light dark . . . / : o macOS: . background . (#RRGGBB RRGGBB) X11 . foreground () . (#RRGGBB RRGGBB) X11 . background-image . PNG JPEG . . (split) . Ghostty . : (VRAM) . ( VRAM) . Ghostty . : 1.2.0 . background-image-opacity . background-opacity . 1.0 () background-opacity . 1.0 background-opacity . 1.0 ( ) . background-opacity 0.5 background-image-opacity 1.5 0.5 * 1.5 = 0.75 . : 1.2.0 . background-image-position . : * top-left * top-center * top-right * center-left * center * center-right * bottom-left * bottom-center * bottom-right center . : 1.2.0 . background-image-fit . : o contain . o cover . . o stretch . o none . contain . : 1.2.0 . background-image-repeat . true . false . : 1.2.0 . selection-foreground . (: / ). (#RRGGBB RRGGBB) X11 . 1.2.0 cell-foreground cell-background . selection-background selection-clear-on-typing . true . . false . " " (shift control alt ) ( ) . (preedit) ( ) . false escape . : 1.2.0 . selection-clear-on-copy . false . true copy_to_clipboard . copy-on-select . false . selection-word-chars . . WORDCHARS zsh . . . UTF-8 . ( ) . (U+0000) . : \t'"|`|:;,()[]{}<>$ . - () : selection-word-chars = " \t'\"|`|:,()[]{}<>$" : 1.3.0 . minimum-contrast () . . ( ). WCAG 2.0 . ( ) 1.1 . . . . palette . N=COLOR N 0 255 ( ) COLOR RGB #AABBCC AABBCC X11 . palette = 5=#BB78D9 <<>> . () () () . : 0b 0o 0x . . (0 15) (16 255) ( palette-generate ). palette-generate ( 16 255) ANSI. . 6x6x6 . palette . false () ( xterm ). . : https://gist.github.com/jake-stewart/0a8ea46159a7da2c808e5be2177e1783 : 1.3.0 . palette-harmonious palette-generate . . 16 231 . . palette-generate . palette-generate . : 1.3.0 . cursor-color . . (#RRGGBB RRGGBB) X11 . : o cell-foreground - ( ). ( : 1.2.0 ) o cell-background - . ( : 1.2.0 ) cursor-opacity ( ) . . . 0.3 . cursor-style . . ( CSI q) . . (shell integration) (bar) . shell-integration-features = no-cursor . : o block o bar o underline o block_hollow cursor-style-blink . DECSCUSR ( CSI q) . . "true" . (null) Ghostty DEC Mode 12 ( AT&T) / . null DEC mode 12 DECSCUSR . : o () o true o false cursor-text . . (#RRGGBB RRGGBB) X11 . 1.2.0 cell-foreground cell-background . cursor-click-to-move (prompt). (shell integration) OSC 133. Fish ( 4) Nu ( 0.111 ) Ghostty . . . mouse-hide-while-typing . ( ) . . macOS . scroll-to-bottom . . no- . . : o keystroke PTY ( Ghostty ) . o output ( ) . keystroke, no-output . mouse-shift-capture shift . shift . false shift . XTSHIFTESCAPE . true shift XTSHIFTESCAPE . never false XTSHIFTESCAPE . always true XTSHIFTESCAPE . shift never . : o true o false o always o never mouse-reporting . false . . true () . toggle_mouse_reporting . mouse-scroll-multiplier . precision: discrete: . : precision:0.1,discrete:3. . Ghostty 1.2.1 . [0.01, 10,000] . . (discrete) "3" (precision) "1" . background-opacity ( ) . . . macOS . . macOS Ghostty . background-opacity-cells . background-opacity . . Neovim Tmux background-opacity ( ). true background-opacity . : 1.2.0 . background-blur ( ) background-opacity . : o . o false 0. o true 20 . . macOS 26.0 macOS : o macos-glass-regular - . o macos-glass-clear - . macOS macOS background-blur = true . macOS : o KDE Plasma ( Wayland X11) : KDE Plasma true . KWin . KWin (System Settings) "Apps & Windows" > "Window Management" > "Desktop Effects" "Blur" . . "Configure" Ghostty . . . unfocused-split-opacity ( ) (split) . . . . "0" ( ) 0.15 . . 0.15 1 . unfocused-split-fill . . . . (#RRGGBB RRGGBB) X11 . split-divider-color . . (#RRGGBB RRGGBB) X11 . : 1.1.0 . split-preserve-zoom . . . navigation ( goto_split) . . no- . : split-preserve-zoom = navigation : 1.3.0 . search-foreground () . . : o (#RRGGBB RRGGBB) o X11 o "cell-foreground" o "cell-background" . search-background search-selected-foreground . / . : o (#RRGGBB RRGGBB) o X11 o "cell-foreground" o "cell-background" . search-selected-background command (shell). PATH . . : o SHELL o passwd ( ) . /bin/sh -c . direct: : direct:nvim foo. /bin/sh ~ glob . ( : 1.2.0 ) shell: . . ( : 1.2.0 ) . Ghostty initial-command . Ghostty -e : ghostty -e fish --with --custom --args. initial-command . initial-command "command" Ghostty . command . ( ) . . ghostty : -e . : ghostty -e fish --with --custom --args. -e : o ( ghostty -e ). o gtk-single-instance=false - CLI . o quit-after-last-window-closed=true - Ghostty . quit-after-last-window-closed-delay . o shell-integration=detect ( none ) - . -e ( ). . -e . notify-on-command-finish . : o never - (). o unfocused - . o always - . OSC 133 . GTK never unfocused . 1.3.0 . notify-on-command-finish-action . : o bell - . o notify - . . no- : no-bell,notify. 1.3.0 . notify-on-command-finish-after . . . . . : o y - SI . . o d - SI . o h - . o m - . o s - . o ms - 0.001 . o us s - 0.000001 . o ns - 0.000000001 . : * 1h30m * 45s . 1h1h 2h . . . 584y 49w 23h 34m 33s 709ms 551s 615ns . . 1.3.0 . env . env=KEY=VALUE . env = foo=bar env = bar=baz env () . env = . env = foo=bar env = foo= foo . . env = foo=bar env = foo=baz foo=baz . Ghostty . GHOSTTY_RESOURCES_DIR Ghostty . Ghostty open xdg-open . : 1.2.0 . input . command pty . . . : o raw: - . Zig . o path: - . . /dev/stdin /dev/urandom . 10MB . . raw: . input = "Hello, world!" ( ) raw: . . ( ) . . . . : 1.2.0 . wait-after-command true . ( ) . . . abnormal-command-exit-runtime . . . macOS login . scrollback-limit (scrollback) . . . . . . (lazy) icherweise . . . . . scrollbar (scrollbar) . system . : o system - . macOS " " . o never - . . link (regex) . URL . ( open xdg-open) . . . link-url . : ! link-url (URL). control () command ( macOS) . URL ( link ). URL link . link-previews . true . false . "osc8" OSC 8 ( ). : 1.2.0 . maximize () . . . : 1.1.0 . fullscreen . . . : o false - (). o true - . o non-native - ( macOS) . . macOS true . o non-native-visible-menu - ( macOS) . macOS true . o non-native-padded-notch - ( macOS) (notch) . macOS true . : . macOS . true () . macOS window-decoration false true ( ) macOS . title Ghostty . Ghostty ( Neovim) . : title = " ". . . . . . Neovim . class (class) . X11 WM_CLASS ( X11) Wayland ( Wayland) (bus name) Ghostty DBus . Ghostty gtk-single-instance=true . . Ghostty .desktop DBus systemd Ghostty class DBus . GTK . com.mitchellh.ghostty . GTK . x11-instance-name X11 WM_CLASS X11 . . ghostty . GTK . working-directory ( ). window-inherit-working-directory . Ghostty window-inherit-working-directory . . . inherit . macOS Ghostty launchd ( ) open home . GTK Ghostty home . ~/ ( ) : o home - . o inherit - . keybind . trigger=action . . ghostty +list-actions . (Trigger): + . : ctrl+a ctrl+shift+b up. . . a a QWERTY q AZERTY ( ). . " " shift. ctrl+a a ctrl+shift+a ( A ) . (case folded) . ctrl+A ctrl+a . . ctrl+_ _ shift+- ctrl+shift+- ctrl+_ ( !). Qt : https://doc.qt.io/qt-6/qkeysequence.html#keyboard-layout-issues W3C . KeyA a . . w3c snake_case . key_a KeyA . F1 f1 ( ). snake_case . . insert up f5 W3C . a KeyA . catch_all . ctrl+catch_all ctrl . Ghostty catch_all . catch_all . : shift ctrl ( : control) alt ( : opt option) super ( : cmd command). . ( ) . : fn " (globe)" . Ghostty . : o ctrl+ctrl+a . o shift+a+ctrl . o ctrl+a+b . > . ctrl+a>n=new_window new_window ctrl+a n . (leader key) (chord) . . : ghostty > . : ghostty --keybind='ctrl+a>n=new_window' : o Ghostty . (timeout) . ( ctrl+a>ctrl+a=text:foo) . o catch_all ignore . . o . ctrl+a new_window ctrl+a>n new_tab ctrl+a . o . ctrl+a>n ctrl+a>t ctrl+a ctrl+a>n ctrl+a>t . o global: all: . . (Action) . action action:param . . o ignore - . . o unbind - . . unbind physical: . o csi:text - CSI. csi:A . o esc:text - . esc:d . o text:text - . Zig . text:\x15 Ctrl-U . o ghostty +list-actions . : o : . . / : --[dq]keybind=up=csi:A B". keybind : o keybind=clear . : . : o all: . . . . ( quit) . : 1.0.0 . o global: . Ghostty ( ). ( Ghostty ) . all: . : . : 1.0.0 macOS 1.2.0 GTK. o unconsumed: . ( ) . unconsumed: : unconsumed:ctrl+a=reload_config. global: all: . . : 1.0.0 . o performable: . copy_to_clipboard . Ghostty . global: all: . ( ). . . . : 1.1.0 . . ctrl+a global:ctrl+a . . global: . . global:unconsumed:ctrl+a=reload_config . : global: macOS . macOS (Accessibility) Ghostty . global: Ghostty Ghostty . . macOS System Preferences -> Privacy & Security -> Accessibility . Global Shortcuts XDG . ( ) : o KDE Plasma ( 5.27 ) GNOME ( 48 ) . o Hyprland . Hyprland . ( : xdg-desktop-portal-hyprland !). o wlroots Sway ( ). (Chained Actions) chain . . : keybind = ctrl+a=new_window keybind = chain=goto_split:left ctrl+a . chain . : keybind = ctrl+a=new_window keybind = chain=goto_split:left keybind = chain=toggle_fullscreen global: unconsumed: . . . : keybind = ctrl+a>n=new_window keybind = chain=goto_split:left . Ghostty 1.3.0 . (Key Tables) " " . . " (copy mode)" " (vim mode)" . (modal) . / . keybinds .
. / = + > . + > () . foo/ctrl+a=new_window foo . activate_key_table: deactivate_key_table . . . . : o / ( ) . o . ( A -> B -> A -> B A -> B -> B ). o (one-shot) activate_key_table_once: . catch-all . o : foo/ctrl+a>ctrl+b=new_window. . o chain table/ctrl+a=new_window chain=text:hello . : chain . o global: : foo/global:ctrl+a=new_window. Ghostty 1.3.0 . key-remap Ghostty. . from=to from to . ctrl alt shift super ( macOS: cmd/command) left_ctrl right_alt . Ghostty . macOS option+a a option ctrl . Ghostty . : key-remap = ctrl=super key-remap = left_control=right_alt : o . ctrl=super Ctrl Super Super Super . o (transitive) . ctrl=super alt=ctrl Alt Ctrl Super. o . Ghostty . option+a macOS a option ctrl . o ( ctrl) . ( left_ctrl) . : o macOS . macOS Ghostty . . . window-padding-x (padding) . . DPI . . . . . . window-padding-x = 2,4 2 4 . window-padding-x = 2 2 . window-padding-y (padding) . . DPI . . . . . window-padding-y = 2,4 2 4 . window-padding-y = 2. window-padding-balance (viewport) . . true . false window-padding . window-padding true . . window-padding-color . : o background - background. o extend - . o extend-always - "extend" . "extend" . ( Neovim) : o . . o (prompt) ( ). powerline . o powerline . . window-vsync (refresh rate) . true (tearing) . false . true macOS ( macOS 14.4 ) DisplayLink . false . . macOS . window-inherit-working-directory true . ( working-directory). tab-inherit-working-directory true . ( working-directory). split-inherit-working-directory true . ( working-directory). window-inherit-font-size true . . false font-size . window-decoration . . Ghostty . : o none . . macOS ( ). o auto . Ghostty "" . o client (CSD). : 1.1.0 . o server (SSD). GTK X11 Wayland org_kde_kwin_server_decoration ( KDE Plasma GNOME ). server . : 1.1.0 . auto . true false . true auto . false none . ( macOS Windows) . "toggle_window_decorations" . macOS: macos-titlebar-style = hidden . window-title-font-family . . : (fixed-width) . : 1.0.0 macOS 1.1.0 GTK. window-subtitle . : o false - . o working-directory - . GTK . : 1.1.0 . window-theme () . : o auto - . "theme" . "auto" "system" . o system - . o light - . o dark - . o ghostty - Ghostty. . macOS macos-titlebar-style tabs transparent . . Ghostty . macOS . window-colorspace . " " SGR (direct-color) . : o srgb - sRGB. . o display-p3 - Display P3. macOS . window-height . . . . . . . (tiling) . Ghostty . . (maximized) . . . . . (BUG): GTK . . ( window-decoration ) . . window-width window-position-x . . . . . . Ghostty . . . . macOS . . : macOS . GTK X11 Wayland. window-position-y window-save-state . . . shell-integration . : o default . macOS Settings.app . o never . o always Ghostty . Ghostty never Ghostty . Ghostty default Ghostty . Ghostty ( macOS ). Ghostty Ghostty . default . macOS . window-step-resize . . macOS . window-new-tab-position . : o current - . o end - . window-show-tab-bar . : o always . : 1.2.0 . o auto () . . o never . (tab overview) . (GTK) . window-titlebar-background . window-theme ghostty . GTK . (#RRGGBB RRGGBB) X11 . window-titlebar-foreground () . window-theme ghostty . GTK . (#RRGGBB RRGGBB) X11 . resize-overlay (resize overlay). . : o always - . o never - . o after-first - . after-first . resize-overlay-position . : o center o top-left o top-center o top-right o bottom-left o bottom-center o bottom-right center . resize-overlay-duration . 3/4 750 . . . . : o y - SI . . o d - SI . o h - . o m - . o s - . o ms - 0.001 . o us s - 0.000001 . o ns - 0.000000001 . : * 1h30m * 45s . 1h1h 2h . . . 584y 49w 23h 34m 33s 709ms 551s 615ns . . 1.0.0 . focus-follows-mouse true . . false . clipboard-read / ( OSC 52). . : o ask - . o allow - . o deny - . clipboard-write clipboard-trim-trailing-spaces . clipboard-write . . . clipboard-paste-protection (paste) . " /" . clipboard-paste-bracketed-safe true (bracketed pastes) . . "" ( ). title-report (CSI 21 t). . . : ( ). : 1.0.1 . image-storage-limit ( Kitty) . 4,294,967,295 ( ) . 320MB . . . copy-on-select . true (selection clipboard) . clipboard . . false . macOS true . right-click-action . : * context-menu - (). * paste - . * copy - . * copy-or-paste - . * ignore - . context-menu . click-repeat-interval ( ) . . macOS . 500 . config-file . . . config-file . . ? . ? . (cycles) . . . . : . : config-file = "foo" a = 1 "foo" a = 2 a foo config-file . config-default-files true . XDG ($XDG_CONFIG_HOME/ghostty/config.ghostty) . false . Ghostty . (CLI-only) . . . . confirm-close-surface . true . false . always . quit-after-last-window-closed . macOS false macOS . true . true Ghostty . quit-after-last-window-closed-delay . quit-after-last-window-closed-delay Ghostty . quit-after-last-window-closed true . 1s . 1s . . . . : o y - SI . . o d - SI . o h - . o m - . o s - . o ms - 0.001 . o us s - 0.000001 . o ns - 0.000000001 . : * 1h30m * 45s . 1h1h 2h . . . 584y 49w 23h 34m 33s 709ms 551s 615ns . . quit-after-last-window-closed-delay quit-after-last-window-closed true Ghostty . . initial-window Ghostty . quit-after-last-window-closed true quit-after-last-window-closed-delay initial-window false Ghostty . macOS . undo-timeout (undo) . . . . . . ( ) . . . . . : o y - SI . . o d - SI . o h - . o m - . o s - . o ms - 0.001 . o us s - 0.000001 . o ns - 0.000000001 . : * 1h30m * 45s . 1h1h 2h . . . macOS . . : 1.2.0 . quick-terminal-position (quick terminal). toggle_quick_terminal . : o top - . o bottom - . o left - . o right - . o center - . macOS Ghostty . : . toggle_quick_terminal . quick-terminal-size . (/) . % ( 20%) px ( 300px) . . : . : . (,) . 50%,500px . : 1.2.0 . gtk-quick-terminal-layer . . : o overlay . o top () . o bottom . o background . GTK Wayland. : 1.2.0 . gtk-quick-terminal-namespace (namespace) . Wayland . GTK Wayland. : 1.2.0 . quick-terminal-screen . : o main - . macOS . Ghostty . o mouse - . o macos-menu-bar - macOS macOS . macOS . main . macOS . quick-terminal-animation-duration ( ) . . . macOS . quick-terminal-autohide . false . macOS true Linux/BSD false . macOS . . quick-terminal-space-behavior (spaces) macOS . macOS . : o move - . o remain - . move . macOS . move . : 1.1.0 . quick-terminal-keyboard-interactivity . Wayland . : - ! : o none . o on-demand () . o exclusive . Wayland . macOS on-demand . : 1.2.0 . shell-integration (shell integration). : o . o "jump_to_prompt" . o . o . : o none - . . o detect - . o bash elvish fish nushell zsh - . detect . shell-integration-features . shell-integration . . no- . . true false . : cursor no-cursor sudo no-sudo title no-title : o cursor - (bar) . o sudo - sudo terminfo. o title - . o ssh-env - SSH. TERM xterm-ghostty xterm-256color COLORTERM TERM_PROGRAM TERM_PROGRAM_VERSION . sshd_config . ( : 1.2.0 ) o ssh-terminfo - terminfo . terminfo Ghostty infocmp tic . infocmp tic . terminfo (cache) . +ssh-cache . ( : 1.2.0 ) o path - Ghostty PATH. ghostty PATH . macOS PATH . . SSH : ssh-env ssh-terminfo Ghostty terminfo xterm-ghostty TERM terminfo xterm-256color . command-palette-entry (command palette). . (:) . . . Zig . . Zig . . . command-palette-entry = title:Reset Font Style, action:csi:0m command-palette-entry = title:Crash on Main Thread,description:Causes a crash on the main (UI) thread.,action:crash:main command-palette-entry = title:Focus Split: Right,description:"Focus the split to the right, if it exists.",action:goto_split:right command-palette-entry = title:"Ghostty",description:"Add a little Ghostty to your terminal.",action:"text:f1" . : command-palette-entry = : 1.2.0 . osc-color-report-format OSC . Ghostty OSC 10 () OSC 11 () OSC 4 ( ) RGB . . . . . : o none - OSC 4/10/11 . o 8-bit - rr/gg/bb. o 16-bit - rrrr/gggg/bbbb. 16-bit . vt-kam-allowed true "KAM" ( ANSI) . KAM . . KAM . KAM . custom-shader . GLSL . : Ghostty . . Shadertoy . mainImage (uniforms) Shadertoy Ghostty. : o sampler2D iChannel0 - (Input texture). . . o vec3 iResolution - [width, height, 1] ( ). o float iTime - . o float iTimeDelta - . o float iFrameRate - ( ). o int iFrame - . o float iChannelTime[4] - ( ). o vec3 iChannelResolution[4] - . iChannel0 iChannelResolution[0] iResolution . o vec4 iMouse - ( ). o vec4 iDate - / ( ). o float iSampleRate - ( ). Ghostty: o vec4 iCurrentCursor - . o iCurrentCursor.xy -X +Y . o iCurrentCursor.zw . o vec4 iPreviousCursor - . o vec4 iCurrentCursorColor - . o vec4 iPreviousCursorColor - . o vec4 iCurrentCursorStyle - . : o CURSORSTYLE_BLOCK 0 o CURSORSTYLE_BLOCK_HOLLOW 1 o CURSORSTYLE_BAR 2 o CURSORSTYLE_UNDERLINE 3 o CURSORSTYLE_LOCK 4 o vec4 iPreviousCursorStyle - . o vec4 iCursorVisible - . o float iTimeCursorChange - . iTime iTime . o float iTimeFocus - . iTime iTimeCursorChange. iTime - iTimeFocus . . o int iFocus - . 1.0 0.0 . . iFocus > 0 . o vec3 iPalette[256] - . RGB [0.0, 1.0]. ANSI xx . o vec3 iBackgroundColor - (RGB). o vec3 iForegroundColor - (RGB). o vec3 iCursorColor - (RGB). o vec3 iCursorText - (RGB). o vec3 iSelectionBackgroundColor - (RGB). o vec3 iSelectionForegroundColor - (RGB). . . shadertoy.com . . . . custom-shader-animation true () . ( ) . . false . . always . . . bell-features (bell) . . . no- . . : o system . . "Sound > Alert Sound" GNOME "Accessibility > System Bell" KDE Plasma. macOS . o audio . ( 1.3.0 macOS) o attention ( ) Ghostty . macOS . / : KDE GNOME Ghostty Sway . o title ( ) () ( ). o border . : 1.2.0 GTK 1.2.1 macOS. : audio no-audio system no-system : 1.2.0 . bell-audio-path audio . CLI . ~/ . : 1.2.0 GTK 1.3.0 macOS. bell-audio-volume audio ( ). 0.0 () 1.0 ( ) . 0.5 . : 1.2.0 GTK 1.3.0 macOS. app-notifications Ghostty . (GTK) (toasts) . . . : o clipboard-copy (: true) - . o config-reload (: true) - . . no- no-clipboard-copy. . "false" "true" . GTK . : 1.1.0 . macos-non-native-fullscreen false macOS . . : . macOS . . . command+tilde . . : o true - macOS . o false - macOS. o visible-menu - macOS . o padded-notch - macOS ( ) . . macos-window-buttons macOS . macOS . window-decoration = none macos-titlebar-style = hidden . : o visible - . o hidden - . visible . . : 1.2.0 . macos-titlebar-style macOS. : "native" "transparent" "tabs" "hidden". "native" macOS . ( window-theme ). "transparent" "native" . macOS . "transparent" ( OSC 11) . . "tabs" . . "hidden" . window-decoration = none . "hidden" . option+click . "transparent" . . macos-titlebar-proxy-icon macOS. . Terminal.app macOS . macOS . : o visible - . o hidden - . visible . . macos-dock-drop-behavior (drop) Ghostty macOS. : o new-tab - . o new-window - . new-tab . macOS . macos-option-as-alt macOS "alt" "option" . macOS option option-b "" . option alt . option alt . ( ) . U.S. Standard U.S. International "true" "false" . true Option Alt . Alt macOS Option . left right Option . macos-window-shadow macOS. true . false . macos-hidden macOS (App Switcher) . (quick terminal) . : o never - macOS . o always - macOS . : macOS . macOS . : 1.2.0 . macos-auto-secure-input true Ghostty macOS " " (Secure Input) . " " macOS . Ghostty > Secure Keyboard Entry . SSH . macos-secure-input-indication true Ghostty . . . . macos-applescript true Ghostty AppleScript macOS . false AppleScript . AppleScript AppleScript . true . macos-icon macOS. . Finder . : o official - Ghostty. o blueprint chalkboard microchip glass holographic paper retro xray - Ghostty ( ). o custom - . macos-custom-icon . o custom-style - Ghostty . macos-icon . macos-icon-ghost-color macos-icon-screen-color . : custom-style . macos-custom-icon . PNG JPEG ICNS . : ~/.config/ghostty/Ghostty.icns macos-icon-frame macOS. : o aluminum - (). o beige - . o plastic - . o chrome - . : macos-icon custom-style . macos-icon-ghost-color macOS. : macos-icon custom-style . (#RRGGBB RRGGBB) X11 . macos-icon-screen-color macOS. . X11 . . : macos-icon custom-style . macos-shortcuts Shortcuts macOS Ghostty. Ghostty Shortcuts Ghostty . . . : o ask - . Ghostty . o allow - Shortcuts . o deny - Shortcuts Ghostty. : 1.2.0 . linux-cgroup ( ) (scope) systemd. . OOM Ghostty . . ( ) "single-instance" . systemd . : o never - cgroup . o always - cgroup . o single-instance - cgroup Ghostty . linux-cgroup-memory-limit ( ) . . MemoryHigh systemd (soft limit) . systemd.resource-control : https://www.freedesktop.org/software/systemd/man/latest/systemd.resource-control.html linux-cgroup-processes-limit . . TasksMax systemd (hard limit) . systemd.resource-control : https://www.freedesktop.org/software/systemd/man/latest/systemd.resource-control.html linux-cgroup-hard-fail false systemd . true . . gtk-opengl-debug OpenGL GTK. true false . : 1.1.0 . gtk-single-instance true GTK : ghostty . false . detect Ghostty true () : 1. TERM_PROGRAM . 2. (CLI) . detect . gtk-titlebar GTK . . window-decoration none macOS . gtk-tabs-location GTK . (top) (bottom) (hidden) . top . hidden . gtk-titlebar-hide-when-maximized true (maximize) . GTK. : 1.1.0 . gtk-toolbar-style . : o flat - . o raised - . o raised-border - raised . gtk-titlebar-style GTK. native tabs . native . . tabs . . . . native . gtk-wide-tabs true () GTK Ghostty " (wide)" . . false . gtk-custom-css CSS . GTK CSS : o https://docs.gtk.org/gtk4/css-overview.html - GTK CSS. o https://docs.gtk.org/gtk4/css-properties.html - CSS . Ghostty env GTK_DEBUG=interactive ghostty GTK Inspector CSS . CSS Ghostty . GTK Inspector https://developer.gnome.org/documentation/tools/inspector.html . . ? . 5MiB . : 1.1.0 . desktop-notifications true () OSC 9 OSC 777 . progress-style true () ConEmu OSC 9;4 . false . bold-color (bold) . background foreground ( #RRGGBB). bold . bold bright . bright bold . bold . palette OSC 4 . Ghostty 1.2.0 . faint-opacity ( ) (faint). . . Ghostty 1.2.0 . term TERM . xterm vim ( modifyOtherKeys) . vim : :set keyprotocol=ghostty:kitty . https://github.com/vim/vim/pull/13211 . enquiry-response ENQ ( 0x05) . . async-backend / (async IO) . auto . API ( io_uring ) API . . . . : o auto - . o epoll - epoll. o io_uring - io_uring. Ghostty . . . macOS kqueue . : 1.2.0 . auto-update Ghostty. macOS Ghostty . . : Ghostty . . : o off - . o check - . o download - . Sparkle (defaults(1)) . . auto-update-channel . Ghostty . (pre-release) Ghostty tip . Ghostty stable . : o stable - "1.0.0". o tip - (main). . . Ghostty . macOS macOS . (KEYBIND ACTIONS) ignore . Ghostty . unbind . Ghostty ( ) . csi CSI. CSI CSI (ESC [ \x1b[). csi:0m . esc ESC. text . Zig . . ( ) . cursor_key pty (application) (normal) . reset . reset. (TUI) vim . enter . copy_to_clipboard . paste_from_clipboard (paste) . paste_from_selection (selection clipboard). copy_url_to_clipboard (URL) . copy_title_to_clipboard . . increase_font_size (pt). increase_font_size:1.5 1.5 . decrease_font_size (pt). decrease_font_size:1.5 1.5 . reset_font_size . set_font_size (pt). set_font_size:14.5 14.5 . search . . end_search . . search_selection . . . navigate_search . . start_search . . end_search . clear_screen (scrollback). select_all . scroll_to_top . scroll_to_bottom . scroll_to_selection . scroll_to_row . scroll_page_up . scroll_page_down . scroll_page_fractional . . scroll_page_fractional:0.5 scroll_page_fractional:-1.5 . scroll_page_lines . . scroll_page_lines:3 scroll_page_lines:-10 . adjust_selection . : . : o left right . o up down . o page_up page_down . o home end . o beginning_of_line end_of_line . jump_to_prompt . (shell integration) . . write_scrollback_file . . : o copy . o paste . o open . open macOS xdg-open . write_screen_file . write_scrollback_file . write_selection_file . write_scrollback_file . . new_window . . new_tab . previous_tab . next_tab . last_tab . goto_tab . . move_tab . . . move_tab:1 . move_tab:-1 . toggle_tab_overview (tab overview). libadwaita 1.4 . libadwaita ghostty +version . prompt_surface_title . prompt_tab_title . . set_surface_title . . set_tab_title . . new_split (split) . : o right down left up . o auto . - . goto_split (right down left up) (previous next). goto_window (previous next). toggle_split_zoom . . . toggle_readonly . : - PTY ( ) - / ( ) . - . resize_split . (,) resize_split:up,10. equalize_splits . reset_window_size . " " . . macOS . inspector (terminal inspector). : toggle show hide. show_gtk_inspector GTK (GTK inspector). macOS . show_on_screen_keyboard . (GTK) . GNOME "Screen Keyboard" Settings > Accessibility > Typing . open_config . . . reload_config . . . close_surface "" . confirm-close-surface . close_tab . . confirm-close-surface . close_window . confirm-close-surface . close_all_windows . : macOS . all:close_window . toggle_maximize (maximize) . macOS . toggle_fullscreen . toggle_window_decorations ( ) . . toggle_window_float_on_top . ( ) . macOS . toggle_secure_input (secure input). . . Ghostty . macOS . toggle_mouse_reporting . . . mouse-reporting . toggle_command_palette (command palette). ( ) . libadwaita 1.5 . ghostty +version . toggle_quick_terminal (quick terminal). " Quake" ( ) . . . (global) . Cmd+` : keybind = global:cmd+backquote=toggle_quick_terminal : o . o ( macOS) . o Wayland X11 Wayland wlr-layer-shell-v1 . GNOME . o KDE "Sliding Popups" KWin . > > > . Ghostty . o macOS macOS . o macOS . . . toggle_visibility . Ghostty . . : . macOS . toggle_background_opacity . background-opacity . background-opacity . macOS . check_for_updates . macOS . undo (undo) . . Ghostty . : o o o / . . undo-timeout . . macOS . redo (redo) . "undo" . end_key_sequence . : ctrl+w>escape=end_key_sequence ctrl+w . . (ctrl+w) . activate_key_table ( keybind ). deactivate_key_table . activate_key_table_once . performable false . performable false . activate_key_table_once activate_key_table ( catch_all ). "" . . deactivate_key_table . ( ) . . deactivate_all_key_tables . performable false . quit Ghostty. crash Ghostty . : (panic) . . . : o main ( ). o io / (IO) . o render . (FILES) $XDG_CONFIG_HOME/ghostty/config.ghostty . $HOME/Library/Application Support/com.mitchellh.ghostty/config.ghostty macOS . XDG . $LOCALAPPDATA/ghostty/config.ghostty $XDG_CONFIG_HOME $LOCALAPPDATA . (ENVIRONMENT) XDG_CONFIG_HOME . $HOME/Library/Application Support/com.mitchellh.ghostty MACOS. XDG . LOCALAPPDATA : . (BUGS) : (AUTHORS) Mitchell Hashimoto Ghostty contributors (SEE ALSO) ghostty(1) Version 1.3.1-arch2 GHOSTTY(5)