Skip to content

jocelchristian/sim-os

Repository files navigation

Sim-OS: Operating System GUI Simulator 🎮

GitHub Repo stars MIT License C++ Version

Welcome to Sim-OS, an innovative Operating System GUI Simulator designed to bring your custom simulation ideas to life. This repository serves as a platform for creating and testing GUI-based simulations using a unique simulation description language. Dive into the world of operating systems with us!

Table of Contents

  1. Features
  2. Getting Started
  3. Usage
  4. Installation
  5. Contributing
  6. License
  7. Contact
  8. Releases

Features

  • Custom Simulation Language: Define your simulations easily with our tailored language.
  • User-Friendly GUI: Intuitive interface to visualize and interact with your simulations.
  • Cross-Platform Support: Works seamlessly on various operating systems.
  • Real-Time Interaction: Engage with simulations in real-time for better understanding.
  • Extensive Libraries: Utilizes libraries like ImGui, GLFW, and Implot for rich graphics and functionality.

Getting Started

To get started with Sim-OS, you can download the latest release from our Releases section. This will provide you with the necessary files to execute the simulator on your machine.

Prerequisites

  • CMake: Make sure you have CMake installed on your system.
  • C++ Compiler: A compiler that supports C++23, such as Clang or GCC.
  • Libraries: Ensure you have the following libraries:
    • ImGui
    • GLFW
    • Implot
    • stb_image

Usage

Once you have installed the simulator, you can start creating your simulations. Here’s a simple guide to get you going:

  1. Define Your Simulation: Use the custom simulation description language to outline your simulation parameters.
  2. Load the Simulation: Open the simulator and load your simulation file.
  3. Run the Simulation: Click on the "Run" button to see your simulation in action.
  4. Interact: Use the GUI to interact with your simulation, making adjustments as needed.

Installation

Follow these steps to install Sim-OS on your local machine:

  1. Clone the Repository:

    git clone https://github.com/jocelchristian/sim-os.git
    cd sim-os
  2. Build the Project:

    mkdir build
    cd build
    cmake ..
    make
  3. Run the Simulator: After building, execute the simulator:

    ./sim-os

Contributing

We welcome contributions to enhance Sim-OS. To contribute:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and commit them.
  4. Push your branch and submit a pull request.

License

Sim-OS is licensed under the MIT License. See the LICENSE file for more details.

Contact

For questions or feedback, please reach out to the project maintainer:

Releases

To download the latest version of Sim-OS, visit our Releases section. Download the required files and execute them to start using the simulator.

Sim-OS Screenshot

Conclusion

Sim-OS aims to provide a simple yet powerful platform for simulating operating systems. Whether you're a student, educator, or developer, you can benefit from using this tool to explore and understand operating system concepts. We hope you find it useful and look forward to your contributions!

Happy simulating! 🚀

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •