Introduction to Rebind: Input Remapping Platform

Rebind

Rebind is an input remapping and automation platform for Windows that runs on a dedicated Teensy 4.x microcontroller. It captures USB input devices (mice, keyboards) and processes them through a programmable Lua scripting engine before sending output through the Teensy's HID interface.

What It Does

• Captures input from USB mice and keyboards connected to the Teensy
• Processes through scripts written in Luau (a typed Lua dialect) running in a sandboxed runtime
• Outputs remapped input back to your PC through the Teensy as a virtual HID device

This means you can:

• Remap keys (CapsLock → Escape, Mouse4 → Tab, etc.)
• Create macros (record and play back input sequences)
• Automate workflows (type expansions, combo sequences, conditional logic)
• Apply context-aware rules (different behavior per application)
• Integrate with external systems (HTTP servers, WebSockets, file I/O, shell commands)
• Build accessibility features (dwell click, sticky modifiers, tremor smoothing)

Key Features

Zero-latency input processing: Because the Teensy is a hardware device, remapped input reaches your PC with minimal latency — ideal for games and precision tasks.

Application-aware: Scripts can target specific windows or processes. Only the relevant scripts run when you switch apps — others are completely inactive with zero overhead.

Scriptable: Full Lua language + rich SDK covering HID output, timers, UI config, file I/O, HTTP, WebSockets, screen capture, window management, audio, and more.

Always on: Scripts stay loaded and persistent across app switches. No manual starting/stopping needed.

Persistent config: UI settings are saved automatically and restored at script startup.

Typical Use Cases

• Gaming (aim assistance, SOCD handling, recoil control, macro playback)
• Productivity (text expansion, window management, clipboard automation)
• Accessibility (one-handed input, dwell clicking, sticky modifiers)
• Streaming (Twitch integration, hotkey control panels)
• Development (rapid file testing, key binding workflows)

The runtime is efficient — you can load dozens of scripts simultaneously and they'll coexist peacefully, with only the active ones consuming resources at any given moment.