Skip to main content


Minor Versionm

by Robert

  1. WorkBee Control has only been tested on Google Chrome
    • WorkBee Control has only been tested on Google Chrome

    • The Name of the machine.

    • Advanced Users: The machine name can be changed by adding the command M550 "Machine Name" to config-user-settings.g

    • Send Manual G-Code commands.

    • To upload and start a job.

    • Make sure the machine has been Homed and Work Zero set.

    • Triggers a software emergency stop.

    Note the default IP address appear to be

    Steve Conway - Reply

    It allows me to also - one month later :)

    Artie - Reply


    It is a public site, therefore public editing is allowed. For this page, any edits have to be approved by admins.

    Best Regards


    Robert -

    The link at the top 3. Connecting and Commissioning allows me to edit this page - Reply

  2. Current position in Work Coordinates. The Work Coordinates displayed are determined by the Work Coordinate Selection dropdown.
    • Current position in Work Coordinates.

    • The Work Coordinates displayed are determined by the Work Coordinate Selection dropdown.

    • Advanced Users: To find out the machine positions of all Work Coordinates open File Management > System > config-override.g

    • Advanced Users: You can directly edit the machine positions of the Work Coordinates in config-override.g and save it.

    • Current position in Machine Coordinates

    • The machine ALWAYS moves within a Work Coordinate system. Machine coordinates are not a selectable coordinate system.

    • Advanced Users: To make absolute G-Code command movements in machine coordinates, G53 has to be explicitly stated at the beginning of each line.

  3. Used to home the machine. You need to home the machine when it is turned on.
    • Used to home the machine. You need to home the machine when it is turned on.

    • When homing an individual axis, it will always home the Z first to insure it is clear of any work piece.

    • Used to jog the machine around the work area. Right-click to modify distance.

    • The jogging feedrate can be modified under Settings > Machine Specific > 'Feedrate for move buttons (mm/min)'

    • Used to set the Work Zero position for the selected Work Coordinate System.

    • Move the machine to the Work Zero position of the currently selected Work Coordinate System.

    • The Compensation and Calibration buttons allows a probe to measure the overall work area flatness. Height maps are useful for milling PCB's. More information on using these buttons can be found here:

    Thanks, this has been fixed.

    Robert -

  4. When running a job, the progress of the job will be displayed here along with the percentage complete and estimated time remaining.
    • When running a job, the progress of the job will be displayed here along with the percentage complete and estimated time remaining.

    • When running a job, pause, resume, & cancel buttons will show here. When pausing a job it will save the current position and home the machine.

    • A controlled power off can also be performed in the middle of a job. This will pause, home and save the current job position, allowing it to be continued at a later time.

    • Use this button to resume a job after a controlled power off.

    • This button can also be used to resume a job after an unexpected power loss.

    • Advanced Users: 'Enable End G-Code' allows a set of pre-defined commands to be run after a job is completed.

    • These commands are defined under File Management > System > Sleep.g

  5. When running a job these buttons allow micro-adjustment of the Z-Axis
    • When running a job these buttons allow micro-adjustment of the Z-Axis

    • For example if the job is not cutting deep enough, these buttons can be used to shift the job downwards.

    • Be warned it will move the whole job downwards by same amount, including Z-Axis Safe Heights.

    • A slider to speed up or slow down the job. The speed is represented by a percentage, with 100% being the normal speed.

  6. Send Manual G-Code commands.
    • Send Manual G-Code commands.

    • Important information outputted from the WorkBee will be displayed here.

  7. Makes the G-Code Viewer Fullscreen. Use the mouse scroll wheel to zoom in and out.
    • Makes the G-Code Viewer Fullscreen.

    • Use the mouse scroll wheel to zoom in and out.

    • Mouse Left-click to Orbit.

    • Ctrl + Mouse Left-click to Pan.

    • The grid shows the machines working area.

    • The X, Y, and Z-Axis markers show where the selected Work Zero is located in the machines working area.

    • Current position in Work Coordinates.

    • Software emergency stop.

  8. Loads the current Job. In this mode it will only display progress thus far.
    • Loads the current Job.

    • In this mode it will only display progress thus far.

    • Loads a local file from your computer.

    • If a job is running, you can load it locally by right clicking the file under File Management > Jobs and press 'plugins.CNCgcodeViewer.view3D'

    • This will display the whole job.

    • It will show the progress in green if you load it once the job is already running.

    • This will elongate the spaces between passes. It can make files much easier to view.

    I have a problem, I see the cursor but not the travels in blue and the spreads in red.

    The work simulation works.

    If I run the job, the viewer only shows the current job cursor.


    Hi Lionel,

    I think if you start the job, and then load the job into the G-Code viewer like Step 10 here: First Project

    This should solve your issue.


    Kimberley -

  9. This is where all the Jobs are stored.
    • This is where all the Jobs are stored.

    • Clicking on a Job will run the Job.

    • Right clicking on a Job will also allow the file to be run, and in addition: Simulate, Download, Edit, Rename, and Delete.

    • Create a sub-folder

    • Upload a job to the current folder

    • The Macros page is similar the Jobs page.

    • Macros are different to jobs in that they are a sequence of commands which are regularly run.

    • For example a macro could be created that would move the head to the machine center instead of typing manual commands each time.

  10. This contains all the System files.
    • This contains all the System files.

    • Anything with 'config' in the name is run at startup.

    • We advise putting any custom settings in 'config-user-settings.g'

    • homeall.g, homex.g, homey.g, and homez.g contain the commands that are executed when the homing buttons are pressed.

    • workzero.g contains the commands that are executed when 'Go To Work Zero' is pressed.

  11. Change Theme Colour
    • Change Theme Colour

    • Autoclose Notifications

    • Manage plugins packaged within WorkBee Control.

    • Configure Webcam. See Duet's Dozuki.

    "Congifure" - typo

    Gary Wilson - Reply

  12. Change machine working area (No restart required)

