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.
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.
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 |
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.
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.
Note: this project currently only builds on Windows!
git clone --recurse-submodules https://github.com/ange-yaghi/engine-sim
Install the latest version of CMake here if it's not already installed.
You will need to install the following dependencies and CMake will need to be able to locate them (ie. they need to be listed on your PATH):
1. SDL2
2. SDL2_image
3. Boost (make sure to build the optional dependencies)
4. Flex and Bison
From the root directory of the project, run the following commands:
mkdir build
cd build
cmake ..
cmake --build .
If these steps are successful, a Visual Studio solution will be generated in build. You can open this project with Visual Studio and then run the engine-sim-app project. If you encounter an error telling you that you're missing DLLs, you will have to copy those DLLs to your EXE's directory.
This project was made possible by the generous donations of the following individuals!
| Devin@Hondatuningsuite | nut | Devin C Martinez | WelcomeCat | Saints Sasha |
| Ida 8858 | Emily | Steelorse | Kruddy | Sgt. Fluff |
| darcuter | FatFluffyFox | Benton1234 | Jim C K Flaten | The Zuck |
| Blade Skydancer | Ye' old apple | Hayden Henderson | AlphaX | Lucas Martins Bündchen |
| Jay Dog | damo | IBS-IS-CRAP | Snowy | Noah Greenberg |
| Eisberg | Brendan M. | Alex Layton | Lukas Bartee | Thibaut Dubuisson |
| The Cheeze Ity | JoeJimTom | MichaelB450 | Björn | Bartdavy |
| sasha bandelier | Caleb Black | COOKIES | Andrew Cooper | asimo3089 |
| Vim Wizard | Kevin Arsenault | Carl Linden | Kele Tappi | Kroklethon |
| labourateur | viperfan7 | SlimmyJimmy | Jason Becker | Sascha Kamp |
| ves | Supernalboot | BeamNG | Paul Harrison | Tyler Russell (Nytelife26) |
| nicholas jacobs | DrDotMadness | AVeryPlainTyler | Zach Perez | Paul Schaefer |
| Clay Bauer | CR33DYM0N14 | julien nadeau | Patt313 | Philip Edwards |
| RegularRuby670 | Mateusz Ładosz | FémLol Stúdió | Crazy Yany | Elden |
| Tristan Walker | Matthew McDonald | Jan-Sander Huiting | Mitchell Almstedt | Dylan Lebiedz |
| Name Here | LoganBoi FNAF | Epic Randomness | MrPiThon | mike |
| dung | Alvaro ArroyoZamora | Skinna Godwin | BeppoBarone | レナVA |
| Sabata | Brady Fulham | Powerpuncher | NK10K | Gavin Osowski |
| Orbitstrider | Steven Doyle | Jaksu2696 | Toni | Devin Abolins |
| Boosted Media | Matthew McLennan | Venican | Lyan le Golmuth | Alberto R. |
| BetaToaster | Akira Takemoto | J Anderson | Apolly007 | LexLuther |
| xilophor | Robert K | viktor lind | Adrian Kucinski | sarowie . |
| Chris Fischer | Marlod | Chase Hansen | Aidan Szalanski | Andrew Taylor |
| Jason Hwang | Juuso Natunen | Ian Moss | PickleRick | Beljim46 |
| RSOFT92 | UCD | Sped | OldManJenkins | James Hart |
| Kalle Nilsson | XxBrasta455xX | Colin Sandage | Dakota Mackinnon | Carter Kopp |
| Jakub Kozak | CJ Plessas | Loizeau | Charles Mills | YellowLight |
| Didrik Esbjug | Alessandro Dal Pino | Carter Williams | Robert D | Cadence Plume |
| BLANK | Provenance EMU | Dylan Engler | Nathan Rojas | Cornelius |
| Acid | larsloveslegos | Maxime Desages | GM | BreadForMen |
| Devin Freeman | Lieven RYCKEBOER | Amelia Taylor | Jelle Plukker | sodmo |
| Jimmy Briscoe | Cirithor | Martin .K | DMartland | Lucas Diem |
| Richard Budíček | Jack Sheppeard | Meemen | Anderson Huynh | NPException |
| Mattia Villa | C | AIDAN POWELL | Brenn_the_Otter | Lane Mosier |
| Ceze | oranjest1 | Jw | ISON | Mathew Graham |
| MACHINA | John Crowell | Asher Blythe | Cronos Skies | Matt Amott |
| CpTKugelHagel | Simon Krayer | Caleb Bek | Monster Man25 | GeneralMoineau |
| EsuKurimu | Caleb Sartin | Jared L. | Hunter Wood | Ben Poole |
| Steven Victoria | Jordan Zondlak | Agelessgod | Christopher Fahs | Jonathan Vincent |
| Dalton Guillot | Simon Stojanovic | Andrew Urbanczyk | deniaL | Tyler Hughes |
| vPam | Justin Kruithof | Curtis C Coomber | Sawyer Clark | Mike Hart |
| Ciro Rancourt | Miles Guo | Rewind | E=mc^2 | Keaton Call |
| J.Es | Jeremy B | Chance Hall | Jack Tompkins | Race Sim Studio |
| Quentin ZAOUI | Floyd Henderson | James Haylow | Milkshiekh | Wyatt Todd |
| User 2820 | Leon Schutte | CYBERBUG_JR | sebiii | Keegan |
| Victor Cosiuga | Rolly ! | Elias Pettersson | Tyson Makovec | Bill McDermott |
| Phontonic | Simon Armstrong | avec | KidozyGAME (Dead) | Stephan Cote |
| Justin Biggerstaff | Jabba Jubba | notD34THNIGHT | Inventor | Wesley Bear |
| Supersonic2510 | Pixel | Simon Bernhardt | Bas Vangermeersch | ToyotaCipra |
| kyle crawford | ApatheticWood | Ben Vaughn | Erich Westhoven | Zack Myers |
| Tbjoern | Vetle Høgås | Derek Thom | Aaron Beck |
| Karol Szép | Leon Jordan | Nathan Higginson | Patrick F | Samuel Picard |
| Alexander Fritsch | Lucas Scarpi | Jack Humbert | G2Eneko | SweCreations |
| Marius Becker | Cedric Wille | infernap12 | Julian Dinges | Wamuthas |
| Alex Mason | Hawar Karem | Melonenstrauch | Jacek Dębski | Alex Eastman |
| Darren Taing | Po Wang | Giorgio Iannucci | Levis | Eden |
| Alin Chiparatu | Arjun Mandakath | A.M. | Dylan Ryan | Noah Entrekin |
| GT130 | Josh D | generic | Henrik Cohrs | Nic Yetter |
| Dan Fredriksen | 153AN1MJ | Rasmus | EpicEcho | Kaur Hendrikson |
| Maddox Partridge | L33TIFY_ | Zack Fletcher | teiiio | Mike Zaite |
| Evan Sonin | Christopher Zimmerman | PrefacedVase | funtomr | Triton Alabaster |
| appelpie | Julien Ferluc | AnomalousFerret_ | Miles Orozco | Spencer Teeter |
| ThatCanadian | Harry Prabowo | Dylan Rogerson | Jaedyn Allen | Zephyr Sefira |
| Alexander Stone | Mason Little | Wojciech Czop | ryzen5 | Kosta Diamantis |
| Karol Stodolak | Tim van der Linde | Loïc Ruttner | jonthefuzz | AsgarK |
| James Morgan | Elijah | 1ntl | Tobias Johansson | Mome |
| P | SOPA_ | Shingekuro | Sean King | Russell Marsh |
| Alyx Ranas | Naters305 | ChrisakaMrXD | Nic | sean |
| Zach Hagedorn | Jhon lenon | Everett Butts | Kyan | ranger Nation |
| Hiago Oliveira | Texi | MrRhody | Inglorious Bastard | Marty Mitchell |
| Justin Chao | ManuelS | Cornelius Rössing | Pedro Freire | Anthony Stuart |
| Hubba Nubba | Skychii | Joe Underwood | Xander_ | Notbigdank |
| Sander D. | Lars Joosten | Danksa | Metrostation | Myles Wommack |
| Derrick Sampson | Corey Hannen | Matteo La Corte | Octothorp Obelus | David Baril |
| Soyuz Kafire | Ivan Coha | BigElbowski | Apolepth | Julian Krad |
| David Soulieres | Eric Huang | Léo Vias | Riccardo Mariani | Vic Viper |
| Shinkaaaa | Mumaransa | Michael Banovsky | Hendrik Voss | Inverted Blackhat |
| skipyC | Tobias Moor | jaky3 . | Clément LEGRAND | Ian C. Simpson |
| Challier | Jan Przemysław Drabik | Dsand23 | Smooth DLX | The German Dude |
| CrazyEagle | Jordon Goodman | HenryWithaG . | Oscar Krula | Brayden Moore |
| Steven | Nall Wolfert | papajonk | Andrew | Ben Kingston |
| Julian Vogl | Maxime Lubrano | MrMekouil | Doudimme | Jacob Hultberg |
| Nolan Orloff | Mike | tobi9899 | Danila Frolkin | Xecotcovach |
| Aj | Carcar404 | John Martin | Dominik Greinert | Lukas Stadler |
| Oliver Yang | sonax51 | Marcel Kliment | Chris | David Rush |
| LethalVenom13 | Dave Osterhoff | Anto1709 | Ben | Morgan Munroe |
| Ivor Forrest | Sam Hopkins | Atte | Dax | William Bergström |
| homelessmeme | Thanleft | Zaxerg | Robeloox | Maximilian-Lukas Marz |
| Morgn | Seth Monteleone | playfulmean videos | Lanimations LA | Bram G |
| Benoit Fournier | Bernar Lepiller | Nicolas Baur | the | Snekers |
| Darkmount | Tobiasz Michalik | Aidas Ri | Daniel Postler | Skim_Beeblez |
| Impetus | Thunderbird324 | Fred Joss | Krzysztof Radowski | Azerrty |
| Harrison Speck | Matt Baker | BigLynch | Markus Pelto | IMBIBE |
| James L Plummer | Rose Giles | Jonas Brekka | HASTRX | Lepoucehumain |
| Naomi Humin | qkrrudgks | Johann Gross | Janis Knappich | WhatTheDuck |
| 테루 | Glimple Bort | Jacob Tudisco | Tanner | Julian kaspi |
| nathan gould | Randal Rainis Kruus | Beppierre | Craig Martin | Thomas Bukovsky |
| Colaxe | Robert Oram | Matsuy15 L | Kacpe | Alex Sedlic |
| Mark Benson | Mhenn! | Anders Nelson | Dingus | Rustle |
| Marco Schulz | stratum | brochier gabriel | Thomas | brody of hillcountry |
| Thomas Afford | Brody Blaskie | Martien Gaming | Adrien MC | William A Grubbs |
| Trevo Ph.D. | Donovan Gibson | Polish R3t4rd | Keith Price | LAWL CAKE |
| Rhien Schultz | FireThrow13 | Seraphim | Titus Standing | Matt Miklos |
| B Dub | Jonathan Ekman | Al Pomeroy | Vestii | Wil |
| adrian | Airatise | TJ Sinkoski | Shotts SilverStone | Reagan Carbaugh |
| WarAestheticsRebooted | Aidan Case | Casey Bryant Goodwin | Konrad | Adam Larcher |
| Kazar Xin Xiao | Riccardo Marcaccio | William S. | Francis Filion | Loïc |
| Kenny Deane | Blackspots | mike | MXT | Joshua Gibson |
| milky boi | Hagen | gunmaster929 | jgvan | Benny 282 |
| Sean Wehner | Christian Poole | Ethan | Tsukiyama Shuu | Ooof_uhhh_haah |
| sano ken ch | Diego Martinez | Chuck | GalaxyFrogs | TheGeForce |
| Chriphost | Carthage | Greg L | Chipskate | Muhammed Mehmood |
| Hamilton Sjoberg | Amina Moh | vSiiFT | Jeremy Wren | Esteban Acosta |
| John A Ullenberg | Michael Morozov | Andrew Webberley | Nathaniel Lim | Aaron Ksicinski |
| Apocalypt | Josh batuzich | Ed | Hunter | Gene Brockoff |
| Redheadspellslinger. | Pablo Magariños | Nilz | Jose Manuel Silva Calvo | AJ |
| Ethan Wille | Aurora | Derek Shunia | Jan | Nope Mircea |
| Giancarlo Cestari | Tanner Edge | brad. | Connor Merrick | Martin Scholer |
| Deppy | Dan Smith | Tyson | Jac Comeau | Itemfinder |
| Tischer Games | Pedro Henrique | BeenWashedUp | martin wolff | Kurt Houben |
| Thomas Onslow | Brendan Puglisi | Kai Anquetil | Rudolph Ignatenko | CloudHackIX |
| Zach Carreau | Jonathan Vanderlyn | Krobivnov | ienergy | Leifster |
| Mikael Kaaronen | Glen | H.Helsing | ange | The Nobles |
| Johnathan Johnson | Juha Merentie | Jim Fares | Tom Marshall | Superferrariman |
| Zakary Zisa | JustTy | 晟道 杜 | Dnialibr Williams | Takumi Fujiwara |
| Koen van Hal | Jonathan Hill | Marco Siciliano | Kevindosenfutter | Angry Prawn |
| Natharic 67 | Rafael Monteiro | Jacob Ashline | ChironTheFloof | Caleb Dauphinee |
| Tony | Zac L | AlainMoto FPV | eirik johan johnsen | Elderet |
| Miles Longmore | lemon head | Viccy | Casey | Kajetan Cupa |
| Conejero00 | Bill Gricko | A cow wearing a turban | Danni Nowicki | Udo Schmidt |
| Tyler Swords | Constellation Gaming | Manimo | valentine | Jules Schattenberg |
| Brandon Crotts | Philipp Popetschnigg | Tiziano Della Fazia | goodgamer1109 | Joshua Thomas |
| Jeff Testa | Avery Snyder | Josh Kern | Triptagram | Bayon Antoine |
| Iván Juárez Núñez | Amery Martinat | ElArGee | Cory Green | lucas Di lorenzo |
| Caleb Sandersier |