Skip to content

Simplified environment for developing Tandy Color Computer applications

Notifications You must be signed in to change notification settings

jamieleecho/coco-dev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
version-bumper
Jan 27, 2024
4f4ebe0 · Jan 27, 2024
Jan 27, 2024
Jan 16, 2023
Dec 31, 2017
Jan 27, 2024
Jan 27, 2024
Jan 27, 2024
Apr 18, 2021
Jan 27, 2024
Dec 31, 2017
Jan 27, 2024

Repository files navigation

coco-dev

This repo implements a simplified environment for developing Tandy Color Computer applications. It implements a Docker image that includes the following tools:

Motivation

This repo is motivated in part by the need to keep the tools in sync between different computers. Because the Dockerfile contains all of the dependencies in a single place creating and sharing a reproducible development environment becomes possible.

Requirements

On Mac systems you must share /Users with Docker. To do this:

  • From the Docker menu select Preferences...
  • Click on the File Sharing tab
  • Click on +
  • Select /Users
  • Click Apply & Restart

Using coco-dev

# Start the Docker application if it is not already running
git clone https://github.com/jamieleecho/coco-dev.git
coco-dev/coco-dev

This will create a Linux shell in your home directory. You can cd into your target folder and use typical development commands such as lwasm, lwlink, decb, os9 and cmoc

Using KAOS on coco-dev

This version of coco-dev includes support for KAOSToolkit-Prototype as KAOS.Assembler. There are 4 command line tools that can be invoked using UNIX calling conventions, particularly using lower case letters instead of uppercase letters. Some examples:

./coco-dev kasm sprite1.asm
./coco-dev kaospp -opalette.asm -ppalette.gpl -ftc1014
./coco-dev kaostc --texture=sprite1.png --palette=palette.gpl --label-prefix=MySprite_ --pitch=128 --bpp=4 --cursor-register=Y --restore-cursor --output-file=sprite1.asm
./coco-dev kaostp --output-file texture.raw -t texture.png -p palette.gpl

Building coco-dev

# Start the Docker application if it is not already running
git clone https://github.com/jamieleecho/coco-dev.git
cd coco-dev
./build