Run Repg From A Stick

RepG on a Stick

Charles Shapiro
18 Dec 2010

Steps to install ReplicatorG 0022 on Puppy Linux 5.11. This allows you to
boot and run ReplicatorG from USB mass storage, without affecting the PC you happen to be working on. It's also a simple way to make sure your operating system (no, I ain't lookin' at Windows, honest!) isn't making trouble for your prints.

Install Puppy 5.11 to stick. Boot puppy 5.11 on the stick.

  • Download the Puppy Linux ISO from the Puppy Linux site ( )
  • Burn the .iso file to a CD-ROM.
  • Boot from the CD-ROM and use the Puppy "Universal Installer" to install Puppy Linux on your USB mass storage device. You'll probably need at least a gb of storage for this.
  • Reboot from your USB mass storage device so you're running puppy linux on it.

Configure Puppy Linux.

  • Connect to the internet with the "Connect" icon on the desktop
  • Click on the "quickpet" icon on the desktop. then "drivers". From here, probe your video card and install the best video driver for it. You'll need this to make ReplicatorG look her best.
  • Use the "quickpet" icon on the desktop to install firefox or seamonkey. You will need this because Puppy's default browser won't handle https, which is required to download the files you will need to make ReplicatorG work.

Download jre 1.6 and install in /opt

  • Download jre-6u22-linux-i586.bin from
  • Make the bin file executable ("chmod +x jre-6u22-linux-i586.bin")
  • cd to /opt and run jre-6u22-linux-i586.bin
  • Set up a softlink from /usr/bin/java to /opt/jre1.6/bin/java ("cd /usr/bin ; ln -s java /opt/jre1.6/bin/java")
  • You should now be able to type "java -version" at the command line and get something like 'java version "1.6.0_0"'

Install python 2.6, python-tk, and psyco

  • Install all of these packages by opening the directory you downloaded them into in the file manager (the "file" icon on the desktop) and clicking on them. For each package, you should get a message indicating that it was installed successfully.
  • Softlink /usr/bin/python2.6 to /usr/bin/python ( "cd /usr/bin ; ln -s python2.6 python")
  • Verify that python-tk is installed correctly. Type "python" at a command prompt, then "import _tkinter" at the python prompt. You should see no errors or complaints. Exit the python interpreter with "ctrl-d"

Install and run replicatorg

  • Download replicatorg-022 from
  • Unpack replicatorg into /opt ( "cd /opt ; tar -xzvf replicatorg-0022-linux.tgz")
  • Run replicatorg ( "cd /opt/replicatorg-0022 ; replicatorg &")
  • Save your changes with the "Save" icon on the puppy desktop, or by rebooting (again).
  • If you wish to make a ReplicatorG icon on the desktop, you can open your replicatorg install directory with the file manager (under the "File" icon), then drag the "replicatorg" script onto the desktop. To make it look really spiffy, you can edit that icon to use the ReplicatorG gif file in the "lib" directory of ReplicatorG's install home.
  • Enjoy 3d printing from a stick!

Bonus! Install Art of Illusion

Running ReplicatorG on bootable USB storage is cool, but for a truly integrated solution you obviously need to create 3d models. _Art_of_Illusion_ will install and run fine on Puppy 5.11, but of course if you put it on your stick you will have less room for profiles, .stl and g-code files which you'll actually use for your makerbot. If you already own a desktop machine, it might make more sense to put your modeling software on it. If not, here's what I did.

  • Download the Art of Illusion zip file ( )
  • Download the Java Media Framework zip from Oracle ( ). "Download" is in the lower right corner of the center block. This is not strictly necessary, but I'm still exploring 3d modelers. You want the "Cross-platform java" zip file.
  • Unzip into your /tmp directory ( "unzip")
  • Execute to install ArtOfIllusion to your /opt directory. Give the installer the name of the jmf zip file when it asks. Skip installing the "Gnome/KDE free desktop integration" portion of the software.
  • Run _Art_Of_Illusion_ by executing its shell script ("cd /opt/ArtOfIllusion; ./")
  • In order to write .stl files, you will need to install a plugin to ArtOfIllusion. You can do this through the plugins manager ( look for "STLTranslator") or by finding "STLTranslator.jar" on the ArtOfIllusion sourceforge site and manually copying it to /opt/ArtOfIllusion/Plugins.
  • Consider installing the ArtOfIllusion CSG Evaluator ( ) as well; it also goes into the Plugins directory. You can also simply install all plugins.
  • If you want to put Art of Illusion on your desktop, open the install directory up in the file manager (under the "File" icon on the desktop), then drag the "" script to your desktop. The ArtOfIllusion icons live in the "Icons" directory in the install directory.

Happy Hacking!

Unless otherwise stated, the content of this page is licensed under GNU Free Documentation License.