Difference between revisions of "Usage Searches"

From AMule Project FAQ
Jump to: navigation, search
m (Typo)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<center>
 +
'''English''' |
 +
[[Usage_Searches-fr|Fran&ccedil;ais]]
 +
</center>
 +
 
[[Usage aMule|Back to Index]]
 
[[Usage aMule|Back to Index]]
  
 
== Description ==
 
== Description ==
 
 
From this window you can search for files on the eD2k and Kademlia network and add them to your download queue.
 
From this window you can search for files on the eD2k and Kademlia network and add them to your download queue.
  
 
== Usage ==
 
== Usage ==
 
 
=== Main ===
 
=== Main ===
 
 
This is how a bare search window looks:
 
This is how a bare search window looks:
  
Line 24: Line 26:
  
 
=== Basic searching ===
 
=== Basic searching ===
 
 
==== Begin a search ====
 
==== Begin a search ====
 
 
To begin a search, type on the '''Name''' box the text you want to find and then click on the '''Start''' button:
 
To begin a search, type on the '''Name''' box the text you want to find and then click on the '''Start''' button:
  
Line 36: Line 36:
  
 
==== Getting results ====
 
==== Getting results ====
 
 
Once a search has began, a results tab will appear:
 
Once a search has began, a results tab will appear:
  
Line 54: Line 53:
  
 
==== Stop a search ====
 
==== Stop a search ====
 
 
To stop an active search just click on the '''Stop''' button (or close the active tab as explained later in this article):
 
To stop an active search just click on the '''Stop''' button (or close the active tab as explained later in this article):
  
Line 60: Line 58:
  
 
=== Downloading ===
 
=== Downloading ===
 
 
Once the search results appear and you know which one(s) to download, you may do so. You will now learn how to download a file from the search results. Notice that when a file is added to download, it is immediately turned to red so that you know it is already in the download queue.
 
Once the search results appear and you know which one(s) to download, you may do so. You will now learn how to download a file from the search results. Notice that when a file is added to download, it is immediately turned to red so that you know it is already in the download queue.
  
Line 73: Line 70:
  
 
==== Download button ====
 
==== Download button ====
 
 
When a search has been performed and results have appeared, you can now start downloading the files listed. To do so, just select the file (or files, see the [[multiple selection]] article) you wish to download and click the '''Download''' button.
 
When a search has been performed and results have appeared, you can now start downloading the files listed. To do so, just select the file (or files, see the [[multiple selection]] article) you wish to download and click the '''Download''' button.
  
Line 81: Line 77:
  
 
==== Double clicking or enter keyboard key ====
 
==== Double clicking or enter keyboard key ====
 
 
To begin a download, instead of clicking the download button, you can just double click the file you wish to download or select it and press the ENTER keyboard key.
 
To begin a download, instead of clicking the download button, you can just double click the file you wish to download or select it and press the ENTER keyboard key.
  
Line 89: Line 84:
  
 
==== Extended options ====
 
==== Extended options ====
 
 
Once you have selected the file(s) you want to download, right-click over it (just right-click over any of the selected files if you selected more than one) and select '''Download'''.
 
Once you have selected the file(s) you want to download, right-click over it (just right-click over any of the selected files if you selected more than one) and select '''Download'''.
  
Line 101: Line 95:
  
 
==== Results colours ====
 
==== Results colours ====
 
 
The files in the results tabs are usually coloured. The colours have a meaning:
 
The files in the results tabs are usually coloured. The colours have a meaning:
  
Line 119: Line 112:
  
 
=== Tabs ===
 
=== Tabs ===
 
 
==== Main descriptions and usage ====
 
==== Main descriptions and usage ====
 
 
Whenever you perform a search a tab is displayed:
 
Whenever you perform a search a tab is displayed:
  
Line 142: Line 133:
 
http://www.amule.org/dev-up/window_search14.jpg
 
http://www.amule.org/dev-up/window_search14.jpg
  
