#include <stddef.h>
#include <stdint.h>
#include <ghostty/vt/types.h>
#include <ghostty/vt/allocator.h>
#include <ghostty/vt/terminal.h>
#include <ghostty/vt/key/event.h>

Macros
#define	GHOSTTY_KITTY_KEY_DISABLED 0
#define	GHOSTTY_KITTY_KEY_DISAMBIGUATE (1 << 0)
#define	GHOSTTY_KITTY_KEY_REPORT_EVENTS (1 << 1)
#define	GHOSTTY_KITTY_KEY_REPORT_ALTERNATES (1 << 2)
#define	GHOSTTY_KITTY_KEY_REPORT_ALL (1 << 3)
#define	GHOSTTY_KITTY_KEY_REPORT_ASSOCIATED (1 << 4)
#define	GHOSTTY_KITTY_KEY_ALL (GHOSTTY_KITTY_KEY_DISAMBIGUATE \| GHOSTTY_KITTY_KEY_REPORT_EVENTS \| GHOSTTY_KITTY_KEY_REPORT_ALTERNATES \| GHOSTTY_KITTY_KEY_REPORT_ALL \| GHOSTTY_KITTY_KEY_REPORT_ASSOCIATED)

Typedefs
typedef struct GhosttyKeyEncoder *	GhosttyKeyEncoder
typedef uint8_t	GhosttyKittyKeyFlags

Enumerations
enum	GhosttyOptionAsAlt { GHOSTTY_OPTION_AS_ALT_FALSE = 0 , GHOSTTY_OPTION_AS_ALT_TRUE = 1 , GHOSTTY_OPTION_AS_ALT_LEFT = 2 , GHOSTTY_OPTION_AS_ALT_RIGHT = 3 }
enum	GhosttyKeyEncoderOption { GHOSTTY_KEY_ENCODER_OPT_CURSOR_KEY_APPLICATION = 0 , GHOSTTY_KEY_ENCODER_OPT_KEYPAD_KEY_APPLICATION = 1 , GHOSTTY_KEY_ENCODER_OPT_IGNORE_KEYPAD_WITH_NUMLOCK = 2 , GHOSTTY_KEY_ENCODER_OPT_ALT_ESC_PREFIX = 3 , GHOSTTY_KEY_ENCODER_OPT_MODIFY_OTHER_KEYS_STATE_2 = 4 , GHOSTTY_KEY_ENCODER_OPT_KITTY_FLAGS = 5 , GHOSTTY_KEY_ENCODER_OPT_MACOS_OPTION_AS_ALT = 6 }

Functions
GhosttyResult	ghostty_key_encoder_new (const GhosttyAllocator allocator, GhosttyKeyEncoder encoder)
void	ghostty_key_encoder_free (GhosttyKeyEncoder encoder)
void	ghostty_key_encoder_setopt (GhosttyKeyEncoder encoder, GhosttyKeyEncoderOption option, const void *value)
void	ghostty_key_encoder_setopt_from_terminal (GhosttyKeyEncoder encoder, GhosttyTerminal terminal)
GhosttyResult	ghostty_key_encoder_encode (GhosttyKeyEncoder encoder, GhosttyKeyEvent event, char out_buf, size_t out_buf_size, size_t out_len)

Detailed Description

Key event encoding to terminal escape sequences.

Definition in file key/encoder.h.

Macro Definition Documentation

◆ GHOSTTY_KITTY_KEY_ALL

#define GHOSTTY_KITTY_KEY_ALL (GHOSTTY_KITTY_KEY_DISAMBIGUATE | GHOSTTY_KITTY_KEY_REPORT_EVENTS | GHOSTTY_KITTY_KEY_REPORT_ALTERNATES | GHOSTTY_KITTY_KEY_REPORT_ALL | GHOSTTY_KITTY_KEY_REPORT_ASSOCIATED)

All Kitty keyboard protocol flags enabled

Examples: c-vt-encode-key/src/main.c.

Definition at line 57 of file key/encoder.h.

◆ GHOSTTY_KITTY_KEY_DISABLED

#define GHOSTTY_KITTY_KEY_DISABLED 0

Kitty keyboard protocol disabled (all flags off)

Definition at line 39 of file key/encoder.h.

◆ GHOSTTY_KITTY_KEY_DISAMBIGUATE

#define GHOSTTY_KITTY_KEY_DISAMBIGUATE (1 << 0)

Disambiguate escape codes

Definition at line 42 of file key/encoder.h.

◆ GHOSTTY_KITTY_KEY_REPORT_ALL

#define GHOSTTY_KITTY_KEY_REPORT_ALL (1 << 3)

Report all key events including those normally handled by the terminal

Definition at line 51 of file key/encoder.h.

◆ GHOSTTY_KITTY_KEY_REPORT_ALTERNATES

#define GHOSTTY_KITTY_KEY_REPORT_ALTERNATES (1 << 2)

Report alternate key codes

Definition at line 48 of file key/encoder.h.

◆ GHOSTTY_KITTY_KEY_REPORT_ASSOCIATED

#define GHOSTTY_KITTY_KEY_REPORT_ASSOCIATED (1 << 4)

Report associated text with key events

Definition at line 54 of file key/encoder.h.

◆ GHOSTTY_KITTY_KEY_REPORT_EVENTS

#define GHOSTTY_KITTY_KEY_REPORT_EVENTS (1 << 1)

Report key press and release events

Definition at line 45 of file key/encoder.h.

Macros

Typedefs

Enumerations

Functions