Skip to content

About

Windows Kernel Filter Driver for keyboard and mouse input interception, remapping and blocking. Microsoft-signed Windows 10/11 x64 demo, simple C++17 SDK, GUI/CLI installers and console/UI examples.

Topics

Resources

Contributing

Security policy

Stars

11 stars

Watchers

0 watching

Forks

Repository files navigation

Interceptor Keyboard & Mouse - Windows Kernel Filter Driver

Capture, remap or block physical keyboard and mouse input with a Microsoft-signed kernel filter driver and a two-file C++17 SDK. Identify each source, receive its input and forward your changes through the device's Windows input path. Requires Windows 10 1709+ / Windows 11 x64.

Download | Installation | C++ API | Examples | Compatibility

Setup and diagnostics Input viewer
Installer dashboard Viewer with simulated input

Screenshots illustrate the interface; preview inputs are simulated.

Install and use

  1. Download this repository's InterceptorSetup.exe and accept elevation.
  2. Choose Install / reinstall. Use Windows Restart if requested, then reopen setup to finish device associations.
  3. Run InterceptorExampleUI.exe and accept the administrator prompt. Observation starts automatically; tabs select keyboard or mouse. Stop releases capture. Close other capture applications first.
  4. Use Diagnose for installation checks and a report you can copy or export. Input features that were not exercised remain unverified.

The GUI provides Uninstall. The console installer uses the same setup engine:

.\InterceptorSetupConsole.exe /install
.\InterceptorSetupConsole.exe /uninstall

Exit code 3010 requests a restart; rerun /install afterward if associations are pending. The driver package is Microsoft-signed; that signature does not automatically sign installer or example EXEs. Recovery.

How it works

For a spare keyboard used as a macro pad, see selecting one keyboard. Before installing a capture driver, read the security model and signing explanation: the capture application can see sensitive input, and selecting one device in an example is not a security boundary against other privileged software.

The driver uses supported Windows keyboard/mouse paths and HID mapper collections. Input passes through normally until an application captures it. The application receives scan codes, press/release flags, mouse movement, buttons and wheel data; it can modify them, forward them or deliberately block individual events. Closing the application releases capture. Physical Ctrl+Alt+Delete revokes captures. Device/report limits are described in compatibility.

This edition provides keyboard and mouse input only. The separate Gamepad & Controller edition can run alongside it, using its own service, SDK, recovery state and demo allowance. Remove an overlapping combined Interceptor installation first. Use each edition's own SDK in its applications.

Application examples and language wrappers

Choose a project for this Keyboard & Mouse edition:

Project Starting point
AutoHotInterceptor AutoHotkey v1/v2 per-device subscriptions and an input monitor; adapted from evilC/AutoHotInterception.
node-interceptor Node.js 20+/TypeScript wait, receive and send bindings; adapted from Rami-Sabbagh/node-interception. Install with npm install interceptor-keyboard-mouse; see its README for driver setup and examples.
Keyboard & Mouse Remapper A complete native C++ application with IGC scripts, visual rules and timed macros.

The interceptor-keyboard-mouse package is the node-interceptor adapter with its Interception / Device API. The interceptor-keyboard-mouse-sdk package in the installation table below exposes this product SDK through its Interceptor API. Use the examples for the package you installed; their names and APIs are not interchangeable.

Close other capture applications, including monitors, before opening another capture session. These projects share this edition's one-hour-per-kernel-boot driver demo; a wrapper does not remove the limit. Read each project's license: the Node wrapper is LGPL-3.0-or-later, while bundled stock AutoHotkey retains its GPL-2.0 terms. Demo/evaluation driver source is documented in driver/README.md; full-version terms remain separate.

C++ SDK and examples

Add Interceptor.h and Interceptor.cpp to your Windows x64 C++17 project. Compile the source once and include the header; no SDK DLL or prebuilt LIB is required. Run capture applications as administrator.

The library manages the capture session automatically. Receive a batch with Get_Input_With_Timeout(), read or change its typed entries, and forward it with Send_Input(inputs). Types, destinations and counts are automatic. Forward unchanged events too: receiving removes them from the input queue.

The console examples demonstrate key swaps, typing, mouse-axis changes and deliberate input blocking. The graphical viewer shows the same input families. Complete API guide.

Downloads and build

Demo/evaluation driver source is available; see driver/README.md for build instructions and separate evaluation-source terms. Those terms apply to Titan-authored driver code. Third-party source licenses and existing application/SDK licenses remain applicable. Full/commercial implementation and private signing or activation material are excluded.

