Skip to content

Latest commit

 

History

History

README.md

Internal Wind Machine — SimHub Plugin

A SimHub plugin for a SimRacing wind simulator.
It allows standard PC fans (connected directly to a motherboard fan header) to be controlled via live telemetry data from racing simulations — without any external microcontrollers (e.g., Arduino).

The system is integrated directly into SimHub and interfaces with Fan Control.

SimHub Plugin UI


🌟 Features

  • Native SimHub Integration: Seamlessly integrated into SimHub.
  • No Extra Software: Replaces the standalone Python script and the Property Server plugin.
  • Live Status Monitor: Real-time visual feedback of all fan outputs directly in the SimHub UI.
  • Auto-Update Check: Automatically notifies you in the UI when a new plugin version is available.
  • Dynamic 3D Wind Support: Individual control for Left, Center, and Right channels.
  • Individual Fan Overrides: Manually control each fan with a slider while keeping others on telemetry
  • Expert Mode: Full control over SimHub property bindings (for advanced users).
  • Safe & Robust: Automatic sensor reset to -1.00 on exit and double-confirmation for global resets.

Check out my Twitch, I plan on streaming a bit with the Wind sim, so it's a good chance to see it in action and ask me questions about it.


🛠️ Dependencies

The following software must be installed:


🚀 Installation

Option 1: Automated Installer (Recommended)

  1. Download the latest release from GitHub Releases.
  2. Extract the downloaded ZIP file.
  3. Run InternalWindMachineInstaller.exe or just drag the Pluginn dll into the simhub root folder.
  4. Follow the on-screen instructions (Admin rights will be requested automatically).

Option 2: Manual Installation

  1. Close SimHub.
  2. Download the Latest Release on GitHub
  3. Download the InternalWindMachinePlugin.dll from Releases.
  4. Copy the .dll into your SimHub plugins directory (usually C:\Program Files (x86)\SimHub, right-click desktop icon → "Open File Location").
  5. Start SimHub.
  6. Enable the plugin in the SimHub settings if not already active.

⚙️ Configuration (UI)

Unlike the standalone version, everything is configured via the SimHub interface:

  • General: Enable 3D Wind and set your output folder path.
  • Fan Power Overrides: Manually test your fans or set a fixed wind speed for specific channels.
  • Advanced: Toggle individual fans and manage expert property bindings.

💨 Fan Control Setup

  1. Open Fan Control.
  2. Create a Custom Sensor (File).
  3. Point to the sensor file(s) in the InternalWindMachineOutput directory:
    • InternalWindMachineOutput\WindPercentageCenter(default).sensor
    • InternalWindMachineOutput\WindPercentageLeft.sensor (if 3D enabled)
    • InternalWindMachineOutput\WindPercentageRight.sensor (if 3D enabled)
  4. Create a new control curve for each fan you want to use:
    • Minimum temperature: -1
    • Maximum temperature: 100
    • Recommended curve: A linear line from 0 °C → (The Lowest % at which the Fan stops spinning, e.g., 33%) to 100 °C → 100%.
    • Important: Add a point at -1 °C → 0% to ensure the fan powers down when you close SimHub.

Fan Curve Example

  1. Assign the fan(s) to the corresponding control curve(s).

🔧 Troubleshooting

  • No fan response: Ensure the path in the Plugin matches the path in Fan Control.
  • Plugin not showing: Verify that the .dll is in the correct folder and you are running a recent version of SimHub.
  • Live Status works, but no wind in-game: Make sure telemetry is correctly configured for your specific game in SimHub.

📦 Notes & 3D Prints

The control latency is extremely low. For the best result, I recommend using a nozzle for your fan. Here is the 3D-printable nozzle I use.


📜 License

Use at your own risk. This project is intended for personal and experimental use. For commercial use or embedding this into a commercial project, please contact me.


📢 Shameless Self Promotion

Stay connected and see the Wind Machine in action: