🐟 Sameko IDE ⚓

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

★ 。＼｜／。★
Welcome to the deep blue sea of coding! 🌊
★ 。／｜＼。★

Features • Screenshots • Download • Development • Shortcuts

🎯 About

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.

✨ Features

• 🚀 GCC 16 bundled on Windows, no setup required (on Linux it uses your distro's g++)
• ⚡ Press F11 to compile and run instantly
• 🐞 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
• 🔗 Auto-links .cpp files when you #include custom headers
• 🎨 6 themes: Kawaii, Dracula, Monokai, Nord, One Dark, Sakura
• 📑 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

📸 Screenshots

🆕 What's New in v1.2.0

• A real debugger. Breakpoints in the gutter, watches, STL-aware variable trees, call stack, hover-to-evaluate, Run to Cursor — all on the bundled GDB.
• Auto dry run. One button walks your program a line at a time while the values update, so you can watch a loop run instead of pressing F10 a hundred times. No breakpoint needed; it starts at main().
• Step back through a recording. Every pause is recorded, so Back lets you look at the previous steps and the values they held.
• Linux support. AppImage, .deb and .tar.gz builds.
• Realtime output — cout/printf appear line by line while the program runs, not all at once when it exits.
• Clangd-powered IntelliSense, replacing the old hardcoded STL tables.
• Faster startup: Monaco loads on demand and ~115 MB of never-used files were dropped from the package.

See CHANGELOG.md for the full list.

Multi-file project note

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.

📥 Download

🪟 Windows (Compiler Bundled)

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

Package	Format	Description	Recommendation
Installer	.exe	Full setup with Start Menu shortcuts & auto-update support	⭐ Recommended for most users
Portable	.zip	Standalone archive. Extract anywhere (including USB drives) and run	Ideal for school / restricted PCs

🐧 Linux Installation Guide

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

📌 Step 1: Install prerequisites (g++ & gdb)

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

---

📌 Step 2: Download your preferred package

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

---

📌 Step 3: Run or install the application

• 🔹 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

---

🔍 Linux Troubleshooting Tips (FUSE 2 & Chrome Sandbox)

• AppImage fails to open: Ubuntu 22.04+ may require FUSE 2:

  sudo apt install libfuse2

  (Or run with ./sameko-dev-cpp-*.AppImage --appimage-extract-and-run)

• Chrome Sandbox permission error: If running unpacked .tar.gz on Ubuntu 24.04+:

  sudo chown root:root chrome-sandbox && sudo chmod 4755 chrome-sandbox

  (The .deb installer configures sandbox permissions automatically).

🛠️ Development

Prerequisites

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

Setup

# 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

Building

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:

Artifact	Notes
sameko-dev-cpp-setup-<version>.exe	Windows installer (NSIS)
sameko-dev-cpp-<version>-portable.zip	Windows portable folder, zipped
sameko-dev-cpp-<version>-linux-x86_64.AppImage	Linux, runs on any distribution
latest.yml + .blockmap	Update metadata the in-app updater reads

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.

Housekeeping

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

⌨️ Shortcuts

Key	Action
F9	Compile
F10	Run
F11	Compile & Run
Ctrl + N	New file
Ctrl + O	Open file
Ctrl + S	Save file
Ctrl + Shift + S	Save As
Ctrl + J	Toggle Panel
Ctrl + \	Split Editor
Ctrl + Shift + A	Auto Format (AStyle)
Ctrl + Alt + S	Toggle Auto-Save
Ctrl + Shift + P	Command Palette

While debugging

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.

Key	Action
F5	Start debugging · Continue
F10	Step over
F11	Step into
Shift + F11	Step out
Shift + F5	Stop debugging
Esc	Stop an Auto dry run · leave the step history
Alt + gutter	Conditional breakpoint
Ctrl + gutter	Enable / disable a breakpoint
Right-click a line	Run to Cursor

🤝 Contributing

💖 Contributors

• Yunchan (Special thanks for designing the logo!)
• KingShiba3766 (Donated the sameko.dev domain)
• aiko-chan-ai (Fixed G++ spawn issue on some machines)

📝 Want to contribute?

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

📄 License

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

---

Made with 💙 and 🐟 by QuangquyNguyenvo

"Have a bubbly day!"

Report Bug • Request Feature

---

_{Keywords: C++ IDE • portable C++ compiler • Dev-C++ alternative • competitive programming IDE • beginner-friendly IDE • lightweight IDE • Windows C++ IDE • GCC compiler • Monaco Editor • Electron IDE • code editor • student IDE • educational software • free C++ IDE • C++11 • C++14 • C++17 • C++20 • C++23 • syntax highlighting • auto-completion • Codeforces • AtCoder • LeetCode • programming tools • MinGW • code runner • AStyle formatter}