This version is intended for build on M1 Mac (tested on OS Ventura 13) with arm64 homebrew (in /opt/homebrew).
git clone https://github.com/boxofbox/engine-sim-m1
brew install cmake
brew install boost
brew install bison
brew install sse2neon
brew install sdl2
brew install sdl2_image
brew install flex
From the root directory of the project, run the following commands:
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build . --target engine-sim-app
If these steps are successful, you should be able to run the program from the build directory with ./engine-sim-app
NOTE: the application currently does not open properly with double-click. You must run it from the command line in the build directory
The work to get this to run on Metal wouldn't have happened without these forks from phire and bobsayshilol and help from jakelst on the engine-sim discord!
https://github.com/phire/delta-studio/tree/clang_linux
https://github.com/bobsayshilol/engine-sim/tree/gcc-fixes
- Engine view is huge.
- Engine view isn't drawn 100% correctly (Valves, cam lobes, etc look weird)
- App may be so big that it goes off the edge of the screen.
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.
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.
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 |