diff options
author | j.spijker@ultimaker.com <jelle spijker> | 2022-06-18 21:01:42 +0300 |
---|---|---|
committer | jspijker <j.spijker@ultimaker.com> | 2022-06-18 21:01:42 +0300 |
commit | 23501a8fdbf6b6fbc2005da8de6e0eb120742c28 (patch) | |
tree | ebc3c547b0de149f8fd1bdc574f0782bed5c03e1 /README.md | |
parent | 229e548e1d311593ba69f9be16b8bf29d301d5fa (diff) |
Update README
- Add banners
- remove old chat channels
- Mention ExtensiveSupportLogging plugin
Contributes to CURA-9365
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 60 |
1 files changed, 19 insertions, 41 deletions
@@ -11,7 +11,7 @@ <img src="https://img.shields.io/github/issues-closed/ultimaker/cura?color=g" /></a> <a href="https://github.com/Ultimaker/Cura/pulls" alt="Pull Requests"> <img src="https://img.shields.io/github/issues-pr/ultimaker/cura" /></a> - <a href="https://github.com/Ultimaker/CuraEngine/graphs/contributors" alt="Contributors"> + <a href="https://github.com/Ultimaker/Cura/graphs/contributors" alt="Contributors"> <img src="https://img.shields.io/github/contributors/ultimaker/cura" /></a> <a href="https://github.com/Ultimaker/Cura" alt="Repo Size"> <img src="https://img.shields.io/github/repo-size/ultimaker/cura?style=flat" /></a> @@ -24,8 +24,8 @@ and hundreds of community-managed print profiles, Ultimaker Cura is sure to lead ![Screenshot](cura-logo.PNG) -Logging Issues ------------- +## Logging Issues + For crashes and similar issues, please attach the following information: * (On Windows) The log as produced by dxdiag (start -> run -> dxdiag -> save output) @@ -34,53 +34,31 @@ For crashes and similar issues, please attach the following information: * `$HOME/Library/Application Support/cura/<Cura version>/cura.log` (OSX) * `$HOME/.local/share/cura/<Cura version>/cura.log` (Ubuntu/Linux) -If the Cura user interface still starts, you can also reach this directory from the application menu in Help -> Show settings folder - -For 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). - -Dependencies ------------- - -* [Uranium](https://github.com/Ultimaker/Uranium) Cura is built on top of the Uranium framework. -* [CuraEngine](https://github.com/Ultimaker/CuraEngine) This will be needed at runtime to perform the actual slicing. -* [fdm_materials](https://github.com/Ultimaker/fdm_materials) Required to load a printer that has swappable material profiles. -* [PySerial](https://github.com/pyserial/pyserial) Only required for USB printing support. -* [python-zeroconf](https://github.com/jstasiak/python-zeroconf) Only required to detect mDNS-enabled printers. - -For a list of required Python packages, with their recommended version, see `requirements.txt`. +If the Cura user interface still starts, you can also reach this directory from the application menu in Help -> Show settings folder. +An alternative is to install the [ExtensiveSupportLogging plugin](https://marketplace.ultimaker.com/app/cura/plugins/UltimakerPackages/ExtensiveSupportLogging) +this creates a zip folder of the relevant log files. If you're experiencing performance issues, we might ask you to connect the CPU profiler +in this plugin and attach the collected data to your support ticket. -This list is not exhaustive at the moment, please check the links in the next section for more details. - -Build scripts -------------- -Please check out [cura-build](https://github.com/Ultimaker/cura-build) for detailed building instructions. - -If you want to build the entire environment from scratch before building Cura as -well, [cura-build-environment](https://github.com/Ultimaker/cura-build-environment) might be a starting point before cura-build. (Again, see -cura-build for more details.) - -Running from Source -------------- +## Running from Source Please check our [Wiki page](https://github.com/Ultimaker/Cura/wiki/Running-Cura-from-Source) for details about running Cura from source. -Plugins -------------- +## Plugins Please check our [Wiki page](https://github.com/Ultimaker/Cura/wiki/Plugin-Directory) for details about creating and using plugins. -Supported printers -------------- +## Supported printers Please check our [Wiki page](https://github.com/Ultimaker/Cura/wiki/Adding-new-machine-profiles-to-Cura) for guidelines about adding support for new machines. -Configuring Cura ----------------- +## Configuring Cura Please check out [Wiki page](https://github.com/Ultimaker/Cura/wiki/Cura-Settings) about configuration options for developers. -Translating Cura ----------------- +## Translating Cura Please check out [Wiki page](https://github.com/Ultimaker/Cura/wiki/Translating-Cura) about how to translate Cura into other languages. -License ----------------- -Cura is released under the terms of the LGPLv3 or higher. A copy of this license should be included with the software. +## License +![License](https://img.shields.io/github/license/ultimaker/cura?style=flat) +Cura is released under terms of the LGPLv3 or higher. A copy of this license should be included with the software. Terms of the license can be found in the LICENSE file. Or at +http://www.gnu.org/licenses/lgpl.html + +> But in general it boils down to: +> **You need to share the source of any Cura modifications** |