Capture and remap physical gamepad/controller input with a Microsoft-signed Windows kernel filter driver and a two-file C++17 SDK. Supports compatible HID, XInput/XUSB, XInputHID and GIP profiles on Windows 10 1709+ / Windows 11 x64.
Download | Installation | C++ API | Compatibility | Examples
| Setup and diagnostics | Input viewer |
|---|---|
![]() |
![]() |
Screenshots illustrate the interface; preview controller inputs are simulated.
- Download this repository's InterceptorSetup.exe, run it and accept elevation.
- Choose Install / reinstall. If requested, use Windows Restart and reopen setup to finish associations. Continue until no restart is requested.
- Open InterceptorExampleUI.exe and accept the administrator prompt. Observation starts automatically; tabs select the family to display. Select a controller family to inspect its input. Stop releases capture; run one capture application at a time.
- Use Diagnose for per-device checks and a report you can copy or export. Features that were not exercised remain unverified.
The GUI provides Uninstall. The console installer uses the same setup engine:
.\InterceptorSetupConsole.exe /install
.\InterceptorSetupConsole.exe /uninstallExit code 3010 requests a restart; rerun /install afterward if associations
are pending. Updating only the viewer does not update the driver. The driver's
Microsoft signature does not automatically sign installer or example EXEs.
Installation and recovery.
The filter receives supported physical reports before they reach the associated Windows input consumers. A capture application can read or change them, then return them through the device's native path. Without a capture owner, physical input passes through normally. Closing the application releases capture.
| Family | Input handling |
|---|---|
| HID | Dynamic controls decoded from the device's report descriptor |
| XInput / XUSB | Compatible wired USB source beneath the native Windows XUSB driver |
| XInputHID | Supported HID collection beneath the Windows translator |
| GIP | Compatible USB gamepad protocol, standard state and Guide input |
Compatible profiles include DualShock 4 / DS4 (PS4), DualSense (PS5), wired Xbox 360, Xbox One and Xbox Series X|S. Connection, descriptor and protocol determine support; consult the compatibility guide. Windows can expose multiple nodes for one controller, including secondary HID views; the setup table is not a count of physical gamepads.
For continuous physical IN / driver OUT inspection and script-based remapping, use GamePad Remapper. Its passive monitor works without a running script or capture. Subscribing starts the same one-hour demo allowance. What IN and OUT measure.
The five standalone controller examples demonstrate vertical inversion, button swaps, instant triggers, 50% stick deadzone and an inverse exponential curve. Each supports HID, XInput/XUSB, XInputHID and GIP.
GamePad Remapper is a complete example application using this driver and SDK: scripts, macros, script-defined settings and continuous IN / OUT monitoring. Its C++ source shows how to build a full application on top of the same capture and forwarding API.
For narrower application examples, see Curve Controller for radial or separate-X/Y stick response curves, and Cronus Interceptor for an independent studio implementing a documented subset of GPC. The latter is a compatibility preview, not the official Cronus compiler or hardware. These MIT applications use this edition's demo driver and share its one-hour demo; live support still depends on the physical controller profile and transport.
Add Interceptor.h and
Interceptor.cpp to your Windows x64 C++17 project.
Compile the source once and include the header. No Interceptor DLL or prebuilt
LIB is required; live capture requires administrator rights.
Get_Input_With_Timeout() automatically creates and reuses the session and
returns a batch containing the supported input families. Read or change typed
state and call Send_Input(inputs). The library determines destinations, types
and counts. Forward unchanged entries too, and finish the batch before receiving
another one. API reference.
This edition handles controllers only. It can coexist with the separate Keyboard & Mouse edition, which has its own service, SDK and demo allowance. Remove an overlapping combined Interceptor installation first.
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, complete/examples/source SDK ZIPs and SHA256SUMS.txt. Use matching components from the same release.
Interceptor/ Interceptor.h and Interceptor.cpp
Examples/
Console/ Five complete controller remapping 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 tools with Visual Studio 2022 C++ tools, a Windows SDK and CMake:
powershell -ExecutionPolicy Bypass -File .\Build.ps1.
The signed driver and compiled recovery binaries are supplied; Demo/evaluation driver source is documented in driver/README.md. Build guide. User-mode source is MIT;
the driver has separate terms.
One hour per Windows kernel boot, starting with the first capture or monitor subscription
and shared across this edition's applications. Sleep time counts; closing or
reinstalling does not reset it. Capture diagnostics can start the allowance.
At expiry, captures are released and capture/injection stop; physical input passes
through normally. Passive IN / OUT monitoring and raw GIP diagnostics follow the
same deadline. Use Windows Restart for a new allowance.
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.
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 loop forwards every received 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* pad = input.Get<Controller_Hid_Input>()) {
// Inspect pad->state.axes, triggers, hats and buttons.
// Each declared control keeps its own descriptor identity.
(void)pad;
} else if (auto* xusb = input.Get<Controller_Xinput_Input>()) {
// Example: xusb->state.left_x is the left stick X value.
(void)xusb;
}
// XInputHID and GIP entries stay in this same batch too.
}
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;
}- 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. - Read: each
inputis one event.input.typegives its family,input.deviceits source ID within that family, andinputs.size()the event count.input.Get<T>()returns a pointer to that family's data ornullptr. Change typed fields before forwarding to modify an input; setinput.blocked = trueto block that event. - 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.acceptedgives the accepted count;sent.erroris0on 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.
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.
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-gamepad-controller |
vcpkg install interceptor-gamepad-controller:x64-windows |
| Conan | interceptor-gamepad-controller |
conan install --requires=interceptor-gamepad-controller/1.0.13 -r titancsa --build=missing -s compiler.cppstd=17 |
| NuGet | Interceptor-Gamepad-Controller.Native |
Install-Package Interceptor-Gamepad-Controller.Native -Version 1.0.13 |
| NuGet | InterceptorGamepadController.SDK |
dotnet add package InterceptorGamepadController.SDK --version 1.0.0 |
| PyPI | interceptor-gamepad-controller |
Commande prevue apres publication : python -m pip install interceptor-gamepad-controller==1.0.0 |
| Conda | interceptor-gamepad-controller |
conda install --override-channels -c https://raw.githubusercontent.com/TitanCSA/sdk-packages/089bc73095aa8eda89bacbe10d0b9e58394b0207/conda-channel -c conda-forge interceptor-gamepad-controller (canal TitanCSA) |
| crates.io | interceptor-gamepad-controller |
cargo add interceptor-gamepad-controller@1.0.0 |
| npm | interceptor-gamepad-controller |
npm install interceptor-gamepad-controller@1.0.0 |
| Maven Central | io.github.titancsa:interceptor-gamepad-controller |
io.github.titancsa:interceptor-gamepad-controller:1.0.0 (pom.xml / Gradle) |
| JitPack | com.github.TitanCSA:Interceptor-Gamepad-Controller |
com.github.TitanCSA:Interceptor-Gamepad-Controller:java-sdk-v1.0.0 (avec le depot JitPack) |
| Go Modules | github.com/TitanCSA/Interceptor-Gamepad-Controller/Interceptor-Gamepad-Controller-Go-modules |
go get github.com/TitanCSA/Interceptor-Gamepad-Controller/Interceptor-Gamepad-Controller-Go-modules@v1.0.0 |
| pkg.go.dev | github.com/TitanCSA/Interceptor-Gamepad-Controller/Interceptor-Gamepad-Controller-Go-modules |
Documentation : https://pkg.go.dev/github.com/TitanCSA/Interceptor-Gamepad-Controller/Interceptor-Gamepad-Controller-Go-modules@v1.0.0 |
| PowerShell Gallery | InterceptorGamepadController |
Install-Module InterceptorGamepadController -RequiredVersion 1.0.0 -Scope CurrentUser |
| pub.dev | interceptor_gamepad_controller |
dart pub add interceptor_gamepad_controller:1.0.0 |
| RubyGems | interceptor-gamepad-controller |
gem install interceptor-gamepad-controller -v 1.0.0 |
| Packagist | titancsa/interceptor-gamepad-controller |
composer require titancsa/interceptor-gamepad-controller: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 Gamepad & Controller.
Tell me whether you need personal use, business integration or OEM redistribution, and ask for pricing and license / activation instructions.
Measured results and raw data · Comparisons · Methodology
Selected virtual input transformations are independently observed; controller results are separated by protocol and receiver API. 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 XUSB modification to XInput observation | 3 validated runs; median run P50 38.10 microseconds |
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.

