Command line interface for CopyNES, a NES copier originally designed by Kevin Horton.
- clone the repository
- place your plugins in the "plugin" directory. The plugin filenames are assumed to use only upper case characters, e.g.
NROM.BIN.
- install FTDI virtual COM port drivers
- install Python 3 and pyserial
- install FTDI virtual COM port drivers
- install Python 3 and
pyserial
e.g. using MacPorts:
sudo port install python32 py32-serial
- install Python 3 and
pyserial
e.g. using apt-get:
sudo apt-get install python3 python3-serial
Pass the --help parameter to get brief usage instructions:
copynes.py --help
First, make sure to place the appropriate plugin in the plugins directory, e.g. plugins/NROM.BIN.
CopyNES plugins don't communicate which iNES mapper they are dumping so you will need to explicitly declare a mapper number for the dump.
copynes.py download NROM > smb.nes
copynes.py download --mapper 3 CNROM > adventure-island.nes
First, make sure to place the appropriate plugin in the plugins directory, e.g. plugins/PPLITE.BIN.
copynes.py upload --plugin pplite < smb.nes
Get a binary dump of CPU memory space.
copynes.py readcpu 0x0000 0x07ff > ram-dump.bin
Write data to CPU memory space.
copynes.py writecpu 0x0000 < ram-dump.bin
Run a custom CopyNES plugin. Data sent from the plugin is not handled in any way, the plugin is just started and then ignored.
copynes.py run < my-custom-plugin.bin
copynes.py version
If the USB cable is connected, CopyNES starts in "copy" mode, i.e. it does nothing and only only waits for a command. To start playing a cartridge, use the "play" command.
copynes.py play
CopyNES uses two serial ports for communication. The program will try to guess the names of these ports, but may get confused if there are other FTDI devices connected (e.g. Arduino). If you're having problems connecting to the CopyNES you may have to explicitly declare which ports to use:
copynes.py --data COM4 --control COM5 ...