Page LogoSynthetic Aperture Logo

Configuring Color Finesse and the Colorociter for Alternate Network Ports

Article Number
420113

Last Edited
1/28/07

Keywords
color finesse, colorociter, ethernet, telnet, tcp, port

 

Platforms/Versions

Color Finesse 2.1.5 or later on Macintosh OS X and Colorociter CS-1 Colorists Control Surface with Ethernet interface.

Problem

When using an Ethernet interface, Color Finesse communicates with the Colorociter the telnet protocol, which uses TCP port 23. In some network environments port 23 is blocked by firewalls for security reasons.

Solution

Color Finesse always initiates the connection to the Colorociter. In most cases that allows firewall rules to be set so that the default port 23 is acceptable. In order for Color Finesse and the Colorociter to communicate when TCP port 23 is not available, you must configure them to use a different port.

Reconfiguring the Colorociter to use a different port is straightforward. Refer to the Knowledge Base article Configuring the Colorociter CS-1 for Use with Ethernet Interface for details on how to select the new port.

Color Finesse does not have a user interface for changing the port it uses to communicate with the Colorociter. However, by editing Color Finesse’s preferences file you can select whatever port you wish. Be sure to quit from Color Finesse before attempting to alter the preference file.

The preference file is located in ~/Library/Preferences. For the Color Finesse plug-in, the preference file is named Color Finesse 2 UI Preferences.plist. For the standalone Color Finesse SD or HD+ the preference file is named Color Finesse 2 Preferences.plist. Locate the preference file for the version of Color Finesse you are using. If you use both versions you will need to edit both files.

Open the preference file in an application which allows editing of .plist files. If you have the developer tools installed on your system, you can use Property List Editor. Otherwise you can use an editor like BBEdit or OmniOutliner. If you are unsure about what application to use, try simply double-clicking on the preference file.

If you are using Property List Editor, twirl open the Root item and then locate the key "Control Surface Port", which will have a value of 23. Double-click on the value and change it to the TCP port you wish to use. Save the preference file.

If you are using an editor like BBEdit, you are looking for the lines:

<key>Control Surface Port</key>
<integer>23</integer>

Change only the value after <integer>, setting it to the desired port number. Save the file.

Once you have changed the port number in both the Colorociter and in the Color Finesse preferences, start Color Finesse and the Colorociter should initialize, using the specified port.

If Color Finesse is unable to communicate with the Colorociter for some reason, there may be a delay of 2-3 minutes while the connection attempt times out. (This lengthy "hang" is imposed by the operating system, not Color Finesse.) For tips on troubleshooting a communications problem, see the Knowledge Base article Colorociter CS-1 with Ethernet Interface is Not Responding.

 


Related Documents

Colorociter CS-1 Colorists Control Surface Users Guide


Home | Products | Ordering | Downloads | Support | Resellers | Tips & Articles
About Us | What's New | Press Room | User Forum | Register a Product

Copyright © 1996-2007, Synthetic Aperture. All rights reserved. Color Finesse is a registered trademark, and Synthetic Aperture, Video Finesse, Echo Fire, Test Gear, Test Pattern Maker, Colorociter, and LiveFire are trademarks of Synthetic Aperture. All other trademarks are the property of their respective owners. Comments, corrections, and suggestions should be sent via our feedback form.

This page was last updated Sunday, January 28, 2007.