Moccatroller Manual

Installing

This section will guide you through the installation of Moccatroller and the software required to run it.

1. Getting the Java Runtime Environment

The PC application

1. The Main Window

The first step in starting a Moccatroller session is to start the PC application. You will see a window that looks like this:

Let's go over it from top to bottom. The big button with coffee beans on it will take you to the profile configuration section, described below. To the right of that you will see the currently active profile.

Below the big button is a set of radio buttons, one for Bluetooth and the other for Internet. Which of these buttons is selected determines the type of connection the application waits for when you activate it (described later). If you select an Internet connection, the Port and Password fields become enabled, allowing you to change the port the program waits on and the password required to log in. There is no password for bluetooth connections.

Next you see the audio capture drop down. If you wish to hear audio on your phone you should select the audio input device to capture from. Some of the choices available may not work on your computer (for examples, the Primary device does not work for me). Some people (like me) may have to connect a cable from their audio output to their audio input on their soundcard in order to get captured audio.

1. The Profiles Window

A "Profile" describes a custom set of commands that can be used by pressing your phones numeric keys (1 to 9). Several other keys and mouse movements are available for every profile. The Profiles Window looks like this:

2. Managing Profiles

1. The Edit Window

The Edit Window allows you to customize what the numeric keys of your phone or PDA do. The Edit Window looks like this:

2. The Keys

At the top is the profile name which you can change to whatever you like. On the left of this window is a list of numbers from 1 to 9, representing the numeric keys on your phone or PDA. The panel of checkboxes and the drop-down box on the right reflects the action performed by pressing that key.

3. The Actions

The checkboxes tell whether a modifier key should be applied or not. The drop-down box defines the key to press along with those modifiers. If a key is not listed in the drop-down box, it can usually be accessed by checking the "Shift" checkbox along with the appropriate key (for example, Shift + 1 to get an exclamation mark).

The Mobile Application

1. Connecting

When you first start the MoccatrollerMobile application on your phone or PDA, you will be given a choice to connect to a Bluetooth server or Internet server. Choose the same one you chose when you started the PC application.

If you choose a Bluetooth connection, your phone will search for available servers and then let you choose one.

If you choose and internet connection, you will have to provide an internet address (or IP address), a port, and a password, all of them matching the server you started.

2. Control Modes

The MoccatrollerMobile application has two modes: Mouse Mode and Keyboard Mode. The program starts in Mouse Mode. In both modes, the "Selection" key (normally in between the arrows on the keypad) sends an Enter key. Also in both modes, the numbers 1 to 9 send the keys that have been set for the active profile in the PC application. The other keys send different values depending on the mode. Mouse Mode can be toggled on and off with the Zero (0) key.

3. Mouse Mode Keys

In Mouse Mode, the arrow keys move the mouse cursor on screen. The Star (*) key left-clicks the mouse and the Pound (#) key right-clicks.

4. Keyboard Mode Keys

In Keyboard Mode (Mouse Mode OFF), the arrow keys send keyboard arrow key codes to the active application on the PC. The Star (*) key sends a Tab and the Pound (#) sends an Escape key.

5. Options explained

There are a lot of options available from within the mobile application. Here is an explanation:

• Exit - Exits the application
• Size - Changes the size of the screen capture (default is no screen capture, so pressing this once will activate screen captures)
• FPS + - Increase the "Frames per second" that are sent to the phone. Be careful or you will easily choke your phone with too much bandwidth.
• FPS - - Decrease the framerate
• Color - Change the color depth of screen captures. The default mode is 4 bit color or 16 colors. The available modes are 1, 2, 4, and 8 bit color. 8 bit gives the best looking results but consumes the most bandwidth.
• Audio - Toggle audio on or off
• TV Mode - Toggle tv mode. TV mode syncs audio and video. Warning, while in TV mode, actions like moving the cursor around will be greatly delayed. It can take some time for this mode to take affect, so be patient.
• Cursor - Toggle the cursor crosshairs.

Putting it all together

Now that you know how all the components work, you can get started using the programs. First start the server on your PC, select a connection type and click the "Wait" button. Next, start the application on your phone and select the connection type. For bluetooth connections, select the computers name from the server list. For internet connections, enter the server URL or ip address and port number then click Ok. Now you're ready to start Mocca... or, rather, remote-controlling your PC!