One search box, several networks
The Search tab takes the same search expressions as classic eMule, and sends them to whichever network you pick under Method: an eD2K server, every server in your list, the Kad network, your Usenet indexers, or a server’s catalogue of Usenet releases, torrents and web links. Each search opens its own result tab, and the tabs come back after a restart.
Choosing a network
| Method | Who answers |
|---|---|
| Automatic | Picks Kad or your eD2K server for you, the way classic eMule does. Kad when only Kad is connected, the server when only the server is. With both, Kad, unless your server is a static one or a large, real server in a short server list. |
| Ed2k Server | The server you are connected to. Fast, and as good as that server’s file index. |
| Ed2k Global | Your server first, then every other server in your list, one after another. |
| Kad Network | The serverless Kademlia network. No server needed, only a Kad connection. |
| Usenet (Indexer) | The newznab indexers you set up under Options → Indexers, all at once. See Usenet. |
| Usenet (Server), Torrent (Server), Web (Server) | The catalogue an eD2K server keeps of Usenet releases, torrents, or files and link lists found on web pages. No indexer account needed. |
Automatic only ever chooses between the server and Kad, which cost nothing to ask. An indexer search uses up a quota you pay for and hands your words to a third party, so it is always your explicit choice.
Searching servers
Ed2k Server asks the server you are connected to, over its TCP connection. When it has more results than fit in one answer, the More button, or scrolling to the end of the list, asks for the next batch.
Ed2k Global asks your own server first. Once it has answered, or after 50 seconds, the other servers in your server list are asked over UDP, one every 0.75 seconds. That is the pace classic eMule keeps, so a large server list never floods anyone. Starting a new eD2K search stops the old sweep. A Kad or Usenet search does not.
Searching Kad
Kad has no server that holds an index. Each word is stored on the nodes closest to its hash, so a Kad search looks up one word (the keyword) and the nodes that hold it filter by the rest of your expression before they answer.
- The keyword is the first word every result must contain, and it needs at least 3 characters. In
@size>100 matrix -1080pthe keyword ismatrix. A word you exclude, a word inside anOR, and an attribute are never the keyword. - So at least one plain word must stand outside an
OR.matrix OR reloadedis refused on Kad;matrix (reloaded OR revolutions)works. - If that keyword is already being searched, the next eligible word is used.
Results from other networks
Some eD2K servers answer a normal search with results they found elsewhere too: Usenet releases, torrents, Kad files and web links. Four check boxes under the search box, Usenet results, Kad results, Torrent results and Web results, show or hide those rows without searching again. A Usenet result downloads through the Usenet engine. A torrent result gives you its .torrent file or its magnet link. A web result lists the links it holds.
Search expressions
Everything below works for server and Kad searches, exactly as in classic eMule.
Words and operators
| Type this | Finds |
|---|---|
matrix reloaded |
names with both words (a space means AND) |
matrix AND reloaded |
the same, written out |
matrix OR reloaded |
names with either word |
matrix -1080p |
matrix, but not names containing 1080p |
matrix NOT 1080p |
the same as -1080p |
"matrix reloaded" |
the quoted phrase as one term |
matrix (dvdrip OR bdrip) |
parentheses group terms |
AND,ORandNOTmust be written in capitals. A lower-caseoris an ordinary word.- A
-excludes only at the start of a word:spider-manis one word. -andNOTneed a word in front of them.matrix -1080pworks,-1080p matrixis an error.- Exclude several words with
matrix -1080p -720p -cam, or a phrase withmatrix -"director cut". NOTbinds tightest, thenOR, thenAND.a b OR cmeansa AND (b OR c), anda OR b -cmeansa OR (b NOT c). Add parentheses when in doubt.- A search can have at most 10 operators, counting the spaces between words. More gives “Expression too complex”.
Attributes
Attributes filter on what the network knows about a file. Their names can be cut to three letters: @siz, @ava.
| Attribute | Compare with | Value |
|---|---|---|
@size |
= > < >= <= <> |
a number with a B, K, M or G suffix (1024-based). No suffix means MB: @size>700 is over 700 MB. |
@type |
= |
audio, video, image, document, program, archive, iso |
@ext |
= |
the file extension: @ext=mkv |
@sources, @availability |
= > < >= <= <> |
the number of sources, with a k or m suffix (1000-based) |
@complete |
= > < >= <= <> |
the number of complete sources |
@rating |
= > < >= <= <> |
the rating |
@bitrate |
= > < >= <= <> |
kbit/s: @bitrate>=192 |
@length |
= > < >= <= <> |
seconds, an s, m or h suffix, or m:ss and h:mm:ss: @length>1:30:00 |
@codec |
= |
@codec=h264 |
@title, @album, @artist |
= |
the media tag, quoted if it has spaces: @artist="pink floyd" |
For example:
matrix -1080p @size>700 @type=video
"pink floyd" @type=audio @bitrate>=256
linux iso @size>=4G @sources>10
Attributes combine like any other term, so they can be excluded too: matrix -@ext=avi. Not every server supports every attribute, and one that does not may ignore it.
An ed2k://|file|…|/ link pasted on its own searches for exactly that file.
When something is wrong
A mistake is reported before anything is sent, with the same messages as classic eMule, in your language: “Missing right side for NOT operator”, “Missing closing ‘)’”, “Unterminated string”, “Unknown search attribute ‘@foo’”, “Syntax error in ‘@size’ search attribute”, and on Kad “Keyword too short”.