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
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.
If it is not the correct version, then follow these steps:
- Download the latest python 2.7.X version from here for mac OSX 10.6 and later
- Open the disk image, and run Python.mpkg
- Check the python version again (You may have to re-open your terminal window)
- Grab ez_setup.py from here.
- In a terminal, run "sudo python ez_setup.py" in the directory where you stored ez_setup.py
- Your python version should be correct. Simply run the commands below
sudo easy_install pip
Install The Client:
pip install bqclient
Prepare your Pi:
- Download the latest version of Raspbian “wheezy” from the Raspberry Pi website.
- Burn the Raspbian disk image to your SD card using these instructions.
- 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:
- expand_rootfs -> make the partition 100% of the sd card.
- change the password for the pi user
- change the timezone to your current location
- enable the ssh server
- do not start the desktop on boot
- finish and reboot
On Pi Second Boot:
- Log in as the user pi with your previous password
- Confirm that your internet is connected by entering "ping 126.96.36.199" or "ifconfig -a"
- Write down your IP address from the step above. If you're using ethernet, it will say something like eth0..... inet addr:192.168.0.100
- 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.
- 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
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 botqueue.com 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.
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 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).