asynergyc 1.0 - Synergy client for AmigaOS 3
============================================
Use the keyboard and mouse of your PC, Mac or Linux box on your Amiga,
over the network. Move the pointer off the edge of the PC screen and it
appears on the Amiga; type, click, scroll and copy text as if the Amiga
had its own keyboard attached. No hardware, no switch box, no second
desk.
Based on Douglas McLaughlin's AmigaOS 4 client: the protocol handling
and the key translation tables are his work. The entire system layer
was rewritten for AmigaOS 3, the original being built on a C++ class
library that exists only for AmigaOS 4, and the MUI interface is new.
WHAT IT DOES
------------
o Full mouse: movement, all three buttons, the wheel, and the fourth
button via the NewMouse convention.
o Full keyboard: qualifiers, dead keys, Caps Lock, Num Lock, the
numeric keypad, and the Amiga reset combinations.
o Bidirectional clipboard sharing of plain text, through the standard
Amiga clipboard in FTXT form. CR/LF from Windows servers is
converted on the way in.
o MUI window with settings, connection control and an event log.
Entirely optional: the client runs headless from the shell, with or
without MUI installed.
o Settings saved to ENV: and ENVARC:, read from tool types when
started from Workbench.
o Runs as a commodity: Show, Hide, Enable, Disable and Quit from
Exchange. The close gadget iconifies rather than quitting.
o Blanks the mouse pointer while the focus is on another machine and
restores it on return.
o Notices when the front screen changes resolution and tells the
server.
o Reconnects on its own if the server goes away, backing off up to
thirty seconds between attempts, without freezing the window.
REQUIREMENTS
------------
o AmigaOS 3.0 or later.
o A TCP/IP stack providing bsdsocket.library - AmiTCP, Miami, MiamiDx,
Genesis or Roadshow - running before the client is started.
o MUI 3.8 or later if you want the window.
o A Synergy server speaking protocol 1.3 or later on the other
machine. Tested against Synergy 3.6.3. Barrier, Input Leap,
Deskflow and any Synergy 1.x release also work.
o Encryption switched off on the server. This client speaks the
plain protocol and cannot negotiate TLS.
The Amiga is always the client. It cannot act as the server.
USAGE
-----
Started with no arguments, or from Workbench, it opens its window.
Given arguments, it runs headless:
asynergyc <synergy-host> <host-os> [screen-name] [debug] [pri=<n>]
[gui] [nogui] [connect] [noconnect]
asynergyc 192.168.1.2 windows
asynergyc 192.168.1.2 linux AMIGA
asynergyc noconnect
connect and noconnect override the saved "connect at startup" setting
for one run without changing it; noconnect on its own opens the window
and waits.
<host-os> is the operating system of the server - windows, linux or mac,
all lowercase - and decides how key codes are translated.
The screen name announced to the server must match a screen declared in
the server configuration; the event log shows which name was sent.
Synergy identifies clients by name, never by IP address. On recent
Synergy releases you will need to enable "config mode" to reach the text
configuration file and declare the Amiga there. Full details, including
a worked server configuration and a troubleshooting section, are in the
included AmigaGuide.
NOT IMPLEMENTED
---------------
Screen saver synchronisation, file drag and drop, clipboard formats
other than plain text, the fifth mouse button, a commodity hotkey, and
encryption.
Clipboard sharing has had the least testing of any feature. Reports
welcome.
DISTRIBUTION
------------
Emailware, as the original. If you find it useful, write and say so.
AmigaOS 3 client by Renaud Schweingruber, based on the AmigaOS 4 client
by Douglas McLaughlin, STR Programming Services.
Synergy itself is the work of Chris Schoeneman and, latterly, Symless.
This client is an independent implementation of the published protocol
and is not affiliated with them.
|