xref: /Cura/
Name Date Size

..18-Aug.-20214 KiB

.dockerignoreH A D02-May-201943

.github/H21-Apr.-20214 KiB

.gitignoreH A D02-Jul.-20201.2 KiB

.pylintrcH A D10-Jan.-20203.8 KiB

build.shH A D02-May-20191 KiB

CITATION.cffH A D29-Jul.-2021265

cmake/H08-Sep.-20214 KiB

CMakeLists.txtH A D08-Sep.-20214.5 KiB

com.ultimaker.cura.appdata.xmlH A D09-Aug.-20211.5 KiB

com.ultimaker.cura.desktop.inH A D16-Feb.-20211.3 KiB

contributing.mdH A D02-May-20192.5 KiB

cura/H17-Sep.-20214 KiB

cura.sharedmimeinfoH A D02-May-20191 KiB

cura_app.pyH A D10-May-202110.4 KiB

docker/H08-Sep.-20214 KiB

DockerfileH A D02-May-20191.1 KiB

docs/H08-Jan.-20214 KiB

icons/H02-May-20194 KiB

JenkinsfileH A D02-May-20192.6 KiB

LICENSEH A D02-May-20197.5 KiB

plugins/H27-Jul.-20214 KiB

pytest.iniH A D02-May-201973

README.mdH A D16-Jul.-20213.2 KiB

requirements.txtH A D29-Jul.-2021570

resources/H08-Sep.-20214 KiB

run_coverage.pyH A D30-Aug.-2019464

run_in_docker.shH A D02-May-2019102

run_mypy.pyH A D16-Feb.-20213 KiB

screenshot.pngH A D29-May-2020309.3 KiB

scripts/H08-Sep.-20214 KiB

test-in-docker.shH A D13-Jan.-2020174

tests/H08-Sep.-20214 KiB

README.md

1Cura
2====
3Ultimaker Cura is a state-of-the-art slicer application to prepare your 3D models for printing with a 3D printer. With hundreds of settings and hundreds of community-managed print profiles, Ultimaker Cura is sure to lead your next project to a success.
4
5![Screenshot](screenshot.png)
6
7Logging Issues
8------------
9For crashes and similar issues, please attach the following information:
10
11* (On Windows) The log as produced by dxdiag (start -> run -> dxdiag -> save output)
12* The Cura GUI log file, located at
13  * `%APPDATA%\cura\<Cura version>\cura.log` (Windows), or usually `C:\Users\<your username>\AppData\Roaming\cura\<Cura version>\cura.log`
14  * `$HOME/Library/Application Support/cura/<Cura version>/cura.log` (OSX)
15  * `$HOME/.local/share/cura/<Cura version>/cura.log` (Ubuntu/Linux)
16
17If the Cura user interface still starts, you can also reach this directory from the application menu in Help -> Show settings folder
18
19For additional support, you could also ask in the [#cura channel](https://web.libera.chat/#cura) on [libera.chat](https://libera.chat/). For help with development, there is also the [#cura-dev channel](https://web.libera.chat/#cura-dev).
20
21Dependencies
22------------
23* [Uranium](https://github.com/Ultimaker/Uranium) Cura is built on top of the Uranium framework.
24* [CuraEngine](https://github.com/Ultimaker/CuraEngine) This will be needed at runtime to perform the actual slicing.
25* [fdm_materials](https://github.com/Ultimaker/fdm_materials) Required to load a printer that has swappable material profiles.
26* [PySerial](https://github.com/pyserial/pyserial) Only required for USB printing support.
27* [python-zeroconf](https://github.com/jstasiak/python-zeroconf) Only required to detect mDNS-enabled printers.
28
29For a list of required Python packages, with their recommended version, see `requirements.txt`.
30
31This list is not exhaustive at the moment, please check the links in the next section for more details.
32
33Build scripts
34-------------
35Please check out [cura-build](https://github.com/Ultimaker/cura-build) for detailed building instructions.
36
37If you want to build the entire environment from scratch before building Cura as well, [cura-build-environment](https://github.com/Ultimaker/cura-build) might be a starting point before cura-build. (Again, see cura-build for more details.)
38
39Running from Source
40-------------
41Please check our [Wiki page](https://github.com/Ultimaker/Cura/wiki/Running-Cura-from-Source) for details about running Cura from source.
42
43Plugins
44-------------
45Please check our [Wiki page](https://github.com/Ultimaker/Cura/wiki/Plugin-Directory) for details about creating and using plugins.
46
47Supported printers
48-------------
49Please check our [Wiki page](https://github.com/Ultimaker/Cura/wiki/Adding-new-machine-profiles-to-Cura) for guidelines about adding support for new machines.
50
51Configuring Cura
52----------------
53Please check out [Wiki page](https://github.com/Ultimaker/Cura/wiki/Cura-Settings) about configuration options for developers.
54
55Translating Cura
56----------------
57Please check out [Wiki page](https://github.com/Ultimaker/Cura/wiki/Translating-Cura) about how to translate Cura into other languages.
58
59License
60----------------
61Cura is released under the terms of the LGPLv3 or higher. A copy of this license should be included with the software.
62