MSX Compiler v2026

Works on Windows and Linux. Write your code in BASIC (very similar to the Basic MSX but with some differences) and the compiler will create an assembly file that will go directly on .ROM or .DSK, to try on the emulator or real MSX. First select the emulator path.

On Mac OS it is necessary to set an additional path because the executable file is located inside the emulator's app folder. Then open a project "*.msxproj" or create one yourself. When you are ready, press "F5" to compile and RUN! In the same folder you will find the ".DSK" or ".ROM" file, and ".ASM" source file if you have selected the option in the settings!

Be careful when you activate the "Save .ASM File When Run" option because it saves the project in assembly files that can overwrite the existing ones.

How It's Work

The compiler read BASIC code and translate it in ASSEMBLER, then translate it in BINARY code You can save and see ASM file if you want, select relative option in Settings window If the binary code resulting from the compilation is greater than 16kb, then you will have to divide your project into more than one file, each with a maximum of 16kb of binary code, up to a maximum of 16 files. It is possible to make calls between files with the instructions CALLPAGE (as gosub) and JUMPPAGE (as goto)

example: CALLPAGE 1,100 --> make a calling to page 1 at line 100

Look at example folders to see how it's work

You can select TARGET of your compilation (CARTRIDGE or DISK)

Depending on the TARGET (cartridge or disk), a .ROM file of a maximum of 512kb or a .DSK file containing up to a maximum of 32 binary files of 16kb each will be created!

• Memory containing the binary code (4000h-7fffh) with memory mapper to change page
• Memory containing the variables (8000h-bfffh)
• Reserved memory (c000h-d16fh)
• Additional memory available from d170h onwards. (Note that the stack pointer is initialized to DB00h)
• Stack (DB00h) but you can change it in Settings window