Swapper3D Instructions

Calibrating the Swapper3D

Check things over


  • Check and make sure that things seems correct. In the right places. 
  • Tight enough screws, Nothing wobbly.
  • Smoothly sliding QuickSwap-Hotend lock
  • cables tied up and out of the way.
  • If you have any questions send an email to [email protected]

Remove the QuickSwap-Insert


Note: If there is filament in the extruder from the last step where you calibrated the first layer using the Prusa3D guide, you will then need to follow these steps. If there is no filament loaded but the QuickSwap-Insert is still loaded in the QuickSwap-Hotend then just press the lock button to remove it. Otherwise, follow the remaining steps to remove the insert with filament loaded.

  1. Ensure the hotend is cold
  2. Press the QuickSwap-Hotend insert release button
  3. Push down on the filament above the extruder to force the QuickSwap_Insert out of the bore
  4. Cut the Filament off close to the top of the QuickSwap-Insert
  5. Pull the filament completely out of the extruder

Install the octoprint Swapper3D plugin


  1. Install the basic Octoprint server to the device of your choice and ensure it can connect to your printer. You will need 2 USB ports available, 1 for your printer and 1 for the swapper.
  2. Plug a USB cable from the Arduino control board on the Swapper3D to the Octoprint server system.
  3. Download the latest/newest Swapper3D Octoprint plugin zip file from here: Octoprint Plugin
  4. Save the .zip file in your “downloads” folder
  5. Do NOT unzip the zip the file. The whole zip file will be used directly.
  6. Open the Octoprint server in a browser window
  7. Click on Settings (green arrow)
  8. Click on ‘Plugin manager’ (yellow arrow)
  9. Click on ‘Get more’ (blue arrow)
  10. Click on Browse (orange arrow)
  11. Select the Swapper3D plugin zip file from the local downloads folder
  12. Click Install (red arrow)
  13. Swapper3D plugin will be installed
  14. close out of all settings windows
  15. restart the octoprint
  16. check that the plugin was installed correctly

Connect the printer to octoprint


  1. Connect a USB cable from your 3D printer to the Octoprint server computer (pink arrow)
  2. In octoprint click the connect button (blue arrow)
  3. ensure that your printer is connected to Octoprint; the Status will be “Operational” (green arrow)

Connect the Swapper3D to octoprint


  1. Connect a USB cable from your Swapper3D to the Octoprint server computer
  2. Click the Swapper3D tab (blue arrow), NOTE: depending on how zoomed into the page you may need to click the hamberger menu (green arrow)
  3. In the Swapper3D control tab click the ‘connect’ button (Red arrow)
  4. Ensure that the Swapper3D successfully connects; The “Swapper3D Connection State” text box will say “Ready to Swap!” (pink arrow)

Determine print head position for Swapping


  1. In the terminal of Octoprint, enter the command “G28 X” and press enter or the “Send” button
  2. wait for X axis to home
  3. In the controls panel in Octoprint,
  4. Using the mm distance controls and arrows,
  5. move the X axis to the right until the distance between the E motor right side and the QS lock servo housing between 7.5 – 8.5mm distance using digital calipers inside jaws. Pro Tip: the left/right arrows moves the distance selected in the boxes below, either 0.1mm, 1mm, 10mm, or 100mm. Just click on the distance you want the X axis to move, then click the right or left arrow. If the extruder is too close click the left arrow to move away from the Swapper, if the extruder is not close enough then click the right arrow to move closer to the Swapper. As you get closer select a smaller distance to move so that it’s more precise, for example, start with 10mm each move then when the extruder is approximately 10-20 mm away switch to 1mm movements, then when it’s about 1-2mm away switch to 0.1mm movements, then measure frequently and make small adjustments until the extruder gap is the correct amount.
  6. Enter M114 in the terminal command box
  7. click the send button
  8. Turn off Autoscroll
  9. Find the line in the termial after “Send: M114”, it should start “Recv: X:[Number]”
  10. Write down your unique X number
  11. Check that the value is correct and repeatable by following the remaining steps
  12. homing the X axis
  13. wait for the printer to home the X axis
  14. in the commands window enter this command substituting your personal value: “G1 X[your value] F2000” (do NOT include the double quotes or the square brackets, and DO substitute “[your value]” for the actual value you wrote down, and keep the square brackets. For example only: “G1 X250.1 F2000”)
  15. Wait for the extruder to move to the swap location.
  16. Use the digital calipers to check that the gap is still between 7.5 and 8.5mm.
  17. If not, Start again at step one(1).

