{"record":{"id":"30fca3de0f26191a","repo":"kovidgoyal/kitty","slug":"the-option-key-is-deprecated-use-scrollbar-inst","errorCode":null,"errorMessage":"The option {key} is deprecated. Use scrollbar instead.","messagePattern":"The option (.+?) is deprecated\\. Use scrollbar instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"info","filePath":"kitty/options/utils.py","lineNumber":1926,"sourceCode":"\n\ndef deprecated_adjust_line_height(key: str, x: str, opts_dict: dict[str, Any]) -> None:\n    fm = {'adjust_line_height': 'cell_height', 'adjust_baseline': 'baseline', 'adjust_column_width': 'cell_width'}[key]\n    mtype = getattr(ModificationType, fm)\n    if x.endswith('%'):\n        ans = float(x[:-1].strip())\n        if ans < 0:\n            log_error(f'Percentage adjustments of {key} must be positive numbers')\n            return\n        opts_dict['modify_font'][fm] = FontModification(mtype, ModificationValue(ans, ModificationUnit.percent))\n    else:\n        opts_dict['modify_font'][fm] = FontModification(mtype, ModificationValue(int(x), ModificationUnit.pixel))\n\n\ndef deprecated_scrollback_indicator_opacity(key: str, val: str, ans: dict[str, Any]) -> None:\n    if not hasattr(deprecated_scrollback_indicator_opacity, key):\n        setattr(deprecated_scrollback_indicator_opacity, key, True)\n        log_error(f'The option {key} is deprecated. Use scrollbar instead.')\n    op = unit_float(val)\n    if op <= 0.001:\n        ans['scrollbar'] = 'never'\n    else:\n        ans['scrollbar_handle_opacity'] = op\n","sourceCodeStart":1908,"sourceCodeEnd":1932,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kitty/options/utils.py#L1908-L1932","documentation":"This error is logged when a deprecated scrollback indicator opacity option (e.g. scrollback_indicator_opacity) is set in kitty.conf. kitty maps these legacy options onto the new scrollbar options, and logs a deprecation warning once per option key via a function-attribute guard.","triggerScenarios":"Setting scrollback_indicator_opacity (or related deprecated keys) in kitty.conf or via a config include; the option parser deprecated_scrollback_indicator_opacity runs and logs once per key.","commonSituations":"Copying old configs from tutorials or older kitty versions into a newer kitty install (scrollbar replaced scrollback_indicator_opacity).","solutions":["Remove scrollback_indicator_opacity from kitty.conf and use scrollbar and scrollbar_handle_opacity instead","Run kitten choices or kitty --config to find which file/line still sets the deprecated option","Alias migration: value <= 0.001 maps to scrollbar never; otherwise set scrollbar_handle_opacity to the same float"],"exampleFix":"# before\nscrollback_indicator_opacity 0.75\n\n# after\nscrollbar auto\nscrollbar_handle_opacity 0.75","handlingStrategy":"validation","validationCode":"# before shipping a config, check for deprecated keys\nimport re\nbad = [l for l in open('kitty.conf') if re.match(r'\\s*scrollback_indicator_opacity', l)]\nassert not bad, bad","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep kitty.conf keys aligned with the docs of your installed version","Run kitten update-config / check release notes when upgrading kitty"],"tags":["kitty","deprecation","config","scrollbar"],"backgroundTag":"deprecated-option","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}