Trimcraft

[!WARNING] ⚠️ Unstable early access, under active development. Expect bugs and breaking changes between versions. Keep backups of your configuration: Trimcraft writes them automatically (Settings → Backup & transfer), and you can export it at any time.

[!TIP] Found a bug or have an idea? Please open a GitHub Issue. There are templates for bug reports and feature requests. Ideas and wishes from real cockpits are explicitly welcome.

Turn your HOTAS into a smart cockpit: virtual radios, modes and switches, macros, vJoy output, Discord/Soundpad control and a click-through in-game overlay.

Website: trimcraft.github.io · Download: latest release

Features

• Devices: every connected stick, throttle, pedal set and button box, live, with a stable identity across restarts and re-plugging (also for two units of the same model).
• Rotary encoders recognised by their behaviour, with measured pulse lengths.
• Virtual controls: radios, toggles, momentary controls, counters and modes (layers), triggered by buttons, hat directions, encoder notches or axis zones, with long and double presses, modifiers and conditions.
• Actions: keyboard and mouse macros (with a recorder, repetition and a panic hotkey), speech, sound files, volume and media keys, launching programs, HTTP requests (webhooks), Soundpad, Discord mute/deafen, Voicemeeter and vJoy.
• vJoy output: control states, axis mappings with curves and deadzones, and vJoy actions feed virtual joysticks that games see as ordinary controllers.
• Profiles per game, switched automatically by the program in the foreground.
• Overlay: a transparent, click-through, always-on-top window with your controls and toasts on changes, freely placed per monitor and themeable.
• Backups, export and import of the whole configuration or single profiles.
• Event log of everything Trimcraft sees and does.

The user guide explains every part in detail.

Screenshots

Virtual controls	Overlay
Connections	Settings

The screenshots show the browser demo with made-up devices. More: Hardware Test, Credits.

Requirements

• Currently runs on Windows 10 or 11 (64-bit); Linux and macOS support are planned.
• The overlay works over games in windowed or borderless fullscreen mode, not in exclusive fullscreen.
• Optional, for the matching features: vJoy, Soundpad (full version), the Discord desktop app, Voicemeeter.

Installation

1. Download Trimcraft_<version>_x64-setup.exe from the latest release.
2. Run it. It installs for the current user; no administrator rights needed.
3. Releases up to now are not code-signed, so Windows SmartScreen warns on the first start ("Windows protected your PC"): click More info, then Run anyway. Code signing through the SignPath Foundation is underway; see the code signing policy.

Trimcraft is early access: back up your configuration (Settings → Backup & transfer) before updating.

Updates

Trimcraft looks for a new release when it starts and every 6 hours while it runs (Settings → Updates; can be turned off) and shows an update badge next to its version when one is available. Download & install there installs it for your user and restarts Trimcraft; it asks first when macros are running or vJoy is in use. Update packages are signed with the project's update key, and Trimcraft installs only packages with a valid signature (this is separate from Windows code signing, see the code signing policy).

Running as administrator

Windows does not let a normal program send keys and mouse input to a program that runs as administrator. If a game (or its launcher) runs as administrator, Trimcraft must too, or its macros will not reach the game. Trimcraft warns when that happens. Settings → General → Always run as administrator makes it restart elevated (UAC prompt); with Start with Windows it then starts through the Task Scheduler without a prompt.

Anti-cheat and fair play

• Trimcraft never injects into game processes: no DLLs, no graphics hooks, no reading or writing game memory. The overlay is a separate transparent window on top of the game.
• Macros send simulated keyboard and mouse input (SendInput), and vJoy creates virtual controllers. Some games and multiplayer servers forbid automated input or macros. Using them is your own responsibility: check the rules of the game and server you play on.

Privacy

• No telemetry, no accounts, no analytics. Trimcraft only goes online for what you configure (Discord sign-in, your HTTP requests) and for update checks; the full list is in the code signing policy below.
• Everything stays on your computer: settings in %APPDATA%\cloud.breu.trimcraft, logs in %LOCALAPPDATA%\cloud.breu.trimcraft\logs.
• Secrets (Discord client secret and tokens, secret HTTP headers) are stored in the Windows Credential Manager, never in the settings files, exports or logs.

Code signing policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

