{"record":{"id":"04b547e1fda37836","repo":"kovidgoyal/kitty","slug":"this-kitten-must-be-used-only-from-a-kitty-conf-ma","errorCode":null,"errorMessage":"This kitten must be used only from a kitty.conf mapping","messagePattern":"This kitten must be used only from a kitty\\.conf mapping","errorType":"console","errorClass":"SystemExit","httpStatus":null,"severity":"warning","filePath":"kittens/command_palette/main.py","lineNumber":308,"sourceCode":"    relocate_mode_entry_bindings(modes)\n    add_unmapped_actions(modes)\n    add_alias_sections(opts, modes)\n\n    mode_order = list(modes.keys())\n    category_order: dict[str, list[str]] = {}\n    for mode_name, cats in modes.items():\n        category_order[mode_name] = list(cats.keys())\n\n    return {\n        'modes': modes,\n        'mouse': collect_mouse_bindings(opts),\n        'mode_order': mode_order,\n        'category_order': category_order,\n    }\n\n\ndef main(args: list[str]) -> None:\n    raise SystemExit('This kitten must be used only from a kitty.conf mapping')\n\n\ndef callback(target_window_id: int, action: str, timer_id: int | None) -> None:\n    boss = get_boss()\n    w = boss.window_id_map.get(target_window_id)\n    boss.combine(action, w)\n\n\n@result_handler(has_ready_notification=True)\ndef handle_result(args: list[str], data: dict[str, Any], target_window_id: int, boss: BossType) -> None:\n    if data and (action := data.get('action')):\n        # run action after event loop tick so command palette overlay is closed\n        add_timer(partial(callback, target_window_id, action), 0, False)\n\n\nhelp_text = 'Browse and trigger keyboard shortcuts and actions'\nusage = ''\nOPTIONS = r\"\"\"","sourceCodeStart":290,"sourceCodeEnd":326,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kittens/command_palette/main.py#L290-L326","documentation":"kitty failed to munmap a window logo bitmap in free_window_logo_bitmap (kitty/window_logo.c:41) - the per-window logo analogue of the background-image error. The logo was mmap'd from kitty's image cache and the unmap syscall failed during logo replacement, window close, or shutdown.","triggerScenarios":"Configuring window_logo_path and then changing the logo at runtime (kitten @set-window-logo), closing windows, or quitting. Fires only when wl->mmap_size != 0 and munmap() returns non-zero.","commonSituations":"Corrupt kitty image cache, logo file modified/truncated while mapped, or memory corruption. Rare in practice.","solutions":["Clear kitty's cache: rm -rf ~/.cache/kitty and restart.","Re-save the logo image to guarantee a valid file.","Test with a different logo to isolate file corruption.","Reproduce and report upstream with kitty/kernel versions if persistent."],"exampleFix":"# before\nwindow_logo_path ~/bad-logo.png\n# after\nrm -rf ~/.cache/kitty\nwindow_logo_path /abs/path/good-logo.png","handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use a valid, stable PNG/JPEG for window_logo_path.","Clear ~/.cache/kitty after changing logo images if oddities appear."],"tags":["kitty","window-logo","mmap","memory","cleanup"],"backgroundTag":"mmap-unmap-failed","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}