ArtBus computer interfaces for art, design, and multimedia

The Transmogrifier was designed to enable applications that cannot directly open a computer's serial port to communicate with the ArtBus. Right now such applications that support communication through OSC or TCP will work with the Transmogrifier. The application can also be used to connect to a device on a remote server.

The Transmogrifier is written in Python for portability and has a few dependencies that need to be installed prior to using it.

Installation Instructions:

Make sure you have your system setup for the ArtBus. You need the FTDI virtual serial port driver from: http://www.ftdichip.com/Drivers/VCP.htm

Install Dependencies:

pyserial install:

1. Download pyserial 2.4 here.
2. Untar the pyserial-2.4.tar. There is a readme.txt file in the untared folder.
3. Open a terminal and cd into the pyserial-2.4 folder.
4. Type: sudo python setup.py install

simpleOSC install:

1. Download simpleosc 0.2.5 here.
2. Unzip the simpleosc0.2.5.zip. There is a readme.txt file in the unzipped folder.
3. Open a terminal and cd into the simpleOSC folder.
4. Type: sudo python setup.py install

wxPython install:

If you system does not have wxPython installed by default then install.

• Mac OS 10.5 Leopard has wxPython installed.
• Mac OS 10.4.11 or less does not.

1. Download the wxPython 2.8 installer package here.
2. Run the wxPython 2.8 installer package.

Using the Transmogrifier:

1. Download the Transmogrifier here.
2. Make sure your hardware is connected to your computer.
3. Open a terminal and cd into the folder containing the transmogrifier.py.
4. Type: python transmogrifier.py

*Terminal window screenshot

*Transmogrifier screenshot

3. Protocol: Choose which protocol you want to use, OSC or TCP. The default is OSC.
4. Receive: If your hardware is connected to your computer then enter 127.0.0.1, this is also the default.
5. Port: It's best to use a higher port number to not interfere with current ports that might be used on your system. The default is 9000.
6. If you are using the OSC protocol you will also have to assign an IP and Port for the sending server.  The IP should be the same as the previous "Receive" address.  However the Port must be different.  The default is 9001. The Message defaults to '/toAB'.
7. Serial Device: Select your serial device. It will look similar to the one in the picture, but it will have a different name.
8. Select the Baud Rate your ArtBus hardware is set to.
9. Click 'Start'
10. Click 'Stop' to stop the Transmogrifier.