Thanks for following the guide. As mentioned this was just a brief outline of using WorkBee Control. Please visit our YouTube channel for more in-depth tutorials on operating a CNC Machine. Even though some of the videos on our YouTube channel use an older version of the WorkBee the concepts still apply!

52 other people completed this guide.

Ryan Lock

Member since: 04/11/2018

48,453 Reputation

22 Guides authored


Hello, would there be a way to automate the CNC based on sensor feedback? Using python maybe?

RMan - Reply

You can communicate with the board two ways outside of the Web Control HTTP requests or using Telnet.The source code for WorkBee Control can be found here:

To see how the HTTP requests are completed, start by looking at the PollConnector.js file.

There is a forum post about connecting via Python using Telnet here:

Robert -

Problem, I calibrated IE cut 60mm square, this is spot on, but when you cut a 300mm(X axis) and 30mm(Y axis) the Y axis is bang on and the X axis is 5mm longer. every time even when running other programs(Gcode) I have checked the screws and all are tight. any help would be much appreciated. cheers peter

Doofa - Reply

Can I send G-code directly to the workbee from python or similar or does the data have to come from this web app?

Looking to use the workbee (without a router head) as part of an automated measurement jig

Dan w - Reply


Yes, we have seen users do this before.

You can communicate with the board two ways outside of the Web Control, HTTP requests or using Telnet.

The source code for WorkBee Control can be found here:

To see how the HTTP requests are completed, start by looking at the PollConnector.js file.

There is a forum post about connecting via Python using Telnet here:

Robert -


I've just built my new Z1+ and produced my first test piece today, Workbee control is fine but I feel that the jog button should represent the direction the machine moves (arrows left/right, front/back for X/Y and up/down for Z) could this not be implemented in the next update, it makes things so much easier to visualise.

Lea Newton - Reply

Hello :)

Can we change the home position?

Currently home is top right. Can this be changed to top left?

Thank you.

Jason King - Reply

Perfect :)

Thanks Robert.

Jason King -

Hi Jason,

It would be easiest to keep the home position as is, but edit the homing scripts, so after it homes, it goes to the top left. Command: G90 G0 X0

Add this to the end of homeall.g and homex.g

Robert -


I use a touchscreen device to control my workbee and accidental clicks have exposed some issues with Workbee Control which you may have overlooked.

It is possible to click the button to turn off the spindle/tool when a job is active, potentially crashing and breaking an endmill.

