Install Instructions

Windows

• download tui-windows.exe
• TODO: eventually just, double click to open
• open up a terminal
  • cmd works best on Windows at the moment
  • PoweShell works too but our default colour scheme doesn't play well with PowerShell's default blue background
  • alacritty is a good alternative too)
    • emoji are blocked on this though
  • the new windows terminal may work too
    • (was blocked on this)
    • mouse events still don't seem to work, unfortunately
    • available here
• navigate to the folder containing tui-windows.exe
  • either launch your terminal (using the start menu) and use cd to get there (i.e. cd C:\Users\Foo\Downloads\)
  • or open the containing folder in File Explorer and press shift + right click somewhere in the folder and then click "Open PowerShell Window Here"
• run like this: tui-windows.exe <path\to\program>

• where <path\to\program> is the file path to your assembly program (must end in .asm) or a memory dump (ends with .mem)

macOS

• download tui-macos
• TODO: eventually just, double click to open
• open up a terminal
  • the default Terminal.app works well
  • iTerm2 works well too
• navigate to the folder containing tui-macos
  • (i.e. cd ~/Downloads)
• set the permissions:
  • chmod +x tui-macos
  • xattr -dr com.apple.quarantine tui-macos
• run like this: ./tui-macos <path/to/program>
  • where <path/to/program> if the file path to your assembly program (must end in .asm) or a memory dump (ends with .mem)

Linux (or WSL on Windows)

• download tui-linux
• open a terminal
• navigate to the folder where tui-linux was downloaded
• set the permissions:
  • chmod +x tui-linux
• run like this ./tui-linux <path/to/program>
  • where <path/to/program> if the file path to your assembly program (must end in .asm) or a memory dump (ends with .mem)`