microdc is a command-line based Direct Connect client written in C by Oskar Liljeblad and designed to compile and run on modern POSIX compatible systems such as Linux.

After releasing microdc 0.12.0 I've renamed the project to microdc2 on Oskar's request.

microdc2 available from this site is the future improvement of the microdc based on Oskar's code version 0.11.0.

Features

In addition to features available in the microdc 0.11.0 this version provides the following new options:

News

Download

The latest version of microdc2 is 0.15.6, which was released on 2006-12-24:

Latest source code tarball (microdc2-0.15.6.tar.gz)

The previous versions of microdc2 are available in the archive:

Previous source code tarballs

Copyright and License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

The source code of this project may contain files from other projects, and files generated by other projects, including:

Such files are licensed under the terms of the GNU General Public License or a license compatible with the GNU GPL (as listed on http://www.gnu.org/licenses/license-list.html). See each file for copyright details.

The translations in the po directory may contain translations from other projects, including:

See the specific message file (PO file) for copyright of those messages.

Requirements

The following programs are required to build microdc2:

GNU C Compiler (gcc), version 3.0 or later

microdc2 makes use of some gcc 3.x features such as declarations in the middle of a block and always inlined functions. The GNU C Compiler is part of the GNU Compiler Collection which can be downloaded from http://gcc.gnu.org/. In Debian and many other distributions the package is called gcc.
make, a modern implementation

The make program is required to build microdc2. microdc2 uses Makefiles generated by GNU Automake. The recommended make is GNU Make which can be downloaded from http://www.gnu.org/software/make/. In Debian and many other distributions the package is called make.

The following libraries are required to run microdc2:

GNU Readline Library, version 4.0 or later

microdc2 uses Readline for user input. GNU Readline can be downloaded from http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html. Libraries such as libedit and libeditline do not support the necessary completion features of GNU Readline, and can as such not be used with microdc2. In Debian woody the required package is libreadline4 (libreadline4-dev during build). In testing and later, the recommended package is libreadline5 (and libreadline5-dev when building).
libxml2, version 5.6.16 or later

microdc2 uses libxml2 to generate filelist. libxml2 can be downloaded from http://xmlsoft.org/downloads.html.

Building

To build the microdc2 executable, simply run

./configure
make

If you want to install microdc2 on your system, run make install. This will copy the executable, manual page and locale files to the appropriate directories.

For more information regarding configure and make, see the INSTALL document.

Usage and Customization

microdc2

microdc2 is usually started like this:

microdc2

(Some command line options are available - run microdc2 --help to get a list.) Once started, a prompt is displayed and microdc2 is ready for your command. You can get a list of commands by pressing tab on the empty prompt or by issuing the help command. The help command can also be used to get information on a specific command:

help exit

microdc_tth

Note: starting from microdc2 0.13.0 release the microdc_tth program is not built by default. It is unnecessary due to availability of the TTH calculation within microdc2 itself.

microdc_tth is an application that can be used to maintain TTH hashes for shared files. It is usually started like this:

microdc_tth /my/share/dir

It creates .microdc_tth folder in the each subdirectory and puts the TTH hash to this folder. The XML file list contains only files with existing TTH files.