clangd now drives live diagnostics (about 100–130 ms); g++ -fsyntax-only is the fallback.
What’s new in Sameko
Faster, calmer, more helpful.
A native launcher measures real wall time and peak memory.
Run All Tests uses up to four workers; tests near the limit rerun alone.
File input, Output / Expected cards, interface scale and a lighter startup.
Flag-aware PCH for debug builds, batched variables, C++26 in the selector.
xterm.js 6 and a deferred Monaco load, so the editor appears sooner.
Windows bundles GCC 16.1.0; Linux uses the compiler tools installed on your system.
Sameko Dev C++ Wiki
Documentation from basics to advanced features.
Sameko Dev C++ is a C++ IDE designed for competitive programming and education. It comes with a pre-configured GCC 16.1.0 compiler on Windows, allowing you to start coding immediately without installing additional compilers or MinGW.
Who is Sameko for?
- Beginners who need a simple environment without the complexity of Visual Studio
- Competitive Programmers who need fast compilation and test case integration
- Students who need a portable IDE to use on school computers via USB
Installing Sameko IDE
Sameko provides 2 download options:
- Installer (.exe) - Automatic setup with Start Menu shortcuts, right-click integration, auto-updates, and a clean uninstaller. Recommended for most users.
- Portable (.zip) - Extract and run anywhere. No admin rights needed. Great for USB drives or school computers. Note: auto-updates are not available in portable mode.
Download Sameko
Go to the homepage and click the Download button to choose Installer or Portable version.
Install or Extract
If Installer: Run the .exe and follow instructions.
If Portable: Extract to a folder like D:\Sameko-IDE\.
Run Sameko Dev C++.exe
Double-click Sameko Dev C++.exe to launch the IDE.
Windows Defender may warn "not commonly downloaded". This is normal, click "Keep" to continue.
Linux releases are available as AppImage, .deb and .tar.gz. They do not bundle a compiler; install g++, gdb, clangd and astyle from your distribution so Sameko can detect them.
Creating your first project
After opening the IDE, try writing and running a Hello World program to verify installation.
#include <bits/stdc++.h>
using namespace std;
int main() {
cout << "Hello, Sameko!" << '\n';
return 0;
}
Steps:
- Paste the code above into the editor
- Press Ctrl + S to save as
hello.cpp - Press F11 to compile and run
- The output will appear in the terminal below
Use F9 to compile only, F10 to run only, F11 for both.
System Requirements
| Component | Minimum | Recommended |
|---|---|---|
| OS | Windows 10 64-bit | Windows 11 |
| CPU | Intel Core i3 / AMD Ryzen 3 | Intel Core i5 / AMD Ryzen 5 or better |
| RAM | 4GB | 8GB+ |
| Disk Space | 1.5GB (free space) | 2GB+ |
Compiler Settings
Sameko uses GCC 16 with pre-configured compile options.
C++ Standard
Sameko fully supports C++ standards from legacy to modern.
| Standard | Description |
|---|---|
| C++98 | Legacy, rarely used today |
| C++11 / C++14 | Stable, widely used, supports auto, lambdas |
| C++17 | (Default) Gold standard for Competitive Programming |
| C++20 | Adds Ranges, Concepts, Modules |
| C++23 | Adds std::print, std::expected |
| C++26 | Available with GCC 16.1.0; use when your target compiler supports the feature |
Common Compiler Flags
-O2- Optimize for speed, use when submitting to Codeforces-Wall- Show warnings, helps find bugs-g- Add debug information
Don't use -O2 when debugging as optimized code is harder to trace.
Keyboard Shortcuts
Shortcuts help you code faster.
| Shortcut | Action |
|---|---|
| F5 | Start or continue debugging |
| F9 | Compile only |
| F10 | Run, or Step Over while debugging |
| F11 | Build & Run, or Step Into while debugging |
| Shift + F5 | Stop the current run or debug session |
| Shift + F11 | Step Out while debugging |
| Ctrl + N | New file |
| Ctrl + O | Open file |
| Ctrl + S | Save file |
| Ctrl + Shift + A | Format code (AStyle) |
| Ctrl + J | Toggle terminal |
| Ctrl + T | New tab |
| Ctrl + Tab | Next tab |
| Ctrl + Shift + Tab | Previous tab |
| Ctrl + \ | Split editor |
Themes & Customization
Sameko includes 6 built-in themes. Change themes in Settings or click the palette icon.
| Theme | Style |
|---|---|
| Kawaii Light | Default light theme with soft blue tones |
| Kawaii Dark | Dark theme with blue accents |
| Sakura Pink | Light pink anime-style theme |
| Dracula | Popular purple-toned dark theme |
| Monokai | Classic warm dark theme |
| Nord | Arctic blue dark theme |
Theme Customizer
Open the Theme Customizer to click on any UI element and change its color. You can also set custom background images or videos with opacity control, and import/export your custom themes.
Editor
Sameko uses the Monaco Editor - the same engine that powers VS Code. This gives you a professional editing experience out of the box.
Key Editor Features
- IntelliSense - clangd-backed completion, hover and signature help for STL methods, functions, and your own code
- Bracket Colorization - matching brackets are colored for readability
- Minimap - a bird's-eye view of your code on the right side
- Multi-cursor - hold Alt and click to place multiple cursors
- Find & Replace - Ctrl + H with regex support
- Code Folding - collapse functions and blocks to focus on what matters
- Split Editor - press Ctrl + \ to work on two files side by side
Tabs
Open multiple files in tabs. Drag to reorder, middle-click to close, or right-click for options like "Close Others" and "Pin Tab". Your open tabs are restored when you reopen the IDE.
Integrated GDB debugger
Build with debug information, set a breakpoint in the gutter, then use the Debug panel without leaving the editor. Sameko drives the bundled MinGW GDB on Windows; Linux uses the system gdb.
Continue, Pause, Step Over / Into / Out, Run to Cursor, Restart and Stop in one row.
Locals, watches, STL values, the call stack and hover-to-evaluate.
Walks from main() with a speed slider. Esc stops it.
Back replays recorded pauses read-only; Back to live continues.
F5 starts or continues debugging, F10 steps over, F11 steps into, Shift + F11 steps out and Shift + F5 stops. When you are not debugging, F10 runs and F11 builds and runs.
File Explorer
The sidebar file explorer lets you browse and manage files without leaving the IDE.
- Click any
.cpp,.c, or.hfile to open it in a tab - Right-click for rename, delete, and other file operations
- Drag and drop files into the IDE to open them
- Recent files are tracked and accessible from the menu
Checkpoints (Local History)
Sameko automatically saves a checkpoint every time you save a file. This means you can always go back to a previous version - even if you forgot to undo.
How It Works
- Every Ctrl + S creates a timestamped backup
- Open the Checkpoints panel to see all saved versions
- Click any checkpoint to preview it
- Restore a checkpoint to revert your file
Checkpoints are stored locally and persist across IDE restarts. Great for experimenting with different solutions during a contest.
Competitive Companion
Competitive Companion is a browser extension that automatically fetches test cases from online judges like Codeforces, AtCoder, and LeetCode.
Setup
- Install Competitive Companion on Chrome or Firefox
- Open Sameko IDE
- Navigate to a problem page and click the extension icon
- Test cases are loaded into the IDE automatically
Verdicts
After running tests, each case shows a verdict:
- AC - Accepted, output matches expected
- WA - Wrong Answer, output differs
- TLE - Time Limit Exceeded
- RE - Runtime Error
- MLE - Memory Limit Exceeded
Snippets
Snippets let you insert code templates by typing a short prefix and pressing Tab or Enter.
Built-in Snippets
| Prefix | Template |
|---|---|
cp |
Competitive programming template with bits/stdc++.h and fast I/O |
for |
For loop (0 → n-1) |
for1 |
For loop (1 → n) |
ford |
Reverse for loop (n-1 → 0) |
fore |
Range-based for loop |
vec |
Declare a vector |
vecn |
Vector with size n |
vv |
2D vector |
all |
v.begin(), v.end() |
pq |
Priority queue |
STL IntelliSense
Clangd provides context-aware completion, documentation hover and signature help for STL members such as push_back, sort, lower_bound and substr. Built-in snippets and language keywords remain available while clangd warms up or when a file is unsaved.
Custom Snippets
Go to Settings → Snippets to create your own. Each snippet has a prefix (trigger word) and a body (the code that gets inserted). Use this to add your own algorithm templates like BFS, DFS, Segment Tree, or DSU.
Auto-Update
The Installer version of Sameko checks for updates automatically in the background.
How It Works
- On startup, the IDE checks GitHub Releases for a newer version
- If an update is found, it downloads in the background
- A notification appears when the download is complete
- Click "Restart" to apply the update - your open files are restored
Auto-update is only available in the Installer version. Portable users need to download new versions manually from the website.
How Sameko stacks up
Default setups only; extensions and local toolchains change the picture.
GCC 16.1.0, clangd, GDB, Competitive Companion and checkpoints in one package.
Flexible editor; you add the C++ extension, compiler and debugger.
Classic IDE with completion and GDB; the compiler depends on the package.
Full IDE for larger CMake projects with a configured toolchain.
Troubleshooting
IDE won't open
Right-click Sameko Dev C++.exe, select Properties, check "Unblock" at the bottom, then Apply.
"Missing DLL" error
Install Visual C++ Redistributable from this link.
Compile doesn't work
Check the following:
- Path doesn't contain special characters or spaces
- Antivirus isn't blocking gcc.exe
- File is saved with .cpp extension
Terminal not showing output
Press Ctrl + J to toggle terminal panel. If still not visible, try restarting the IDE.
Create an issue on GitHub with a detailed description of your problem.