cbmshell

A Python application to manipulate the contents of disk and tape images used by emulators of Commodore 8-bit microcomputers.

Files can be copied between an image and the local filesystem as well as converted to and from PETSCII.

cbmshell has many of the properties of a UNIX shell, giving both an interactive environment and the ability to run predefined scripts.

Getting Started

Install the Python cbmshell package from pypi using:

$ pip install cbmshell

Start an interactive session by running:

$ cbm-shell
(cbm)

Commands entered following the (cbm) prompt will be immediately executed. To see a list of supported commands use help:

(cbm) help

Documented commands (use 'help -v' for verbose/'help <topic>' for details):
===========================================================================
alias   detach     from_petscii  lock   rename        shell       unlist
attach  directory  help          macro  renumber      shortcuts   unlock
cat     edit       history       merge  run_pyscript  text        untext
copy    file       images        mkdir  run_script    to_petscii
delete  format     list          quit   set           token_set

Disk images are made available by attaching them to a drive number:

(cbm) attach mydisk.d64
Attached mydisk.d64 to 0

Many commands can work with either a file on the local filesystem:

(cbm) list test.prg

or a file inside an image:

(cbm) list 0:PRINT

or a combination of both:

(cbm) copy 0:TEST test.prg

Topics

Examples