{"record":{"id":"58613bfb1fe4f2da","repo":"kovidgoyal/kitty","slug":"should-be-run-as-kitten-hints-58613b","errorCode":null,"errorMessage":"Should be run as kitten hints","messagePattern":"Should be run as kitten hints","errorType":"console","errorClass":"SystemExit","httpStatus":null,"severity":"warning","filePath":"kittens/query_terminal/main.py","lineNumber":297,"sourceCode":"\n    query: data\n\nIf a particular :italic:`query` is unsupported by the running kitty version, the\n:italic:`data` will be blank.\n\nNote that when calling this from another program, be very careful not to perform\nany I/O on the terminal device until this kitten exits.\n\nAvailable queries are:\n\n{}\n\n\"\"\".format('\\n'.join(f':code:`{name}`:\\n  {c.help_text}\\n' for name, c in all_queries.items()))\nusage = '[query1 query2 ...]'\n\n\nif __name__ == '__main__':\n    raise SystemExit('Should be run as kitten hints')\nelif __name__ == '__doc__':\n    cd = sys.cli_docs  # type: ignore\n    cd['usage'] = usage\n    cd['options'] = options_spec\n    cd['help_text'] = help_text\n    cd['short_desc'] = 'Query the terminal for various capabilities'\n","sourceCodeStart":279,"sourceCodeEnd":304,"githubUrl":"https://github.com/kovidgoyal/kitty/blob/6d5d0c440603ad9bdf6dcd599f73f6dde21acb44/kittens/query_terminal/main.py#L279-L304","documentation":"Writing the single wakeup byte 'w' to the canberra notification-sound pipe failed (non-EINTR error). The sound event stays queued until the canberra thread next wakes, so the expected sound may be delayed or missed. Purely an audio-notification plumbing failure.","triggerScenarios":"Triggering a bell/system sound (queue_canberra_sound, e.g. on window bell) when the canberra pipe write end is closed or the pipe is full/broken — typically during shutdown or if the sound thread died.","commonSituations":"Kitty shutting down while a bell fires; libcanberra unavailable or the audio thread crashed earlier; descriptor exhaustion making the write fail.","solutions":["If sounds otherwise work, treat a one-off occurrence during shutdown as harmless","If sounds never play, check audio setup (libcanberra, PipeWire/PulseAudio) and kitty's audio support on your platform","Update kitty — sound-thread lifecycle bugs get fixed over versions"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":["Ignore single occurrences during shutdown","Verify libcanberra and the audio server work (test with canberra-gtk-play)","Keep kitty updated for sound-thread fixes"],"tags":["audio","libcanberra","bell","kitty"],"backgroundTag":"audio-notification-failed","analyzedSha":"6d5d0c440603ad9bdf6dcd599f73f6dde21acb44","analyzedAt":"2026-08-27T14:20:20.142Z","schemaVersion":2},"datasetVersion":"2026-08-27T19:17:21.184Z"}