Movement, homing and set axis zero buttons on the dashboard should be disabled/greyed out when a job is running. I accidentally set a new X Zero in the middle of a job and ruined the part.

I hope you can fix these in the next update to WorkBee Control.

Andy Ofori - Reply

Hi Andy,

Thanks for your comments and good feedback, we will look to get them changes implemented.

Robert -

Hi Ryan,

Is there a way to change the units from millimeters to inches in WorkBee Control? Created jobs in VCarve Pro in inches. If I enter inch dimensions and select “mm” it does not convert it. If I do the job in inches and upload that to the WorkBee, I don’t think the Workbee will convert it, right? What would be easiest, for me at least, would be to setup the WorkBee Control in inches.

Tom Hawkins - Reply

Hi Tom,

Thanks for your post. If you send the command G20 in the WorkBee Control, it will now put you in inches.

You could add this command to config.g for it to be permanent.


Robert -

I must admit that the building of my 1500 x 1500 was as much pleasure as it is to start using it. Thanks

John Smith - Reply

Thanks John! That is awesome to hear!!!

Robert -

Sorry, tried to paste a screen shot but it wouldn’t accept.



1; pause.g

2; called when a print from SD card is paused


4 M98 P”homeall.g” ; Home the machine


(note: The first quote marks on 4 should be the other way round)

Steve - Reply

Hi Steve,

Change it to this: ; pause.g

; called when a print from SD card is paused


G53 G1 Z{move.axes[2].max} F1500 ; move the Z-Axis to the maximum position

G53 G1 X{move.axes[0].max} F2500 ; move the X-Axis to the maximum position

G53 G1 Y{move.axes[1].max} F2500 ; move the Y-Axis to the maximum position

And see if that helps.


Robert -

Hi Robert,

Yes when pressing ‘home all’ the Z axis does raise first before homing the X and Y

Steve - Reply

Hi Steve,

Ok, can you go to File Management > System. Click on a file called pause.g and send me the contents please?

Robert -


The z axis definitely doesn’t raise. Either with pause button or the cancel button.

The speed factor does work but not until the next round of g code. In my ignorance I thought it responded immediately, akin to pressing a car accelerator pedal.

Steve - Reply

Hi all,

The answer is probably hiding in plain sight, but the issue I have is when I have ‘paused’ a job, it first completes the bit of G code its currently doing and then returns to the home position, which is all well and good.

However it doesn’t raise the z height before moving to the home position, resulting in the bit carving through the workpiece on its way home.

Should the z axis automatically raise itself to the safe height before it moves to home when the pause button is pressed? if not what should I be doing to make sure the bit is raised to a safe height when pausing the job?

Thanks in anticipation.


Steve - Reply

Hi Steve,

Thanks for the info. When you are not cutting a job and then press Home All, does the Z-Axis raise then?

Robert -

Hi Robert, I have the Z1+, so as I understand it, there is no firmware update.

Whilst I’ve got you, I also tried to increase the speed factor last night, but that didn’t work either, (again not sure if it’s ever worked because it was the first time of trying it)

I’m just going down into the garage to try both again. Just in case I was doing something stupid last night.

FYI I’m using Carveco maker

Steve -

Hi Steve,

Thanks for your comment.

Yes, when pausing it should finish the current G-Code line it is on. And then raise the Z-Axis.

If it is not raising the Z-Axis, that is an issue.

Are you on our latest firmware?

Robert -

Hi all,

One question, can I use “WorkBee Control” with original workbee CNC xPro controller from 05.2018?

Recommend control software.

Stefan - Reply

Hi Stefan,

I am afraid WorkBee Control is only compatible with the Duet Controller. It will not work with the xPro.

Robert -

Hello Ryan. Can you tell me if there is any way to switch the Z1 off on the control software, without just pulling the plug. Thanks, maybe it’s there and I can’t see further than the end of my nose.

Merv Howard - Reply

Hi Merv,

Sorry there isn’t, you don’t need to pull the plug from the wall, just turn it off.

Robert -


Is it possible to control a workbee cnc with a duet2 controller with any software ? I want yo control my workbee cnc with openbuild control ?

Thanks a lot

Gregory Renault - Reply

Hi Gregory,

