Main Forums Bugs FAQ Feature Requests Screen Shots Journal QS Manual Wiki
Which feature would you like to see next?
HTTP Support ( 240 )
TightVNC Support ( 2452 )
SSH Support ( 1999 )
New Interface ( 1164 )

How Can I Help?
Submit a patch.
Download and test.

The following people have help in one way or another:
Angela Antoniou, Mark Goodwin, Konrad Brunner, Steffen Menne, Nythil, Emeric Laroche and Sergey V. Udaltsov.


Beta 3.0.0 - Tue Nov 4 05:28:28 GMTST 2003

Welcome to the J2ME VNC Quick Start Manual. This document will lead you though a typical J2ME VNC experience. Highlighting the common errors made, and how to avoid them.


As well as this static page, a user-editable Wiki version has been set up. Should you wish to read user-coments and improvemnts on this QuickStart Manual, please check the Wiki version.


This document makes the following assumptions, 1) you know what VNC and J2ME are. 2) You can start a VNC server on your target computer, and can connect to it over the Internet.

Hardware Requirements

A J2ME enabled device, with socket support.

The Connection

The Connection Screen has two text boxes, and two check boxes. The host box takes the Internet address of the VNC server you are connecting to, for example: This may also take the display, or the port to connect to. NOTE: numbers less than 5900 are taken to be display numbers, numbers above are taken to be port number. This is the same as the desktop versions of VNC.
Next you have the Password. If you have password protected your VNC server (recommended).
The Shared Desktop check box, when ticked will let more than one VNC client connect to the server at one time.
Finally, we have Nokia Compatibility Mode, if you have a Nokia phone enable this, if not disable it.
Once this is all filled in, press the Connect command.

Quick Links

You can add Quick Links, which will save your host name, and password on the phone. To access it, you will select the new command with the title of the host name.


The status icon lives in the bottom right hand corner of the screen, when you have a The Refresh Icon refresh icon, this will show as the server sends the client new data.


This VNC client works using three modes, Navigation, Mouse and SMS.

Switching Modes

To switch modes select the Mode command, then in Entry radio selection select the required mode.

Mode Icons

To show the current mode, in the bottom right corner you have two icons The bottom icon is the status icon, as described above, above this is the mode icon. When it is blank, you are in Navigation mode, when you are in Mouse Mode you get the The Mouse Mode IconThe Mouse Mode Icon, and finally, when in SMS mode you get the The SMS Mode IconThe SMS Mode Icon.

Navigation (default)

As the mobile screen is almost always smaller than server screen, you need a method of navigating.

Arrow Keys + Fire

The arrow keys will move the screen. Each device uses a different style of arrow keys, the Nokia 7650 uses a small joystick like device, while Blackberry's have a wheel which act as up down and other keys for left right.
Fire does nothing in this mode.

The Numerical Keypad + Letter Keys

The letter keys and numerical key pad sends the literal to the server, i.e. 'a' will send 'a', '1' will send '1', and so for.

The Mouse Mode IconMouse

This mouse mode will let the use move the mouse about the screen.

Arrow Keys + Fire

The arrow keys move the mouse cursor. It starts at the top right of the servers screen. To quickly call the mouse to the centre of the currently displayed section, press the Call Mouse command.
If you press the Options command, you can change the amount the mouse moves from between 1 pixel, right up to 20 pixels.
The fire button will press the Right (or default) mouse button once. (single click), while the Game A button (see your phone documentation) will double click. If the Game A button is mapped to a character key, like hash or star the rule below will over ride it.
Fire press the primary mouse button, while secondary fire will double click.

The Numerical Keypad + Letter Keys

The letter keys and numerical key pad sends the literal to the server, i.e. 'a' will send 'a', '1' will send '1', and so for.

The SMS Mode IconSMS

The SMS mode will allow you to enter text quickly using a SMS style text entry. This does not use an identical key layout to the phone.

Arrow Keys + Fire

The arrow keys act as the cursor keys on a standard keyboard.

The Numerical Keypad + Letter Keys

The numerical keypad will act as an SMS keyboard. The key layout is as followed.

. !1

The Options Screen

The options screen allows you to customise the way J2ME VNC works.

Scroll X and Y

Changes the amount that you scroll in Navigation mode. This works in 1/5ths of the screen.

Mouse Move Amount

Changes the amount the mouse moves for each press of the direction buttons. Between 1 and 20 pixels.

Active Refresh

Will refresh the screen once every 3 seconds.

Local Cursor

Local cursor mode will stop the client sending cursor move requests (quicker, less data sent, so cheaper). Logo Valid XHTML 1.0! Valid CSS! Level Triple-A conformance icon, W3C-WAI Web Content Accessibility Guidelines 1.0 - The Source for Java Technology Donate to this project