luizperes / snes-image

Docker image and files for SNES tutorial on WikiBooks

SNES Image

This repository has a docker image of the WLA-65816 Macro Assembler with its binaries for linux.

This image supports Assembly programming language for Super Nintendo.

Getting Started

• Make sure you have already installed snes-image
• cd /path/to/snes-image
• bash compile_rom.sh /path/to/snes-image/rom
• Execute cd rom and see that you have a file named Greenspace.smc. This is your first compiled ROM! You can test it in pretty much any SNES emulators such as bsnes, Zsnes, Snes 9x for Windows and others.
• Next step: How to program for SNES
• Have fun!

How to install

• Download and install Docker. You can do it by following it here.
• After installing Docker, execute: docker pull luizperes/snes:v1. It may take one or two minutes.

How to execute

• To execute your docker image, you can run the commands:
  • cd <path/to/snes-image>
  • bash compile_rom.sh <path/to/snes/assembly/files/directory>
• Obs.: To run your script file, please do not include . as in "current directory", e.g. ./rom once docker will fail. The right form is /home/user/rom or ~/rom

How to program for SNES

You can visit Super NES Programming and SNES Programming to get started with programming for this amazing console!

Help

Feel free to send your pull requests. :)

LICENSE

This project extends GNU GPL v. 3, so be aware of that, regarding copying, modifying and (re)destributing.