The Search window allows searching for files inside the shares of on-line
users. You can search for one or more keywords and optionally use filters as
described below. When your search query is ready, press the Search button to
send out the search request to the hub(s) you are connected to; these hubs
will then forward the search request to all of their connected users.
When a client matches a search request, it sends the results back to the
requester. These results then show up in the search results list of the
You can open several independent Search windows and define different search
arguments in each, thus allowing you to process multiple searches
simultaneously. Be careful though, it sometimes happens that search results
show up in the wrong window (this is a deficiency of the NMDC protocol, and
should never happen with ADC hubs).
Note that search requests are sent out only once, when the Search button
is pressed. After that - until that button is pressed again - the sole
purpose of the Search window is to show results received by DC++ that:
either match the search query (NMDC); or match the search ID (ADC).
(This means that users who have logged in after you pressed the
Search button won't send you any search result unless you repeat the
You may not start or repeat searches as fast as you like. There is a minimum
interval of a few seconds between two searches defined in DC++. You will get
a countdown message in the Status bar if you try to search sooner than
allowed and will be able to repeat the search only when the client is ready
to search again. Besides, some hubs also limit searches by checking for
forbidden keywords or by blocking repeated similar searches sent in a too
small amount of time. Some hubs have predefined minimum search intervals for
all searches or some even totally block searches if you are in passive mode.
Search hits with TTH are always matched to the Download queue and new
sources are automatically added to the queue items unless they were removed
or marked as "bad" sources before. The filelists of all newly discovered
sources will be automatically matched for possible other queued files if the
Automatically match queue for search hits setting is
enabled. Activating that option can generate lots of filelist traffic when
large amount of new sources are found for queued files.
Search results with identical hashes are grouped under the same entry. A
merged entry can be respectively expanded and collapsed using the [+] and
[-] glyphs on the left or with the right and left arrow keys were one to
want to peek at the various results received for the same file.
If you often get too few search results or no results at all, refer to the
Search troubleshooting FAQ.
Search options (left)
- Search for
- This is the set of search strings to search for. Words beginning with "-"
will be filtered away.
- Clear the contents of the search history.
- Start searching for the set of search strings defined above. Note; you may
not start too many searches in a small amount of time.
- Filter away files depending on their file size.
- File type
- Filter away results depending on their file type (extension) or hash value.
Note: options that specify a certain file type (other than Any,
Directory & TTH) will work different on ADC and NMDC hubs
- In NMDC hubs : not all possible extensions are included in some file type
groups. If you search for newer or obscure file types then it is recommended
to use the Any option here and include the desired file extension(s)
in the search string instead.
- In ADC hubs : all file type groups will filter results using the
corresponding configured Search Types setting.
- Only users with free slots
- Filter away files depending on the user's free slots.
- Hide files already in share
- Filter away files that are already in share.
- Search only selected hubs.
Results list (right)
- The file name.
- The amount of results received for the same file. Multiple identical results
are grouped together; they may be expanded with the [+] sign or by pressing
the right arrow key.
- The user's nick name.
- The file's extension (file type).
- The file's size.
- x/y: x slots available of a total y.
- The path in the user's file list where the file is stored.
- The user's possible line speed in upload.
- In which hub the user is in.
- Exact size
- The exact size of the file.
- The user's IP.
- TTH root
- The TTH root for the file.
- The unique ID that DC++ use to identify other users.
Context menu commands
- Adds the selected file(s) or director(ies) to the Download Queue. They will
be downloaded to the Default download directory.
- Download to...
- Adds the selected file(s) or director(ies) to the Download Queue. The
download target can be selected using the submenu elements : either a
predefined place from the Download Favorites or any other
folder specified using the Browse... submenu.
- Download whole directory
- If one or more files selected from the same folder it will add the whole
folder to the Download Queue.
- Download whole directory to...
- Combines the function of Download to... and Download whole
- View as text
It downloads the selected file to the temporary folder of the operating
system and opens its contents in a text viewer window. The file will be
deleted right after its contents shown.
This function is useful for previewing small text based info files as they
may contain more information about other files in the same folder. Note
that only plain text files will be shown correctly. For files of other
format you must download and open them with their respective viewer
application. You can open downloaded files from the Finished
downloads window using the Open menu command.
- Search for alternates
- Will open a new Search window to search for alternate
sources for the selected file.
- Lookup TTH at Bitzi.com
- Will trigger the default browser to lookup the TTH of the selected file at
- Copy magnet link to clipboard
- Will copy the file's magnet link to the clipboard.
- Get file list
- Download the file list of the selected users.
- Browse file list
- Download only the required pieces of the file lists of the selected users in
form of a partial file list. Note that you may not able to fully exploit
certain file list functions in a partial list window until you get the whole
list using the "Download full list" button.
- Match queue
- Matches the files in your download queue to the file lists of the selected
users. 2 files are considered to be the same if their TTH is the same. If
matches are found in one user's file list, she will be added as a source for
the relevant downloads.
- Send private message
- Open Private Message windows to chat privately with the selected users.
- Grant extra slot
- In addition to your regular upload slots, an extra upload slot will be given
to the selected users until the end of the current DC++ session.
- Remove user from queue
- Remove the selected users from the source list of all queued files. Pending
file list requests will be removed as well.
- Ignore chat
- Add user matching definitions (or modify existing ones, if possible) to
ignore chat messages from the selected users.
- Un-ignore chat
- Add user matching definitions (or modify existing ones, if possible) to stop
ignoring chat messages from the selected users.
- Copy user information
- Copy a few lines containing user information to the clipboard. The data may
include: the user's nick(s), her hub address(es), her IP, country, email,
CID (not exhaustive). When multiple users are selected, each user
information blob is separated with a blank line.
- Add to favorites
- Adds the selected users to your Favorite Users list.
- Deletes the actual item from the list. If the corresponding setting in Confirm dialog options is enabled, you will be prompted before
- Remove all
- Deletes all the selected items from the list. If the corresponding setting
in Confirm dialog options is enabled, you will be prompted
before the removal.
- Allows copying the content of any column to the clipboard. An "All
command is available as well to gather all the columns in the
copied text (one column per
Filter search results
These controls allow filtering current search results in order to only see
The filter, consisting of an input box, a column selection box and a method
selection box, can help filter the list on the fly based on textual
matching. You can filter the contents of any individual column or the whole
list. There are three filtering methods available to choose from: excact
word match, partial word match or match a regular
. Note that filtered results are not removed from the list;
they can at any time be restored by just clearing the filter out.
The filter input box can be focused with Alt+I.
Eg selecting "File" in the drop down, and writing "foo" in the filter, will
only display results that have "foo" in their file name. When a filter is in
effect, the "Items" part of the status bar is updated to reflect it.
- +/- checkbox
- Show or hide the search options group (left side of the search window).
- X items or C / N items
- Either the total amount of search results applicable to the running search
query, if none has been filtered away after applying the "Filter search
results" filter ("X items" format), or the current amount of items that are
displayed in the list after applying the filter out of the total amount of
search results ("C / N items" format).
- # dropped
- The amount of search results that have been received but do not satisfy the
running search query.