Sorry this is not possible :(


Robert -

Hi Ryan , can you tell me if you can do a preview on the gcode Viewer ? kenny - Reply

Hi Kenny,

Yes, as per Step 8, press Load Local G-Code.



Robert -

hi, I want to see the machine position in real time as its moving, it seems to display the moves ahead, is this a stetting i can change,

i have the Z1 with duet

appreciate any comments



david hoough - Reply

Hi David,

Thanks for your email

Sorry, there is no setting to change it to what you want. The coordinates are based on where the current move would make it end up.


Robert -

Hi Ryan,

Step 7 - G Code viewer

I do not have this as a selection under the ‘Control ‘ section. Below Dashboard and console I have ‘Height map’

Please can you let me know how I can access the G-Code viewer?

I have not been able to use my machine for a number of months due to illness so any help you can give would be appreciated.

Many thanks Serge Agius

serge agius - Reply

Hi Serge. That is part of our latest WorkBee Firmware. You can upgrade by following this guide: How To Update WorkBee Firmware V1.0.7 > V3.3.0-1.2

Robert -

The reset motors calibration confirmation popup rather asks you to reset the probe. Confirming does reset the calibration though.

Andy Ofori - Reply

Hi Andy, thanks for your comment. We will get this fixed. Robert

Robert -

I have fitted the xyz probe and tried to test the z probe macro. The duet controller gives an error that command G38.2 does not exist?

Terry - Reply

Hi Terry, It sounds like you may not have updated the WorkBee Control on your machine.

Are you able to email into Technical Support and we can look at what is causing your issues with the Touch Probe -

Ryan Christy -

How do I get access to Workbee control ie download or web address. I would rather use this than the duet web controller

Terry - Reply

hi ryan

could you please let me know where i can find a file too download the workbee control panel

many thanks bryan

bryan robbins - Reply

Hi Bryan, Thanks for your message, Please see this link on how to update to the latest WorkBee Control - How To Update WorkBee Firmware

Ryan Christy -

Hi I have just built my workbee and at the moment have no idea about all this g-code for the duet or even how to load up the ooznest custom control panel. So far all I have done is manage to home XYZ using the duet web control. Any links for a NOOB

Terry - Reply

Hi Terry, All the information you require can be found on the Learning Portal if you are stuck on a specific step feel free to get in contact with the team here -

Ryan Christy -


Is it possible to run the Workbee control from a tablet or android phone? - Reply

Of course! The WorkBee Control is browser-based so if you have the Wifi Version connect your device to the same network and search for the IP Address that your WorkBee is assigned to.

Ryan Christy -

Hi Ryan,

step 4 - job control has a typo in the sentence below

Use this button to resume a job offer a controlled power off.

should say ‘after’ not ‘offer’

otherwise useful initial guide to the contour panel

serge agius - Reply

Thanks for the feedback, I have made the adjustment!

Ryan Christy -

I’ve just noticed it’s the Y axis as well ?

Keith Reavill - Reply

Hi, Keith are you able to contact us here and we can help! -

Ryan Christy -

Hi Ryan…after using the emergency stop the parameter of X has changed and even though it says on the bar 550 it doesn’t travel that far …how do I get my full parameters back ?

Keith Reavill - Reply

Hi Ryan and happy new year to you…

is there a tutorial on how to us “height map” ?

Keith Reavill - Reply

Hi Keith,

We don’t have a guide on doing it, however Duet have a guide on using it here:

Best Regards


Robert -

Hello Ryan,

What files or information do you need?

thank you so much


Seb - Reply

Hi Ryan,

I'll send it to you as soon as possible



Seb -

Hi, config.g and customconfig.g, if you can email we can sort it out there. Best Regards Ryan Lock

Ryan Lock -

Hello Ryan,

I have an original Workbee 1000 x 1500mm Belt & Screw Drive.

I have just prepared my work surface, which should be 680 x 1150, except after machining, the dimensions are not correct (678 x 1146).

What should I change to get the right dimensions after machining?

Thanks in advance



Seb - Reply

Hi Sebastien,

Thanks for your comment. You need to adjust your steps per mm. Did you want to email into with your system settings and i can make the adjustment for you? We don’t have a guide on it i am afraid.

Best Regards

Ryan Lock

Ryan Lock -

Hi Ryan,

I would like to add a 5” PanelDue to my system.

Are there any plans to update the WorkBee Control to also be available on the PanelDue (for stand alone mode)?

If so any timelines available yet?



EdV - Reply

Hi Ed, Thanks for your comment. I am afraid there is no plans to put WorkBee Control on the PanelDue, as the PanelDue, runs a completely different software from the Web Control. An easier way would be to have a Raspberry Pi connected to the machine, and have a small touch screen connected to this pi, running the web control. Ryan

Ryan Lock -

Hi Ryan,

I have figured this out (in case others ask you).

The problem relates to user local screen resolution. I must have pressed something on my keyboard that altered the display resolution.

Subtle, but when I tried CNTRL +/- (in my case -) the screen adjusted and I saw the button return :)

