Ahmed x86 - C/C++ RunX 🚀

The ultimate code runner and compiler extension for C/C++ developers on VS Code. Fast, transparent, and powerful.

VS Code VSCodium C C++ GCC Linux Windows macOS Wine Arch Linux Debian Ubuntu
C/C++ RunX VS Code Extension
Write, check, build, and run C/C++ code with a single click!

✨ Key Features


🛠️ Requirements & Dependencies

For the extension to work properly across all its features (including Cross-Compilation), you must install the core compilers (GCC/G++, TCC) and Windows emulators (Wine/MinGW).

🪟 Windows

Install MSYS2 and use pacman to get the GCC toolchain.

🪟 Download MSYS2 (Official Site)
pacman -S mingw-w64-ucrt-x86_64-gcc make

🍎 macOS Dependencies

Use Homebrew to install the required compilers and Wine for cross-platform simulation.

brew install gcc tcc mingw-w64 wine

🐧 GNU/Linux Dependencies

Choose your Linux distribution below to install the required tools (gcc, tcc, mingw-w64, and wine).

Arch Linux / Manjaro / CachyOS
sudo pacman -S --needed gcc tcc mingw-w64-gcc wine
Debian / Ubuntu / Linux Mint
sudo apt update && sudo apt install -y gcc g++ tcc gcc-mingw-w64 g++-mingw-w64 wine
Fedora / Nobara
sudo dnf install -y gcc gcc-c++ tcc mingw64-gcc mingw64-gcc-c++ wine
Void Linux
sudo xbps-install -S gcc tcc cross-x86_64-w64-mingw32-gcc wine
Gentoo
sudo emerge --ask sys-devel/gcc dev-lang/tcc dev-util/mingw64-toolchain app-emulation/wine-vanilla
Solus
sudo eopkg install gcc tcc mingw-w64 wine
openSUSE
sudo zypper install -y gcc gcc-c++ tcc mingw64-gcc mingw64-gcc-c++ wine
Alpine Linux
sudo apk add --no-cache gcc g++ tcc mingw-w64-gcc wine
Puppy Linux
pkg install gcc tcc mingw-w64-gcc wine

📜 Built-in Snippets

Type the prefix in a .c or .cpp file and hit Tab for instant boilerplate code!

Prefix Description
hello_world_c Generates a standard C Hello World.
hello_world_c++ Generates a standard C++ Hello World.
fstream_c++_windows C++ file handling template with Windows paths (C:\\...). Great for Wine testing!
fstream_c++_unix C++ file handling template with Unix paths (/tmp/...).

⚙️ How to Use

  1. Open any .c or .cpp file in VS Code.
  2. Quick Run: Click the Play button top-right or use the command palette to Run C or Run C++.
  3. Smart Menu: Press Ctrl + Alt + C to open the RunX Build Menu. From here, you can natively compile, generate Assembly, or cross-compile to Windows.
  4. Settings Center: Open the command palette and select C/C++ RunX: Settings to:
    • Change your C compiler (GCC ↔ TCC).
    • Change your Build Profile (Normal ↔ Release).
    • Turn Wine debug logs ON/OFF.
  5. Syntax Errors? If you make a typo, the extension stops execution and points out the exact error with a red squiggle!

⬇️ Download from VS Code Store ⬇️ Download for VSCodium (Open VSX) ⭐ View GitHub Repository