Click here to Skip to main content
15,861,172 members
Articles / Programming Languages / Java / Java SE / J2SE 5.0

Java Remote Desktop Administration

Rate me:
Please Sign up or sign in to vote.
4.96/5 (46 votes)
2 May 2009CPOL4 min read 261.8K   36.9K   47   78
Control And View Another Computer Remotely

Actual Client Desktop

client_screen_small.JPG

Remote Image of the Connected Client Desktop

connected_client_small.JPG

Introduction 

This program allows any computer to control other PCs remotely.   

Program Features

  • View remote desktop
  • Mouse movement control
  • Mouse buttons control
  • Keyboard control

Background  

One of the biggest challenges in this project is finding a way to move the mouse pointer, simulate key stroke and capture the screen. After spending some time I found a great class, Robot class that does all that I need.

In addition, using serialization to send screenshots from client to server and to send server events like mouse move, key press, key release  helped me a lot to write clean and simple code instead of sending images and events in raw data format over the network. 

Robot Class Methods 

  • mouseMove - Moves the mouse pointer to a set of specified absolute screen coordinates given in pixels
  • mousePress - Presses one of the buttons on the mouse
  • mouseRelease - Releases one of the buttons on the mouse
  • keyPress - Presses a specified key on the keyboard
  • keyRelease - Releases specified key on the keyboard
  • createScreenCapture - Takes a screenshot  

Program Parts    

1. RemoteServer 

This is the server part which waits for clients connections and per each connected client, a new frame appears showing the current client screen. When you move the mouse over the frame, this results in moving the mouse at the client side. The same happens when you right/left click mouse button or type a key while the frame is in focus.

2. RemoteClient  

This the client side, its core function is sending a screen shot of the client's desktop every predefined amount of time. Also it receives server commands such as "move the mouse command", then executes the command at the client's PC.  

Using the Code 

In order to run the program, you need to download RemoteServer_source.zip and RemoteClient_source.zip on two different PCs, then extract them. In one of the PCs say PC1, run RemoteServer.jar which is located under dist folder using the following command: 

>> java -jar  RemoteServer.jar 

You will be asked to enter port number for the server to listen at, enter any port number above 1024, for example 5000.   

On the other PC say PC2, execute RemoteClient.jar using the following command:  

>> java -jar RemoteClient.jar  

You will be asked to enter server IP, enter IP address of PC1, then you will be asked to enter port number, enter the same port you entered above, e.g. 5000. 

Now, in PC1 you have full control over PC2 including moving the mouse, clicking the mouse, keys stroking, viewing PC2 desktop, etc.  

Coding Structure    

RemoteServer

ServerInitiator  Class

This is the entry class which listens to server port and wait for clients connections. Also, it creates an essential part of the program GUI.

ClientHandler Class 

Per each connected client, there is an object of this class. It shows an InternalFrame per client and it receives clients' screen dimension.

ClientScreenReciever Class 

Receives captured screen from the client, then displays it.

ClientCommandsSender Class

It listens to the server commands, then sends them to the client. Server commands include mouse move, key stroke, mouse click, etc.

EnumCommands Class

Defines constants which are used to represent server commands.

RemoteClient   

ClientInitiator Class 

This is the entry class that starts the client instance. It establishes connection to the server and creates the client GUI.

ScreenSpyer Class  

Captures screen periodically and sends them to the server.

ServerDelegate Class   

Receives server commands and executes them in the client PC.

EnumCommands Class  

Defines constants which are used to represent server commands.   

Code Snippets

1) RemoteClient  

Connect to Server 
Java
 System.out.println("Connecting to server ..........");
 socket = new Socket(ip, port);
 System.out.println("Connection Established.");  
Capture Desktop Screen then Send it to the Server Periodically  

In ScreenSpyer class, Screen is captured using  createScreenCapture method in Robot class and it accepts a Rectangle object which carries screen dimension. If we try to send image object directly using serialization, it will fail because it does not implement Serializable interface. That is why we have to wrap it using the ImageIcon class as shown below:

