{"record":{"id":"3459ef4ca19d6926","repo":"kovidgoyal/kitty","slug":"the-option-key-is-deprecated-use-macos-show-win","errorCode":null,"errorMessage":"The option {key} is deprecated. Use macos_show_window_title_in menubar instead.","messagePattern":"The option (.+?) is deprecated\\. Use macos_show_window_title_in menubar instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"kitty/options/utils.py","lineNumber":1880,"sourceCode":"            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'\n        elif macos_show_window_title_in == 'menubar':\n            macos_show_window_title_in = 'none'\n    ans['macos_show_window_title_in'] = macos_show_window_title_in\n\n\ndef deprecated_send_text(key: str, val: str, ans: dict[str, Any]) -> None:\n    parts = val.split(' ')\n\n    def abort(msg: str) -> None:","sourceCodeStart":1862,"sourceCodeEnd":1898,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kitty/options/utils.py#L1862-L1898","documentation":"macos_show_window_title_in_menubar is deprecated in favor of macos_show_window_title_in; kitty logs once per key (note the memoization writes attribute 'key' rather than the actual key, so the warning may repeat for distinct keys) and translates the boolean into the new option's value.","triggerScenarios":"Setting 'macos_show_window_title_in_menubar yes/no' in kitty.conf.","commonSituations":"Configs predating the menubar/window/all option; combining the old boolean with the new option and getting surprising merged results ('none'->'menubar', 'window'->'all').","solutions":["Replace with macos_show_window_title_in none|window|menubar|all.","Remove the old boolean line.","Verify merged behavior if both old and new options are present."],"exampleFix":"# before\nmacos_show_window_title_in_menubar yes\n\n# after\nmacos_show_window_title_in menubar","handlingStrategy":"fallback","validationCode":"def uses_deprecated_menubar_title(cfg: str) -> bool:\n    return 'macos_show_window_title_in_menubar' in cfg","typeGuard":"def uses_deprecated_menubar_title(cfg: str) -> bool:\n    return 'macos_show_window_title_in_menubar' in cfg","tryCatchPattern":null,"preventionTips":["Replace with macos_show_window_title_in menubar/window/none/all","Remove old boolean once migrated"],"tags":["kitty","config","deprecation","macos"],"backgroundTag":"deprecated-config-option","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}