summaryrefslogtreecommitdiff
path: root/noncore/comm/keypebble/README.html
Unidiff
Diffstat (limited to 'noncore/comm/keypebble/README.html') (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/comm/keypebble/README.html206
1 files changed, 206 insertions, 0 deletions
diff --git a/noncore/comm/keypebble/README.html b/noncore/comm/keypebble/README.html
new file mode 100644
index 0000000..def766b
--- a/dev/null
+++ b/noncore/comm/keypebble/README.html
@@ -0,0 +1,206 @@
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html>
3 <head>
4 <title>Keystone README</title>
5 </head>
6
7 <body>
8 <h1>Keystone README</h1>
9 <div align="justify"> <!-- #BeginEditable "Body" -->
10 <h3>Contents</h3>
11 <ul>
12 <li><a href="#whatisvnc">What is Keystone?</a></li>
13 <li><a href="#servers">Servers</a></li>
14 <li><a href="#status">Status</a></li>
15 <li><a href="#bugs">Bugs</a></li>
16 <li><a href="#download">Download</a></li>
17 <li><a href="#faq">FAQs</a></li>
18 <li><a href="#todo">Todo</a></li>
19 <li><a href="#credits">Credits</a></li>
20 <li><a href="#references">References</a></li>
21 </ul>
22 <h3><a name="whatiskvnc">What is Keystone?</a></h3>
23 <p>Keystone is a tool for <a href="http://www.kde.org/">KDE</a> that
24 allows you to remotely access the desktops of machines using the cross-platform
25 VNC system. Keystone can access machines running a variety of operating
26 systems (including most UNIX systems and Windows 95/98/NT/2000) providing
27 they are running a VNC server. Note that Keystone is only a client
28 program, you will need to download a server separately in order to
29 use it.</p>
30 <p>The protocol used by Keystone (called RFB) was developed, and released
31 as GPL by ORL (now the UK branch of AT&amp;T research), they also
32 wrote and maintain GPL servers for several platforms. You can find
33 both information about the protocol and links to servers for a range
34 of platforms on their <a href="http://www.uk.research.att.com/vnc/">website</a>.</p>
35 <p>Keystone started life as a port of Markus Wuebben's kvncviewer program
36 to KDE 2, but in the course porting the code, I have rewritten and
37 redesigned most of the system. The new implementation builds on several
38 new facilities that were not available in KDE 1, such as KPixmapIO
39 and QSocket. There is so little of the original code left that I have
40 decided on a name change, and to put the version number back to 0.1.</p>
41 <p>You can see a few screenshots of <a href="http://www.ipso-facto.demon.co.uk/keystone/screenshots.html">Keystone
42 in action</a> on my screenshots page. The screenshots may or may not
43 reflect the look of the current version as I have some look and feel
44 improvements planned.</p>
45 <h3><a name="servers">Servers</a></h3>
46 <p>Most Linux distributions include the standard Xvnc server (usually
47 run via the <i>vncserver</i> script), you can also download this and
48 servers for other platforms such as MS Windows from the <a href="http://www.uk.research.att.com/vnc/">VNC
49 website</a>. If you have a problem with setting up a server then you
50 should read the <a href="http://www.uk.research.att.com/vnc/faq.html">VNC
51 FAQ</a>, and if that does not help join the VNC mailing list. Do not
52 mail me on this topic - I can't help and won't even reply.</p>
53 <p>I may in future write a server that operates in the same manner as
54 the Win32 server for KDE. The Win32 server differs from the X11 server
55 in that it does not virtualise the entire desktop. This has both advantages
56 and disadvatages, it means that you can make an existing session available
57 over the network, but only allows you to run a single server. I may
58 also put a GUI together that makes it easy to configure the ORL server.</p>
59 <h3><a name="status">Status</a></h3>
60 <p><font color="#000000">The current version is 0.4, and the following
61 are now working:</font></p>
62 <p>
63 <ul>
64 <li><b>0.1</b>
65 <ul>
66 <li>Non-blocking socket handling</li>
67 <li>Authentication and logon</li>
68 <li>KDE 2 user interface</li>
69 <li>Raw and CopyRect encodings</li>
70 <li>Full screen mode</li>
71 <li>Grab keyboard mode</li>
72 <li>Graphics</li>
73 <li>Taking screenshots of the remote desktop</li>
74 <li>Event dispatching</li>
75 <li>Konqueror helper application support (you can run Keystone
76 by entering a vnc: URL anywhere in KDE).</li>
77 <li>Options, login, password and about dialogs</li>
78 </ul>
79 </li>
80 <li><b>0.2</b>
81 <ul>
82 <li>XSHM support using KPixmapIO</li>
83 <li>Now uses KXMLGUI (thanks to Kurt)</li>
84 <li>Tru64 patch from Tom Leitner</li>
85 <li>Status reporting improvements</li>
86 <li>Config handling fixed</li>
87 <li>Recent connections list implemented</li>
88 <li>Update frequency respected</li>
89 </ul>
90 </li>
91 <li><b>0.3 [KDE 2.0]</b>
92 <ul>
93 <li>Portability fixes for FreeBSD (and maybe others)</li>
94 </ul>
95 </li>
96 <li><b>0.4</b>
97 <ul>
98 <li>Icons for the full screen mode now reflect the current state</li>
99 <li>Added a toolbar (optional of course)</li>
100 <li>Added support for the clipboard (you can cut and paste between the
101 local and remote machines)</li>
102 <li>Added some what's this help to the options dialog</li>
103 </ul>
104 </li>
105 </ul>
106 <h3><a name="bugs">Bugs</a></h3>
107 <p>Version 0.4 contains the following known bugs:
108 <ul>
109 <li><b>Custom about dialog is not shown</b><br>
110 I can't see a clean way to fix this without creating a complete custom
111 help menu. For now I've left the standard about dialog in place.
112 </li>
113 <li><b>Crash when you connect to a non-existant server</b><br>
114 I can reproduce this every time, but I can't figure out what's wrong
115 other developers have reported similar problems and they seem to be
116 down to QSocket. The only known fix so far is to use KSocket instead.
117 I'd prefer to fix the problem at the source, but I'm having no luck and
118 I suspect QSocket may also be causing some other weird network issues
119 I've seen, so if I can't track down the bug soon I'll give in and switch
120 to KSocket like everyone else.
121 </li>
122 </ul>
123 </p>
124 <h3><a name="download"></a>Download</h3>
125 <p>Keystone is available in the kdenetwork module of the
126 <a href="http://www.kde.org/anoncvs.html">KDE CVS</a>, and
127 is included in the KDE 2.0 release. The current version is 0.4.
128 Note that Keystone <b>requires KDE 2</b>, you cannot use KDE 1.x.</p>
129 <h3><a name="faq"></a>FAQs</h3>
130 <p>
131 <ul>
132 <li><b>Why don't the shortcut keys work in full screen mode?</b><br>
133 When you're in full screen mode Keystone grabs the keyboard to send
134 every key press to the remote screen. This means that you can send key
135 combinations that are used by Keystone or KDE to the remote screen. If
136 you really hate it, then you can add -nograb to the command line
137 arguments to disable all keyboard grabs. I will add an option to allow
138 this behaviour to be overridden in a future release.
139 </li>
140 <li><b>Why is Keystone so slow?</b><br>
141 Currently only the simplest of the RFB encodings are supported, this
142 means that Keystone is only useful on fairly fast networks. This is
143 a serious bug and is being addressed.
144 </ul>
145 </p>
146 <h3><a name="todo">Todo</a></h3>
147 These are the things I'm hoping to add to future versions of Keystone.
148 They're vaguely sorted in order of importance.
149 <p>
150 <ul>
151 <li>RRE encoding.<br>
152 I've started this, but the implementation has some
153 bugs so it did not make the cut for Keystone 0.3.</li>
154 <li>CoRRE and Hextile encodings</li>
155 <li>Session management</li>
156 <li>Support for Windows Terminal Server.<br>
157 There is now a GPL implementation
158 of the protocol, and the author is happy for me to use the code. If someone
159 can offer me an account to test it on then this is possible.</li>
160 <li>Zoom support.<br>
161 This will be handled using the same protocol extension
162 as is used in the Palm client, this will allow you to make use of
163 server side scaling to reduce the amount of network traffic. You
164 will also be able to do client side zooms, but in this case the
165 full screen needs to transmitted over the network.</li>
166 <li>Macros</li>
167 <li>Monitor mode (thumbnails of several machines)</li>
168 <li>ZLib extension support</li>
169 <li>Bookmarks</li>
170 <li>URL specific settings</li>
171 <li>Possibly a DnD extension using a mechanism based on mulitpart
172 MIME attachments.</li>
173 </ul>
174 <h3>Credits<a name="credits"></a></h3>
175 <p>Keystone owes a lot to Markus Wuebben's kvncviewer which some of
176 the code is derived from. Thanks are also due to Espen Sand the author
177 of khexedit from which I borrowed some code for the about dialog.
178 Alison Burch drew the bridge image used in the background of this
179 page (and in future versions of Keystone too of course). Finally thanks
180 go to ORL for making the RFB protocol and servers GPL.</p>
181 <h3><a name="references">References</a><br>
182 </h3>
183 <p>
184 <ul>
185 <li>The Keystone homepage<br>
186 <a href="http://www.ipso-facto.demon.co.uk/keystone/">http://www.ipso-facto.demon.co.uk/keystone/</a></li>
187 <li>The VNC Homepage<br>
188 <a href="http://www.uk.research.att.com/vnc/">http://www.uk.research.att.com/vnc/</a></li>
189 <li>The VNC FAQ<br>
190 <a href="http://www.uk.research.att.com/vnc/faq.html">http://www.uk.research.att.com/vnc/faq.html</a></li>
191 <li>The KDE Homepage<br>
192 <a href="http://www.kde.org/">http://www.kde.org/</a> </li>
193 </ul>
194 <p></p>
195 <!-- #EndEditable --> </div>
196
197
198
199 <hr>
200 <address><a href="mailto:rich@kde.org">Richard Moore</a></address>
201<!-- Created: Tue Dec 5 01:35:56 GMT 2000 -->
202<!-- hhmts start -->
203Last modified: Tue Dec 5 01:37:17 GMT 2000
204<!-- hhmts end -->
205 </body>
206</html>