bsnes-purify(6) 						   Games Manual 						   bsnes-purify(6)

NAME
bsnes-purify - Tool for preparing ROMs for usage with bsnes SYNOPSIS
bsnes-purify scan source-dir output-file bsnes-purify output source-dir target-dir DESCRIPTION
bsnes can not open all ROMs. For example SNES ROMs have to be without copier headers and with the filename extension .sfc. Recent versions of bsnes support games to be arranged in cartridge folders (see below). bsnes 0.089 and later will only support cartridge folders. bsnes-purify searches a directory for ROMs and performs an action on them. It also finds ROMs contained in .zip files. bsnes-purify scan writes a list of the found ROMs together with their SHA256 checksums and sizes to a file. bsnes-purify output creates for each found ROM a cartridge folder with the files program.rom and and manifest.xml in the target directory. If the original ROM was a headered SNES ROM, program.rom will be the same, but without the header. CARDRIDGE FOLDERS
Cartridge folders are intendended to contain all data belonging to a game. The name of a cartridge folder has to end with one of the file- name extensions sfc, fc, gb, gbb, gbc or gba, depending on the system the game is for. The user has to make sure that the following files exist program.rom the game ROM manifest.xml Additional data about the cartridge, generated by bsnes-purify. Sometimes bsnes-purify can't guess all the information for this file and it has to be edited manually. dsp1.rom, dsp1b.rom, dsp2.rom, dsp3.rom, dsp4.rom, st010.rom, st011.rom, st018.rom or cx4.rom Some SNES games have pre-programmed coprocessors (DSPs) built into their cartridges. For these games, the required DSP programs also need to be in the cartridge folders. bsnes itself also writes files to cartridge folders, for example the data that would be saved to RAM in real cartridges to save progress, or bsnes specific save states. For further details, please ask at http://board.byuu.org/. SEE ALSO
bsnes(6) MAN PAGE AUTHOR
Tobias Hansen May 11, 2012 bsnes-purify(6)