Input keymap 0.9
Schema reference / Input keymap / 0.9
Keymap v2: per-mode actions with up to three bindings each, hold timing and capture limits. Directory versions follow the IPC revision that introduced them.
Raw schema
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://hyprune.com/schema/v0.9/input.schema.json", "type": "object", "properties": { "version": { "const": 2 }, "longHoldMs": { "type": "integer", "minimum": 100, "maximum": 5000 }, "scopeVignette": { "type": "boolean" }, "useDistance": { "type": "number", "minimum": 0.2, "maximum": 30 }, "useTolerance": { "type": "number", "minimum": 0, "maximum": 0.5 }, "captureInputLimit": { "type": "integer", "minimum": 16, "maximum": 1024 }, "modes": { "type": "object", "properties": { "world": { "type": "object", "properties": { "look": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "forward": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "back": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "left": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "right": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "menu": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "sprint": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "up": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "down": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "use": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "focus": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "noclip": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "scope": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "debug": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "capture": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "carry": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "resize": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "distance": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "rotate": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "tool1": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "tool2": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "tool3": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "tool4": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "hud.cycle": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "transport": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "autopilot": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "primary": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "secondary": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "wheel": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "fly": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true } }, "required": [ "look", "forward", "back", "left", "right", "menu", "sprint", "up", "down", "use", "focus", "noclip", "scope", "debug", "capture", "carry", "resize", "distance", "rotate", "tool1", "tool2", "tool3", "tool4", "hud.cycle", "transport", "autopilot", "primary", "secondary", "wheel", "fly" ], "additionalProperties": false }, "interactive": { "type": "object", "properties": { "exit": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "debug": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "capture": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true } }, "required": [ "exit" ], "additionalProperties": false }, "focus": { "type": "object", "properties": { "exit": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "debug": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "capture": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true } }, "required": [ "exit" ], "additionalProperties": false }, "menu": { "type": "object", "properties": { "exit": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "debug": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true }, "capture": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 96 }, "maxItems": 3, "uniqueItems": true } }, "required": [ "exit" ], "additionalProperties": false } }, "required": [ "world", "interactive", "focus", "menu" ], "additionalProperties": false }, "invert_y": { "type": "boolean", "description": "Invert vertical mouse look; default false." }, "show_area_markers": { "type": "boolean", "description": "Render optional place/area labels in core; default false." } }, "required": [ "version", "longHoldMs", "scopeVignette", "useDistance", "useTolerance", "captureInputLimit", "modes" ], "additionalProperties": false}Changes since 0.6
Structural diff against 0.6: 1 definition changed. Descriptions and $id changes are ignored.
1 change
- changed
top-level fields- +
modes.world.hud.cyclestring[] (required) · items ≤ 3 · unique items · each length 1–96 - −
modes.world.tool5
- +
Fields
| Field | Type | Constraints |
|---|---|---|
versionrequired | 2 | |
longHoldMsrequired | integer | ≥ 100 · ≤ 5000 |
scopeVignetterequired | boolean | |
useDistancerequired | number | ≥ 0.2 · ≤ 30 |
useTolerancerequired | number | ≥ 0 · ≤ 0.5 |
captureInputLimitrequired | integer | ≥ 16 · ≤ 1024 |
modesrequired | object | |
worldrequired | object | |
lookrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
forwardrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
backrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
leftrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
rightrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
menurequired | string[] | items ≤ 3 · unique items · each length 1–96 |
sprintrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
uprequired | string[] | items ≤ 3 · unique items · each length 1–96 |
downrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
userequired | string[] | items ≤ 3 · unique items · each length 1–96 |
focusrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
nocliprequired | string[] | items ≤ 3 · unique items · each length 1–96 |
scoperequired | string[] | items ≤ 3 · unique items · each length 1–96 |
debugrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
capturerequired | string[] | items ≤ 3 · unique items · each length 1–96 |
carryrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
resizerequired | string[] | items ≤ 3 · unique items · each length 1–96 |
distancerequired | string[] | items ≤ 3 · unique items · each length 1–96 |
rotaterequired | string[] | items ≤ 3 · unique items · each length 1–96 |
tool1required | string[] | items ≤ 3 · unique items · each length 1–96 |
tool2required | string[] | items ≤ 3 · unique items · each length 1–96 |
tool3required | string[] | items ≤ 3 · unique items · each length 1–96 |
tool4required | string[] | items ≤ 3 · unique items · each length 1–96 |
hud.cyclerequired | string[] | items ≤ 3 · unique items · each length 1–96 |
transportrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
autopilotrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
primaryrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
secondaryrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
wheelrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
flyrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
interactiverequired | object | |
exitrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
debug | string[] | items ≤ 3 · unique items · each length 1–96 |
capture | string[] | items ≤ 3 · unique items · each length 1–96 |
focusrequired | object | |
exitrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
debug | string[] | items ≤ 3 · unique items · each length 1–96 |
capture | string[] | items ≤ 3 · unique items · each length 1–96 |
menurequired | object | |
exitrequired | string[] | items ≤ 3 · unique items · each length 1–96 |
debug | string[] | items ≤ 3 · unique items · each length 1–96 |
capture | string[] | items ≤ 3 · unique items · each length 1–96 |
invert_y | boolean | Invert vertical mouse look; default false. |
show_area_markers | boolean | Render optional place/area labels in core; default false. |
Examples
Offline fixtures from the schema repository, validated by its test suite. They show shape, not a real session or package.
placement-input.json
{ "version": 2, "longHoldMs": 1000, "scopeVignette": true, "invert_y": false, "useDistance": 6, "useTolerance": 0.12, "captureInputLimit": 256, "modes": { "world": { "look": [ "MouseMove" ], "forward": [ "k", "w", "Up" ], "back": [ "j", "s", "Down" ], "left": [ "h", "a", "Left" ], "right": [ "l", "d", "Right" ], "menu": [ "Tab[L]" ], "sprint": [ "Shift_L" ], "up": [ "space" ], "down": [ "Control_L" ], "use": [ "e" ], "focus": [ "f" ], "noclip": [ "v" ], "scope": [ "q" ], "debug": [ "F3", "y" ], "capture": [ "u" ], "carry": [ "Super+LMB" ], "resize": [ "Super+RMB" ], "distance": [ "Super+Wheel" ], "rotate": [ "Super+Ctrl+Wheel" ], "tool1": [ "1" ], "tool2": [ "2" ], "tool3": [ "3" ], "tool4": [ "4" ], "hud.cycle": [], "transport": [ "z" ], "autopilot": [ "x" ], "primary": [ "LMB" ], "secondary": [ "RMB" ], "fly": [ "F4" ], "record.toggle": [], "exit": [ "Super+Tab", "Back" ], "tool5": [ "5" ], "content.scale": [ "Super+Shift+Wheel" ], "window.reset": [ "Super+Shift+MMB" ], "carry.facing": [ "r" ], "alternate": [ "MMB" ], "cycle": [ "Wheel" ] }, "interactive": { "exit": [ "Super+Tab", "Back" ], "debug": [ "F3" ], "capture": [ "Super+u" ], "record.toggle": [] }, "focus": { "exit": [ "Super+Tab", "Back" ], "debug": [ "F3" ], "capture": [ "Super+u" ], "record.toggle": [] }, "menu": { "exit": [ "Escape" ], "debug": [ "F3" ], "capture": [ "Super+u" ], "record.toggle": [] } }, "show_area_markers": false}Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 a069cb5db721bf78a3760516b0e6da855b382705eccfa9b41c04d41da5aa6064.