The latest release contains InterceptorSetup.exe, InterceptorSetupConsole.exe, InterceptorExampleUI.exe, examples and source SDK ZIPs, and SHA256SUMS.txt.

For raw relative mouse movement, extract the examples ZIP and run 09_Mouse_Move_Horizontal.exe as administrator. Enter 300 or -485, then press Enter to send that value directly as mouse X input. See the example instructions.

Interceptor/       The two-file C++ library
Examples/
  Console/         Seven keyboard/mouse examples
  UI/              Graphical input viewer
Installer/
  Console/         Console installer
  UI/              GUI, setup engine and compiled driver/recovery binaries
docs/ licenses/    Guides, screenshots and license terms

Build user-mode applications with Visual Studio 2022 C++ tools, a Windows SDK and CMake: powershell -ExecutionPolicy Bypass -File .\Build.ps1. Builds use the supplied signed driver and compiled recovery binaries. Demo/evaluation driver source is documented in driver/README.md. Build guide. User-mode source is MIT; driver binaries have separate terms.

Demo edition

One hour per Windows kernel boot, starting with the first successful capture and shared across this edition's applications. Sleep counts; closing, uninstalling or reinstalling does not reset the allowance. Capture diagnostics can start it. At expiry, capture/injection stop and physical input passes through normally. Use Windows Restart for another allowance; Fast Startup shutdown does not reset the kernel boot. For the unrestricted version, DM titancsa on Discord.

This independent project evolves the workflow popularized by oblitum/Interception, with its own implementation and API. It is not affiliated with oblitum or ABI-compatible with the original. Attribution.

Minimal example: receive, read, forward

Install this edition first, restart if requested, and run your application as administrator. Include Interceptor.h, compile Interceptor.cpp with your application, and enable C++17. This example changes H to J and forwards every other input:

#include "Interceptor.h"
#include <iostream>
#include <system_error>

int main() try {
    using namespace Interceptor;
    const auto init = Init_AllDevices();
    if (!init.ready) {
        std::cerr << "Initialization error: " << init.error
                  << ", restart required: " << init.reboot_required << '\n';
        return 1;
    }
    for (;;) {
        auto inputs = Get_Input_With_Timeout(1000);
        for (auto& input : inputs) {
            if (auto* key = input.Get<Keyboard_Input>()) {
                // make_code is the scan code; KeyUp marks a key release.
                if (!(key->stroke.flags & (KeyE0 | KeyE1)) &&
                    key->stroke.make_code == 0x23)
                    key->stroke.make_code = 0x24; // H becomes J.
            }
        }
        const auto sent = Send_Input(inputs);
        if (!sent) {
            std::cerr << "Send error: " << sent.error << '\n';
            return 1;
        }
    }
} catch (const std::system_error& error) {
    std::cerr << error.what() << '\n';
    return 1;
}
  1. Receive: Get_Input_With_Timeout(1000) waits up to 1,000 milliseconds for input after initial context setup. Timeout returns an empty batch. The library creates and reuses the capture automatically; no context argument is needed.
  2. Read: each input is one event. input.type gives its family, input.device its source ID within that family, and inputs.size() the event count. input.Get<T>() returns a pointer to that family's data or nullptr. Change typed fields before forwarding to modify an input; set input.blocked = true to block that event.
  3. Forward: Send_Input(inputs) returns the batch to its source devices. Destination, type and count are automatic. Receiving consumes input, so forward unchanged entries too. sent.accepted gives the accepted count; sent.error is 0 on success. This basic example exits on a send error.

A batch borrows reusable storage: finish it before receiving another one. Closing the application releases capture. See API details for field layouts, cancellation, errors and partial-send retries.

Responsible use and disclaimer

This project, including its drivers, SDKs, libraries, applications, installers and examples, was created for lawful, constructive purposes such as accessibility, device customization, research, testing and software development. Illegal, malicious or unauthorized use is neither intended nor endorsed by TitanCSA or the contributors.

You are solely responsible for how you use, modify or distribute the software, for obtaining any necessary authorization, and for complying with applicable laws, third-party rights and service rules. TitanCSA and the contributors do not accept responsibility for users' actions, including illegal activity or misuse of the drivers or SDKs.

To the maximum extent permitted by applicable law, the software is provided "AS IS", without warranties of any kind, and TitanCSA and the contributors are not liable for claims, damages, data loss, system damage or other consequences arising from its use or misuse. Nothing in this notice excludes liability that cannot legally be excluded. Existing project and third-party license terms remain applicable.

Paquets et installation

