Skip to content

A docker image and a launcher to run SASM on Linux, Windows and MacOS

License

Notifications You must be signed in to change notification settings

keinenclue/sasm-docker

Repository files navigation


Sasm-docker

GitHub release Badge tests Go report

Sasm-docker simplifies the setup and use of SASM by running it inside a docker container and using x11 (X Window System) in order to display the SASM GUI.

Features

  • Easy setup: Just install docker and xserver, download the launcher, and you're ready to go
  • Easy updating: The launcher checks for and downloads updates on every start

Run

Install X server

These are just examples, you don't have to use these installation methods.
You just need to have X server on your system in the end.

  • On MacOS
    1. Install XQuartz:
      • With the dmg from the official website
      • Or with the MacPorts instructions down below on the website
      • Or use Homebrew brew install --cask xquartz
    2. Launch XQuartz. Under the XQuartz menu, select Preferences
    3. Go to the security tab and ensure "Allow connections from network clients" is checked.
    4. Restart XQuartz.
  • On Windows
  • On Linux you are probaply ready to go :)

Install docker

Install the launcher

Known issues

  • If you get the warning warning: creating DT_TEXTREL in a PIE add the flag -fPIC to Linking options
  • Debugging of a project which uses multiple files will not work (this is a bug in sasm)
  • Debugging will not work if you have a function which is not delcared as global
  • If the debugging doesn't work, clear your Data path(it's best that you completly delete the folder and then recreate it and put your files back in)
  • Assembling, running and debugging does not work on Apple M1 based systems. See this issue for more details

Screenshots

Screenshot launch Screenshot pulling
Screenshot logs Screenshot settings