# About

The Community Controller is a [fork ](https://en.wikipedia.org/wiki/Fork_\(software_development\))of the Makera Carvera Controller that has a number of features and bug fixes added  above and beyond the Makera software. See the [CHANGELOG](https://github.com/Carvera-Community/Carvera_Controller/blob/develop/CHANGELOG.md) and [screenshots](#screenshots) for more details.

* **3-axis** and advanced **probing** UI screens for various geometries (**corners**, **axis**, **bore/pocket**, **angles**) for use with a [true 3D touch probe](https://www.instructables.com/Carvera-Touch-Probe-Modifications/) (not the included XYZ probe block)
* [**Pendant** device support](https://carvera-community.gitbook.io/docs/controller/features/pendant-support) of **WHB04** family of **MPG devices**. Such devices can be used to jog, run macros, and perform feed/speed overrides.
* [**Workspace Management**](https://carvera-community.gitbook.io/docs/controller/features/workspace-management) options supporting multiple Work Coordinate Systems (WCS) From G54 to G59.3
* [WCS Rotation](https://carvera-community.gitbook.io/docs/controller/features/wcs-rotation) capability meaning no more tramming of vises for alignment
* Options to **reduce** the **autolevel** probe **area** to avoid probing obstacles
* **Tooltip support** for user guidance with over 110 tips and counting
* **Background images** for bolt hole positions in probe/start screens; users can add their own too
* Support for setting/changing to **custom tool numbers** beyond 1-6
* [Keyboard button](https://carvera-community.gitbook.io/docs/features/jogging-controls#keyboard-jogging) based **jog movement** controls
* **No dial-home** back to Makera
* **Single portable binary** for Windows and Linux
* **Laser Safety** prompt to **remind** operators to put on **safety glasses**
* **Multiple developers** with their own **Carvera** machines *"drinking their own \[software] champagne"* daily and working to improve the machine's capabilities.
* Various **Quality-of-life** improvements:
  * **Controller config settings** (UI Density, screensaver disable, Allow MDI while machine running, virtual keyboard)
  * **Enclosure light** and **External Output** switch toggle in the center control panel
  * Machine **reconnect** functionality with stored last used **machine network address**
  * **Set Origin** Screen pre-populated with **current** offset values
  * **Collet Clamp/Unclamp** buttons in Tool Changer menu for the original Carvera
  * Better file browser **upload-and-select** workflow
  * **Previous** file browsing location is **reopened** and **previously** used locations stored to **quick access list**
  * **Greater speed/feed** override scaling range from **10%** and up to **300%**
  * **Improved** 3D gcode visualisations, including **correct rendering** of movements around the **A axis**
  * [**Continuous Jogging**](https://carvera-community.gitbook.io/docs/features/jogging-controls#continuous-jogging) support
  * [Auto-Reconnect capability](https://carvera-community.gitbook.io/docs/controller/features/auto-reconnect)
  * [Logging](https://carvera-community.gitbook.io/docs/controller/features/logging)

## **Screenshots**

Please note that the below screenshots maybe from previous versions.

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-2e3ff443dbac8c1f3d2d99833fed9bf25e31263f%2F3d_probe_inside_corner.png?alt=media" alt=""><figcaption><p>3D Probe Inside Corner</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-aa3b2e3bb3113adae8d51a36b739e1f59a4e5736%2F3d_probe_outside_corner.png?alt=media" alt=""><figcaption><p>3D Probe Inside Corner</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-d7bc7d9cf252d678ea4be8894ab62a8af3a0b895%2F3d_probe_pocket.png?alt=media" alt=""><figcaption><p>3D Probe Pocket</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-26fb0e50f08603f493c71d48339351cef008980c%2F3d_probe_single_axis.png?alt=media" alt=""><figcaption><p>3D Probe Single axis</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-2542aaff9dc461b3ab22072b639b2b2e5579ca5a%2F3d_visualisation.png?alt=media" alt=""><figcaption><p>3D Visualisation</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-1c02db13dee3eab0c746c1c501d10db3c3e18920%2Fautolevel_with_offsets_config.png?alt=media" alt=""><figcaption><p>Autolevel with Offset Config</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-19e597bec40ba072f2dfd98f8197e0cb9790498b%2Fcollet_clamp_dropdown.png?alt=media" alt=""><figcaption><p>Collet clamp dropdown</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-95bfea9651afaf95362a820cc9b9fdc88cff7777%2Fconfig_and_run_with_offsets_and_background_image.png?alt=media" alt=""><figcaption><p>Config and Run with Offsets and Background Image</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-78cb79f7519a81a2dee8fe261c0a6f9d1cb20487%2Fcontroller_settings.png?alt=media" alt=""><figcaption><p>Controller Settings</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-e49577a90a4596912fc371e9de99dd95a688081a%2Fcustom_tool_numbers.png?alt=media" alt=""><figcaption><p>Custom Tool Numbers</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-a395902d6ed60c2b3c5e0a06bda03e6b4361c868%2Flaser_safety_prompt.png?alt=media" alt=""><figcaption><p>Laser Safety Prompt</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-3594ce9c115976279b3cca8a8cc5fda51e5b2784%2Freconnect_button.png?alt=media" alt=""><figcaption><p>Reconnect Button</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-460f464d2c7accaed89719e3137c79ce3f22db3b%2Frotated_wcs_support.png?alt=media" alt=""><figcaption><p>Rotated WCS Support in Config and Run preview</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-28d871cd97cc8ff46f7f580e16a4964b19a85061%2Funlock_w_safez_move.png?alt=media" alt=""><figcaption><p>Unlock and Move to Safe Z</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-af11a53ad71f474f68fe9d18de15c41c9f239d55%2Fworkspace_management_topbar.png?alt=media" alt=""><figcaption><p>Workspace Management Top Bar</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-56ca216d17e085112896519018b39dc127d847b5%2Fworkspace_settings.png?alt=media" alt=""><figcaption><p>Workspace Settings</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-72d44fe21b606af50897ffb794960f49e2544f60%2Fpendant_config.png?alt=media" alt=""><figcaption><p>Pendant Config</p></figcaption></figure>

<figure><img src="https://796221717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIcl2yLv4r2ehdkJpmlK%2Fuploads%2Fgit-blob-5d78d97509b5cc82605087a9b9de440da4deb58e%2Fcontroller_in_web_browser.png?alt=media" alt=""><figcaption><p>Carvera Controller in a Web Browser (via Container)</p></figcaption></figure>