Les sources, licences, guides API et exemples sont regroupes dans le depot SDK dedie. Choisis le paquet a installer puis execute sa commande dans son dossier.

Registre Paquet Installation / utilisation
vcpkg interceptor-keyboard-mouse vcpkg install interceptor-keyboard-mouse:x64-windows
Conan interceptor-keyboard-mouse conan install --requires=interceptor-keyboard-mouse/1.0.5 -r titancsa --build=missing -s compiler.cppstd=17
NuGet Interceptor-Keyboard-Mouse.Native Install-Package Interceptor-Keyboard-Mouse.Native -Version 1.0.5
NuGet InterceptorKeyboardMouse.SDK dotnet add package InterceptorKeyboardMouse.SDK --version 1.0.0
PyPI interceptor-keyboard-mouse Commande prevue apres publication : python -m pip install interceptor-keyboard-mouse==1.0.0
Conda interceptor-keyboard-mouse conda install --override-channels -c https://raw.githubusercontent.com/TitanCSA/sdk-packages/089bc73095aa8eda89bacbe10d0b9e58394b0207/conda-channel -c conda-forge interceptor-keyboard-mouse (canal TitanCSA)
crates.io interceptor-keyboard-mouse cargo add interceptor-keyboard-mouse@1.0.0
npm interceptor-keyboard-mouse-sdk npm install interceptor-keyboard-mouse-sdk@1.0.0
Maven Central io.github.titancsa:interceptor-keyboard-mouse io.github.titancsa:interceptor-keyboard-mouse:1.0.0 (pom.xml / Gradle)
JitPack com.github.TitanCSA:Interceptor-Keyboard-Mouse com.github.TitanCSA:Interceptor-Keyboard-Mouse:java-sdk-v1.0.0 (avec le depot JitPack)
Go Modules github.com/TitanCSA/Interceptor-Keyboard-Mouse/Interceptor-Keyboard-Mouse-Go-modules go get github.com/TitanCSA/Interceptor-Keyboard-Mouse/Interceptor-Keyboard-Mouse-Go-modules@v1.0.0
pkg.go.dev github.com/TitanCSA/Interceptor-Keyboard-Mouse/Interceptor-Keyboard-Mouse-Go-modules Documentation : https://pkg.go.dev/github.com/TitanCSA/Interceptor-Keyboard-Mouse/Interceptor-Keyboard-Mouse-Go-modules@v1.0.0
PowerShell Gallery InterceptorKeyboardMouse Install-Module InterceptorKeyboardMouse -RequiredVersion 1.0.0 -Scope CurrentUser
pub.dev interceptor_keyboard_mouse dart pub add interceptor_keyboard_mouse:1.0.0
RubyGems interceptor-keyboard-mouse gem install interceptor-keyboard-mouse -v 1.0.0
Packagist titancsa/interceptor-keyboard-mouse composer require titancsa/interceptor-keyboard-mouse:1.0.0

Pour vcpkg et Conan, configure d abord le registre TitanCSA avec le guide complet. Le guide explique aussi Maven/Gradle, les prerequis et le chargement des DLL. Les pilotes/applications du produit sont installes separement. Les commandes marquees prevues ne sont pas encore disponibles.

Les anciens imports Go et versions JitPack gardent leurs tags. Pour les anciennes archives SDK, utilise les liens de remplacement.

Important

Get the full version without demo restrictions

Discord username: titancsa

Open Discord, choose Friends > Add Friend, enter titancsa, then send a direct message. Ask for the full version without the demo time limit, and mention Interceptor Keyboard & Mouse.

Tell me whether you need personal use, business integration or OEM redistribution, and ask for pricing and license / activation instructions.

Performance & Benchmarks

Measured results and raw data · Comparisons · Methodology

Virtual HID input crosses the tested filter and is checked by a separate Windows Raw Input receiver, with per-run PnP and capture evidence. These are publisher-operated Windows 11 Hyper-V software-path measurements, not physical USB latency or a universal speed ranking.

Tested scope Verified result
Virtual keyboard/mouse filter paths 6 validated runs: forwarding, mouse remapping and controlled blocking

Stability limitation: the Vdevice-backed controller campaign reproduced an unresolved guest WDF queue-purge bugcheck. Successful timings do not establish safe repeated teardown. See the incident and test limits.

About

Windows Kernel Filter Driver for keyboard and mouse input interception, remapping and blocking. Microsoft-signed Windows 10/11 x64 demo, simple C++17 SDK, GUI/CLI installers and console/UI examples.

Topics

Resources

Contributing

Security policy

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages