{"record":{"id":"462d341405a7601f","repo":"kovidgoyal/kitty","slug":"the-option-key-is-deprecated-use-hide-window-de","errorCode":null,"errorMessage":"The option {key} is deprecated. Use hide_window_decorations instead.","messagePattern":"The option (.+?) is deprecated\\. Use hide_window_decorations instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"kitty/options/utils.py","lineNumber":1871,"sourceCode":"        return ()\n    ans: list[tuple[Color, float]] = []\n    seen: dict[Color, int] = {}\n    for part in spec.split():\n        col, sep, alpha = part.partition('@')\n        c = to_color(col)\n        o = max(-1, min(float(alpha) if alpha else -1, 1))\n        if (idx := seen.get(c)) is not None:\n            ans[idx] = c, o\n            continue\n        seen[c] = len(ans)\n        ans.append((c, o))\n    return tuple(ans[:7])\n\n\ndef deprecated_hide_window_decorations_aliases(key: str, val: str, ans: dict[str, Any]) -> None:\n    if not hasattr(deprecated_hide_window_decorations_aliases, key):\n        setattr(deprecated_hide_window_decorations_aliases, key, True)\n        log_error(f'The option {key} is deprecated. Use hide_window_decorations instead.')\n    if to_bool(val):\n        if is_macos and key == 'macos_hide_titlebar' or (not is_macos and key == 'x11_hide_window_decorations'):\n            ans['hide_window_decorations'] = True\n\n\ndef deprecated_macos_show_window_title_in_menubar_alias(key: str, val: str, ans: dict[str, Any]) -> None:\n    if not hasattr(deprecated_macos_show_window_title_in_menubar_alias, key):\n        setattr(deprecated_macos_show_window_title_in_menubar_alias, 'key', True)\n        log_error(f'The option {key} is deprecated. Use macos_show_window_title_in menubar instead.')\n    macos_show_window_title_in = ans.get('macos_show_window_title_in', 'all')\n    if to_bool(val):\n        if macos_show_window_title_in == 'none':\n            macos_show_window_title_in = 'menubar'\n        elif macos_show_window_title_in == 'window':\n            macos_show_window_title_in = 'all'\n    else:\n        if macos_show_window_title_in == 'all':\n            macos_show_window_title_in = 'window'","sourceCodeStart":1853,"sourceCodeEnd":1889,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kitty/options/utils.py#L1853-L1889","documentation":"macos_hide_titlebar / x11_hide_window_decorations (and related aliases) are deprecated; kitty logs this once per key and maps them to hide_window_decorations where appropriate. The log line uses {key} without .format in the deprecation branch path shown, producing the literal placeholder in the message text.","triggerScenarios":"Having 'macos_hide_titlebar yes' or 'x11_hide_window_decorations yes' in kitty.conf on any platform; the warning fires once per deprecated key per process due to a function-attribute memoization.","commonSituations":"Old configs from kitty <0.14-ish era; tutorials still recommending the old options.","solutions":["Replace with hide_window_decorations yes|no|titlebar-only (macOS alias: system).","Remove macos_hide_titlebar and x11_hide_window_decorations lines.","Ignore the warning harmlessly if you cannot edit the config yet."],"exampleFix":"# before\nmacos_hide_titlebar yes\n\n# after\nhide_window_decorations titlebar-only","handlingStrategy":"fallback","validationCode":"def uses_deprecated_hide_decorations(cfg: str) -> bool:\n    return 'macos_hide_titlebar' in cfg or 'x11_hide_window_decorations' in cfg","typeGuard":"def uses_deprecated_hide_decorations(cfg: str) -> bool:\n    return 'macos_hide_titlebar' in cfg or 'x11_hide_window_decorations' in cfg","tryCatchPattern":null,"preventionTips":["Migrate to hide_window_decorations","Periodically run kitty +runpy config parse to catch deprecations"],"tags":["kitty","config","deprecation","window-decorations"],"backgroundTag":"deprecated-config-option","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}