Keyboard Neighbor Shift Cipher

Shift each letter in caller complete26-key row layout with explicit wrap, no OS keyboard access or Unicode layout assumption. Classical educational encoding only; not secure encryption, no hidden normalization or inferred key.

Description

A keyboard-neighbor cipher replaces each letter with a neighbor within its supplied row.

A keyboard-neighbor cipher replaces each letter with a neighbor within its supplied row.^[1]

Per-row wrapping and layout are part of this tool's declared convention. Use Keyboard Neighbor Shift Cipher to evaluate the supplied inputs under the specific model below.

When to use Keyboard Neighbor Shift Cipher

Use Keyboard Neighbor Shift Cipher to evaluate the supplied inputs under the specific model below. Choose the intended encoding, alphabet or check and keep the exact character, key and measurement conventions described below.

How to use Keyboard Neighbor Shift Cipher and understand its results

Choose the intended encoding, alphabet or check and keep the exact character, key and measurement conventions described below.
Enter Text, Direction, Caller keyboard rows using the field table and validation rules below, then run the tool.
Read Transformed and interpret units, signs, ordering and placeholders as explained below.
If the tool reports an input error, correct that field and rerun. A successful false result, empty match list or unknown-evidence placeholder has the specific meaning described here; check the limitations before applying the result.

Input field	Meaning	Value type	Requirement
text	Text	string	Required; constraints below
direction	Direction	number	Required; constraints below
callerKeyboardRows	Caller keyboard rows	array of string	Required; constraints below

Supply nonempty keyboard-row strings whose combined alphabet has exactly 26 distinct uppercase ASCII letters or digits, uppercase A–Z text and direction −1 or +1. Every text letter must be present in a supplied row. Shift each letter within that row, wrapping at its ends; there is no cross-row or physical-keyboard search. Use A–Z rows when encoding ordinary alphabetic text.

shiftedLetter = row[(letterIndex+direction) mod rowLength]

Field order, units and branch conditions follow the implementation explanation above.

Output field	Meaning	Value type
transformed	Transformed	string

json

{
  "input": {
    "text": "QAZ",
    "direction": 1,
    "callerKeyboardRows": [
      "QWERTYUIOP",
      "ASDFGHJKL",
      "ZXCVBNM"
    ]
  },
  "output": {
    "transformed": "WSX"
  }
}

Limitations and assumptions

Per-row wrapping and layout are part of this tool's declared convention. Apply the exact scope and assumptions described above.

All listed fields require explicit values. Unexpected fields, incorrect types, nonfinite numbers and sparse arrays fail validation. Domain-specific bounds, alignments and supported tokens are stated above; extremely large inputs or outputs can also be rejected. These errors differ from successful results such as false, no matches or unknown evidence.

This educational transformation or format check does not establish modern cryptographic confidentiality, authentication or key security.

Alternative or Complementary methods

Use Pigpen Masonic Encoder for a related task: Pigpen notation represents letters with grid and cross forms.

Use Pigpen Masonic Decoder for a related task: A textual Pigpen token stream requires an agreed symbol convention.

References

Keyboard Neighbor Shift Cipher — tool.io

Similar or alternative tools

Pigpen Masonic Encoder
Pigpen notation represents letters with grid and cross forms.
Pigpen Masonic Decoder
A textual Pigpen token stream requires an agreed symbol convention.