Configuration

The configuration file is kept at ~/.config/honeymux/config.json in JSON format. Keys are serialized alphabetically, matching the order below. Most settings can be edited from the in-app Options dialog; a few advanced ones require editing the JSON file directly.

Setting	Description
activeWindowIdDisplayEnabled	Show the active tmux window’s ID in the status chrome.
Type boolean Default false
agentAlertAnimConfusables	Use a Unicode-confusables glitch animation on the pane whose agent is waiting.
Type boolean Default false
agentAlertAnimCycleCount	Number of times the alert animation repeats for each alert event.
Type number (integer) Default 3
agentAlertAnimDelay	Delay between alert animation frames, in milliseconds. Larger values animate more slowly.
Type number (milliseconds) Default 60
agentAlertAnimEqualizer	Overlay an equalizer-style bar animation on the waiting agent’s pane.
Type boolean Default false
agentAlertAnimGlow	Apply a glow effect to the waiting agent’s pane.
Type boolean Default false
agentAlertAnimScribble	Apply a scribble/squiggle animation to the waiting agent’s pane.
Type boolean Default true
agentAlertCursorAlert	Swap in the alert cursor shape/color on panes whose agent is waiting.
Type boolean Default true
agentAlertCursorBlink	Whether the alert cursor blinks. “default” keeps the terminal’s existing blink behavior; “on” and “off” force it.
Type ”default” | “off” | “on” Default ”default”
agentAlertCursorColor	Color of the alert cursor, as a CSS hex string.
Type string (e.g. “#ff0000”) Default ”#ff0000”
agentAlertCursorShape	Shape of the alert cursor. “default” keeps the cursor’s existing shape.
Type ”bar” | “block” | “default” | “underline” Default ”default”
agentAlertWatermark	Watermark glyph drawn on the status area while at least one agent is waiting.
Type ”off” | “bear face” | “bear paw” | “honeycomb” | “unanswered count” Default ”off”
bufferZoomFade	Use a quick fade transition when entering/exiting buffer zoom. Truecolor terminals only.
Type boolean Default true
bufferZoomMaxLines	Maximum number of scrollback lines captured by buffer zoom. Use 0 for unlimited.
Type number (integer) Default 50000
dimInactivePanes	Dim every pane except the focused one.
Type boolean Default false
dimInactivePanesOpacity	Opacity applied to dimmed inactive panes, as a percentage from 0 (fully dim) to 100 (no dim).
Type number (0–100) Default 40
honeybeamsEnabled	Enable the Honeybeams idle animation.
Type boolean Default false
ignoreMouseInput	Drop mouse events inside panes, even for programs that request mouse-reporting mode.
Type boolean Default false
metaSavedAt	Timestamp of the last time the config file was written. Managed automatically; do not edit by hand.
Type number (epoch milliseconds) Default 0
muxotronEnabled	Enable the Mux-o-Tron interactive tmux controller.
Type boolean Default true
paneTabsEnabled	Enable Pane Tabs, which stack multiple terminal sessions inside a single pane.
Type boolean Default true
policyLocalOsc52Passthrough	Policy for forwarding local pane–originated OSC 52 clipboard sequences to the outer terminal emulator.
Type ”off” | “write-only” | “all” Default ”write-only”
policyLocalOtherOscPassthrough	Policy for forwarding host-affecting non-clipboard OSC passthrough sequences from local panes.
Type ”off” | “allow” Default ”allow”
privilegedPaneDetection	Detect panes running as root / under sudo and mark them visually.
Type boolean Default true
privilegedPaneDetectionOpacity	Opacity of the privileged-pane indicator, as a percentage from 0 to 100.
Type number (0–100) Default 10
quickTerminalSize	Percentage of the screen occupied by the Quick Terminal drop-down.
Type number (0–100) Default 90
remote	List of remote servers available for Remote Stitching. Omit or set to undefined for no remotes.
Type RemoteServerConfig[] | undefined Default undefined name (string, required) — user-facing label, e.g. “dev-box”. host (string, required) — SSH hostname or alias from ~/.ssh/config. port (number, optional) — SSH port. Defaults to 22. identityFile (string, optional) — path to an SSH identity key file. agentForwarding (boolean, optional) — forward the local SSH agent to the remote. Defaults to false.
screenshotDir	Directory where screenshot captures are written. ~ is expanded.
Type string (path) Default ”~/.local/state/honeymux/screenshots”
screenshotFlash	Play a brief screen flash when a screenshot is captured.
Type boolean Default true
screenshotMaxHeightPixels	Maximum height, in pixels, for a screenshot image. Captures whose scrollback would exceed this are refused.
Type number (pixels) Default 65535
themeBuiltin	Name of the bundled Base16 scheme to use when themeMode is “built-in”.
Type Base16SchemeName (one of the bundled Base16 scheme names) Default the project-wide default scheme
themeCustom	Base16 color palette used when themeMode is set to the custom mode. Edit to define a custom theme.
Type Base16Palette — object with hex-color string fields base00 through base0F. Default a neutral grayscale palette
themeMode	Selects which palette source drives the UI (e.g. a built-in Base16 scheme or the themeCustom palette).
Type ThemeMode Default ”built-in”
tmuxKeyBindingHints	Show inline hints next to actions that have a bound tmux key.
Type boolean Default true
tmuxPrefixKeyAlias	Modifier-only key (e.g. “right_alt”) that sends the current tmux prefix when tapped.
Type string | null (a canonical modifier-key name such as “left_shift”, “right_alt”, “right_super”, …) Default null
uiMode	Overall UI layout mode.
Type ”adaptive” | “marquee-top” | “marquee-bottom” | “raw” Default ”adaptive”
zoomAgentsViewStickyKey	When true, the zoom-agents modifier key is tap-to-toggle; when false, it must be held down.
Type boolean Default true
zoomServerViewStickyKey	When true, the zoom-panes modifier key is tap-to-toggle; when false, it must be held down.
Type boolean Default true