DC++ 0.24 Readme
--------------------------------------------------
DC++
Copyright (C) 2001-2003 Jacek Sieka,
[email protected]
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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
--------------------------------------------------
This Readme will give you a quick startup guide and explain some features
that are NOT obvious :)
So this is especially for NMDC upgraders.
Newbies should (also) check out the web site, http://dcplusplus.sourceforge.net
There you can also find a FAQ (Frequenty Asked Questions) and a forum
(http://dcplusplus.sf.net/forum).
Contents
--------
1 Installation
2 Upgrade
3 Uninstall
4 Available commands (type in main chat or pm)
5 What do those Icons mean ??
6 Not-so-obvious options
7 Other things you might want to know about
8 Shortcuts
9 Further information
10 Have fun
1 Installation
---------------
Just run the installer and fire it up, then enter the settings to set it up according to your
preferences (most important is nick, download location and shared folders).
version without installer available at http://sourceforge.net/projects/dcplusplus
2 Upgrade
----------
If u used NMDC: You can import your queue file now !
If u used older DC++ version:
Just install in the folder your old version was in.
Your old settings will still be there as is your queue.
BEWARE: Old (ver <= 0.163) Notepad notes will get lost, format change in 0.17
BEWARE: If you upgrade to 0.22, all old queue items that are missing a directory in the
target file-name will be removed. Don't upgrade if your queue is precious to you, and you didn't have
anything in the default download directory box in the settings (finish it with version 0.181
or edit your queue.xml file and add a directory to all targets without...).
3 Uninstall
------------
There is an uninstaller as well ...
If you didn't use the installer: Just delete the folder, there are no .dll's or registry settings :)
4 Available commands (type in main chat or pm)
----------------------------------------
/grant grants a slot to the user of the pm window you type in
/close close current window
/help short help message
/refresh Refreshes list of shared files :)
/away <message> Specifies a message to auto-respond in PM's while you're AFK
(there's a default message so you don't need to specify one)
/back Turn away message off
/slots <#> Changes number of slots to <#>
/clear Clears the main chat windows
/ts Switches timestamps in chat windows on and off
/showjoins Toggles joins/parts messages for the current hub
/search <string> Searches for <string>
/join <hub> Joins <hub>
/dc++ Gives a comment about DC++ and shows the URL where
you can get it
/fav /favorite Adds hub to favourites (also works in pm's from that user)
5 What do those Icons mean ??
-----------------------------
green = normal Icon
blue = DC++ user (identified on 1st direct connection to this user)
with bricks = User is in passive mode
with key = User is an Operator
6 Not-so-obvious options
------------------------
Settings:
General:
Active: The usual connection mode, you can specify your IP
if detection fails and a port of your choice if you need to.
This mode will use a random port between 1025 and 32000
chosen anew on restart if nothing is set in settings.
Passive: Compatibility connection mode for users behind
Firewalls they can't change to let DC++
connections trough.
Only use this if Active is not working.
Note: Passive <-> Passive connections aren't possible.
Downloads:
Unfinished files temporary directory: You can specify a Directory for your
partial files here, suggestion si to have it on another
partition than the "Default download directory" to have
the files defragmented through moving there :)
Download slots: Maximum number of Downloads runing at once, suggestion
is to set it to the same number as your upload slots
Sharing:
Upload slots: The number of maximum simultaneous uploads, set to a reasonable
value; you should have at least 4-5 KB/s uplaod speed per slot.
Appearance:
Use system icons: Displays the icons set in Windows for filetypes
Language File: A XML-file containing most of the text used in DC++.
You can specify a file to have DC++ in your favourite language.
There's an example.xml if you want to make your own.
Language files available at http://DCPlusPlus.sourceforge.net
Logs and Sound:
Log Downloads: You can use this feature to see what downloads
completed while you were AFK :)
Parameters for the logging (the things in %[xxx]):
target target filename (for downloads)
source source filename (for uploads)
user nick
hub hub name
hubip hub ip
size size of the file
sizeshort size in b/kB/MB/GB (short version)
chunksize size downloaded this session (if resuming, otherwise the same as size)
chunksizeshort ...
speed speed of download
time time to download (hh:mm:ss format)
sfv 1 if the file was sfv/crc32 checked, 0 otherwise
You can also use all date and time parameters (%Y, %m, ...) of strftime (google for it).
Advanced:
Rollback: Size of bytes to rollback when resuming a file to
ensure it contains no errors.
If there is an error DC++ deletes <rollback>
bytes and checks again.
Write buffer size: Anti-fragmentation feature, DC++ saves every
<write buffer size> bytes to keep fragmentation low.
Client version: Since most hubs specify a min client version that
is much higher than DC++'s real version number you
can set something here, i suggest adding 1 to version
number e.g. 1.181
to be able to enter the hub.
Automatically search for alternate download locations: Allows DC++ to try
to find other locations to download your files.
Useful if you're AFK a lot.
Install URL handler on startup: Set if you want URLS of type dchub://
to open in DC++
Use small send buffer: If uploads slow down your downloads A LOT you may
try this option, but beware it increases HD usage and
slows down upload, so it's not suggested.
Enable SFV checking: Many dow