Downloads

Get guideXOS and everything you need

💿
guideXOS
The complete operating system ISO image
Version 0.1
Download ISO

File size: 12.1MB | Format: ISO Image

Development Tools

Create your own applications for guideXOS

🖥️

GXM Packager GUI

Graphical tool for creating GXM executables. Features drag-and-drop interface, script validation, and live preview. Perfect for beginners.

  • ✎️ Visual script editor
  • 🎯 Entry point configuration
  • 🖼️ GUI script support
  • 📦 Binary packaging
Download GUI (Windows)

Requires .NET 9.0 | ~2MB

⚙️

GXM Packager CLI

Command-line tool for automated builds and CI/CD pipelines. Scriptable and perfect for batch operations.

  • 🔧 Automation-friendly
  • 📂 Batch processing
  • 🌐 Cross-platform
  • 🔄 CI/CD integration
Download CLI

Requires .NET 9.0 | ~1.5MB

CLI Quick Start

# Package a GUI script GXMPackager.exe myscript.txt myapp.gxm --gui # Package a native binary GXMPackager.exe myapp.exe myapp.gxm --entry 0x1000 # Get help GXMPackager.exe --help

GXM Modules & Applications

Extend guideXOS with additional software

📚

Sample Applications

Example GXM applications to learn from and modify.

  • Hello World
  • Calculator UI
  • App Launcher
  • Settings Panel
👥

Community Modules

Applications created by the guideXOS community.

Coming soon! Share your creations with the community.

🔧

Utility Tools

System utilities and helper applications.

  • Disk Manager
  • Process Monitor
  • Network Tools
  • Log Viewer
Coming Soon

Customization Resources

Personalize your guideXOS experience

🔤

System Fonts

Additional bitmap fonts for the GUI system.

  • Multiple sizes (12-32px)
  • Monospace variants
  • Custom character sets
🖼️

Wallpapers

Desktop backgrounds and wallpaper packs.

  • HD backgrounds
  • Abstract patterns
  • Solid colors
🎨

Icons & Themes

Custom icon packs and UI themes.

Theme system in development. Create your own visual style!

Coming Soon

🔧 Create Your Own Fonts

Use the included Python font generator to create custom bitmap fonts from TrueType fonts. Supports multiple sizes and custom character sets.

📖 Learn How →

System Requirements

Minimum specifications to run guideXOS

Virtual Machine (Recommended)

  • Software: QEMU, VMware, VirtualBox
  • RAM: 2GB recommended
  • Storage: 100MB recommended
  • Network: NAT or Bridged adapter (optional)
  • Graphics: VESA-compatible

Physical Hardware

  • CPU: x86-64 compatible processor
  • RAM: 512MB minimum, 1GB+ recommended
  • Storage: 100MB minimum
  • Network: Intel 825xx or RTL8111
  • Input: PS/2 or USB keyboard/mouse

Quick Start Guide

Get up and running in minutes

Step 1: Download the ISO

Download the guideXOS ISO image from the top of this page. Save it to a location you can easily access.

Step 2: Create Virtual Machine

Open your virtualization software and create a new virtual machine:

VMware Settings: - Guest OS: Other / Other (64-bit) - Memory: 2048 MB (2 GB) - Hard Disk: 100 MB (or larger) - Network Adapter: NAT or Bridged VirtualBox Settings: - Type: Other - Version: Other/Unknown (64-bit) - Memory: 2048 MB - Network: NAT or Bridged Adapter QEMU Command: qemu-system-x86_64 -m 2048 -cdrom guideXOS.iso -netdev user,id=net0 -device rtl8139,netdev=net0

Step 3: Mount the ISO

Configure the virtual machine to boot from the guideXOS ISO image. This is usually done in the CD/DVD settings of your VM.

Step 4: Boot and Enjoy!

Start the virtual machine. guideXOS will boot up and automatically start the GUI desktop environment. Explore the built-in applications, try the network features, and have fun!

Build from Source

For developers who want to compile guideXOS themselves

Requirements

  • .NET 9.0 SDK
  • Visual Studio 2022 or later (or VS Code)
  • NASM (for bootloader assembly)
  • Git
# Clone the repository git clone https://gitlab.com/guidex/guideXOS cd guideXOS # Build the kernel dotnet publish -c Release # Build complete ISO (Windows) .\build.ps1 # The ISO will be in ISO\guideXOS.iso

Need Help?

Check out our comprehensive documentation for detailed guides, tutorials, and troubleshooting tips.

📚 Browse Wiki ❓ FAQ 🐛 Report Issue