Skip to main content

This Python module provides an interactive shell to read and write files to disk image files (.d64, .d71, .d80, .d81, .d82) and tape image files (.t64, .tap) used by various Commodore microcomputer emulators and tools.

It permits moving files between images and the local file system as well as other actions such as directory listing and file deletion.

It provides many common benefits of a traditional UNIX shell including filename completion, command history and output redirection.

Quickstart Guide

The shell is started by running the cbm-shell command, this presents the prompt

(cbm)

The list of available commands is shown by the help command

(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

Detailed information for a command is shown using help <command>.

Images need to be attached to a drive number in order to be used.

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

Up to ten images can be attached at any one time.

Files in an image can be addressed by prefixing the drive number followed by a colon. For example, to list a BASIC program in the image

(cbm) list 0:PRINT
5 INPUT"UPPER OR LOWER";C$:SA=0:IFC$="L"THENSA=7
10 INPUT"FILENAME";F$
11 OPEN4,4,SA
15 OPEN2,8,2,F$+",S,R"
20 GET#2,A$:IFST<>0THENPRINT#4:CLOSE4:CLOSE2:END
21 IFA$="π"THENA$=","
30 PRINT#4,A$;:GOTO20

Full documentation on Read the Docs.

TODO

  • more commands

  • better error handling

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cbmshell-1.18.tar.gz (19.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cbmshell-1.18-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

Details for the file cbmshell-1.18.tar.gz.

File metadata

  • Download URL: cbmshell-1.18.tar.gz
  • Upload date:
  • Size: 19.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Mageia","version":"9","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for cbmshell-1.18.tar.gz
Algorithm Hash digest
SHA256 61c230369176bc70b8cd0d88b713e4613a4489b4e6eeca213e1ad11b8dbc3b50
MD5 b9e1bb93ac7ea0b5e4050963fa2e9566
BLAKE2b-256 9cb0e2396199aa5b4916d01b8960a662e70c1c16a38db1bbfa0f9f13f4c5b8c3

See more details on using hashes here.

File details

Details for the file cbmshell-1.18-py3-none-any.whl.

File metadata

  • Download URL: cbmshell-1.18-py3-none-any.whl
  • Upload date:
  • Size: 22.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Mageia","version":"9","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for cbmshell-1.18-py3-none-any.whl
Algorithm Hash digest
SHA256 a2702d323181fa9b4b77fbde22979bc5b87c9e5fad63a1672e00772b754656ed
MD5 ec3e11957f9cbf00442f2bee683b41be
BLAKE2b-256 9136d576c2e472d6a35b8f2aa260de946b0ab00f436195ce57f9e0aabeb7a321

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.18 This release

2 files

1.17

1 file

1.16

2 files

1.15

2 files

1.14

2 files

1.13

2 files

1.12

2 files

1.11

2 files

1.10

2 files

1.9

2 files

1.8

2 files

1.7

2 files

1.6

2 files

1.5

2 files

1.4

2 files

1.3

2 files

1.2

2 files

1.1

2 files

1.0

2 files

0.5

2 files

0.4

2 files

0.3

2 files

0.2

2 files

0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page