a56bedc9 |
1 | Dolda Connect - README |
2 | |
3 | Introduction |
4 | |
5 | Dolda Connect is a peer-to-peer file sharing program, designed around |
6 | the Direct Connect protocol. It is written in a fashion that is |
7 | intended for flexibility and easy extension. It currently only |
8 | supports the normal Direct Connect protocol, but support is also |
9 | planned for the ADC protocol, and it can most likely be made to |
10 | support a great deal of other file sharing protocols as well. |
11 | |
12 | Extensibility |
13 | |
14 | Dolda Connect is built around a client-server model, in the way that |
15 | there is a server (daemon) program carrying out all the actual |
16 | file-sharing work, and a number of client programs that connect to the |
17 | server in order to command it and display its status. The interaction |
18 | between the client and server is carried out using a well-defined |
19 | protocol, making it fairly easy to write new clients for specialized |
eba5d7d1 |
20 | tasks. It is worthy of note that the default configuration file |
21 | disables running clients over the network, for convenience of |
22 | setup. See the INSTALL file for details and instructions on how to |
23 | enabled networked clients. |
a56bedc9 |
24 | |
25 | To make it easier to write new clients, a C library has been written |
26 | to make common functions easier, such as connecting, authenticating, |
27 | sending requests and parsing the responses. The C library also has a |
28 | wrapper module for GNU Guile, so that clients can be written in |
a5b603ac |
29 | Scheme. As of 0.3, there is also a Python module available seperately. |
a56bedc9 |
30 | |
31 | None of these are documented (yet), but there are a number of examples |
32 | scattered around the source tree, so it should not be awfully hard to |
33 | figure out how to do simple things. If in doubt, just contact the |
34 | author. |
35 | |
36 | Clients |
37 | |
397aee1a |
38 | So far, the following clients are distributed along with the source |
a56bedc9 |
39 | tree: |
40 | |
41 | * A Gtk2 based GUI, which loosely resembles a normal Direct Connect |
42 | client program. |
43 | * A GNOME panel applet for showing the status of current downloads in |
44 | progress. |
45 | * A Gaim chat plugin for chatting in hubs and writing private |
416ada5c |
46 | messages (only for Gaim 2.0.0 and above). |
a56bedc9 |
47 | * A command-line automatic downloader written in Scheme. |
48 | * A chat logger written in Scheme. |
a5b603ac |
49 | * A hub manager written in Scheme. |
a56bedc9 |
50 | |
51 | The GNOME applet and Gaim plugin are somewhat experimental. The applet |
52 | seems to be working well, but the installation have some quirks (since |
53 | GNOME does not normally look in /usr/local, care must be taken with |
416ada5c |
54 | the installation prefix). The Gaim plugin seems to be leaking some |
55 | memory. |
a56bedc9 |
56 | |
57 | Installation |
58 | |
59 | See the INSTALL file. |
60 | |
4e75a4ae |
61 | Documentation |
62 | |
63 | Documentation is still spotty at best. For any information not found |
64 | in the README or INSTALL files (or the source code, if you are a |
65 | programmer), contact the author. |
66 | |
a56bedc9 |
67 | Credits |
68 | |
69 | Dolda Connect is primarily written by Fredrik Tolf. He can be reached |
70 | through the e-mail address <fredrik@dolda2000.com>. His homepage is |
71 | <http://www.dolda2000.com/~fredrik/>. |
72 | |
73 | |
74 | |
416ada5c |
75 | This documented was last updated 2007-04-11, reflecting release 0.3 of |
a56bedc9 |
76 | Dolda Connect. |