ange-yaghi /engine-sim

Combustion engine simulator that generates realistic audio.

★ 9,655⑂ 967👁 126⑃ 43● 424▤ 9
C++MITCreated 2021-12-18engine-sim.parts/
Download: v0.1.11av0.1.11a ↓v0.1.11a2022-09-29
+1
Daily
9,655
stars
967
forks
126
watchers
43
prs
424
issues
9
releases

README

Engine Simulator
!Alt text
---
 Engine Simulator has moved!

To get the newest releases of the game, click here.
---

 What is this?

This is a real-time internal combustion engine simulation designed specifically to produce engine audio and simulate engine response characteristics. It is NOT a scientific tool and cannot be expected to provide accurate figures for the purposes of engineering or engine tuning.

 How do I install it?

This is a code repository and might not look like other software that you're used to downloading and installing (if you're not familiar with programming). To download a ready-to-use version of the application, navigate to the releases page, find the most recent release (ex. v0.1.5a), click "Assets" and download the .zip file with a name that starts with engine-sim-build. Unzip this file, then run bin/engine-sim-app.exe. The simulator should then start normally.

Check out our Frequently Asked Questions if you need more details.

 How do I use it?

The UI is extremely minimalistic and there are only a few controls used to interact with the engine:

| Key/Input | Action |
| :---: | :---: |
| A | Toggle ignition |
| S | Hold for starter |
| D | Enable dyno |
| H | Enable RPM hold (see below for instructions) |
| G + Scroll | Change hold speed |
| F | Enter fullscreen mode |
| I | Display dyno stats in the information panel |
| Shift | Clutch (hold spacebar at the same time to slowly engage/disengage) |
| Up Arrow | Up Gear | 
| Down Arrow | Down Gear | 
| Z + Scroll | Volume |
| X + Scroll | Convolution Level |
| C + Scroll | High frequency gain |
| V + Scroll | Low frequency noise |
| B + Scroll | High frequency noise |
| N + Scroll | Simulation frequency |
| M | Increase view layer |
| , | Decrease view layer |
| Enter | Reload engine script |
| Escape | Exit the program |
| Q, W, E, R | Change throttle position |
| Space + Scroll | Fine throttle adjustment |
| 1, 2, 3, 4, 5 | Simulation time warp |
| Tab | Change screen |

 Using the RPM hold
The RPM hold feature will hold the engine at a specific RPM and also measure the engine's horsepower and torque at that RPM. You can enable RPM hold by pressing the H key. You must then enable the dynomometer (press the D key) in order for the RPM hold to take effect. To change the hold speed, hold the G key and scroll with the mouse wheel. The RPM hold will be shown on the DYNO. SPEED gauge in the lower left of the screen.

 Why is the code so sloppy?

I wrote this to demo in a YouTube video, not as a real product. If you would like it to become a usable product please reach out to me or join my Discord (link can be found in the description of the aforementioned YouTube video). I use this codebase for my own purposes and so it might change frequently and without warning.

 How do I build it? (Ignore this section if you're not a developer!)
Note: this project currently only builds on Windows!

 Step 1 - Clone the repository
git clone --recurse-submodules https://github.com/ange-y

Top issues

Latest release

v0.1.11a v0.1.11a Pre-release 2022-09-29
Overview
This change was originally meant to be for Patreon supporters only, however, based on a vote, it was decided to release them publicly. You can thank all of the supporters who are now listed in the README!

 Change Notes
- You can now edit the lengths of individual header tubes (this can be used for things like Subaru unequal length headers)
- Filtering was added to correct aliasing for high-reving engines
- All engines from my 2 compilation videos are now included in assets/engines/atg-video-1 and assets/engines/atg-video-2. In these engines you can find examples of how to use t

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON