Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


3d printer control toolchain for reprap machines

Main purpose?

Command line tool for 3d printing with a reprap machine from given G-code.

What's this?

3dpct is a simple lightweight python script which lets you control your 3d printer using G-code.


  • G-code parser: It provides a simple G-code parser which removes G-code comments and empty lines, so that only the necessary information will be sent to the reprap machine.
  • Checksum generator: The parser also adds a line number and checksum to each line of G-code, so that the 3d printer is able to indicate transmission errors and re-requests corrupt lines of G-code.
  • Code sender: 3dpct overtakes the whole printer communication for you. You just have to feed it with the G-code file and the printer device (baudrate).
  • G-code cli: 3dpct also provides a cli which turns you able to write gcode on the command line and send it directly to the printer

All features are packed into two python classes, which you could also use in your own python program.

But how?

Example usage:

  • Print a model:

    ./ -f model.gcode -p -d /dev/ttyUSB0 -b 250000
  • Output filtered G-code:

    ./ -f model.gcode -o
  • Use as part of a pipeline:

    cat model.gcode | ./ -f - -o > filtered_gcode.gcode
  • Simple command execution (without checksum and line numbers):

    ./ --no-checksum -e G28

Please also check out the -h option:

usage: [-h] [-f [FILE]] [-o] [-p] [-c] [-n] [-e ...] [--no-checksum]
                [--silent] [-d [DEVICE]] [-b [BAUD]]

3dpct - a 3d printer control toolchain

optional arguments:
  -h, --help            show this help message and exit
  -f [FILE], --file [FILE]
                        load gcode from given file name or use '-' for STDIN
  -o, --output          output filtered gcode to STDOUT
  -p, --print           use 3d printer to print gcode
  -c, --cli             start a cli for manual printer control using gcodes
  -n, --no-direction-mark
                        don't show direction marks and prompt (eg: <~: ,~>:
                        ,<-: )
  -e ..., --execute ...
                        execute a single gcode line (must be last argument)
  --no-checksum         don't generate line numbers and checksums
  --silent              don't output communication while printing
  -d [DEVICE], --device [DEVICE]
                        the device to use for printing (default: /dev/ttyUSB0)
  -b [BAUD], --baud [BAUD]
                        the baudrate to use on device (default: 250000)


The programm has only been tested with a Velleman K8200. Please contact me if you get errors with your reprap (Just open a GitHub issue). Then I'll try to fix them. Please also let me know if it works with your reprap.

See also


3d printer control toolchain




No releases published


No packages published