Enter the value into the plugin settings


  1. Click on the Settings wrench in the top right corner of Octoprint
  2. Click on the the Settings for the Swapper3D octoprint plugin
  3. In the “X Axis position” text box enter your unique swap position number
  4. Click Save !!!!

Test Empty swap


  1. In the Swapper3D plugin panel
  2. Ensure that the status is “connected”
  3. Ensure that there are no inserts in the tool holder
  4. Ensure that there is no insert in the QuickSwap-Hotend
  5. Press the “Swap” button
  6. Observe that the swap procedure runs without issue
  7. Observe that the status is not “inserted”
  8. Observe that the Tool Arm end effector moved in alignment with the bore hole of the QuickSwap-Hotend
  9. Using digital calipers,
  10. Measure the distance between the extruder motor swapper main housing again, ensure that the distance is the same as you measured during the previous steps.
  11. Press the Unload button
  12. Ensure that the unload proceedure appears correct, that the cutter actuated, and the tool arm attempted to return the insert to the tool holder without error or interference.
Pro tip: you can also see a list of all the steps being output on the LCD screen during a swap. After a swap you can see the status of which tool is loaded or if it’s empty.

Test Load Insert


  1. Press a QuickSwap-Insert into the #1 tool holder receptacle
  2. Using the octoprint control panel, home the X axis
  3. In the Swapper3D plugin panel select #1 insert
  4. Press the “Swap” button
  5. Observe that the Insert is removed from the Tool Holder #1 receptacle
  6. and inserted into the bore of the QuickSwap-Hotend
  7. Using the octoprint control panel, move the X axis 100mm to the left
  8. Check that the QuickSwap-Insert is inserted correctly, that it’s inserted all the way, and the locking button is fully locked (all the way to the right with gentle pressure)

Test Unload Insert


  1. In the Swapper control panel,
  2. press the Unload button
  3. Observe that the currently loaded insert,
  4. is removed from the QuickSwap-Hotend
  5. The cutter is actuated
  6. and the insert is stowed in the #1 tool holder receptacle
  7. If so, this step was successful

Test load and unload two inserts


  1. Press a QuickSwap-Insert into the #2 tool holder receptacle
  2. You should now have a QuickSwap-Insert stowed in both the #1 and #2 tool holder receptacles
  3. In the Swapper3D plugin panel select #1 insert
  4. Press the “Swap” button
  5. Observe that the Insert is removed from the Tool Holder #1 receptacle
  6. and inserted into the bore of the QuickSwap-Hotend
  7. Now in the Swapper3D control panel,
  8. select insert #2 from the drop down list
  9. press the “Swap” button
  10. observe that the currently loaded #1 insert is stowed in the Tool holder #1 receptacle
  11. then the #2 insert is removed from its receptacle and inserted into the QuickSwap-Hotend
  12. press the unload button
  13. Observe that the #2 insert is stowed in the #2 receptacle of the tool holder
  14. if this happens then this step is successful

Load filament


  1. If the previous steps failed then go back to the step “Determine print head position for Swapping” and repeat until they work correctly
  2. If the previous steps were successful,
  3. Swap to insert #1
  4. in the octoprint control panel,
  5. heat the hotend to the temperature required for your filament (for example PLA: 220C)
  6. Wait for hotend temp to be reached
  7. Load the filament either by move the E axis until the filament is coming out the nozzle
  8. Once the filament is loaded,
  9. In the swapper3D control panel press the “Unload” button
  10. Observe that the hot insert #1 is removed from the hotend bore
  11. the filament is cut
  12. the insert is stowed in receptacle #1 of the tool holder
  13. repeat for each Insert with the color you will use during printing
  14. The Swapper3D is now “Calibrated”

Setup Prusa Slicer and test print


  1. Read through the Prusa3D Multi-Material guide here

2 thoughts on “Swapper3D – Instructions – Calibrate the Swapper3D”

Leave a Reply