VICE Manual - 14 cartconv

Go to the first, previous, next, last section, table of contents.

# 14 cartconv

The cartconv program is a cartridge conversion utility, it can convert between binary and .crt images and it can 'insert' binary and/or .crt images into the EPROM type of cartridges.

## 14.1 cartconv command line options

The cartconv program has the following parameters:

`-i "input name"`
  This parameter is mandatory, it should contain the name of the binary/.crt file you want to convert. For the EPROM type of cartridges this parameter can be used multiple times to insert images into the resulting file.
`-o "output name"`
  This parameter is mandatory, it should contain the name of the binary/.crt file you want to convert the input file to.
`-t carttype`
  This parameter is optional. It is only needed when converting to a .crt file. See below for the supported cartridge types.
`-s revision`
  This parameter is optional. It is only needed when converting to a .crt file. See the detailed description of the .crt format for which types support subtypes/revisions.
`-n "cart name"`
  This parameter is optional and is used as the cartridge name when creating a .crt file.
`-l loadaddress`
  This parameter is optional and is used as the load-address when converting a .crt file to a .prg file, or when converting to a generic type .crt file.
`-f "input name"`
  This parameter is optional, and is meant to output information about the named file. It can't be used in conjuction with any of the other parameters.
`-r`
  This parameter is optional, it enables repair mode (accept broken input files)
`-p`
  This parameter is optional, when it is given cartconv will accept input files that do not match the cartridge sizes (useful for development).
`-b`
  This parameter is optional, when it is given cartconv will not omit banks that are empty (filled with $ff).
`-q`
  This parameter is optional, it disables all non-error messages
`--types`
  This parameter is optional. It shows all supported cartridge types (see below).
`--version`
  Show cartconv version string and exit

The following cartridge types are supported:

`bin`
  Binary .bin file (Default crt->bin)
`normal`
  Generic 8kB/12kB/16kB .crt file (Default bin->crt)
`prg`
  Binary C64 .prg file with load-address
`ulti`
  Ultimax mode 4kB/8kB/16kB .crt file
`ap`
  Atomic Power .crt file
`ar2`
  Action Replay MK2 .crt file
`ar3`
  Action Replay MK3 .crt file
`ar4`
  Action Replay MK4 .crt file
`ar5`
  Action Replay V5 .crt file
`cap`
  Capture .crt file
`comal`
  Comal 80 .crt file
`dep256`
  Dela EP256 .crt file, extra files can be inserted (1)(2)
`dep64`
  Dela EP64 .crt file, extra files can be inserted (1)
`dep7x8`
  Dela EP7x8 .crt file, extra files can be inserted (1)(2)(3)
`din`
  Dinamic .crt file
`dsm`
  Diashow-Maker .crt file
`easy`
  EasyFlash .crt file
`ecr`
  Easy Calc Result .crt file
`epyx`
  Epyx FastLoad .crt file
`exos`
  EXOS .crt file
`expert`
  Expert Cartridge .crt file
`f64`
  Formel 64 .crt file
`fc1`
  The Final Cartridge .crt file
`fc3`
  The Final Cartridge III .crt file
`fcp`
  Final Cartridge Plus .crt file
`ff`
  Freeze Frame .crt file
`fm`
  Freeze Machine .crt file
`fp`
  Fun Play .crt file
`gk`
  Game Killer .crt file
`gmod2`
  GMod2 .crt file
`gs`
  C64 Games System .crt file
`ide64`
  IDE64 .crt file
`ieee`
  IEEE-488 Interface .crt file
`kcs`
  KCS Power Cartridge .crt file
`ks`
  Kingsoft .crt file
`mach5`
  MACH 5 .crt file
`md`
  Magic Desk .crt file
`mf`
  Magic Formel .crt file
`max`
  MAX Basic .crt file
`mikro`
  Mikro Assembler .crt file
`mmc64`
  MMC64 .crt file
`mmcr`
  MMC Replay .crt file
`mv`
  Magic Voice .crt file
`ocean`
  Ocean .crt file
`p64`
  Prophet64 .crt file
`pf`
  Pagefox .crt file
`rep256`
  REX 256k EPROM Cart .crt file, extra files can be inserted (1)(2)(3)
`rgcd`
  RGCD .crt file
`ross`
  ROSS .crt file
`rr`
  Retro Replay .crt file
`rrnet`
  RR-Net MK3 .crt file
`ru`
  REX Utility .crt file
`s64`
  Snapshot 64 .crt file
`sb`
  Structured BASIC .crt file
`se5`
  Super Explode V5.0 .crt file
`sg`
  Super Games .crt file
`silver`
  Silverrock 128K Cartridge .crt file
`simon`
  Simons' BASIC .crt file
`ss4`
  Super Snapshot V4 .crt file
`ss5`
  Super Snapshot V5 .crt file
`star`
  Stardos .crt file
`wl`
  Westermann Learning .crt file
`ws`
  Warp Speed .crt file
`zaxxon`
  Zaxxon .crt file

- (1) insertion of 32kB EPROM files supported.
- (2) insertion of 8kB .crt/binary files supported.
- (3) insertion of 16kB .crt/binary files supported.

## 14.2 cartconv examples

`cartconv -i foo.crt -o foo.bin`
  Convert a .crt file to a binary file with no load-address.
`cartconv -t prg -i foo.crt -o foo.prg`
  Convert a .crt file to a .prg file with default load-address.
`cartconv -t prg -l 49152 -i foo.crt -o foo.prg`
  Convert a .crt file to a .prg file with 49152 as the load-address.
`cartconv -t ocean -i foo.bin -o foo.crt`
  Convert a binary file to an ocean type cartridge.
`cartconv -t dep64 -i dep64.bin -i eprom.prg -o foo.crt`
  Inserting a 32kB EPROM file into an dep64 type cartridge.
  - step 1 : use the dep64 binary file in VICE as a generic 8kB cartridge.
  - step 2 : generate an EPROM file.
  - step 3 : get the EPROM file to the host computer.
  - step 4 : insert the EPROM file into the final dep64 .crt file:
`cartconv -t dep256 -i dep256.bin -i somegame.crt -o foo.crt`
  Insert an 8kB .crt file into a dep256 type cartridge.
`cartconv -t rep256 -i rep256.bin -i foo1.crt -i foo2.crt -i foo3.crt -o foo.crt`
  Insert multiple 8kB .crt files into a rep256 type cartridge.
`cartconv -f foo.crt`
  Get information about a .crt file.

Go to the first, previous, next, last section, table of contents.