🐟 Sameko IDE ⚓

The cutest & fastest C++ IDE for your coding adventures! (≧◡≦) ♡

Sameko IDE is a lightweight C++ IDE for Windows and Linux, built for competitive programming and learning. The Windows build comes with GCC 16 pre-configured — no MinGW installation needed. Just download, extract, and start coding. 💡 Think of it as a modern Dev-C++ alternative: simple interface, fast compilation, works out of the box.

• 🚀 GCC 16 bundled on Windows, no setup required (on Linux it uses your distro's g++)
• ⚡ Press F11 to compile and run instantly; an unchanged file runs again without recompiling
• ✅ Input / Output / Expected cards with an AC / WA verdict, and big test inputs straight from a .txt file
• 🐞 Real GDB debugger: breakpoints, watches, STL-aware variable trees, and an Auto dry run that walks your program line by line on its own
• 🏆 Fetch test cases from Codeforces, AtCoder, LeetCode via Competitive Companion, and run them all in parallel
• 🔗 Auto-links .cpp files when you #include custom headers
• 🎨 6 themes: Kawaii Dark, Kawaii Light, Sakura, Dracula, Monokai, Nord, plus your own in the Theme Customizer
• 📑 Multi-tab editor with split view
• ✂️ Custom snippets and templates (BFS, DFS, Segment Tree, etc.)
• 🧹 Format code with AStyle (Ctrl+Shift+A)
• 💾 Auto-save with configurable intervals
• 👁️ File watcher detects external changes

• A fresh look. The header, explorer, editor, panels and status bar are floating rounded cards; dialogs, menus and notifications match them, in your theme's colours, and the loading screen follows your theme too.
• Input / Output / Expected. The I/O column shows what your last run printed, with an AC or WA badge when Expected is filled.
• Test input from a file. Attach (or drop) a .txt file to the Input card and it is fed to your program straight from disk; only its first lines are shown, so even a 100 MB test stays smooth.
• A new Explorer. Your folder's files with Recent at the top, a filter box, a Done count per folder, status pills, and compiler output tucked away.
• Faster everywhere. Live checking ~10× faster, unchanged files run without recompiling, Run All Tests in parallel, accurate run time and memory, and Electron 44 opens the editor ~15% sooner.
• Editor touches. struct Name { closes as {};, standard-library names complete from the first second, and Ctrl+T / Ctrl+Tab work for tabs.
• A new setup. One window: choose the folder and install. Updates now install silently and reopen the app.
• Lots of fixes. Undo history kept per tab, no more freezes on endless output, Stop only stops your program, and more.

See CHANGELOG.md for the full list.

If your project is split across multiple .cpp files and you see linker errors like undefined reference, open:

• Settings > Compiler > Single-file Compile Mode

Then turn it OFF and build again.

💡 Zero setup required. MinGW-w64 (GCC 16.1.0) is pre-packaged. Download and code!

Sameko on Linux uses your system's compiler and debugger. Follow these 3 simple steps:

Open your terminal and run the command for your Linux distribution:

# Debian / Ubuntu / Linux Mint / Pop!_OS
sudo apt update && sudo apt install -y g++ gdb

# Fedora / RHEL
sudo dnf install -y gcc-c++ gdb

# Arch Linux / Manjaro
sudo pacman -S --noconfirm gcc gdb

Get the latest Linux release from sameko.dev or GitHub Releases.

• 🔹 Option A: AppImage (Universal — no installation needed)

  chmod +x sameko-dev-cpp-*.AppImage
  ./sameko-dev-cpp-*.AppImage

• 🔹 Option B: .deb Package (Debian / Ubuntu / Mint — auto-configures app menu & sandbox)

  sudo apt install ./sameko-dev-cpp-*.deb
  sameko-dev-cpp

• 🔹 Option C: .tar.gz Archive (Standalone portable folder)

  tar -xzf sameko-dev-cpp-*-linux-*.tar.gz
  cd sameko-dev-cpp-*-linux-*
  ./sameko-dev-cpp

• Node.js v18+
• npm or yarn
• On Linux: g++ and gdb (see Linux above)

# Clone the repository
git clone https://github.com/QuangquyNguyenvo/Sameko-Dev-CPP.git
cd Sameko-Dev-CPP

# Install dependencies
npm install

# Run in development mode
npm start

npm run build        # the three release artifacts: Windows installer + portable .zip + Linux AppImage
npm run build:win    # Windows only
npm run build:linux  # AppImage + .deb + .tar.gz  (run this on Linux or WSL)
npm run build:all    # everything, in one pass

Everything lands in samekodevcpp/. A full npm run build produces:

How the AppImage gets built on Windows. Packing an AppImage requires creating symlinks, which Windows only allows from an elevated terminal or with Developer Mode on; otherwise electron-builder stops at A required privilege is not held by the client. scripts/build-appimage.js checks for that permission up front and, when it is missing, runs the same build through WSL — which has no such restriction and can build in place from /mnt/<drive>. So npm run build produces all three artifacts on a plain terminal as long as WSL is installed; if it is not, the script prints every way to fix it. The Windows targets are built first either way, so they survive a Linux-side failure.

.deb additionally needs fpm, which has no Windows build — run npm run build:linux inside WSL or on a real Linux machine for the .deb and .tar.gz.

npm run clean        # wipe settings/history/snippets (the app's user-data folder)
npm run clean:dist   # wipe samekodevcpp/
npm run rebuild      # clean:dist, then a full build

Click the left gutter to set a breakpoint, then press F5. F10 and F11 switch to stepping for as long as the session is live, and go back to Run / Compile & Run once it ends.

💖 Contributors

• Yunchan (Special thanks for designing the logo!)
• KingShiba3766 (Donated the sameko.dev domain)
• aiko-chan-ai (Fixed G++ spawn issue on some machines)
• MerlyStella (Tested the app and shared feedback that helped improve it)

📝 Want to contribute?

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

This project is licensed under the MIT License - see the LICENSE file for details.