Support UniversalBit Project -- Disambiguation -- Bash Reference Manual -- Join Mastodon -- Website -- Content Delivery Network
- Linux app image cncjs v1.10.3
wget https://github.com/cncjs/cncjs/releases/download/v1.10.3/cncjs-app-1.10.3-linux-x86_64.AppImage
-
Start cncjs-app with PM2 advanced process manager
-
Execute permissions
sudo chmod a+x cncjs-app-1.10.3-linux-x86_64.AppImage
npm i pm2 -g
pm2 start cncjs-app-1.10.3-linux-x86_64.AppImage --cron-restart="0 0 * * *"
pm2 startup
### [PM2] To setup the Startup Script, copy/paste the following command: <== copy and paste your PATH
sudo env PATH=$PATH:/home/universalbit/.nvm/versions/node/v20.11.0/bin /home/universalbit/.nvm/versions/node/v20.11.0/lib/node_modules/pm2/bin/pm2 startup systemd -u user --hp /home/universalbit
systemctl enable pm2-universalbit
pm2 save
- After starting cncjs-app it may be necessary to resolve the error "Error : Error: Permission Denied cannot open port:dev/ttyUSB0"
sudo chmod 777 /dev/ttyUSB0
CODE HAS VULNERABILITIES AND ERRORS ...is a news? Npm Auditing
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.
- Supported controllers
- 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
- 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
- cncjs-widget-boilerplate - Creating custom widgets for CNCjs.
- cncjs-pendant-boilerplate - A bare minimum example to develop a cncjs pendant.
- 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.
- cncjs-pendant-tinyweb - A tiny web console for small 320x240 LCD display.
- cncjs-shopfloor-tablet - A simplified UI for cncjs optimized for tablet computers in a production (shop floor) environment.
Chrome |
Edge |
Firefox |
IE |
Opera |
Safari |
---|---|---|---|---|---|
Yes | Yes | Yes | Not supported | Yes | Yes |
Version | Supported Level |
---|---|
<= 10 | Not supported |
12 | Supported |
>= 14 | Supported |
>= 20(LTS) | Recommended |
Required Packages:
sudo apt install curl git build-essential
nvm allows you to quickly install and use different versions of node via the command line.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install 20
nvm use 20
Add these lines to your ~/.bash_profile, ~/.bashrc, or ~/.profile file to have it automatically sourced upon login: ?
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
upgrade npm to the latest version. To upgrade, run:
npm install npm@latest -g
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.
npm install --unsafe-perm -g cncjs
Check out https://github.com/cncjs/cncjs/wiki/Installation for other installation methods.
Run npm install -g cncjs@latest
to install the latest version. To determine the version, use cncjs -V
.
cncjs -p 8001
http://localhost:8001
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:
-V, --version output the version number
-p, --port <port> Set listen port (default: 8000)
-H, --host <host> Set listen address or hostname (default: 0.0.0.0)
-b, --backlog <backlog> Set listen backlog (default: 511)
-c, --config <filename> Set config file (default: ~/.cncrc)
-v, --verbose Increase the verbosity level (-v, -vv, -vvv)
-m, --mount <route-path>:<target> Add a mount point for serving static files
-w, --watch-directory <path> Watch a directory for changes
--access-token-lifetime <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 <type> 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:
{
"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": ""
}
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
echo $HOME
-
Windows
echo %USERPROFILE%
Check out an example configuration file here.
See cncjs#242 (comment) for a detailed explanation.
{
"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": []
}
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.
Use GitHub issues for requests.
Pull requests welcome! Learn how to contribute.
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 |
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 | Український (Ukraine) | ✔ | khvalera |
tr | Türkçe (Turkish) | ✔ | Ali GÜNDOĞDU |
zh-cn | 简体中文 (Simplified Chinese) | ✔ | Mandy Chien, Terry Lee |
zh-tw | 繁體中文 (Traditional Chinese) | ✔ | Cheton Wu |
If you would like to support this project, you can make a donation using PayPal. Thank you!
This project exists thanks to all the people who contribute. [Contribute].
Thank you to all our backers! 🙏 [Become a backer]
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]