Difference between revisions of "Usage Searches"
Line 9: | Line 9: | ||
This is how a bare search window looks: | This is how a bare search window looks: | ||
− | window_search1.jpg | + | http://www.amule.org/dev-up/window_search1.jpg |
The part surrounded by a red square is what's actually used for searching. | The part surrounded by a red square is what's actually used for searching. | ||
Line 15: | Line 15: | ||
The above part of the search box is where you will input your search queries: | The above part of the search box is where you will input your search queries: | ||
− | window_search2.jpg | + | http://www.amule.org/dev-up/window_search2.jpg |
The lower part in the serach box is where search results are displayed: | The lower part in the serach box is where search results are displayed: | ||
− | window_search3.jpg | + | http://www.amule.org/dev-up/window_search3.jpg |
=== Basic searching === | === Basic searching === | ||
Line 27: | Line 27: | ||
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: | ||
− | window_search4.jpg | + | http://www.amule.org/dev-up/window_search4.jpg |
For example, if you wanted to search for files which's 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''. | For example, if you wanted to search for files which's 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''. | ||
Line 37: | Line 37: | ||
Once a search has began, a results tab will appear: | Once a search has began, a results tab will appear: | ||
− | window_search5.jpg | + | 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 [[source]]s, [[file_type|type of file]] and [[file_hash|fileID]]: | On the results tab you will see a list of available files. You can see the [[filename]], [[size]], amount of [[source]]s, [[file_type|type of file]] and [[file_hash|fileID]]: | ||
− | window_search6.jpg | + | http://www.amule.org/dev-up/window_search6.jpg |
When no results are found for the search query, the results tab appears empty. | When no results are found for the search query, the results tab appears empty. | ||
Line 49: | Line 49: | ||
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): | ||
− | window_search18.jpg | + | http://www.amule.org/dev-up/window_search18.jpg |
=== Downloading === | === Downloading === | ||
Line 64: | Line 64: | ||
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. | ||
− | window_search7.jpg | + | 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. | This method is available for all users and allows multiple files downloading in a single click. | ||
Line 72: | Line 72: | ||
To begin a download, instead of clicking the download button, you can just double click the file you wish to download. | To begin a download, instead of clicking the download button, you can just double click the file you wish to download. | ||
− | window_search8.jpg | + | http://www.amule.org/dev-up/window_search8.jpg |
This method is very comfortable, however, it will only download a signle 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. | This method is very comfortable, however, it will only download a signle 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. | ||
Line 94: | Line 94: | ||
Whenever you perform a search a tab is displayed: | Whenever you perform a search a tab is displayed: | ||
− | window_search10.jpg | + | 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 forground: | 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 forground: | ||
− | window_search11.jpg | + | 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. | Each tab shows a text which corresponds to the search you performed for the results shown in that tab. | ||
− | window_search12.jpg | + | 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 multple search results simultaneously (so you can compare them, for example). | If you click on any of the tabs, the results obtained for that search request are shown. This allows you to have multple search results simultaneously (so you can compare them, for example). | ||
− | window_search13.jpg | + | http://www.amule.org/dev-up/window_search13.jpg |
Appart from the search text, the tab displays also a number in brackets. This number corresponds to the amount of results found: | Appart from the search text, the tab displays also a number in brackets. This number corresponds to the amount of results found: | ||
− | window_search14.jpg | + | http://www.amule.org/dev-up/window_search14.jpg |
==== Close a tab ==== | ==== Close a tab ==== | ||
Line 116: | Line 116: | ||
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. | ||
− | window_search15.jpg | + | http://www.amule.org/dev-up/window_search15.jpg |
==== Scroll tabs ==== | ==== Scroll tabs ==== | ||
Line 122: | Line 122: | ||
When there are enough openned 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 openned 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. | ||
− | window_search20.jpg | + | http://www.amule.org/dev-up/window_search20.jpg |
=== Advanced searching === | === Advanced searching === | ||
Line 151: | Line 151: | ||
The search text can be removed by selecting the text and deleting it or by simply clicking the '''Reset''' button: | The search text can be removed by selecting the text and deleting it or by simply clicking the '''Reset''' button: | ||
− | window_search16.jpg | + | http://www.amule.org/dev-up/window_search16.jpg |
==== Clear a tab ==== | ==== Clear a tab ==== | ||
Line 157: | Line 157: | ||
We've already seen that to clear a tab you must click on the '''X''' button by the search text in the tab: | We've already seen that to clear a tab you must click on the '''X''' button by the search text in the tab: | ||
− | window_search15.jpg | + | http://www.amule.org/dev-up/window_search15.jpg |
==== Clear all ==== | ==== Clear all ==== | ||
Line 163: | Line 163: | ||
If you just want to remove all tabs and clear the search text, simply click the '''Clear''' button: | If you just want to remove all tabs and clear the search text, simply click the '''Clear''' button: | ||
− | window_search17.jpg | + | http://www.amule.org/dev-up/window_search17.jpg |
=== Miscellaneous === | === Miscellaneous === | ||
Line 169: | Line 169: | ||
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. | ||
− | window_toolbar1.jpg | + | http://www.amule.org/dev-up/window_toolbar1.jpg |
== Quick Reference == | == Quick Reference == |
Revision as of 17:44, 4 December 2005
Contents
Description
From this window you can search for files on the eD2k and Kademlia netowrk 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 serach 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 which's 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, 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.
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
There are three ways to begin a download:
- Through the download button
- Double clicking
- 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
To begin a download, instead of clicking the download button, you can just double click the file you wish to download.
http://www.amule.org/dev-up/window_search8.jpg
This method is very comfortable, however, it will only download a signle 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.
NOTE: I was unable to grab an image of the extended options (right-click) menu with the Download option selected, since ImageMagick is working badly for me. If someone could please provide one...
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.
NOTE: I was unable to grab an image of the extended options (right-click) menu with thte Download in category option extended, since ImageMagick is working badly for me. If someone could please provide one...
This method allows multiple files downloading with a single click, but is not available for those Mac users using a single buttoned mouse.
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 forground:
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 multple search results simultaneously (so you can compare them, for example).
http://www.amule.org/dev-up/window_search13.jpg
Appart 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
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 openned 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
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
Extended parameters
Filtering
Clearing searches
There are several things you can clear in the search window when the seraches have been performed and you don't need the results any more.
Clear search text
The search text can be removed by selecting the text and deleting it or by simply clicking the Reset button:
http://www.amule.org/dev-up/window_search16.jpg
Clear a tab
We've already seen that to clear a tab you must click on the X button by the search text in the tab:
http://www.amule.org/dev-up/window_search15.jpg
Clear all
If you just want to remove all tabs and clear the search text, simply click the Clear button:
http://www.amule.org/dev-up/window_search17.jpg
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_toolbar1.jpg