Settings

mightty reads one JSON settings file. It checks the file for changes every two seconds. A valid change affects new panes. An invalid change keeps the last valid settings active and shows an error in the window.

The default file is %APPDATA%\mightty\settings.json on Windows. Unix uses $XDG_CONFIG_HOME/mightty/settings.json or ~/.config/mightty/settings.json.

Set MIGHTTY_CONFIG_FILE to use an explicit file. Create mightty.portable beside the application to use settings.json in the application directory.

All fields are optional. This example shows the main settings:

{
  "app": {
    "sidebar_visible": true,
    "bell_notifications": true,
    "quick_terminal": {
      "enabled": false,
      "hotkey": "ctrl-`",
      "width_ratio": 0.8,
      "height_ratio": 0.45,
      "hide_on_focus_loss": true
    }
  },
  "terminal": {
    "initial_rows": 30,
    "initial_cols": 100,
    "scrollback": 10000,
    "cursor_style": "line",
    "cursor_blink": true,
    "blink_interval_ms": 500,
    "terminal_clipboard_policy": "deny",
    "font_family": "JetBrainsMono Nerd Font Mono",
    "font_size_px": 16,
    "theme": {
      "foreground": "#c0c0c0",
      "background": "#000000",
      "cursor": "#ffffff",
      "selection": "#3d3d3d"
    }
  },
  "profiles": [
    {
      "id": "work",
      "label": "Work PowerShell",
      "executable": "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
      "arguments": ["-NoLogo"],
      "starting_directory": "C:\\work",
      "environment": {
        "TERM": "xterm-256color"
      }
    }
  ],
  "default_profile": "work",
  "key_bindings": [
    {
      "chord": "ctrl-shift-p",
      "action": {"type": "command_palette"}
    }
  ]
}

Profile IDs are stable. Workspaces and actions use the ID instead of the label. An explicit profile can override a discovered profile with the same ID.

mightty discovers PowerShell, Command Prompt, WSL distributions, and Git Bash on Windows. Unix uses $SHELL and falls back to /bin/sh.

bell_notifications flashes the Windows taskbar button when an unfocused window receives a terminal bell. Active windows do not request attention.

AppInstaller controls updates for installed Windows packages. It checks on launch and in the background. See Windows distribution for package details.