User Tools

Site Tools


howto:synergy

Introduction

“Synergy lets you easily share a single mouse and keyboard between multiple computers with different operating systems, each with its own display, without special hardware. It's intended for users with multiple computers on their desk since each system uses its own monitor(s).

Redirecting the mouse and keyboard is as simple as moving the mouse off the edge of your screen. Synergy also merges the clipboards of all the systems into one, allowing cut-and-paste between systems. Furthermore, it synchronizes screen savers so they all start and stop together and, if screen locking is enabled, only one screen requires a password to unlock them all.” - from the synergy homepage

Synergy basically allows you to move the mouse off the side of your main desktop system and onto the eeepc, this lets you use your normal desktop mouse and keyboard, it works on both Linux, OSX and Windows (including a mixture of them).

Installing Synergy

Firstly you need to add either Xandros or Debian repositories to your eeePC.

Then you need to install synergy on the eeePC:

 sudo apt-get install synergy

Configuring Synergy

On your main desktop system you need to install synergy, on Debian based systems (such as Ubuntu) you can use the same command as above. Windows and OSX users can download the windows version from the SourceForge page.

Next you need to configure the server, the server runs on the system with the mouse and keyboard you want to share. Windows users have a GUI application for configuring synergy, you just need to tell it what screens you want (your eeepc and your main system) and which side of the screen leads to where. Linux users need to edit ~/.synergy.conf.

Here is a sample .synergy.conf that allows a desktop system with the hostname “desktopname” to control an eeepc with the hostname “eeepc-yourname” by moving left of the desktop system, you can probably use ip addresses instead of hostnames if you need to:


section: screens
eeepc-yourname:
desktopname:
end

section: links
eeepc-yourname:
right = desktopname
desktopname:
left = eeepc-yourname
end


Next you need to start the synergy server, first time around you probably want the -f flag which will stop the server backgrounding itself and let you check that everything is working ok, once it works you can drop it so it doesn't tie up a terminal:

 synergys -f

Now on the eeepc you need to start the synergy client, one again we are using the -f to allow us to check everything is working ok, you also need to give it the name of the server to connect to:

 synergyc -f desktopname

You might want to use the ip address of the server if you are setting the client to automatically run and your internet connection might not be active at first otherwise the client will attempt to resolve the hostname, will fail and won't try again, using the ip address will cause it to retry every few secconds.

See Also

http://en.wikipedia.org/wiki/Synergy_(software) - Wikipedia's article on Synergy
http://synergy2.sourceforge.net/ - The Synergy homepage

howto/synergy.txt · Last modified: 2007/12/19 13:55 by h3g3m0n