Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time

Dear ImGui Test Engine + Test Suite


Don't blink

Running Dear ImGui Test Suite, in Fast Mode, in a visible window:

Quick overview of what automation code may look like like:

ImGuiTest* test = IM_REGISTER_TEST(e, "demo_test", "test1");
test->TestFunc = [](ImGuiTestContext* ctx)
    ctx->SetRef("My Window");           // Set a base path so we don't have to specify full path afterwards
    ctx->ItemClick("My Button");        // Click "My Button" inside "My Window"
    ctx->ItemCheck("Node/Checkbox");    // Open "Node", find "Checkbox", ensure it is checked if not checked already.
    ctx->ItemInputValue("Slider", 123); // Find "Slider" and set the value to 123
    IM_CHECK_EQ(app->SliderValue, 123); // Check value on app side


  • Designed to automate and test Dear ImGui applications.
  • We also use it to self-test Dear ImGui itself, reduce regression and facilitate contributions.
  • Test Engine interacts mostly from the point of view of an end-user, by injecting mouse/keyboard inputs into Dear ImGui's IO. It means it tries to "find its way" toward accomplishing an action. Opening an item may mean CTRL+Tabbing into a given widow, moving things out of the way, scrolling to locate the item, querying its open status, etc.
  • It can be used for a variety of testing (smoke testing, integration/functional testing) or automation purposes (running tasks, capturing videos, etc.).
  • Your app can be controlled from Dear ImGui + You can now automate your app = You can test anything exposed in your app/engine! (not only UI).
  • It can run in your windowed application. It can also run headless (e.g. running GUI tests from a console or on a CI server without rendering).
  • It can run at simulated human speed (for watching or exporting videos) or can run in fast mode (e.g. teleporting mouse).
  • It can export screenshots and videos/gifs. They can be leveraged for some forms of testing, but also to generate assets for documentation, or notify teams of certain changes. Assets that often need to be updated are best generated from a script inside of manually recreated/cropped/exported.
  • You can use it to program high-level commands e.g. MenuCheck("Edit/Options/Enable Grid") or run more programmatic queries ("list openable items in that section, then open them all"). So from your POV it could be used for simple smoke testing ("open all our tools") or for more elaborate testing ("interact with xxx and xxx, check result").
  • It can be used as a form of "live tutorial / demo" where a script can run on an actual user application to showcase features.
  • It includes a performance tool and viewer which we used to record/compare performances between builds and branches (optional, requires ImPlot).


  • It is currently a C++ API but down the line we can expect that the commands will be better standardized, stored in data files, called from other languages.
  • It has been in use and development since 2018. Library is provided as-is, and we'll provide best effort to make it suitable for user needs.
  • You will run into problems and shortcomings. We are happy to hear about them and improve the software and documentation accordingly.


See Wiki sections:


  • The imgui_test_engine/ folder is under the Dear ImGui Test Engine License.
    TL;DR: free for individuals, educational, open-source and small businesses uses. Paid for larger businesses. Read license for details. License sales to larger businesses are used to fund and sustain the development of Dear ImGui.
  • Other folders are all under the MIT License.


Dear ImGui Tests & Automation






No releases published


No packages published