CNCjs     

!cncjs

CNCjs is a full-featured web-based interface for CNC controllers running Grbl, Marlin, Smoothieware, or TinyG.

For a more complete introduction, see the Introduction section of the wiki page.

!cncjs

Features

* Supported controllers
- Grbl (Download)
- Grbl-Mega (Download)
- Marlin (Download)
- Smoothieware (Download)
- TinyG (_Recommend: firmware version 0.97 build 449.xx_) (Download)
- g2core
* Desktop App for Linux, Mac OS X, and Windows
* 6-axis digital readout (DRO)
* Tool path 3D visualization
* Simultaneously communicate with multiple clients
* Responsive view for small screen display with device width less than 720px
- Safari on an iPhone 5S [\[1\]](https://cloud.githubusercontent.com/assets/447801/15633749/b817cd4a-25e7-11e6-9beb-600c65ea1324.PNG) [\[2\]](https://cloud.githubusercontent.com/assets/447801/15633750/b819b5f6-25e7-11e6-8bfe-d3e6247e443b.PNG)
* Customizable workspace
* Custom widget (since 1.9.10)
* Custom MDI (Multiple Document Interface) command buttons (since 1.9.13)
* My Account
* Commands
* Events
* Keyboard Shortcuts
* Contour ShuttleXpress
* Multi-Language Support
* Watch Directory
* Tool Change (since 1.9.11)
* Z-Probe

Custom Widgets

* cncjs-widget-boilerplate - Creating custom widgets for CNCjs.

Pendants

$3

* cncjs-pendant-boilerplate - A bare minimum example to develop a cncjs pendant.

$3

* cncjs-pendant-keyboard - A simple pendant (using wireless keyboard or usb) to CNCJS.
* cncjs-pendant-numpad - A simple pendant (using wireless numpad or usb) to CNCJS.
* cncjs-pendant-lcd - CNCjs Web Kiosk for Raspberry Pi Touch Displays.
* cncjs-pendant-ps3 - Dual Shock / PS3 Bluetooth Remote Pendant for CNCjs.
* cncjs-pendant-raspi-gpio - Simple Raspberry Pi GPIO Pendant control for CNCjs.

Tablet UI

* cncjs-pendant-tinyweb - A tiny web console for small 320x240 LCD display.

!cncjs-pendant-tinyweb
* cncjs-shopfloor-tablet - A simplified UI for cncjs optimized for tablet computers in a production (shop floor) environment.

!cncjs-shopfloor-tablet

Browser Support

!Chrome
Chrome | !Edge
Edge | !Firefox
Firefox | !IE
IE | !Opera
Opera | !Safari
Safari
--- | --- | --- | --- | --- | --- |
Yes | Yes | Yes| Not supported | Yes | Yes |

Supported Node.js Versions

| Version | Supported Level |
| :------ |:--------------- |
| <= 10 | Not supported |
| 12 | Supported |
| >= 14 | Recommended |

Getting Started

$3

Node.js 14 or higher is recommended. You can install Node Version Manager to manage multiple Node.js versions. If you have git installed, just clone the nvm repo, and check out the latest version:
``
git clone https://github.com/creationix/nvm.git ~/.nvm
cd ~/.nvm
git checkout git describe --abbrev=0 --tags
cd ..
. ~/.nvm/nvm.sh
`

Add these lines to your ~/.bash_profile, ~/.bashrc, or ~/.profile file to have it automatically sourced upon login:
`bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
`

Once installed, you can select Node.js versions with:
`
nvm install 14
nvm use 14
`

It's also recommended that you upgrade npm to the latest version. To upgrade, run:
`
npm install npm@latest -g
`

$3

Install cncjs as a non-root user, or the serialport module may not install correctly on some platforms like Raspberry Pi.
`
npm install -g cncjs
`

If you're going to use sudo or root to install cncjs, you need to specify the --unsafe-perm option to run npm as the root account.
`
sudo npm install --unsafe-perm -g cncjs
`

Check out https://github.com/cncjs/cncjs/wiki/Installation for other installation methods.

$3

Run npm install -g cncjs@latest to install the latest version. To determine the version, use cncjs --version.

$3

Run cncjs to start the server, and visit http://yourhostname:8000/ to view the web interface. Pass --help to cncjs for more options.

`
pi@rpi3$ cncjs -h

Usage: cncjs [options]


Options:

--version output the version number
-p, --port Set listen port (default: 8000)
-H, --host Set listen address or hostname (default: 0.0.0.0)
-b, --backlog Set listen backlog (default: 511)
-c, --config Set config file (default: ~/.cncrc)
-v, --verbose Increase the verbosity level (-v, -vv, -vvv)
-m, --mount : Add a mount point for serving static files
-w, --watch-directory Watch a directory for changes
--access-token-lifetime Access token lifetime in seconds or a time span string (default: 30d)
--allow-remote-access Allow remote access to the server (default: false)
--controller Specify CNC controller: Grbl|Marlin|Smoothie|TinyG|g2core (default: '')
-h, --help output usage information

Examples:

$ cncjs -vv
$ cncjs --mount /pendant:/home/pi/tinyweb
$ cncjs --mount /widget:~+/widget --mount /pendant:~/pendant
$ cncjs --mount /widget:https://cncjs.github.io/cncjs-widget-boilerplate/v1/
$ cncjs --watch-directory /home/pi/watch
$ cncjs --access-token-lifetime 60d # e.g. 3600, 30m, 12h, 30d
$ cncjs --allow-remote-access
$ cncjs --controller Grbl
`

Instead of passing command line options for --watch-directory, --access-token-lifetime, --allow-remote-access, and --controller, you can create a ~/.cncrc file that contains the following configuration in JSON format:
`json
{
"mountPoints": [
{
"route": "/pendant",
"target": "/home/pi/tinyweb"
},
{
"route": "/widget",
"target": "https://cncjs.github.io/cncjs-widget-boilerplate/v1/"
}
],
"watchDirectory": "/path/to/dir",
"accessTokenLifetime": "30d",
"allowRemoteAccess": false,
"controller": ""
}
`

To troubleshoot issues, run:
`
cncjs -vvv
`

$3

The configuration file .cncrc contains settings that are equivalent to the cncjs command-line options. The configuration file is stored in user's home directory. To find out the actual location of the home directory, do the following:

* Linux/Mac
`sh
echo $HOME
`

* Windows
`sh
echo %USERPROFILE%
`

Check out an example configuration file here.

$3

See https://github.com/cncjs/cncjs/issues/242#issuecomment-352294549 for a detailed explanation.

`json
{
"ports": [
{
"path": "/dev/ttyAMA0",
"manufacturer": ""
}
],
"baudrates": [115200, 250000],
"mountPoints": [
{
"route": "/widget",
"target": "https://cncjs.github.io/cncjs-widget-boilerplate/v1/"
}
],
"watchDirectory": "/path/to/dir",
"accessTokenLifetime": "30d",
"allowRemoteAccess": false,
"controller": "",
"state": {
"checkForUpdates": true,
"controller": {
"exception": {
"ignoreErrors": false
}
}
},
"commands": [
{
"title": "Update (root user)",
"commands": "sudo npm install -g cncjs@latest --unsafe-perm; pkill -f cncjs"
},
{
"title": "Update (non-root user)",
"commands": "npm install -g cncjs@latest; pkill -f cncjs"
},
{
"title": "Reboot",
"commands": "sudo /sbin/reboot"
},
{
"title": "Shutdown",
"commands": "sudo /sbin/shutdown"
}
],
"events": [],
"macros": [],
"users": []
}
``

Documentation

https://cnc.js.org/docs/

Examples

There are several *.gcode files in the examples directory. You can use the GCode widget to load a GCode file and make a trial run.

If you don't have a CAM software, try using jscut to create G-Code from *.svg. It's a simple CAM package that runs in the browser.

Check out a live demo at http://jscut.org/jscut.html.

Contributions

Use GitHub issues for requests.

Pull requests welcome! Learn how to contribute.

Localization

You can help translate resource files in both of app and server directories from English to other languages. Check out Localization guide to learn how to get started. If you are not familiar with GitHub development, you can open an issue or send your translations to cheton@gmail.com.

Locale | Language | Status | Contributors
:----- | :------- | :----- | :-----------
cs | Čeština (Czech) | ✔ | Miroslav Zuzelka
de | Deutsch (German) | ✔ | Thorsten Godau, Max B.
es | Español (Spanish) | ✔ | Juan Biondi, hasecilu
fr | Français (French) | ✔ | Simon Maillard, CorentinBrulé
hu | Magyar (Hungarian) | ✔ | Sipos Péter
it | Italiano (Italian) | ✔ | vince87
ja | 日本語 (Japanese) | ✔ | Naoki Okamoto
nl | Nederlands (Netherlands) | ✔ | dutchpatriot
pt-br | Português (Brasil) | ✔ | cmsteinBR
ru | Ру́сский (Russian) | ✔ | Denis Yusupov
uk | українська (Ukrainian) | ✔ | khvalera
tr | Türkçe (Turkish) | ✔ | Ali GÜNDOĞDU
zh-cn | 简体中文 (Simplified Chinese) | ✔ | Mandy Chien, Terry Lee
zh-tw | 繁體中文 (Traditional Chinese) | ✔ | Cheton Wu

Donate

If you would like to support this project, you can make a donation using PayPal. Thank you!


Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

License

Licensed under the MIT License.