cc-tool

CLI tool for managing an Elegoo Centauri Carbon 3D printer over its local network SDCP WebSocket API.

Installation

If you have uv, once you have this repo around, you can just:

uv run cc-tool

or you can also just uv sync, activate the virtualenv, and run cc-tool directly. Or you could install this as a tool with uv tool... or uvx --from=git+https://github.com/akx/centauri-carbon-tool.git cc-tool ...

Usage

Substitute uv run cc-tool (or similar) for cc-tool below.

Configuration

All commands accept --host (default 192.168.1.121, or set CC_HOST env var).

List files

cc-tool files                          # list /local/ (default), sorted by date
cc-tool files /usb/                    # list USB storage
cc-tool files --sort name --desc       # sort by name, descending

Sort options: name, size, date, layers.

Print history

cc-tool history

Shows completed/stopped/errored prints with timestamps, durations, and layer counts.

Download files

cc-tool download ./backup              # download all files to ./backup
cc-tool download ./backup --glob "*.gcode"  # only matching files
cc-tool download ./backup --compress   # compress with zstdmt after download
cc-tool download ./backup --path /usb/ # download from USB storage

Already-downloaded files (including .zst compressed versions) are skipped automatically.

Delete files

cc-tool delete /local/old-model.gcode          # delete a file (with confirmation)
cc-tool delete /local/file1 /local/file2 --yes # skip confirmation
cc-tool delete -d /local/somefolder            # delete a folder