[!NOTE] Trimcraft has applied to the SignPath Foundation's open source program. Releases published before the approval, including v0.1.0, are not Windows code-signed.

What is signed: only the Windows installer Trimcraft_<version>_x64-setup.exe and the program trimcraft.exe inside it. Both are built from a tagged commit of this repository by the release workflow on GitHub-hosted runners and submitted to SignPath from that run; nothing built elsewhere or by hand is signed. The installer contains no third-party programs: vJoy, Voicemeeter, Soundpad and Discord are installed separately.

Team roles:

• Committers and reviewers: @bresam (members of the trimcraft organisation)
• Approvers: @bresam

Contributions from anyone else arrive as pull requests and are reviewed by a committer before they are merged, including changes to the build scripts and workflows. Every signing request is approved manually.

Privacy: This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it, with one exception that is on by default: the update check. In detail:

• Update check: on start and every 6 hours while it runs, until a new version is found, Trimcraft fetches latest.json from this repository's GitHub releases (github.com); Download & install downloads the update from there. Turn the check off under Settings → Updates. GitHub's privacy statement applies.
• Discord: only when you set up the Discord connection. Trimcraft talks to the Discord desktop app on your computer and, for the sign-in, to Discord's token endpoint (discord.com). Discord's privacy policy applies.
• HTTP request actions: exactly the requests you configure, to the addresses you configure.
• Links and launch actions: web pages you open (links in Trimcraft, your launch actions) open in your browser.
• Installer: if the Microsoft Edge WebView2 Runtime is missing (it is part of current Windows 10 and 11), the installer downloads it from Microsoft. Microsoft's privacy statement applies.

There is no telemetry, analytics or crash reporting.

Connections

Set up under Connections; each one can be tested there. Details in the user guide.

• Soundpad: needs the full version of Soundpad, running (Trimcraft uses its remote control).
• Discord: uses your own free Discord application; the Discord card has a step-by-step guide with a link to the Developer Portal. Needs the Discord desktop app.
• Voicemeeter: Standard, Banana or Potato, installed and running.
• vJoy: install vJoy and add buttons and POVs to its devices in Configure vJoy; Trimcraft shows what each device has.

Build from source

Requirements: Rust (stable, MSVC toolchain), Node 24, CMake (SDL3 is built from source and linked statically), Windows 10/11.

npm ci
npx tauri dev                       # app with real devices
TRIMCRAFT_INPUT=mock npx tauri dev  # app with synthetic devices (no hardware needed)
npm run dev                         # UI only, in a browser, with an in-page demo
./scripts/check.sh                  # full gate, same as CI; run before every push

The SDL3 build fails on Windows' 260-character path limit in deep folders: set CARGO_TARGET_DIR to a short path (e.g. C:\t\trimcraft) if the checkout is nested deeply.

Path	What
crates/trimcraft-core	Platform-independent logic, unit-tested: devices, encoders, virtual controls, triggers, actions, profiles, overlay, migrations.
crates/trimcraft-input	Input backends: SDL3 and a mock with synthetic devices.
src-tauri	Desktop app (Tauri 2): engine thread, windows, connectors, persistence.
ui	Svelte 5 + TypeScript: main window and overlay.

CLAUDE.md is the working guide for the code base (for people and coding agents).

Contributing

Bug reports, ideas and pull requests are welcome; see CONTRIBUTING.md. Security problems: SECURITY.md. This project follows the Contributor Covenant.

Credits

Maintained by Samuel Breu (@bresam). Contributors, supporters and the open source projects Trimcraft is built on are listed in CREDITS.md, also in the app under Settings → About → Credits.

Support Trimcraft

Trimcraft is free and stays free, without ads, nags or locked features. The most valuable support is feedback: open an issue with bugs, ideas or wishes from your cockpit.

Licence

Trimcraft is free software under the GNU General Public License v3.0 or later. The licences of the third-party software it contains are in THIRD_PARTY_LICENSES (also under Settings → About).

Trademarks

Trimcraft is an independent project and is not affiliated with, endorsed or sponsored by Discord, Leppsoft (Soundpad), VB-Audio (Voicemeeter), the vJoy project, Turtle Beach, VKB, Thrustmaster, Logitech, Virpil, WinWing, Microsoft or any game publisher. All product names, logos and trademarks belong to their owners and are used only to describe compatibility.