dotfiles/.config/ghostty/README.org

Ghostty Terminal Configuration

• Ghostty Terminal Configuration
  • Header
  • Basic Settings
  • Colors
  • Normal Colors
  • Bright Colors
  • Cursor Settings
• Setting Up Auto-Tangle

Ghostty Terminal Configuration

This file contains the configuration settings for the Ghostty terminal emulator. It's written using Org Mode's literate programming features, allowing for clear documentation alongside the configuration code.

The configuration is automatically tangled (extracted) into a file named config in the same directory whenever this Org file is saved in Emacs, thanks to the #+auto_tangle: t property and a custom Emacs Lisp function (detailed at the end). This ensures the Ghostty application always uses the latest settings defined here.

Header

A decorative header block.

#
# ██████╗  ██████╗  ██████╗ ███████╗
# ██╔══██╗██╔═══██╗██╔════╝ ██╔════╝     Roger Gonzalez
# ██████╔╝██║   ██║██║  ███╗███████╗     https://rogs.me
# ██╔══██╗██║   ██║██║   ██║╚════██║
# ██║  ██║╚██████╔╝╚██████╔╝███████║
# ╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚══════╝

Basic Settings

This section covers fundamental appearance and behavior settings for the terminal window.

#########
# Basic #
#########
gtk-titlebar=false          # Use Ghostty's custom titlebar instead of the GTK default.
background-opacity = 0.80   # Set the terminal background transparency (0.0=fully transparent, 1.0=fully opaque).
term = xterm-256color       # Set the TERM environment variable value reported by the terminal.
confirm-close-surface=false # Disable confirmation dialog when closing a terminal window/tab.
window-decoration=false     # Disable window decorations (like borders and title bar) managed by the window manager. Useful for tiling WMs.
mouse-scroll-multiplier=2   # Adjust the speed of scrolling with the mouse wheel.

font-size = 12              # Set the default font size.
font-family = MesloLGS NF   # Specify the primary font family. 'MesloLGS NF' includes Nerd Fonts glyphs.
class = ghostty             # Set the window class hint, useful for window manager rules.
font-thicken = true         # Apply a slight thickening effect to the font for better visibility.

Colors

Defines the core color elements of the terminal interface.

##########
# Colors #
##########

background = 000000           # Default background color (black).
foreground = d0d0d0           # Default text color (light gray).
selection-background = 555555 # Background color for selected text (medium gray).

Normal Colors

These are the standard 8 ANSI colors used by many terminal applications.

# Normal colors
# Black
palette = 0=#282a36
# Red
palette = 1=#f07178
# Green
palette = 2=#c3e88d
# Yellow
palette = 3=#ffcb6b
# Blue
palette = 4=#82aaff
# Magenta
palette = 5=#c792ea
# Cyan
palette = 6=#89ddff
# White
palette = 7=#d0d0d0

Bright Colors

These are the brighter variants of the standard 8 ANSI colors.

# Bright colors
# Black
palette = 8=#434758
# Red
palette = 9=#ff8b92
# Green
palette = 10=#ddffa7
# Yellow
palette = 11=#ffe585
# Blue
palette = 12=#9cc4ff
# Magenta
palette = 13=#e1acff
# Cyan
palette = 14=#a3f7ff
# White
palette = 15=#ffffff

Cursor Settings

Controls the appearance and behavior of the text cursor within the terminal.

# Cursor
cursor-color = #FFFFFF          # The color of the cursor itself (white).
cursor-text = #000000           # The color of the text character under the cursor (black).
cursor-style-blink = false      # Disable cursor blinking.
cursor-style = block            # Set the cursor shape to a solid block.
shell-integration-features = no-cursor # Disable cursor shape changes based on shell integration hints (e.g., Vim mode).
cursor-invert-fg-bg = true      # When the cursor is over text, invert the foreground and background colors instead of using cursor-text.

Setting Up Auto-Tangle

This configuration file uses Org Mode's literate programming capabilities. To automatically generate the config file needed by Polybar every time this .org file is saved in Emacs, you need to add the following Elisp code to your Emacs initialization file (e.g., ~/.emacs.d/init.el). This code defines a function `org-babel-auto-tangle` and adds it to the `after-save-hook`. When an Org file is saved, this function checks for the `#+auto_tangle: t` property at the beginning of the file and, if found, runs `org-babel-tangle` to generate the output file(s) (in this case, config).

;; Auto-tangle configuration files
(use-package org
  :config
  (defun org-babel-auto-tangle ()
    "Automatically tangle org files when saved if they have '#+auto_tangle: t'."
    (when (eq major-mode 'org-mode)
      ;; Check for the #+auto_tangle property in the Org file's keywords
      (let ((auto-tangle (cdr (assoc "auto_tangle" (org-collect-keywords '("PROPERTY"))))))
        ;; If the property exists and is set to "t", tangle the file
        (when (and auto-tangle (string= auto-tangle "t"))
          (org-babel-tangle)))))
  ;; Run the auto-tangle function after any buffer is saved
  (add-hook 'after-save-hook #'org-babel-auto-tangle))