Serial communications and a simple test application for interfacing with cutters.
Film at 11.
This list is incomplete. If you have more information, please file a pull request to update this table or otherwise let us know:
Cutter | Version | Status |
---|---|---|
Cricut Cake | v2.35 | should work |
Cricut Cake Mini | v1.54 | should work |
Cricut Create | v1.51 | should work |
Cricut Create | v1.54 | should work |
Cricut Expression | v2.00 | too old |
Cricut Expression | v2.31 | works |
Cricut Expression | v2.34 | should work |
Cricut Expression | v2.43 | should work |
Cricut Personal | v1.00 | too old |
Cricut Personal | v1.34 | works |
These are not provided with the library for various reasons. Please do not ask for them here or elsewhere.
You must provide keys at runtime by passing in a path to a key configuration file to each utility.
Key config files are a simple text file with a key's name and a key on each line, separated by whitespace. Like this (using fake keys):
MOVE_KEY_0 0x0123abcd
MOVE_KEY_1 0x0123abcd
MOVE_KEY_2 0x0123abcd
MOVE_KEY_3 0x0123abcd
LINE_KEY_0 0x0123abcd
LINE_KEY_1 0x0123abcd
LINE_KEY_2 0x0123abcd
LINE_KEY_3 0x0123abcd
CURVE_KEY_0 0x0123abcd
CURVE_KEY_1 0x0123abcd
CURVE_KEY_2 0x0123abcd
CURVE_KEY_3 0x0123abcd
Running any command that requires keys will also explain this format :).
Suggested bcpp command: bcpp -s -f 2 -i 4 -bnl -fi $in -fo $out
libcutter itself does not have many dependencies outside of OS-level serial port drivers. However, some of the utilities need the following:
- libsvg - a copy is in deps folder, need to patch png_set_gray_1_2_4_to_8 to png_set_expand_gray_1_2_4_to_8 in src/svg_image.c
- libpng - needed by libsvg
- SDL2 & SDL2GFX - needed by some of the simulator tools
If you're on a Mac:
brew install libsvg # or `brew install --build-from-source libsvg`
Otherwise, extract the file in the deps/
directory and follow the instructions in INSTALL
. You may need to apply the patch mentioned above: patch png_set_gray_1_2_4_to_8
to png_set_expand_gray_1_2_4_to_8
in src/svg_image.c
.
From this directory:
mkdir build
cd build
cmake ..
make
- Yay! Now you can run the code:
./util/some-program
To build for win32, you first need MinGW. On Debian install the following packages:
- mingw-w64
- mingw-w64-i686-dev
Once done, ./build-win32.sh has a sample for how to build the library and utilites.
Note, currently some of the utilities do not build on Win32 if libsvg is not present.
This project prebuilds binaries for Linux & Mac with every pull request. You can download and run these executables. To run them after downloading:
cd build-output/ # wherever you downloaded the output
chmod +x ./util/draw_gcode # or whichever file you want to run
./util/draw_gcode
Note: draw_svg
is dynamically linked to libsvg
(among a few other things), which means that you must have installed libsvg
to run it.
Note: If you're on a Mac, this will probably show an error message that the file was not written by an authorized developer. You can fix this by:
- Run the above so that you get the error message.
- Open Settings > Security & Privacy > General
- Under
Allow apps downloaded from
, you should see the name of the executable you just ran with a buttonAllow anyway
. Click that button. - Run the program again. It should now work!
Windows and MacOSX DLL wrapper for libcutter to add as a plugin for Sure Cuts A Lot 4 using the SCAL4 Custom Plugin spec https://www.craftedge.com/tutorials/cut_plugin/cut_plugin.php
Pre-built libraries are in Windows/Build and Mac/Build folders. Both library and XML files are required.
To build for Windows, there is a Visual Studio project in the Windows folder. To build for Mac, there is a XCode project in the Mac folder.