Thingomatic Software Installation
Cannot fetch Flickr photo (id: 5224149304). The photo either does not exist, or is private

ReplicatorG is the program that prepares digital files for printing and controls your Thing-O-Matic. It is also used to test your Thing-O-Matic, and upload new firmware to its electronics.

Install ReplicatorG before your machine arrives and familiarize yourself with the program before your bot is assembled.

Install ReplicatorG

Download the version of ReplicatorG appropriate for your platform. ReplicatorG runs on Windows, Linux, and Mac OS X.

The most recent version of ReplicatorG is linked to below. Our downloads are hosted on Google Code, where we store older versions as well. You can download the latest version directly from the links below:

Or you can search for an older version of the program to use via Google Code.

Follow the installation instructions for your platform:

Install on Windows

Prerequisites

Note: Java now comes bundled with ReplicatorG on Windows, and should not need to be installed separately.

Install Python

The program that slices your model (turns it from a 3D model into a printable path) is called Skeinforge. It is written in python, which you'll need to install. You'll want Python 2.6. Download it from python.org, and follow the installation instructions.

Copy folder

Unzip the folder you downloaded and put it in a convenient directory.

  • Note: If you encounter errors while unzipping the file to your user directory, it may be that the maximum filename length is exceeded. Try unzipping it to another directory, such as C:\Program Files.
  • Windows 7 note: in some Windows 7 systems, some users have had permissions problems when installing ReplicatorG in the "Program Files" directory. If you encounter hanging issues when trying to edit or run Skeinforge profiles, try reinstalling ReplicatorG in a directory other than "Program Files".

Install Drivers

The drivers folder contains drivers for the FTDI USB -> Serial converter chips that the Motherboard uses. If you've already installed Arduino, you can skip this step. Otherwise, follow the instructions on the Arduino website.
Alternatively (helpful for XP systems) download these drivers from the FTDI website.

Here are some instructions specifically for installing the new drivers you'll need to use with The MakerBot Replicatorâ„¢.

Run it!

You can run the application by double clicking the ReplicatorG application.

Install on OSX

Prerequisites

Java 1.5 comes preinstalled on Mac OS X 10.4 or later, so you won't need to install it yourself.

Python, which the Skeinforge toolpath generator uses to do its magic, is preinstalled on Mac OS X. However, if Python is giving you trouble, you can download and install version 2.7.2 from Python.org.

Copy to Applications

  1. Mount the .dmg file.
  2. Create a new subdirectory in Applications to contain ReplicatorG and all its parts. Call it replicatorg.
  3. Select all the contents of the mounted .dmg file and copy them into you new replicatorg folder in Applications.

Note: If you try to run ReplicatorG directly from the mounted disk image, it will complain about running from a read-only directory and exit. Likewise, if you copy only the ReplicatorG.app file from the image and not the rest of the image contents, you will not be able to run the application.

Install Drivers

There is a /drivers folder in the replicatorg folder you installed. It contains a driver for the FTDI USB->Serial converter used with Arduino and Sanguino boards. If you have already installed Arduino, you can skip this step. Otherwise, please install it.

Run it

You can run the ReplicatorG application by double clicking the ReplicatorG icon.

Install on Linux

Prerequisites

You'll need to install a recent version of Java (1.5 or later), python 2.6 or later, and the python TkInter package. Additionally, you can speed up toolpath generation by installing the Python "psyco" package.

If you're using Ubuntu or a similar system, you can install all these from the command line:

sudo apt-get install openjdk-6-jdk python python-tk python-psyco

For Ubuntu 11.04 (natty narwhal)

If the model preview window doesn't display properly, you will need to install a proprietary version of Java. To do so, copy and paste this into a terminal:

sudo add-apt-repository "deb http://archive.canonical.com/ubuntu natty partner"
sudo apt-get update
sudo apt-get install sun-java6-jre

Next, you need to configure your system to use this version of java. Copy this into a terminal:

sudo update-alternatives --config java

Select the '/usr/lib/jvm/java-6-sun/jre/bin/java' option (it should be option 2)

If you are using KDE and ReplicatorG crashes on startup, add the following line to the file '/usr/lib/jvm/java-6-sun/jre/lib/swing.properties':

swing.defaultlaf=com.sun.java.swing.plaf.motif.MotifLookAndFeel

This line is needed because the GTK look and feel does not work with KDE.

For Ubuntu 12.04 LTS

As for Ubuntu 11.04, it's necessary to install a proprietary version of Java if the model preview window doesn't display properly.

To do so, copy and paste this into a terminal:

sudo apt-add-repository ppa:ferramroberto/java
sudo apt-get update
sudo apt-get install sun-java6-jre sun-java6-plugin

Next, you need to configure your system to use this version of java. Copy this into a terminal:

sudo update-alternatives --config java

Select the '/usr/lib/jvm/java-6-sun/jre/bin/java' option (it should be option 2)

Note: If this repository is unavailable, you can also install directly from Oracle's official Java distribution. See instructions here: http://www.java.com/en/download/help/linux_install.xml

If you're still having trouble installing Java, see the instructions at http://thedaneshproject.com/posts/how-to-install-java-7-on-ubuntu-12-04-lts/.

Optional: remove brltty

Some users have had issues with a Braille program that comes pre-installed in Ubuntu and may conflict with the serial driver. If you run into problems, you can remove the program with this command:

sudo apt-get remove brltty

Unpack it

Unpack the ReplicatorG .tar.gz file to a folder on your desktop (or wherever you'd like to install it).

For Fedora 14 and higher

ReplicatorG 25 ships an older version of the rxtx-library which can cause trouble:

check_group_uucp(): error testing lock file creation
Error details:Permission denied
check_lock_status: No permission to create lock file.

If this happens, replace the library from the replicatorg folder (replicatorg-0025/lib-i686/librxtxSerial.so) with the one from your system (/usr/lib/rxtx/librxtxSerial-*.*.so.) Change the paths accordingly if you are on a 64bit system. (replicatorg-0025/lib-x86_64 and /usr/lib64/rxtx/)

See http://replicatorg.lighthouseapp.com/projects/66325/tickets/181-upgrading-to-current-rxtx-library for more details on this issue.

For Archlinux

Packages requirements

# pacman -Syu python tk

Java version

Unfortunately the model preview doesn't work with openjdk. Oracle proprietary version is required.
You can install it from AUR using jre and jdk packages.
https://aur.archlinux.org/packages.php?ID=51908
http://aur.archlinux.org/packages.php?ID=51906

If you have installed aurget then you can simply type

$ aurget -S jre jdk

Access to serial port

Ensure your user have access to the serial port. Check rights on the file /dev/ttyUSBX (if you are using a FTDI usb-serial adapter, where X is the number of the corresponding serial port)

$ ls -la /dev/ttyUSB0
crw-rw---- 1 root uucp 4, 64 Oct  4 08:47 /dev/ttyUSB0

User root and group uucp have read/write access to the device.
In this example, you can simply add your user in the group uucp by editing file /etc/group or using your favorite GUI.

You will probably need to logout/login to update paths and rights.

Run It!

Open the replicatorg folder and run the "replicatorg" script by double-clicking it.

Next Step: Identify Your Parts

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