This is a simple collection of tools to assist with developing software for the TRS-80 Color Computer.
# To install via pip
pip install coco-tools
# To install from source
git clone https://github.com/jamieleecho/coco-tools.git
cd coco-tools
make install-pre-commit
make install
The Makefile makes it easy to perform the most common operations:
make all transpiles several exapmle ECB programs to Basic09make check-all runs linting and uv.lock checksmake check-lint checks for linting issuesmake check-lock verifies the uv.lock is aligned to pyproject.tomlmake clean cleans the virtual environment and cachesmake default runs a default set of checks on the codemake fix-all formats the code, fixes lint errors and runs locks uv.lock to pyproject.tomlmake fix-format formats the codemake fix-lint fixes linting issuesmake fix-lint-unsafe fixes linting issues potentially adding inadvertant bugsmake help outputs the different make optionsmake install build install the distributionmake install-pre-commit installs pre-commit hooksmake lock locks uv.lock to pyproject.tomlmake install-pre-commit installs pre-commit hooksmake run-tests runs the unit testsmake sync syncs the python environment with uv.lock.vscode/settings.json is set so that unit tests can be run without further configuration.
usage: decb-to-b09 [-h] [--version] [-l] [-z] [-s DEFAULT_STRING_STORAGE] [-D] [-w]
[-c CONFIG_FILE]
program.bas program.b09
Convert a Color BASIC program to a BASIC09 program
Copyright (c) 2023 by Jamie Cho
Version: 0.18
positional arguments:
program.bas input DECB text program file
program.b09 output BASIC09 text program file
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
-l, --filter-unused-linenum
Filter out line numbers not referenced by the program
-z, --dont-initialize-vars
Don't pre-initialize all variables
-s DEFAULT_STRING_STORAGE, --default-string-storage DEFAULT_STRING_STORAGE
Bytes to allocate for each string
-D, --dont-output-dependencies
Don't output required dependencies
-w, --dont-run-width-32
if set don't run the default width 32
-c CONFIG_FILE, --config-file CONFIG_FILE
Optional compiler configuration file
usage: cm3toppm [-h] [--version] [image.cm3] [image.ppm]
Convert RS-DOS CM3 images to PPM
Copyright (c) 2017 by Mathieu Bouchard
Copyright (c) 2018-2020 by Jamie Cho
Version: 0.6
positional arguments:
image.cm3 input CM3 image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
usage: hrstoppm [-h] [-w width] [-r height] [-s bytes] [--version]
[image.hrs] [image.ppm]
Convert RS-DOS HRS images to PPM
Copyright (c) 2018 by Mathieu Bouchard
Copyright (c) 2018-2020 by Jamie Cho
Version: 0.6
positional arguments:
image.hrs input HRS image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
-w width choose different width (this does not assume bigger pixels)
-r height choose height not computed from header divided by width
-s bytes skip some number of bytes
--version show program's version number and exit
usage: maxtoppm [-h] [--version]
[-br | -rb | -br2 | -rb2 | -br3 | -rb3 | -s10 | -s11] [-i]
[-w width] [-r height] [-s bytes] [-newsroom]
[image] [image.ppm]
Convert RS-DOS MAX and ART images to PPM
Copyright (c) 2018 by Mathieu Bouchard
Copyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho
Version: 0.6
positional arguments:
image input image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
pixel mode:
Default pixel mode is no artifact (PMODE 4 on monitor). The 6 other modes:
-br PMODE 4 artifacts, cyan-blue first
-rb PMODE 4 artifacts, orange-red first
-br2 PMODE 3 Coco 3 cyan-blue first
-rb2 PMODE 3 Coco 3 orange-red first
-br3 PMODE 3 Coco 3 primary, blue first
-rb3 PMODE 3 Coco 3 primary, red first
-s10 PMODE 3 SCREEN 1,0
-s11 PMODE 3 SCREEN 1,1
Format and size options::
Default file format is CocoMax 1/2's .MAX, which is also Graphicom's
.PIC and SAVEM of 4 or 8 pages of PMODE 3/4.
Also works with any other height of SAVEM (including fractional pages).
-i ignore header errors (but read header anyway)
-w width choose different width (this does not assume bigger pixels)
-r height choose height not computed from header divided by width
-s bytes skip header and assume it has the specified length
-newsroom read Coco Newsroom / The Newspaper .ART header instead
usage: mgetoppm [-h] [--version] [image.mge] [image.ppm]
Convert RS-DOS MGE images to PPM
Copyright (c) 2017 by Mathieu Bouchard
Copyright (c) 2018-2020 by Jamie Cho
Version: 0.6
positional arguments:
image.mge input MGE image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
usage: mge_viewer2 [-h] [--version] [image.mge]
View ColorMax 3 MGE files
Copyright (c) 2022 by R. Allen Murphey
Version: 0.6
positional arguments:
image.mge input MGE image file
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
usage: pixtopgm [-h] [--version] image.pix [image.pgm]
Convert RS-DOS PIX images to PGM
Copyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho
Version: 0.6
positional arguments:
image.pix input PIX image file
image.pgm output PGM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
usage: rattoppm [-h] [--version] [image.rat] [image.ppm]
Convert RS-DOS RAT images to PPM
Copyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho
Version: 0.6
positional arguments:
image.rat input RAT image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
usage: veftopng [-h] [--version] image.vef image.png
Convert OS-9 VEF images to PNG
Copyright (c) 2018-2020 Travis Poppe <tlp@lickwid.net>
Copyright (c) 2020 Jamie Cho
Version: 0.6
positional arguments:
image.vef input VEF image file
image.png output PNG image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
# To set up pre-commit checks
pre-commit install
# Build the docker image
docker compose build test
# Run tests using the source on the docker image
docker compose run test
# Run tests using the source on the host computer
docker compose run testv
# To develop locally
pip install -r requirements.txt
# Run linting, build example disk images for basic conversion
make
# Remove built artifacts
make clean
# Reformats the code
make format
# Only runs linting
make lint
# Only run tests
make test
# Build basic and os-9 eample images
make basic.dsk os9boot.dsk
The programs in the examples/decb and examples/other-decb-examples-to-try directories are from the following sources:
FAQs
TRS-80 Color Computer Tools
We found that coco-tools demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Malicious Ruby gems typosquat Fastlane plugins to steal Telegram bot tokens, messages, and files, exploiting demand after Vietnam’s Telegram ban.
Research
Security News
Socket uncovered four malicious npm packages that exfiltrate up to 85% of a victim’s Ethereum or BSC wallet using obfuscated JavaScript.
Security News
TC39 advances 9 JavaScript proposals, including Array.fromAsync, Error.isError, and Explicit Resource Management, which are now headed into the ECMAScript spec.