Java
while(continueLoop){
            //Capture screen
            BufferedImage image = robot.createScreenCapture(rectangle);
            /* I have to wrap BufferedImage with ImageIcon because 
	     * BufferedImage class does not implement Serializable interface
             */
            ImageIcon imageIcon = new ImageIcon(image);

            //Send captured screen to the server
            try {
                System.out.println("before sending image");
                oos.writeObject(imageIcon);
                oos.reset(); //Clear ObjectOutputStream cache
                System.out.println("New screenshot sent");
            } catch (IOException ex) {
               ex.printStackTrace();
            }

            //wait for 100ms to reduce network traffic
            try{
                Thread.sleep(100);
            }catch(InterruptedException e){
                e.printStackTrace();
            }
        }
Receive Server Events then call Robot Class Methods to Execute these Events 
Java
while(continueLoop){
                //receive commands and respond accordingly
                System.out.println("Waiting for command");
                int command = scanner.nextInt();
                System.out.println("New command: " + command);
                switch(command){
                    case -1:
                        robot.mousePress(scanner.nextInt());
                    break;
                    case -2:
                        robot.mouseRelease(scanner.nextInt());
                    break;
                    case -3:
                        robot.keyPress(scanner.nextInt());
                    break;
                    case -4:
                        robot.keyRelease(scanner.nextInt());
                    break;
                    case -5:
                        robot.mouseMove(scanner.nextInt(), scanner.nextInt());
                    break;
                }
            }

2) RemoteServer

Wait for Clients Connections 
Java
//Listen to server port and accept clients connections
            while(true){
                Socket client = sc.accept();
                System.out.println("New client Connected to the server");
                //Per each client create a ClientHandler
                new ClientHandler(client,desktop);
            }
Receive Client Desktop Screenshots and Display them
Java
 while(continueLoop){
 //Receive client screenshot and resize it to the current panel size
  ImageIcon imageIcon = (ImageIcon) cObjectInputStream.readObject();
  System.out.println("New image received");
  Image image = imageIcon.getImage();
  image = image.getScaledInstance
	(cPanel.getWidth(),cPanel.getHeight(),Image.SCALE_FAST);
  //Draw the received screenshot
  Graphics graphics = cPanel.getGraphics();
  graphics.drawImage(image, 0, 0, cPanel.getWidth(),cPanel.getHeight(),cPanel);
}
Handle Mouse and Key Events then Send them to the Client Program to Simulate them 

In ClientCommandsSender class, when mouse is moved, x and y values are sent to the client but we have to take into consideration the size difference between clients' screen size and  server's panel size, that is why we have to multiply by a certain factor as shown in the following code: 

Java
public void mouseMoved(MouseEvent e) {
     double xScale = clientScreenDim.getWidth()/cPanel.getWidth();
     System.out.println("xScale: " + xScale);
     double yScale = clientScreenDim.getHeight()/cPanel.getHeight();
     System.out.println("yScale: " + yScale);
     System.out.println("Mouse Moved");
     writer.println(EnumCommands.MOVE_MOUSE.getAbbrev());
     writer.println((int)(e.getX() * xScale));
     writer.println((int)(e.getY() * yScale));
     writer.flush();
 }

 public void mousePressed(MouseEvent e) {
     System.out.println("Mouse Pressed");
     writer.println(EnumCommands.PRESS_MOUSE.getAbbrev());
     int button = e.getButton();
     int xButton = 16;
     if (button == 3) {
         xButton = 4;
     }
     writer.println(xButton);
     writer.flush();
 }

 public void mouseReleased(MouseEvent e) {
     System.out.println("Mouse Released");
     writer.println(EnumCommands.RELEASE_MOUSE.getAbbrev());
     int button = e.getButton();
     int xButton = 16;
     if (button == 3) {
         xButton = 4;
     }
     writer.println(xButton);
     writer.flush();
 }


 public void keyPressed(KeyEvent e) {
     System.out.println("Key Pressed");
     writer.println(EnumCommands.PRESS_KEY.getAbbrev());
     writer.println(e.getKeyCode());
     writer.flush();
 }

 public void keyReleased(KeyEvent e) {
     System.out.println("Mouse Released");
     writer.println(EnumCommands.RELEASE_KEY.getAbbrev());
     writer.println(e.getKeyCode());
     writer.flush();
 }

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer
Egypt Egypt
I have over 5 years of experience in the field of Sofware development and management.
My programming experience includes Java, ASP.Net, PHP, C# C, C++