If you are applying a filter (filters are explained [[Usage_Search#Filtering|later in this article]]), the number by the search text in the tab will look like ''N/M''. In this case, ''M'' will be the total amount of results received for the search and ''N'' will be the amount of results that passed through the filter and are being currently displayed.
+
If you are applying a filter (filters are explained [[Usage_Searches#Filtering|later in this article]]), the number by the search text in the tab will look like ''N/M''. In this case, ''M'' will be the total amount of results received for the search and ''N'' will be the amount of results that passed through the filter and are being currently displayed.
  
 
http://www.amule.org/dev-up/window_search41.jpg
 
http://www.amule.org/dev-up/window_search41.jpg
  
 
==== Close a tab ====
 
==== Close a tab ====
 
 
The '''X''' button displayed on each tab to the left of the search text can be clicked to close the tab. Closing a tab will also stop the search it is performing if the search is still active.
 
The '''X''' button displayed on each tab to the left of the search text can be clicked to close the tab. Closing a tab will also stop the search it is performing if the search is still active.
  
Line 153: Line 143:
  
 
==== Scroll tabs ====
 
==== Scroll tabs ====
 
 
When there are enough opened tabs not to fit in the window you will be able to scroll through the tabs by using the two arrows displayed to the right and left  of the tabs.
 
When there are enough opened tabs not to fit in the window you will be able to scroll through the tabs by using the two arrows displayed to the right and left  of the tabs.
  
Line 159: Line 148:
  
 
==== Tabs extended options (right-click) menu ====
 
==== Tabs extended options (right-click) menu ====
 
 
By right clicking on a tab you get a menu like this:
 
By right clicking on a tab you get a menu like this:
  
Line 171: Line 159:
  
 
=== Advanced searching ===
 
=== Advanced searching ===
 
 
Several aspects of a search can be tweaked. This are:
 
Several aspects of a search can be tweaked. This are:
 
*The search type. In other words, the method aMule will use to perform the search.
 
*The search type. In other words, the method aMule will use to perform the search.
Line 178: Line 165:
  
 
==== Search type ====
 
==== Search type ====
 
+
In the '''Type''' selection box you can decide the search method to use. Read [[search|this article]] to learn more about how each method works and what it is good for.
In the '''Type''' selection box you can decide the search method to use. Read [[search|this article]] to learn more about how it method works and what it is good for.
+
  
 
http://www.amule.org/dev-up/window_search23.jpg
 
http://www.amule.org/dev-up/window_search23.jpg
  
 
==== Extended parameters ====
 
==== Extended parameters ====
 
 
By clicking the '''Extended parameters''' button advanced search options will be displayed.
 
By clicking the '''Extended parameters''' button advanced search options will be displayed.
  
Line 192: Line 177:
  
 
===== File type =====
 
===== File type =====
 
 
You might want to select what kind of files you wish to be shown in your results. This is, just show videos, audios, documents, images, etc. You can select this here. You might want to read [[faq_search|this article]] to know more about this tweak.
 
You might want to select what kind of files you wish to be shown in your results. This is, just show videos, audios, documents, images, etc. You can select this here. You might want to read [[faq_search|this article]] to know more about this tweak.
  
Line 198: Line 182:
  
 
===== Category =====
 
===== Category =====
 
 
When you plan to download many files from the search results, you may want them all to be enqueued in a concrete category instead of going into default Main category or having to do it manually or through the right-click menu. You can do so by selecting the category in the '''Category''' menu.
 
When you plan to download many files from the search results, you may want them all to be enqueued in a concrete category instead of going into default Main category or having to do it manually or through the right-click menu. You can do so by selecting the category in the '''Category''' menu.
  
Line 204: Line 187:
  
 
===== Extension =====
 
===== Extension =====
 
+
The [[Usage_Searches#File type|File type]] search parameter filters results based on their extension, but you might be searching for files with a concrete extension. If so, enter the extension in the '''Extension''' box and only those files with that extension will be displayed.
The [[Usage_Search#File type|File type]] search parameter filters results based on their extension, but you might be searching for files with a concrete extension. If so, enter the extension in the '''Extension''' box and only those files with that extension will be displayed.
+
  
 
http://www.amule.org/dev-up/window_search31.jpg
 
http://www.amule.org/dev-up/window_search31.jpg
  
 
===== Minimum size =====
 
===== Minimum size =====
 
 
You can select the minimum size you want files in the results list to have. All files with a size smaller than the indicated in the '''Min size''' box will be dropped. Note that you can select if the amount is to be interpreted as [[Bytes]], Kilobytes, Megabytes or Gigabytes.
 
You can select the minimum size you want files in the results list to have. All files with a size smaller than the indicated in the '''Min size''' box will be dropped. Note that you can select if the amount is to be interpreted as [[Bytes]], Kilobytes, Megabytes or Gigabytes.
  
Line 216: Line 197:
  
 
===== Maximum size =====
 
===== Maximum size =====
 
 
You can also select the maximum size you want files in the results list to have. All files with a size higher than the indicated in the '''Max size''' box will be dropped. Again, note that you can select if the amount is to be interpreted as [[Bytes]], Kilobytes, Megabytes or Gigabytes.
 
You can also select the maximum size you want files in the results list to have. All files with a size higher than the indicated in the '''Max size''' box will be dropped. Again, note that you can select if the amount is to be interpreted as [[Bytes]], Kilobytes, Megabytes or Gigabytes.
  
Line 222: Line 202:
  
 
===== Availability =====
 
===== Availability =====
 
 
Sometimes you will want to discard all results with too few sources. You can do this by setting a number in the '''Availability''' box. All files with less sources than that number will be dropped.
 
Sometimes you will want to discard all results with too few sources. You can do this by setting a number in the '''Availability''' box. All files with less sources than that number will be dropped.
  
Line 228: Line 207:
  
 
==== Filtering ====
 
==== Filtering ====
 
 
By clicking the '''Filtering''' box, some advanced options will appear to filter the results.
 
By clicking the '''Filtering''' box, some advanced options will appear to filter the results.
  
Line 236: Line 214:
  
 
===== Filter =====
 
===== Filter =====
 
 
The normal behaviour of the filter is to list in the results list only those files whose filename contains the exact string provided in the '''Filter''' box. Once the text is in the box, click on the '''Filter results''' button to filter the results.
 
The normal behaviour of the filter is to list in the results list only those files whose filename contains the exact string provided in the '''Filter''' box. Once the text is in the box, click on the '''Filter results''' button to filter the results.
  
Line 242: Line 219:
  
 
===== Invert result =====
 
===== Invert result =====
 
 
You can invert the way the filter works by clicking the '''Invert result''' button. If you do so, only files whose filename does '''not''' contain the string in the '''Filter''' box will be listed in the results list.
 
You can invert the way the filter works by clicking the '''Invert result''' button. If you do so, only files whose filename does '''not''' contain the string in the '''Filter''' box will be listed in the results list.
  
Line 248: Line 224:
  
 
===== Hide known files =====
 
===== Hide known files =====
 
 
By clicking this button, all files which are already in the download queue or have been completed will be removed from the results list.
 
By clicking this button, all files which are already in the download queue or have been completed will be removed from the results list.
  
Line 254: Line 229:
  
 
=== Clearing searches ===
 
=== Clearing searches ===
 
 
There are several things you can clear in the search window when the searches have been performed and you don't need the results or parameters any more.
 
There are several things you can clear in the search window when the searches have been performed and you don't need the results or parameters any more.
  
 
==== Clear search parameters ====
 
==== Clear search parameters ====
 
 
The search text can be removed and the extended parameters reseted clicking the '''Reset''' button:
 
The search text can be removed and the extended parameters reseted clicking the '''Reset''' button:
  
Line 264: Line 237:
  
 
==== Clear all tabs ====
 
==== Clear all tabs ====
 
 
If you just want to remove all tabs, simply click the '''Clear''' button:
 
If you just want to remove all tabs, simply click the '''Clear''' button:
  
Line 274: Line 246:
  
 
=== Results extended options (right-click) menu ===
 
=== Results extended options (right-click) menu ===
 
 
By right-clicking on a search result you get a menu like this:
 
By right-clicking on a search result you get a menu like this:
  
Line 288: Line 259:
  
 
=== Miscellaneous ===
 
=== Miscellaneous ===
 
 
The [[Fast ED2K links handler]] will always be shown in the search window, even if disabled in Preferences. However, if you have disabled "Preferences" -> "GUI tweaks" -> "Show fast ED2K links handler", then you can click twice the '''Search''' button in the main aMule window toolbar and the Fast ED2K links handler will be hidden in the search window too.
 
The [[Fast ED2K links handler]] will always be shown in the search window, even if disabled in Preferences. However, if you have disabled "Preferences" -> "GUI tweaks" -> "Show fast ED2K links handler", then you can click twice the '''Search''' button in the main aMule window toolbar and the Fast ED2K links handler will be hidden in the search window too.
  
Line 294: Line 264:
  
 
== Quick Reference ==
 
== Quick Reference ==
 
 
{|
 
{|
 
|+ Searches window
 
|+ Searches window
Line 403: Line 372:
 
| 5 || ''Copy file's ed2k link to clipboard in anchor (<a>) HTML format''
 
| 5 || ''Copy file's ed2k link to clipboard in anchor (<a>) HTML format''
 
|}
 
|}
 
<center>[[Usage aMule|Back to Index]]</center>
 

Latest revision as of 15:35, 25 September 2008

English | Français

Back to Index

Description

From this window you can search for files on the eD2k and Kademlia network and add them to your download queue.

Usage

Main

This is how a bare search window looks:

http://www.amule.org/dev-up/window_search1.jpg

The part surrounded by a red square is what's actually used for searching.

The above part of the search box is where you will input your search queries:

http://www.amule.org/dev-up/window_search2.jpg

The lower part in the search box is where search results are displayed:

http://www.amule.org/dev-up/window_search3.jpg

Basic searching

Begin a search

To begin a search, type on the Name box the text you want to find and then click on the Start button:

http://www.amule.org/dev-up/window_search4.jpg

For example, if you wanted to search for files whose filename contained the work amule, you would search for amule (see image above). If you would want to search for Debian ISO CDs, you would type something like debian iso.

The logic of search queries is described in this article.

Getting results

Once a search has began, a results tab will appear:

http://www.amule.org/dev-up/window_search5.jpg

On the results tab you will see a list of available files. You can see the filename, size, amount of sources and amount of sources with the complete file (in brackets), type of file and fileID:

http://www.amule.org/dev-up/window_search6.jpg

When no results are found for the search query, the results tab appears empty.

On global searches, a progress bar appears which indicates the progress of the search.

http://www.amule.org/dev-up/window_search35.jpg

You may want to read about using lists.

Stop a search

To stop an active search just click on the Stop button (or close the active tab as explained later in this article):

http://www.amule.org/dev-up/window_search18.jpg

Downloading

Once the search results appear and you know which one(s) to download, you may do so. You will now learn how to download a file from the search results. Notice that when a file is added to download, it is immediately turned to red so that you know it is already in the download queue.

http://www.amule.org/dev-up/window_search43.jpg

There are three ways to begin a download:

  • Through the download button
  • Double clicking or enter keyboard key
  • From the extended options menu

Each of them have advantages and disadvantages. They are now described.

Download button

When a search has been performed and results have appeared, you can now start downloading the files listed. To do so, just select the file (or files, see the multiple selection article) you wish to download and click the Download button.

http://www.amule.org/dev-up/window_search7.jpg

This method is available for all users and allows multiple files downloading in a single click.

Double clicking or enter keyboard key

To begin a download, instead of clicking the download button, you can just double click the file you wish to download or select it and press the ENTER keyboard key.

http://www.amule.org/dev-up/window_search8.jpg

This method is very comfortable, however, it will only download a single selected file. That is, if you have more then one file selected, it will only download the file you double click on, not all those you have selected. Of course, you will also loose the selection.

Extended options

Once you have selected the file(s) you want to download, right-click over it (just right-click over any of the selected files if you selected more than one) and select Download.

http://www.amule.org/dev-up/window_search21.jpg

A great advantage of this method is that you can directly define he category you want the file(s) to be added to if instead of selecting Download you select Download in category and the category you want it to be enqueued into.

http://www.amule.org/dev-up/window_search22.jpg

This method allows multiple files downloading with a single click, but is not available for those Mac users using a single buttoned mouse.

Results colours

The files in the results tabs are usually coloured. The colours have a meaning:

Green files are files which have already been successfully downloaded or are being shared by you.

http://www.amule.org/dev-up/window_search45.jpg

Red files are files which are already in the download queue.

http://www.amule.org/dev-up/window_search43.jpg

Black and blue files are files which are not known to have been downloaded and are not in the download queue. The lighter blue the file's coulour is, the more sources it has. The darker blue (or black), the fewer sources.

http://www.amule.org/dev-up/window_search44.jpg

Also, sometimes you will be able to know an approximate average rating for the files listed in the results (since some servers report it). See this article to know more about it. Anyway, note that only average ratings may be displayed, comments will definitely not since they are not provided when searching.

Tabs

Main descriptions and usage

Whenever you perform a search a tab is displayed:

http://www.amule.org/dev-up/window_search10.jpg

If you now start another search, a new tab will appear and the old results tab(s) will go to background leaving the new tab in foreground:

http://www.amule.org/dev-up/window_search11.jpg

Each tab shows a text which corresponds to the search you performed for the results shown in that tab.

http://www.amule.org/dev-up/window_search12.jpg

If you click on any of the tabs, the results obtained for that search request are shown. This allows you to have multiple search results simultaneously (so you can compare them, for example).

http://www.amule.org/dev-up/window_search13.jpg

Apart from the search text, the tab displays also a number in brackets. This number corresponds to the amount of results found:

http://www.amule.org/dev-up/window_search14.jpg

If you are applying a filter (filters are explained later in this article), the number by the search text in the tab will look like N/M. In this case, M will be the total amount of results received for the search and N will be the amount of results that passed through the filter and are being currently displayed.

http://www.amule.org/dev-up/window_search41.jpg

Close a tab

The X button displayed on each tab to the left of the search text can be clicked to close the tab. Closing a tab will also stop the search it is performing if the search is still active.

http://www.amule.org/dev-up/window_search15.jpg

Scroll tabs

When there are enough opened tabs not to fit in the window you will be able to scroll through the tabs by using the two arrows displayed to the right and left of the tabs.

http://www.amule.org/dev-up/window_search20.jpg

Tabs extended options (right-click) menu

By right clicking on a tab you get a menu like this:

http://www.amule.org/dev-up/window_search38.jpg

Selecting Close tab option will close the selected tab.

Selecting Close all tabs will close all tabs.

Selecting Close other tabs will close all tabs except for the one selected.

Advanced searching

Several aspects of a search can be tweaked. This are:

  • The search type. In other words, the method aMule will use to perform the search.
  • Extended search parameters to adjust better the results and how to operate with them.
  • Filename filtering to remove non-wanted results.

Search type

In the Type selection box you can decide the search method to use. Read this article to learn more about how each method works and what it is good for.

http://www.amule.org/dev-up/window_search23.jpg

Extended parameters

By clicking the Extended parameters button advanced search options will be displayed.

http://www.amule.org/dev-up/window_search24.jpg

This options are described below.

File type

You might want to select what kind of files you wish to be shown in your results. This is, just show videos, audios, documents, images, etc. You can select this here. You might want to read this article to know more about this tweak.

http://www.amule.org/dev-up/window_search29.jpg

Category

When you plan to download many files from the search results, you may want them all to be enqueued in a concrete category instead of going into default Main category or having to do it manually or through the right-click menu. You can do so by selecting the category in the Category menu.

http://www.amule.org/dev-up/window_search30.jpg

Extension

The File type search parameter filters results based on their extension, but you might be searching for files with a concrete extension. If so, enter the extension in the Extension box and only those files with that extension will be displayed.

http://www.amule.org/dev-up/window_search31.jpg

Minimum size

You can select the minimum size you want files in the results list to have. All files with a size smaller than the indicated in the Min size box will be dropped. Note that you can select if the amount is to be interpreted as Bytes, Kilobytes, Megabytes or Gigabytes.

http://www.amule.org/dev-up/window_search32.jpg

Maximum size

You can also select the maximum size you want files in the results list to have. All files with a size higher than the indicated in the Max size box will be dropped. Again, note that you can select if the amount is to be interpreted as Bytes, Kilobytes, Megabytes or Gigabytes.

http://www.amule.org/dev-up/window_search33.jpg

Availability

Sometimes you will want to discard all results with too few sources. You can do this by setting a number in the Availability box. All files with less sources than that number will be dropped.

http://www.amule.org/dev-up/window_search34.jpg

Filtering

By clicking the Filtering box, some advanced options will appear to filter the results.

http://www.amule.org/dev-up/window_search25.jpg

The filter applies to all results lists simultaneously.

Filter

The normal behaviour of the filter is to list in the results list only those files whose filename contains the exact string provided in the Filter box. Once the text is in the box, click on the Filter results button to filter the results.

http://www.amule.org/dev-up/window_search26.jpg

Invert result

You can invert the way the filter works by clicking the Invert result button. If you do so, only files whose filename does not contain the string in the Filter box will be listed in the results list.

http://www.amule.org/dev-up/window_search27.jpg

Hide known files

By clicking this button, all files which are already in the download queue or have been completed will be removed from the results list.

http://www.amule.org/dev-up/window_search28.jpg

Clearing searches

There are several things you can clear in the search window when the searches have been performed and you don't need the results or parameters any more.

Clear search parameters

The search text can be removed and the extended parameters reseted clicking the Reset button:

http://www.amule.org/dev-up/window_search16.jpg

Clear all tabs

If you just want to remove all tabs, simply click the Clear button:

http://www.amule.org/dev-up/window_search17.jpg

Also, as it has already been described, you can select any of the tabs and click on Close all tabs:

http://www.amule.org/dev-up/window_search39.jpg

Results extended options (right-click) menu

By right-clicking on a search result you get a menu like this:

http://www.amule.org/dev-up/window_search37.jpg

The meaning of the Download and Download in category items have already been explained.

Selecting Get Razorback 2's stats for this file will open a browser with Razorback 2's statistics page for the selected file (only the last selected file if more than one file is selected).

Selecting Copy ED2k link to clipboard will copy the selected file(s)'s ed2k link(s) to the clipboard in plain text.

Selecting Copy ED2k link to clipboard (HTML) will copy the selected file(s)'s ed2k link(s) to the clipboard in a plain text HTML link form (that is <a href="link">filename</a>).

Miscellaneous

The Fast ED2K links handler will always be shown in the search window, even if disabled in Preferences. However, if you have disabled "Preferences" -> "GUI tweaks" -> "Show fast ED2K links handler", then you can click twice the Search button in the main aMule window toolbar and the Fast ED2K links handler will be hidden in the search window too.

http://www.amule.org/dev-up/window_toolbar4.jpg

Quick Reference

Searches window
http://www.amule.org/dev-up/window_search36.jpg
Number Description
1 Toggle to Search window / Toggle ED2K links handler
2 Search parameters
3 Text to search
4 Select type of search
5 Show extended parameters
6 Extended parameters
7 File types to search
8 Filter parameters
9 Text to filter (discard others')
10 Apply filter
11 Stop search
12 Start search
13 Search results
14 Close tab
15 Searched text
16 File name
17 File size
18 Global search progress bar
19 Clear search parameters
20 Show filtering parameters
21 Extension to search
22 Category to add files to
23 Minimum amount of sources
24 Maximum size unit
25 Maximum size
26 Hide downloading or completed files
27 Invert filter action
28 Clear all searches
29 Download selected file(s)
30 Results tab
31 Amount of results filtered / found
32 Amount of sources
33 Amount of sources with the complete file
34 Type of file
35 File ID
36 File
Tab options
http://www.amule.org/dev-up/window_search46.jpg
Number Description
1 Close the selected tab
2 Close all tabs
3 Close all tabs except the selected one
File options
http://www.amule.org/dev-up/window_search47.jpg
Number Description
1 Download the file(s)
2 Download the file(s) into the selected category
3 Get statistics from razorback2 about file
4 Copy file's ed2k link to clipboard
5 Copy file's ed2k link to clipboard in anchor (<a>) HTML format