Sasm-docker

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
  • Install VcXsrv Windows X Server
  • Or install through Chocolatey choco install vcxsrv
• On Linux you are probaply ready to go :)

Install docker

• On MacOS follow these steps
• On Windows follow these steps
• On Linux follow these steps

Install the launcher

• Download the binary for your OS over here: https://github.com/keinenclue/sasm-docker/releases/latest
• On MacOS open the dmg and drag the application to you applications folder

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