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 | 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 |
| Shaqalito | damo | IBS-IS-CRAP | Snowy | Noah Greenberg |
| Eisberg | Brendan M. | Kevin Nowald | poklijn | 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 | Blobby McBlob | labourateur | viperfan7 |
| SlimmyJimmy | Jason Becker | malek george haddad | 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 | rotary media |
| James L Plummer | 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 | cole newcomb |
| MrPiThon | mike | dung | Alvaro ArroyoZamora | vincie.net |
| Skinna Godwin |
| Boosted Media | Matthew McLennan | Venican | Lyan le Golmuth | Alberto R. |
| BetaToaster | Akira Takemoto | J Anderson | Apolly007 | LexLuther |
| Saints Sasha | xilophor | Robert K | viktor lind | Adrian Kucinski |
| sarowie . | Chris Fischer | Marlod | Chase Hansen | Aidan Szalanski |
| Andrew Taylor | Jason Hwang | Juuso Natunen | MoonOperator | Ian Moss |
| PickleRick | Beljim46 | RSOFT92 | UCD | Sped |
| OldManJenkins | James Hart | Kalle Nilsson | XxBrasta455xX | Colin Sandage |
| Dakota Mackinnon | Carter Kopp | george | Jakub Kozak | CJ Plessas |
| Loizeau | Charles Mills | YellowLight | Didrik Esbjug | Alessandro Dal Pino |
| Carter Williams | Robert D | Cadence Plume | zach kettering | BLANK |
| Provenance EMU | rommi5000 | Dylan Engler | Nathan Rojas | Cornelius |
| Acid | larsloveslegos | Maxime Desages | GM | BreadForMen |
| Devin Freeman | Lieven RYCKEBOER | Amelia Taylor | Jelle Plukker | sodmo |
| Maurice Matos | Jimmy Briscoe | Cirithor | Martin .K | DMartland |
| Lucas Diem | Richard Budíček | Jack Sheppeard | Meemen | Anderson Huynh |
| NPException | Mattia Villa | Austin King | C | AIDAN POWELL |
| Brenn_the_Otter | Lane Mosier | Ceze | oranjest1 | POPA ALBERT |
| Jw | ISON | Mathew Graham | John Crowell | Asher Blythe |
| Joe Worm | Kuiper | Cronos Skies | Matt Amott | Simon Krayer |
| József Gulyás | Caleb Bek | Monster Man25 | GeneralMoineau | EsuKurimu |
| Caleb Sartin | JoshuaTheGreat | Prono_Wolfie | Jared L. | Hunter Wood |
| Ben Poole | Steven Victoria | Jordan Zondlak | Agelessgod | Christopher Fahs |
| Jonathan Vincent | Dalton Guillot | Simon Stojanovic | Andrew Urbanczyk | Daniel |
| vPam | Justin Kruithof | Zavier Studios | Curtis C Coomber | Sawyer Clark |
| Mike Hart | Ciro Rancourt | Miles Guo | Michael Lesslie` | Rewind |
| E=mc^2 | Keaton Call | 1 | Jeremy B | Chance Hall |
| 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. | BrickTheBassist | Dylan Ryan |
| Noah Entrekin | 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 | Samuel Plante | 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 |
| REMI VIGOUROUX | Russell Marsh | Alyx Ranas | Naters305 | ChrisakaMrXD |
| Nic | BeaminYo | sean | Zach Hagedorn | Jhon lenon |
| Everett Butts | Kyan | ranger Nation | Hiago Oliveira | Texi |
| MrRhody | cat | Inglorious Bastard | Marty Mitchell | Justin Chao |
| ManuelS | Cornelius Rössing | Michał Szyszkowski | 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 |
| Antonino Arenas | 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 | Rafael Morais | Sandu Denis | skipyC | Tobias Moor |
| jaky3 . | Clément LEGRAND | Ian C. Simpson | Challier | Jan Przemysław Drabik |
| Dsand23 | Tim Doherty | Smooth DLX | The German Dude | CrazyEagle |
| Jordon Goodman | HenryWithaG . | Oscar Krula | Brayden Moore | Steven |
| Nall Wolfert | papajonk | Andrew | Ben Kingston | Julian Vogl |
| Maxime Lubrano | foxy foxfoxy | zero3growlithe | MrMekouil | Doudimme |
| Elliott Towlson | Jacob Hultberg | Nolan Orloff | Mike | tobi9899 |
| Eda Misař | Danila Frolkin | Xecotcovach | Jumbobaco | Rastus |
| Aj | Carcar404 | John Martin | Dominik Greinert | Lukas Stadler |
| Oliver Yang | sonax51 | Marcel Kliment | Chris | David Rush |
| LethalVenom13 | Dave Osterhoff | JC Estacio | Anto1709 | Ben |
| Morgan Munroe | Ivor Forrest | Hayden Nance | Sam Hopkins | Mr. Chilz Live |
| Atte | Dax | William Bergström | homelessmeme | Thanleft |
| Zaxerg | Robeloox | Maximilian-Lukas Marz | Morgn | Seth Monteleone |
| playfulmean videos | Lanimations LA | Bram G | Benoit Fournier | Nexorio |
| Bernar Lepiller | Nicolas Baur | the | Snekers | Darkmount |
| HITMAN | Tobiasz Michalik | Aidas Ri | Daniel Postler | Skim_Beeblez |
| PurpleToaster | Impetus | Thunderbird324 | Fred Joss | Krzysztof Radowski |
| Azerrty | Harrison Speck | Matt Baker | BigLynch | Markus Pelto |
| Duke Boreham | IMBIBE | MACHINA | Rose Giles | Jonas Brekka |
| HASTRX | Lepoucehumain | Az | Bluetn | Naomi Humin |
| qkrrudgks | Lociel | Johann Gross | Janis Knappich | WhatTheDuck |
| 테루 | Glimple Bort | Jacob Tudisco | Tanner | Julian kaspi |
| nathan gould | Mr nobody | Randal Rainis Kruus | Beppierre | Brennan Huff |
| CpTKugelHagel | mix gaming | Craig Martin | Thomas Bukovsky | Colaxe |
| Robert Oram | Matsuy15 L | Aleksander Dzwonkowski | Kacpe | Alex Sedlic |
| Mark Benson | Mhenn! | Anders Nelson | Dingus | Rustle |
| Marco Schulz | stratum | brochier gabriel | Thomas | brody of hillcountry |
| cree | Thomas Afford | Brody Blaskie | Martien Gaming | Adrien MC |
| William A Grubbs | Trevo Ph.D. | Donovan Gibson | Polish R3t4rd | Keith Price |
| LAWL CAKE | Rhien Schultz | Cody Cox | FireThrow13 | Landon Barnes |
| Seraphim | Titus Standing | Matt Miklos | Sean Ramey | B Dub |
| Jonathan Ekman | Al Pomeroy | Vestii | Wil | adrian |
| Airatise | night the wolf | TJ Sinkoski | Shotts SilverStone | Reagan Carbaugh |
| Jayden Turner | WarAestheticsRebooted | Aidan Case | Casey Bryant Goodwin | Konrad |
| Stephanie Summers | Bananensmoothie 56 | 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 | josh | Tsukiyama Shuu | Ooof_uhhh_haah | sano ken ch |
| Diego Martinez | Chuck | GalaxyFrogs | Danial Thomas Cairns | Leaked Night |
| Sivear | Marco Hernandez | Bacon baconbacon | TheGeForce | Leander Mengel |
| Tripplex2112 Sub plz | 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 | Tyler Hughes |
| Hunter | Gene Brockoff | Redheadspellslinger. | Pablo Magariños | Nilz |
| Jose Manuel Silva Calvo | AJ | Ethan Wille | Aurora | DILLY |
| Derek Shunia | Jan | Crimcy Productions | Nope Mircea | Giancarlo Cestari |
| Tanner Edge | brad. | Connor Merrick | Zurpy Dood | Martin Scholer |
| Deppy | Dan Smith | Tyson | Jac Comeau | Itemfinder |
| Tischer Games | Pedro Henrique | Jonathon Owens | BeenWashedUp | martin wolff |
| Kurt Houben |