Krotox Engine › Docs › Start Here › Welcome & Setup

Install Krotox & system requirements

Check your GPU and OS, download the editor for Windows or macOS, install it, and get ready to test on an Android phone.

This page takes you from "nothing installed" to "Project Hub on screen".

---

Step 1: Check your computer

Krotox renders only through Vulkan 1.3, so the one thing that matters most is your graphics card and driver.

	Windows	macOS
Operating system	Windows 10 or 11, 64-bit	macOS 12 (Monterey) or later
Processor	x64	Apple Silicon (M1 to M4) or Intel x64, one universal build
Graphics	A GPU with Vulkan 1.3: NVIDIA Maxwell, AMD GCN 2.0, Intel Iris Xe or newer	Vulkan is translated to Metal by MoltenVK, bundled
Already bundled	DirectX Shader Compiler, Mono 6.x runtime	The Vulkan-to-Metal layer

Update your graphics driver first. Most "it will not start" problems on Windows are an out-of-date driver that does not expose Vulkan 1.3.

What if I have no Vulkan GPU?

The Lavapipe software renderer is bundled, so the editor can still open. It runs much more slowly than a real GPU, so use it to look around rather than to work.

---

Step 2: Download the editor

1. Open the Download section on the home page. Only a Windows build is available for now.
2. Save the file. It arrives as a .zip.

---

Step 3: Install

Windows

You can use either option:

• Installer (.exe): one click. It adds desktop shortcuts and file associations for .ktxproj (projects) and .ktx (scenes), so double-clicking a project opens it in the editor.
• Portable archive (.zip): unpack anywhere and run Launch-Editor.bat. No administrator rights are needed, which suits locked-down machines or a USB stick.

macOS (once a macOS build is published)

1. Open the .dmg.
2. Drag Krotox into Applications.
3. Launch it from Applications or Launchpad. The app is notarized by Apple, so it opens without the "unidentified developer" warning.

---

Step 4: Pick a code editor

Krotox scripts are plain .cs files. Double-clicking a script in the Content Browser opens it in Visual Studio Code or JetBrains Rider. Install one of them now if you do not have one.

Step 5: Get ready for a phone (optional, but worth it)

You can build and test everything on your desktop first. When you want to run on a real phone:

1. On the phone, turn on Developer options and USB debugging.
2. Connect it by USB cable, or pair it over Wi-Fi with wireless ADB (see Android export).
3. Keep the phone and computer on the same network if you use Wi-Fi.

---

Checklist

• Graphics driver is up to date
• Editor downloaded and installed (or unpacked)
• A code editor (VS Code or Rider) installed
• Optional: phone with USB debugging on

Launch Krotox. You should land on the Project Hub. Next: Your first project.