Setup

Due to the sheer number of various computer systems that TRSE now supports, a comprehensive list of recommended emulator / assembler configurations was compiled.

The TRSE application

Windows: TRSE and its libraries are in a self-contained ZIP file can can simply be extracted to any desired folder. The TRSE settings are stored in AppData/Roaming/TRSE/ on windows.

MacOS : Please follow these instructions to avoid TRSE being flagged as quarantined:

  • unpack the trse_osx.tar.gz
  • use finder to move the trse.app and OK64.app to /Applications
  • do not start any of the applications yet, or they will be quarantined!
  • open terminal:
  • sudo xattr -r -d com.apple.quarantine /Applications/trse.app
  • sudo xattr -r -d com.apple.quarantine /Applications/OK64.app

Commodore 64/128/PET/PLUS4/VIC-20

Assembler: TRSE contains a built-in assembler called OrgAsm, so no need for external downloads.

Emulator: We’d recommend using VICE : https://vice-emu.sourceforge.io/

Nintendo Entertainment System (NES)

Assembler: Use the built-in OrgAsm assembler

Emulator: Mednafen

Gameboy

Assembler: Download the RGBASM development kit and extract. Point the TRSE settings to the *directory* and not any individual .exe files.

Emulator: We recommend using Mednafen (pretty): https://mednafen.github.io/. However, if you plan to run on real hardware, a much more accurate emulator would be Gambatte

Amiga 500

Assembler: If you’re using windows, download the vasmm68k_mot assembler and point to the .exe from in the TRSE settings. Source/release for osx/linux can be found here.

Emulator:

  • Download and install FS-UAE. (apt-get on linux)
  • Download your favorite Kickstart ROMs, and set up a new computer in the emulator.
  • Add an emulated hard drive as a directory on your OS
  • Set the TRSE setting “Target executable deployment directory for the Amiga” to point to this directory.
  • TRSE will now automatically copy compiled files to this directory, and you’ll be able to start the program.
  • We’d recommend keeping several computer snapshots available for efficient development

Atari ST

Assembler: (Same as the Amiga) If you’re using windows, download the vasmm68k_mot assembler and point to the .exe from in the TRSE settings. Source/release for osx/linux can be found here.

Emulator:

  • Download and install Hatari (apt-get on linux)
  • Download your favorite TOS
  • Set up a new computer
  • Add an emulated hard drive as a directory on your local computer
  • Set the TRSE setting “Target executable deployment directory for the Atari ST” to point to this directory.
  • TRSE will now automatically copy compiled files to this directory, and you’ll be able to start the program from Hatari right after build.
  • We’d recommend keeping several computer snapshots available for efficient development

DOS

Assembler: Download NASM and point to the executable from the TRSE settings

Emulator: DOSBOX

OK64

Assembler: The OK64 uses the internal TRSE OrgAsm assembler

Emulator: Included with TRSE (on windows) as OK64.exe

Atari 2600

Assembler: Uses the internal OrgAsm assembler

Emulator: Download Stella (“apt-get install stella” on linux)

Amstrad CPC 464

Assembler: Internal OrgAsm Z80 assembler

Emulator: Download caprice from here! The only CPC emulator that supports injection, hence the only one that is supported in TRSE.

ZX Spectrum

Assembler: Internal OrgAsm Z80 assembler.

Emulator: Use Retro Virtual Machine 2 on win/macos/linux

Tiki 100

Assembler: Internal OrgAsm z80 assembler

Emulator: You don’t have much choice in this matter =) And, pages only in Norwegian. Ask me if anything is unclear…