This environment provides out-of-the-box support for Linux x64 and Windows (x86/x64), featuring pre-configured VS Code settings for a seamless workflow.
🛠️ Quick Installation
Choose your weapon (Operating System) and run the corresponding command to configure your environment immediately:
🐧 Linux (One-Line Installer)
Supports Arch, Debian/Ubuntu, Fedora, Alpine, openSUSE, Solus, Gentoo, Puppy Linux, and Void.
bash <(curl -sSL https://raw.githubusercontent.com/ahmed-x86/asm/refs/heads/main/install-linux.sh)🪟 Windows 10 / 11 (PowerShell Installer)
Optimized for modern Windows environments.
irm https://raw.githubusercontent.com/ahmed-x86/asm/refs/heads/main/install-windows.ps1 | iex🏛️ Windows 7 (Legacy Support)
Dedicated script for Windows 7 compatibility.
irm https://raw.githubusercontent.com/ahmed-x86/asm/refs/heads/main/install-windows7.ps1 | iex✨ Key Features
- Dual-Platform Support: Native installers for both Windows and Linux, ensuring your dev environment is consistent everywhere.
- VS Code Integration: Pre-configured
tasks.jsonandlaunch.jsonallow you to build and debug your code with a single shortcut (Ctrl+Shift+B). - Global CLI Tool: Installs the custom
asm-runcommand globally, allowing you to compile and test.asmfiles directly from any terminal without opening an editor. - Smart Dependency Management: Automatically detects your package manager on Linux and skips unnecessary downloads, while natively setting up NASM on Windows.
- Legacy Support: Special installer for Windows 7 to ensure assembly development isn't limited by OS version.
- Cross-Compilation: Ready-to-use toolchains to compile and test Windows binaries directly from Linux using Wine and MinGW.
🧠 Smart Engine Features
- Bulletproof Execution: Features built-in network stability checks, strict input validation loops, and a
Ctrl+Ctrap that automatically cleans up partial downloads. - Security First: Implements rigorous SHA256 Integrity Checks for external binaries to guarantee file authenticity.
- Editor Agnostic: Automatically scans and detects your installed IDE (VS Code, VSCodium, Cursor) and sets up Assembly extensions.
- Universal Package Tracking: Detects if your editor is installed via Native Package Manager, Snap, or Flatpak and configures extensions isolatedly.
- Auto-Path Patching: Dynamically updates
launch.jsonandtasks.jsonbased on your current OS username and directory path.
🎭 Final Note
[!IMPORTANT]
This project was built to prove that "Understanding Linux" isn't about talking, it's about building solutions that work on 9+ distributions with a single click.
This project was built to prove that "Understanding Linux" isn't about talking, it's about building solutions that work on 9+ distributions with a single click.
echo -e "\033[1;35m فيه حمار قال اني مابفهمش لينكس.. عايز اقولك شوف السكربت ده يا حمار بشري\033[0m"Stay Hard, Keep Coding. 🚀
Note for Arch Users: Because "I use Arch btw" shouldn't mean spending three hours on config. We've got you covered. 😎
# i use arch btw