Skip to content

Input keymap 0.6

Schema reference / Input keymap / 0.6

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.

Status
Frozen · latest is 0.9
Published
2026-10-08
Title as published
“Hyprune input keymap v2” This title doesn’t name version 0.6. Published schemas are frozen byte-for-byte, so it is kept; the version on this page comes from the schema’s path and $id.
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemainput.schema.json · 519 lines · 13 KB
DownloadOpen rawsha256 41193bad62d8…
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://hyprune.com/schema/v0.6/input.schema.json",
"title": "Hyprune input keymap v2",
"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
},
"tool5": {
"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",
"tool5",
"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
}

This is the first published version of this contract.

Fields

FieldTypeConstraints
versionrequired2
longHoldMsrequiredinteger≥ 100 · ≤ 5000
scopeVignetterequiredboolean
useDistancerequirednumber≥ 0.2 · ≤ 30
useTolerancerequirednumber≥ 0 · ≤ 0.5
captureInputLimitrequiredinteger≥ 16 · ≤ 1024
modesrequiredobject
worldrequiredobject
lookrequiredstring[]items ≤ 3 · unique items · each length 1–96
forwardrequiredstring[]items ≤ 3 · unique items · each length 1–96
backrequiredstring[]items ≤ 3 · unique items · each length 1–96
leftrequiredstring[]items ≤ 3 · unique items · each length 1–96
rightrequiredstring[]items ≤ 3 · unique items · each length 1–96
menurequiredstring[]items ≤ 3 · unique items · each length 1–96
sprintrequiredstring[]items ≤ 3 · unique items · each length 1–96
uprequiredstring[]items ≤ 3 · unique items · each length 1–96
downrequiredstring[]items ≤ 3 · unique items · each length 1–96
userequiredstring[]items ≤ 3 · unique items · each length 1–96
focusrequiredstring[]items ≤ 3 · unique items · each length 1–96
nocliprequiredstring[]items ≤ 3 · unique items · each length 1–96
scoperequiredstring[]items ≤ 3 · unique items · each length 1–96
debugrequiredstring[]items ≤ 3 · unique items · each length 1–96
capturerequiredstring[]items ≤ 3 · unique items · each length 1–96
carryrequiredstring[]items ≤ 3 · unique items · each length 1–96
resizerequiredstring[]items ≤ 3 · unique items · each length 1–96
distancerequiredstring[]items ≤ 3 · unique items · each length 1–96
rotaterequiredstring[]items ≤ 3 · unique items · each length 1–96
tool1requiredstring[]items ≤ 3 · unique items · each length 1–96
tool2requiredstring[]items ≤ 3 · unique items · each length 1–96
tool3requiredstring[]items ≤ 3 · unique items · each length 1–96
tool4requiredstring[]items ≤ 3 · unique items · each length 1–96
tool5requiredstring[]items ≤ 3 · unique items · each length 1–96
transportrequiredstring[]items ≤ 3 · unique items · each length 1–96
autopilotrequiredstring[]items ≤ 3 · unique items · each length 1–96
primaryrequiredstring[]items ≤ 3 · unique items · each length 1–96
secondaryrequiredstring[]items ≤ 3 · unique items · each length 1–96
wheelrequiredstring[]items ≤ 3 · unique items · each length 1–96
flyrequiredstring[]items ≤ 3 · unique items · each length 1–96
interactiverequiredobject
exitrequiredstring[]items ≤ 3 · unique items · each length 1–96
debugstring[]items ≤ 3 · unique items · each length 1–96
capturestring[]items ≤ 3 · unique items · each length 1–96
focusrequiredobject
exitrequiredstring[]items ≤ 3 · unique items · each length 1–96
debugstring[]items ≤ 3 · unique items · each length 1–96
capturestring[]items ≤ 3 · unique items · each length 1–96
menurequiredobject
exitrequiredstring[]items ≤ 3 · unique items · each length 1–96
debugstring[]items ≤ 3 · unique items · each length 1–96
capturestring[]items ≤ 3 · unique items · each length 1–96
invert_yboolean

Invert vertical mouse look; default false.

show_area_markersboolean

Render optional place/area labels in core; default false.

Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 41193bad62d8b977a781c015614781a76caff25a67aecdc7927e7e6575957fca.