Fork me on GitHub

How Do I Get Started?


  • A reliable 3D printer. BotQueue is designed for printing dozens or hundreds of jobs.
  • An automated 3D printer. You should not need to touch your machine after hitting print.
  • A supported 3D printer running software like GRBL, Sprinter, Marlin, or Teacup.
  • Mac or Linux preferred. Never been tested on Windows. Likely broken. Testers/Devs wanted.

Step 1: Register an account

Super easy - just visit the register page and sign up. Totally free.

Step 2: Install BumbleBee, the client software

Install These Programs:
sudo apt-get install fswebcam uvcdynctrl v4l-utils
Install The Client:
pip install bqclient
Run it!
Download Bumblebee

You can use the Github repo

Verify python version is at least 2.7. Python 3 is not tested and is likely not to work.
python --version
If it is not the correct version, then follow these steps:
  1. Download the latest python 2.7.X version from here for mac OSX 10.6 and later
  2. Open the disk image, and run Python.mpkg
  3. Check the python version again (You may have to re-open your terminal window)
  4. Grab from here.
  5. In a terminal, run "sudo python" in the directory where you stored
  6. Your python version should be correct. Simply run the commands below
Install pip:
sudo easy_install pip
Install The Client:
pip install bqclient
Run it!
Prepare your Pi:
  1. Download the latest version of Raspbian “wheezy” from the Raspberry Pi website.
  2. Burn the Raspbian disk image to your SD card using these instructions.
  3. Insert the SD card into your Pi, connect an HDMI monitor, ethernet or wifi, a keyboard, and then power it up.
On Pi First Boot:

In the Raspbian config screen, make these changes:

  1. expand_rootfs -> make the partition 100% of the sd card.
  2. change the password for the pi user
  3. change the timezone to your current location
  4. enable the ssh server
  5. do not start the desktop on boot
  6. finish and reboot
On Pi Second Boot:
  1. Log in as the user pi with your previous password
  2. Confirm that your internet is connected by entering "ping" or "ifconfig -a"
  3. Write down your IP address from the step above. If you're using ethernet, it will say something like eth0..... inet addr:
  4. Open a terminal on your main computer and ssh into the pi. Doing config / install stuff from an SSH session is much easier - you can copy and paste, and you don't need to be physically next to your Pi.
  5. Get screen installed and running. This will put you in a virtual screen. You can exit by hitting CTRL+A and then CTRL+D. The whatever you run will continue to run when close the terminal. You can then rejoin it at any time by running screen -dR botqueue again. This is also used to run bumblebee, so you can log in and see the command line interface later.
    sudo apt-get install screen
    screen -dR botqueue
Run these commands to configure your Pi.
sudo apt-get update -qy
sudo apt-get upgrade -qy

#install webcam tools
sudo apt-get install fswebcam uvcdynctrl v4l-utils python-picamera

#get Botqueue linked up and working on boot.
sudo apt-get install -qy git-core screen python-pip
sudo usermod -a -G dialout pi

#Install the client
pip install bqclient

#authorize our app now.
screen -dR botqueue bumblebee
Windows is not currently supported by BotQueue - patches welcome!

Step 3: Authorize the client software

From the command line, run this command: bumblebee

If you are on the same internet-facing IP (such as on most home networks) then when you visit the main dashboard, it will show you that an app is requesting access. Accept it and give the app a name that will identify the computer that it is running on.

If you are not on the same ip, the script in the terminal will give you a link that you can visit to authorize the app to access your account.

Important: the Bumblebee client will scan all of your serial ports and attached cameras. It will upload one picture from each camera to make selecting the right webcam easy. After granting access to the app, please wait 1-2 minutes for this scan data to upload to the site.

Step 4: Register and Configure your Bots

Once you register a bot, configure the slicer and driver settings. Follow the instructions in the bot config area for more details. No need to touch Bumblebee after you config your bot. The new config will be automatically downloaded.

Step 5: Bring your Bot Online

Bots default to the offline mode so that you have time to configure it. From the dashboard, select the 'bring online' option from the bot dropdown. You now have a network linked 3D printer. If you want it to stop processing jobs, use the same dropdown to take it offline again.

Step 6: Upload a job to BotQueue

Next, upload STL or GCode files to the site. These files will be automatically downloaded and executed by any eligible machines. If your client software is running, it will automatically download and process uploaded jobs.

Step 7: Removing a print upon completion

When a job is complete is done, you must go to the Botqueue site to go through the output verification (QA) process. It will request that you remove the print and confirm that the print was successful. If it is not successful, the bot will go offline and not take any more jobs. If the print is successful, the bot will look at the queue for new jobs, grab the next available one, and immediately begin printing it.

Getting Further Help

This project is a labor of love by Zach Hoeken and Justin Nesselrotte. Both the website and client code are 100% open source.

This project is considered mostly stable, but new changes can always break things. If you are stuck and can't get it working, try some of the places below for help. You'll probably have better luck getting in touch with Justin (jnesselr) than with Zach (hoeken).

Hey You! If you run into any problems, please report a bug. Make sure to include the bumblebee/info.log file if it is client-related.