If you wan to simulate open your workbee control. Make sure you can see the “Send Code” field.

Now press CNTRL+ twice (ie 120% of normal resolution). See the “Send Code” field disapear!

Now press CTRL- twice (ie 100% normal resolution) and presto you can see your field again.

Hope it helps.



EdV - Reply

Hi Ed, Thanks for clearing that up, should help others! Ryan

Ryan Lock -

Hi Ryan,

Many Thanks. Yes that fixed it :)

I have another one for you if I may?

On the Dashboard I had the field with the SEND button so I can send G & M codes to the workbee.

I don’t know what I did, but this field has suddenly disappeared! I can find it in the ‘Console’ Window but I find it much handier in the Dashboard.

Do you know how I can get it back to the dashboard?



EdV - Reply

Hi Ed,

That is strange it has disappeared. I can’t think why it would do that. Can you email a screenshot to

Best Regards

Ryan Lock

Ryan Lock -

Hi Ryan,

Firstly thanks for your informative docs & youtube videos :)

I am setting up a workbee screwdrive 500x500, Duet2 board (1.02+), Duet2 Wifi (V2.03), Duet Wifi Server (V1.23), Workbee control V1.0.1.

In the ‘congig.g’ file it tells me not to modify it and to rather paste any settings in ‘customconfig.g’.

So my problem is that trying to change the Z axis motor direction by updating (from) M569 P2 S0 > (to) M569 P2 S1 does NOT work.

Firstly I tried customconfig.g, then config.g and finally also added config.g.bak. None of them made any difference,.

Now here is my question:

(1) Is the correct procedure for modification of config.g to ONLY update customconfig.g?

(2) Is there a special “save” routine or SD Card update required for the Duet2 board?

(3) Is there an explanation why changing all the config.g files above with the new S0/1 setting has no affect?

Thanks in advance for any help or further comment.



EdV - Reply


Thanks for your message. Putting the command in M569 P2 S1 should work. After saving, please press the emergency stop button to restart the controller.

In config.g it should definitely work, i think it is because the controller needs restarting.

Best Regards

Ryan Lock

Ryan Lock -

Hi Ryan,

Many thanks for clearing that up. Do you know if I’m going to get 4 or 5 jogging buttons if I get either a 7 inch or 10 inch android tablet. Cheers

Colin Mill - Reply

It is based on pixels, do you know what pixel sizes each is going to be?

Ryan Lock -

Hi Ryan,

Sorry not to get back to you sooner. Can you please let me know where this button is located as I have been over the interface on both my PC and my phone and especially the settings tabs and cant find it. Cheers.

Colin Mill - Reply

Sorry i think i was incorrect in my previous message, the version you see if based on screen size and there is no button to switch.

Ryan Lock -

One question I have is about the way the web controller screen setup is controlled. In my PC (with 1920 x 1080 monitor) I get the version with 5 manual move control buttons per axis per direction. On my phone (also with 1920 x 1080 screen) I get the version with only 3 move control buttons per axis per direction. I want to buy a tablet to use with the router but want to be sure that I will get the version of the interface I get on the PC. What do I need to specify as regards the tablet in order for this to happen? Thanks.

Colin Mill - Reply

Hi Colin, Thanks for your email. On your phone, are you on the Mobile version or Desktop Version. There should be a button to switch between the two?

Ryan Lock -

Add Comment

View Statistics:

Past 24 Hours: 9

Past 7 Days: 77

Past 30 Days: 272

All Time: 24,928