Synergy – share input between multiple machines : Ubuntu (6.06.1 / 6.10)

By | 2006/11/18

I’ve been using synergy for quite some time now. It allows you to share a single input (ie; mouse & keyboard) between multiple machines without the need for any type of switches or extra hardware.  Everything is done over the network.  This is great for situations where you might have two local desktops or, in my situation, where I bring my laptop into the office and then share the desktop keyboard and mouse between the two machines.  To setup synergy follow the steps below (this outlines steps for an all ubuntu network, or a mixed ubuntu and XP network.)

Installing Synergy

  • sudo aptitude install synergy (ubuntu machine)
  • Download Synergy (windows machine)

Configuring Synergy
After you have Synergy installed you simply need to configure the screens that you’d like to use.  Configuring synergy is fairly simple once you get an idea of how it works. Below is an example synergy.conf file that I use on my network. You should be able to pretty easily figure out your configuration based on that.

section: screens




section: links


left = notebook

right = silverbox


Let me break this down for you. The first half of this is the “section: screens” which defines the screens you want to use. You need to use the hostnames of your networked machines in this area. As you can see one of my screens is notebook, for my laptop, and the other is silverbox, for my desktop machine.

The second half is the “section: links” which maps where each screen should display. From the example you can see that to the left of silverbox is notebook and to the right of notebook is silverbox. Basically repeat this layout for all machines that you want setup. I have setup five machines on one network. Basically list the screens (hostnames) and then map where each screen shows on that map and you’re done. You can use right, left, up and down for your directional mapping. Pretty simple.

The windows setup is a little more complicated and I’m not sure I can explain it without screenshots (which I don’t have). If you’re using synergy with XP as the server you’re outside of the reach of this post. A simpler method might be to use Ubuntu as the host and simply click the option in synergy for XP “use another machines input: ” and enter the hostname or IP address there.

Running Synergy
Running Synergy is pretty simple as well. Based on your map (above), which is saved as synergy.conf on the “server” or “host” machine, you can easily get things going. Below are the commands for starting the server and the client.

Synergy Server
synergys –config .synergy.conf

Synergy Client

synergyc <>

Note the synergyS for server and synergyC for client.

Synergy Autostart

Once you get things setup the way you’d like you can simply add the appropriate command to your System > Preferences > Sessions > Startup Programs and it’ll auto load & connect each time you log into your profile.


technorati tags:, , , ,

4 thoughts on “Synergy – share input between multiple machines : Ubuntu (6.06.1 / 6.10)

  1. Pingback: Update: Securing Synergy Over The Wire : Ubuntu Tutorials : Breezy - Dapper - Edgy - Feisty

  2. Pingback: Ubuntu | Christer Edwards: Update: Securing Synergy Over The Wire

  3. Mark Harrison

    Thanks for this. I did what you said, and basically it all “just worked” (though, TBH, I used the Windows software to configure the server rather than editing the files on the Linux one.)

    Fantastic – I now have this very surreal setup… Windows XP on the laptop screen… to the right, Ubuntu 7.10 running full-screen on an external monitor on the laptop, in Windows Virtual PC… to the left, Ubuntu 7.04 running on another PC, with just the monitor visible, hooked up with Synergy.


Comments are closed.