Recently I'm working as a teaching assistant and team leader for PHP based projects.

Comments and Discussions

 
QuestionAsk Pin
Immanuel 202114-Jun-22 16:26
Immanuel 202114-Jun-22 16:26 
QuestionI get blank window only !!!! Pin
Member 1353754423-Nov-17 7:17
Member 1353754423-Nov-17 7:17 
QuestionExecution issue Pin
Member 1344800518-Nov-17 7:42
Member 1344800518-Nov-17 7:42 
QuestionRemote desktop administratation project Pin
Member 1317190817-May-17 2:26
Member 1317190817-May-17 2:26 
QuestionSAME JDK version but only white screen appearing Pin
Member 1312146011-Apr-17 5:59
Member 1312146011-Apr-17 5:59 
AnswerRe: SAME JDK version but only white screen appearing Pin
Amit Khurana11-Apr-17 8:15
Amit Khurana11-Apr-17 8:15 
Questionrun project Pin
Member 1294318428-Jan-17 0:18
Member 1294318428-Jan-17 0:18 
QuestionExecution Pin
Member 1286867524-Nov-16 2:57
Member 1286867524-Nov-16 2:57 
Question.jar works, but not with Netbeans Pin
Member 127052538-Sep-16 8:08
Member 127052538-Sep-16 8:08 
QuestionCan I have this code Pin
Member 1249317130-Apr-16 4:02
Member 1249317130-Apr-16 4:02 
Questionhw to execute it??plzz give full detail Pin
Ravi Vishwakarma19-Mar-16 19:57
Ravi Vishwakarma19-Mar-16 19:57 
QuestionAbout Licence Pin
Ichroman Raditya Duwila17-Oct-15 18:28
Ichroman Raditya Duwila17-Oct-15 18:28 
Questionregarding ip or connection Pin
Member 1153445322-Mar-15 20:45
Member 1153445322-Mar-15 20:45 
AnswerRe: regarding ip or connection Pin
Member 123110879-Feb-16 4:04
Member 123110879-Feb-16 4:04 
GeneralRe: regarding ip or connection Pin
Member 126247618-Jul-16 4:00
Member 126247618-Jul-16 4:00 
AnswerRe: regarding ip or connection Pin
Member 1294318428-Jan-17 0:13
Member 1294318428-Jan-17 0:13 
AnswerRe: regarding ip or connection Pin
ustcpingping1-Mar-18 15:59
ustcpingping1-Mar-18 15:59 
Questioncan't access another computer Pin
Member 1153445318-Mar-15 3:38
Member 1153445318-Mar-15 3:38 
QuestionRegarding the client service. Pin
Member 1145003713-Feb-15 2:14
Member 1145003713-Feb-15 2:14 
QuestionRegarding the client service. Pin
Member 1145003713-Feb-15 2:07
Member 1145003713-Feb-15 2:07 
Questionvoice nd video conferencing Pin
salman786ansari8-Jan-15 7:17
salman786ansari8-Jan-15 7:17 
Questionproblem in code Pin
Member 112726382-Dec-14 22:25
Member 112726382-Dec-14 22:25 
Questionthanks Pin
Member 111558121-Dec-14 7:30
Member 111558121-Dec-14 7:30 
GeneralThanks Pin
Member 102773089-Jul-14 23:16
Member 102773089-Jul-14 23:16 
GeneralRe: sir Pin
Member 110709279-Sep-14 19:58
Member 110709279-Sep-14 19:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.