🐟 Sameko Dev C++ ⚓

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

Sameko Dev C++ is a free, open-source C++ IDE for Windows and Linux, built for competitive programming and learning. The Windows build includes GCC 16, clangd and GDB. On Linux, Sameko uses the tools installed on your system. 💡 Think of it as a modern Dev-C++ alternative: simple interface, fast compilation, works out of the box. 🐟 Unofficial fan project, not affiliated with Sameko Saba. Why the name?

• 🚀 GCC 16 comes bundled on Windows. On Linux, Sameko uses your system's g++.
• ⚡ Press F11 to build and run. An unchanged file can run again without recompiling.
• 🔗 Include a custom header to link its sibling .cpp file when multi-file mode is enabled.
• 🧠 Get code completion and live diagnostics with clangd. Choose a C++ standard and add compiler flags in Settings.

• ✅ Compare Input, Output and Expected results with AC, WA and TLE verdicts. cerr output gets its own Stderr card, so verdicts check stdout only. Load large inputs from a .txt file.
• 🏆 Fetch problems and test cases with Competitive Companion. Run all tests in parallel or inspect them one at a time.
• 🗂️ Organize problems into contests and collections, with statuses, notes and saved approaches.
• 🐞 Debug with GDB using breakpoints, conditional breakpoints, watches and STL-aware variable trees. Auto dry run steps through code while you watch variables change.

• 🌏 Use the interface in English, Tiếng Việt or 简体中文. Code and program output are never translated.
• 📑 Work across tabs and split editor panes. Rename tabs, drag files into the window and create C++, C, input, output, text or Markdown files from the tab bar.
• ⌨️ Turn on Vim Mode (:w, :q, :wq), a cursor trail and scrolling past the last line. Indentation (spaces or tabs) is kept per file.
• 📝 Preview Markdown beside the editor as you type. Toggle the preview with Ctrl+Shift+V.
• 🧹 Format C and C++ with AStyle. Choose from 13 styles and optionally format on Ctrl+S.
• ✂️ Customize snippets and C or C++ templates, and hide or edit the built-in snippets. Import templates and snippets from files.
• 💾 Use auto-save, session restore and local history checkpoints to return to your work. Sameko also notices changes made outside the editor.
• 🎨 Choose from eleven built-in themes, including Catppuccin Mocha, Gruvbox Dark, the soft red-on-black Crimson and the space-themed Event Horizon, or create your own with the Theme Customizer. Add an image or video background and share your theme.
• 🔎 Search settings and shortcuts from the Settings dialog. Keybindings can be customized there too.

Explore the user guide for more features and instructions.

• Vietnamese and Chinese interface. Switch between English, Tiếng Việt and 简体中文 in Settings › Appearance.
• New themes. Event Horizon, Catppuccin Mocha, Gruvbox Dark and Crimson, plus new Kawaii Dark and Kawaii Light. The old Kawaii Dark is still there as Pixel Night.
• A clearer Theme Customizer. It now looks like Settings, and backgrounds can be up to 512 MB.
• Vim Mode, cursor trail and more editor options. Scroll beyond the last line, indentation per file, and built-in snippets you can hide or edit.
• Stderr in its own card. cerr output no longer mixes with Output, so AC/WA checks stdout only.
• Show Terminal on Run. Turn it off to keep your panels as they are when you build and run.
• Safer saving and security fixes. No half-written files after a crash, and themes can no longer reach network paths.

See CHANGELOG.md for the full list and the release notes for screenshots.

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!

🛡️ Windows SmartScreen may warn that the app is from an unknown publisher, because the builds are not code-signed yet. Click More info → Run anyway. You can check the 1.4.0 installer's VirusTotal scan (0/56).

The v1.4.0 release provides an AppImage for 64-bit Linux. Sameko uses the compiler and tools installed on your system.

Install g++ to compile programs and gdb to debug them. Install clangd for code suggestions and live diagnostics, and astyle for code formatting. Open a terminal and run the command for your distribution:

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

# Fedora / RHEL
sudo dnf install -y gcc-c++ gdb clang-tools-extra astyle

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

Download sameko-dev-cpp-1.4.0-linux-x86_64.AppImage from GitHub Releases or visit sameko.dev.

Open a terminal in the folder where you downloaded the file, then run:

chmod +x sameko-dev-cpp-1.4.0-linux-x86_64.AppImage
./sameko-dev-cpp-1.4.0-linux-x86_64.AppImage

You can keep the AppImage wherever you like and run it again from that folder. To build .deb or .tar.gz packages yourself, see Building.

• 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)
• aguajardoc (Added template and snippet imports and fixed the Linux dock icon)
• baodao211 (Contributed the cursor trail and Scroll Beyond Last Line)
• MerlyStella (Tested everything, twice. The app is better because of it :D)

📝 Want to contribute?

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

I like making my coding space feel like mine: themes, wallpapers, characters I like. Sameko Saba is one of them.

Classic Dev-C++ can barely be customized. VS Code can, but every time I changed computers (at school, for example) I had to set everything up again: the compiler, extensions, settings, theme. So I made my own IDE, one that comes with its compiler, works as soon as you open it, and lets me change every colour.

To be honest, most of this started because I just wanted to customize things my way. Saba is what kept me motivated while building it, so the app is named after her.

Not an official project. Sameko Dev C++ is a free, unofficial fan project. It is not affiliated with or endorsed by Sameko Saba or anyone who represents her. All rights to her name, likeness and artwork belong to their owners. The built-in themes don't use her artwork; I'd love to make a Saba theme one day, but only with permission.

Art credits. The Saba illustration on the website is by Nuu (@XD_zow). Saba's character design is by Shouu and her illustration by Tousaki Shiina. The logo was designed by Yunchan.

Saba, if you ever see this: hi! I wanted to ask your permission, but I couldn't find a way to message you. If you'd rather I change the name or anything else, please email me at [email protected] and I'll do it right away.

If you own any of the artwork above and want something changed or removed, email me or open an issue and I'll fix it quickly.

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