{"id":13494140,"url":"https://github.com/ange-yaghi/engine-sim","last_synced_at":"2025-05-14T03:06:31.313Z","repository":{"id":37390437,"uuid":"439491516","full_name":"ange-yaghi/engine-sim","owner":"ange-yaghi","description":"Combustion engine simulator that generates realistic audio.","archived":false,"fork":false,"pushed_at":"2024-06-17T11:35:26.000Z","size":5966,"stargazers_count":8857,"open_issues_count":136,"forks_count":796,"subscribers_count":125,"default_branch":"master","last_synced_at":"2025-04-10T20:06:33.698Z","etag":null,"topics":["engine","simulation"],"latest_commit_sha":null,"homepage":"http://engine-sim.parts/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ange-yaghi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-18T00:14:57.000Z","updated_at":"2025-04-10T15:03:01.000Z","dependencies_parsed_at":"2024-10-31T08:31:59.693Z","dependency_job_id":"6eb6fcd6-afc1-4dae-a645-995eaade6c31","html_url":"https://github.com/ange-yaghi/engine-sim","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":"ange-yaghi/delta-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ange-yaghi%2Fengine-sim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ange-yaghi%2Fengine-sim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ange-yaghi%2Fengine-sim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ange-yaghi%2Fengine-sim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ange-yaghi","download_url":"https://codeload.github.com/ange-yaghi/engine-sim/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254059500,"owners_count":22007768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["engine","simulation"],"created_at":"2024-07-31T19:01:22.260Z","updated_at":"2025-05-14T03:06:31.261Z","avatar_url":"https://github.com/ange-yaghi.png","language":"C++","funding_links":[],"categories":["C++","Stale","By Language","游戏"],"sub_categories":["C / C++ \u0026 Systems","C++","网络服务_其他"],"readme":"# Engine Simulator\n![Alt text](docs/public/screenshots/screenshot_v01.png?raw=true)\n---\n# Engine Simulator has moved!\n\nTo get the newest releases of the game, [click here](https://github.com/Engine-Simulator/engine-sim-community-edition).\n---\n\n## What is this?\n\nThis 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.\n\n## How do I install it?\n\nThis 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](https://github.com/ange-yaghi/engine-sim/releases), 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.\n\nCheck out [our Frequently Asked Questions](https://github.com/ange-yaghi/engine-sim/wiki/Frequently-Asked-Questions) if you need more details.\n\n## How do I use it?\n\nThe UI is extremely minimalistic and there are only a few controls used to interact with the engine:\n\n| Key/Input | Action |\n| :---: | :---: |\n| A | Toggle ignition |\n| S | Hold for starter |\n| D | Enable dyno |\n| H | Enable RPM hold (see below for instructions) |\n| G + Scroll | Change hold speed |\n| F | Enter fullscreen mode |\n| I | Display dyno stats in the information panel |\n| Shift | Clutch (hold spacebar at the same time to slowly engage/disengage) |\n| Up Arrow | Up Gear | \n| Down Arrow | Down Gear | \n| Z + Scroll | Volume |\n| X + Scroll | Convolution Level |\n| C + Scroll | High frequency gain |\n| V + Scroll | Low frequency noise |\n| B + Scroll | High frequency noise |\n| N + Scroll | Simulation frequency |\n| M | Increase view layer |\n| , | Decrease view layer |\n| Enter | Reload engine script |\n| Escape | Exit the program |\n| Q, W, E, R | Change throttle position |\n| Space + Scroll | Fine throttle adjustment |\n| 1, 2, 3, 4, 5 | Simulation time warp |\n| Tab | Change screen |\n\n### Using the RPM hold\nThe 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.\n\n## Why is the code so sloppy?\n\nI wrote this to demo in a [YouTube video](https://youtu.be/RKT-sKtR970), 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.\n\n## How do I build it? (Ignore this section if you're not a developer!)\n**Note: this project currently only builds on Windows!**\n\n### Step 1 - Clone the repository\n```git clone --recurse-submodules https://github.com/ange-yaghi/engine-sim```\n\n### Step 2 - Install CMake\nInstall the latest version of CMake [here](https://cmake.org/) if it's not already installed.\n\n### Step 3 - Install Dependencies\nYou 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):\n\n    1. SDL2\n    2. SDL2_image\n    3. Boost (make sure to build the optional dependencies)\n    4. Flex and Bison\n\n### Step 4 - Build and Run\nFrom the root directory of the project, run the following commands:\n\n```\nmkdir build\ncd build\ncmake ..\ncmake --build .\n```\n\nIf 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.\n\n## Patreon Supporters\n\nThis project was made possible by the generous donations of the following individuals!\n\n### Grease Monkeys\n\n|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\n|-|-|-|-|-|\n|Devin@Hondatuningsuite|nut|Devin C Martinez|WelcomeCat|Saints Sasha|\n|Ida 8858|Emily|Steelorse |Kruddy|Sgt. Fluff|\n|darcuter|FatFluffyFox|Benton1234|Jim C K Flaten|The Zuck|\n|Blade Skydancer|Ye' old apple|Hayden Henderson|AlphaX|Lucas Martins Bündchen|\n|Jay Dog|damo|IBS-IS-CRAP|Snowy|Noah Greenberg|\n|Eisberg|Brendan M.|Alex Layton|Lukas Bartee|Thibaut Dubuisson|\n|The Cheeze Ity|JoeJimTom|MichaelB450|Björn|Bartdavy|\n|sasha bandelier|Caleb Black|COOKIES|Andrew Cooper|asimo3089|\n|Vim Wizard|Kevin Arsenault|Carl Linden|Kele Tappi|Kroklethon|\n|labourateur|viperfan7|SlimmyJimmy|Jason Becker|Sascha Kamp|\n|ves|Supernalboot |BeamNG|Paul Harrison|Tyler Russell (Nytelife26)|\n|nicholas jacobs|DrDotMadness|AVeryPlainTyler|Zach Perez|Paul Schaefer|\n|Clay Bauer|CR33DYM0N14|julien nadeau|Patt313|Philip Edwards|\n|RegularRuby670|Mateusz Ładosz|FémLol Stúdió|Crazy Yany|Elden|\n|Tristan Walker|Matthew McDonald|Jan-Sander Huiting|Mitchell Almstedt|Dylan Lebiedz|\n|Name Here|LoganBoi FNAF|Epic Randomness|MrPiThon|mike |\n|dung|Alvaro ArroyoZamora|Skinna Godwin|BeppoBarone|レナVA|\n|Sabata |Brady Fulham|Powerpuncher |NK10K|Gavin Osowski|\n|Orbitstrider|Steven Doyle|Jaksu2696|Toni |Devin Abolins|\n### Tuners\n\n|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\n|-|-|-|-|-|\n|Boosted Media|Matthew McLennan|Venican|Lyan le Golmuth|Alberto R.|\n|BetaToaster|Akira Takemoto|J Anderson|Apolly007|LexLuther|\n|xilophor|Robert K|viktor lind|Adrian Kucinski|sarowie .|\n|Chris Fischer|Marlod|Chase Hansen|Aidan Szalanski|Andrew Taylor|\n|Jason Hwang|Juuso Natunen|Ian Moss|PickleRick |Beljim46|\n|RSOFT92|UCD|Sped|OldManJenkins|James Hart|\n|Kalle Nilsson|XxBrasta455xX |Colin Sandage|Dakota Mackinnon|Carter Kopp|\n|Jakub Kozak|CJ Plessas|Loizeau|Charles Mills|YellowLight|\n|Didrik Esbjug|Alessandro Dal Pino|Carter Williams|Robert D|Cadence Plume|\n|BLANK|Provenance EMU|Dylan Engler|Nathan Rojas|Cornelius|\n|Acid|larsloveslegos|Maxime Desages|GM|BreadForMen|\n|Devin Freeman|Lieven RYCKEBOER|Amelia Taylor|Jelle Plukker|sodmo |\n|Jimmy Briscoe|Cirithor|Martin .K|DMartland|Lucas Diem|\n|Richard Budíček|Jack Sheppeard|Meemen|Anderson Huynh|NPException|\n|Mattia Villa|C|AIDAN POWELL|Brenn_the_Otter|Lane Mosier|\n|Ceze |oranjest1|Jw|ISON |Mathew Graham|\n|MACHINA|John Crowell|Asher Blythe|Cronos Skies|Matt Amott|\n|CpTKugelHagel|Simon Krayer|Caleb Bek|Monster Man25|GeneralMoineau|\n|EsuKurimu|Caleb Sartin|Jared L.|Hunter Wood|Ben Poole|\n|Steven Victoria|Jordan Zondlak|Agelessgod|Christopher Fahs|Jonathan Vincent|\n|Dalton Guillot|Simon Stojanovic|Andrew Urbanczyk|deniaL|Tyler Hughes|\n|vPam |Justin Kruithof|Curtis C Coomber|Sawyer Clark|Mike Hart|\n|Ciro Rancourt|Miles Guo|Rewind |E=mc^2|Keaton Call|\n|J.Es|Jeremy B|Chance Hall|Jack Tompkins|Race Sim Studio|\n|Quentin ZAOUI|Floyd Henderson|James Haylow|Milkshiekh |Wyatt Todd|\n|User 2820|Leon Schutte|CYBERBUG_JR|sebiii|Keegan|\n|Victor Cosiuga|Rolly !|Elias Pettersson|Tyson Makovec|Bill McDermott|\n|Phontonic|Simon Armstrong|avec |KidozyGAME (Dead)|Stephan Cote|\n|Justin Biggerstaff|Jabba Jubba|notD34THNIGHT|Inventor|Wesley Bear|\n|Supersonic2510|Pixel|Simon Bernhardt|Bas Vangermeersch|ToyotaCipra|\n|kyle crawford|ApatheticWood|Ben Vaughn|Erich Westhoven|Zack Myers|\n|Tbjoern|Vetle Høgås|Derek Thom|Aaron Beck||\n### Junior Mechanics\n\n|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\u003c!-- --\u003e|\n|-|-|-|-|-|\n|Karol Szép|Leon Jordan|Nathan Higginson|Patrick F|Samuel Picard|\n|Alexander Fritsch|Lucas Scarpi|Jack Humbert|G2Eneko|SweCreations|\n|Marius Becker|Cedric Wille|infernap12 |Julian Dinges|Wamuthas|\n|Alex Mason|Hawar Karem|Melonenstrauch|Jacek Dębski|Alex Eastman|\n|Darren Taing|Po Wang|Giorgio Iannucci|Levis|Eden|\n|Alin Chiparatu|Arjun Mandakath|A.M. |Dylan Ryan|Noah Entrekin|\n|GT130|Josh D|generic|Henrik Cohrs|Nic Yetter|\n|Dan Fredriksen|153AN1MJ|Rasmus|EpicEcho|Kaur Hendrikson|\n|Maddox Partridge|L33TIFY_|Zack Fletcher|teiiio|Mike Zaite|\n|Evan Sonin|Christopher Zimmerman|PrefacedVase |funtomr|Triton Alabaster|\n|appelpie|Julien Ferluc|AnomalousFerret_|Miles Orozco|Spencer Teeter|\n|ThatCanadian|Harry Prabowo|Dylan Rogerson|Jaedyn Allen|Zephyr Sefira|\n|Alexander Stone|Mason Little|Wojciech Czop|ryzen5 |Kosta Diamantis|\n|Karol Stodolak|Tim van der Linde|Loïc Ruttner|jonthefuzz|AsgarK|\n|James Morgan|Elijah |1ntl|Tobias Johansson|Mome |\n|P|SOPA_|Shingekuro|Sean King|Russell Marsh|\n|Alyx Ranas|Naters305 |ChrisakaMrXD |Nic |sean|\n|Zach Hagedorn|Jhon lenon|Everett Butts|Kyan|ranger Nation|\n|Hiago Oliveira|Texi|MrRhody|Inglorious Bastard|Marty Mitchell|\n|Justin Chao|ManuelS|Cornelius Rössing|Pedro Freire|Anthony Stuart|\n|Hubba Nubba|Skychii|Joe Underwood|Xander_|Notbigdank|\n|Sander D.|Lars Joosten|Danksa|Metrostation |Myles Wommack|\n|Derrick Sampson|Corey Hannen|Matteo La Corte|Octothorp Obelus|David Baril|\n|Soyuz Kafire|Ivan Coha|BigElbowski|Apolepth|Julian Krad|\n|David Soulieres|Eric Huang|Léo Vias|Riccardo Mariani|Vic Viper|\n|Shinkaaaa|Mumaransa |Michael Banovsky|Hendrik Voss|Inverted Blackhat|\n|skipyC |Tobias Moor|jaky3 .|Clément LEGRAND|Ian C. Simpson|\n|Challier|Jan Przemysław Drabik|Dsand23|Smooth DLX|The German Dude|\n|CrazyEagle |Jordon Goodman|HenryWithaG .|Oscar Krula|Brayden Moore|\n|Steven|Nall Wolfert|papajonk|Andrew|Ben Kingston|\n|Julian Vogl|Maxime Lubrano|MrMekouil|Doudimme|Jacob Hultberg|\n|Nolan Orloff|Mike|tobi9899 |Danila Frolkin|Xecotcovach|\n|Aj|Carcar404|John Martin|Dominik Greinert|Lukas Stadler|\n|Oliver Yang|sonax51|Marcel Kliment|Chris|David Rush|\n|LethalVenom13|Dave Osterhoff|Anto1709|Ben|Morgan Munroe|\n|Ivor Forrest|Sam Hopkins|Atte |Dax |William Bergström|\n|homelessmeme|Thanleft|Zaxerg |Robeloox|Maximilian-Lukas Marz|\n|Morgn|Seth Monteleone|playfulmean videos|Lanimations LA|Bram G|\n|Benoit Fournier|Bernar Lepiller|Nicolas Baur|the |Snekers|\n|Darkmount|Tobiasz Michalik|Aidas Ri|Daniel Postler|Skim_Beeblez|\n|Impetus|Thunderbird324|Fred Joss|Krzysztof Radowski|Azerrty|\n|Harrison Speck|Matt Baker|BigLynch|Markus Pelto|IMBIBE|\n|James L Plummer|Rose Giles|Jonas Brekka|HASTRX|Lepoucehumain|\n|Naomi Humin|qkrrudgks|Johann Gross|Janis Knappich|WhatTheDuck|\n|테루|Glimple Bort|Jacob Tudisco|Tanner|Julian kaspi|\n|nathan gould|Randal Rainis Kruus|Beppierre|Craig Martin|Thomas Bukovsky|\n|Colaxe|Robert Oram|Matsuy15 L|Kacpe|Alex Sedlic|\n|Mark Benson|Mhenn!|Anders Nelson|Dingus|Rustle|\n|Marco Schulz|stratum |brochier gabriel|Thomas|brody of hillcountry|\n|Thomas Afford|Brody Blaskie|Martien Gaming|Adrien MC|William A Grubbs|\n|Trevo Ph.D.|Donovan Gibson|Polish R3t4rd|Keith Price|LAWL CAKE|\n|Rhien Schultz|FireThrow13|Seraphim|Titus Standing|Matt Miklos|\n|B Dub|Jonathan Ekman|Al Pomeroy|Vestii|Wil|\n|adrian|Airatise|TJ Sinkoski|Shotts SilverStone|Reagan Carbaugh|\n|WarAestheticsRebooted|Aidan Case|Casey Bryant Goodwin|Konrad|Adam Larcher|\n|Kazar Xin Xiao|Riccardo Marcaccio|William S.|Francis Filion|Loïc |\n|Kenny Deane|Blackspots|mike |MXT|Joshua Gibson|\n|milky boi|Hagen|gunmaster929 |jgvan |Benny 282|\n|Sean Wehner|Christian Poole|Ethan|Tsukiyama Shuu|Ooof_uhhh_haah|\n|sano ken ch|Diego Martinez|Chuck|GalaxyFrogs|TheGeForce |\n|Chriphost|Carthage|Greg L|Chipskate|Muhammed Mehmood|\n|Hamilton Sjoberg|Amina Moh|vSiiFT|Jeremy Wren|Esteban Acosta|\n|John A Ullenberg|Michael Morozov|Andrew Webberley|Nathaniel Lim|Aaron Ksicinski|\n|Apocalypt|Josh batuzich|Ed|Hunter |Gene Brockoff|\n|Redheadspellslinger.|Pablo Magariños|Nilz|Jose Manuel Silva Calvo|AJ|\n|Ethan Wille |Aurora|Derek Shunia|Jan|Nope Mircea|\n|Giancarlo Cestari|Tanner Edge|brad.|Connor Merrick|Martin Scholer|\n|Deppy|Dan Smith|Tyson |Jac Comeau|Itemfinder |\n|Tischer Games|Pedro Henrique|BeenWashedUp|martin wolff|Kurt Houben|\n|Thomas Onslow|Brendan Puglisi|Kai Anquetil|Rudolph Ignatenko|CloudHackIX|\n|Zach Carreau|Jonathan Vanderlyn|Krobivnov|ienergy|Leifster|\n|Mikael Kaaronen|Glen|H.Helsing|ange|The Nobles|\n|Johnathan Johnson|Juha Merentie|Jim Fares|Tom Marshall|Superferrariman|\n|Zakary Zisa|JustTy|晟道 杜|Dnialibr Williams|Takumi Fujiwara|\n|Koen van Hal|Jonathan Hill|Marco Siciliano|Kevindosenfutter|Angry Prawn|\n|Natharic 67|Rafael Monteiro|Jacob Ashline|ChironTheFloof|Caleb Dauphinee|\n|Tony |Zac L|AlainMoto FPV|eirik johan johnsen|Elderet|\n|Miles Longmore|lemon head|Viccy|Casey|Kajetan Cupa|\n|Conejero00|Bill Gricko|A cow wearing a turban|Danni Nowicki|Udo Schmidt|\n|Tyler Swords|Constellation Gaming|Manimo|valentine|Jules Schattenberg|\n|Brandon Crotts|Philipp Popetschnigg|Tiziano Della Fazia|goodgamer1109|Joshua Thomas|\n|Jeff Testa|Avery Snyder|Josh Kern|Triptagram|Bayon Antoine|\n|Iván Juárez Núñez|Amery Martinat|ElArGee|Cory Green|lucas Di lorenzo|\n|Caleb Sandersier|||||\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fange-yaghi%2Fengine-sim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fange-yaghi%2Fengine-sim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fange-yaghi%2Fengine-sim/lists"}