AMIGIFT Documentation :: General Usage :: Main Window

Browsing /General Usage/Main Window/Results Listview

This is the list of results. What we see here is three simultaneous searches, on the list title are the search string as you typed it, followed by the current number of results found and then the formated size of all results. The list title will be highlighted when new results are found for a list which isn't the active one, and changed to bold when the search finishes.

Currently the list of results are formed by 27 columns to give accurate info about the result, Note there isn't returned always enough info to full fill all of the columns, that depends on which software used the peer who gave you the result(s) and the file type/format. A summary of all of the columns contents can be seen by selecting an entry and keeping the mouse quiet over the list, a bubble-help will popup with the info.

The currently being used columns are the follow: availability, file, size, user, node, url, mime, hash, bitrate, frequency, duration, audioformat, audiofreq, audiobitrate, videoformat, resolution, fps, width, height, format, comment, title, album, track, artist, year. - You can disable as many as you would want using the context-menu over the NList-title, as for adjust the width or the order.

In Detail:

Column	Description
av	Availability of the file: `* RED:` 0 slots available to download at this time. `* YELLOW:` 1 slot available, we may download it but probably too slow. `* SHADOWGREEN:` 2-6 slots available, we should be able to download it. `* GREEN:` all slots available, the peer isn't uploading to other users atm. Note: When the lamp isn't GREEN means the peer is uploading to other users which could make our download to be [somewhat] slow. Consider as well the inet connection that peer have, obviously isn't the same uploading to 4 users/peers with a 1MB-DSL than with a 20MB-DSL connection (Well, if you live at Spain, or want to download from Spanish people, note it's the same...), above all this it could be as well the peer who owns the file has limited its bandwidth usage and/or other inet programs he may have running are limiting the bandwidth as well, as a result your download speed could be ridiculous. just remember those points and do not blame the amigift authors by low download speeds as some of you did, it is something we have not on our hands. - Note also there are sometimes where we may be able to download files with RED lamp, this only means from the time passed from the supernode to give us that result and we try to download it some slot goes free, it may worth a try to try to download such result if there aren't other good alternatives.
File	Filename (may contains a path, whatever it's saved without a path)
MIME	MIME type of the file
User	User supplying the file
Node	(super)node this user is connected to
Bitrate	Bitrate for audio or video files (On videos it's the general bitrate)
Frequency	Frequency for audio or video files (On videos it's the general frequency)
Duration	Running time of audio/video files
AudioFormat	For video files, this contains the format of the audio stream
AudioFreq	For video files, this contains the frequency of the audio stream
Bps	bits per second
Audiobitrate	For video files, this contains the bitrate of the audio stream
VideoFormat	Which Codec used on video files (AVI, MPEG, etc)
Resolution	Resolution of video files
Fps	Frames per second
Width	Width of images
Height	Height of images
Format	Image format
Comment	Comment supported from some formats (eg MP3)
Title	Song title
Album	Album the song was taken from
Track	Track number of a song on the album
Artist	Performer of a song
Year	Release time of the song/album
Network	Network that the file was found on
Hash	ASCII Representation of the file's CheckSum (MD5, SHA1, etc)

When AMIGIFT 0.1 was created, we checked all those are the data returned as meta-tags from the various networks, Todays we have noticed new tags are being used but to avoid adding even more columns all those unrecognized tags will be appended to the Comment column.

Build in the list of results are available a context-menu with certain actions we'll explain now, some of the options are actions to be performed over a selected entry, for those click RMB over the desired file.

- Use multi-lists

Toggle the multi-list option that determines whether to open a new list upon each search or not.

(for registered users only)

- Format Bytes

Toggle the Convert Sizes option that allows you to convert file sizes from bytes to something better readable (eg: 1234567 -> 1.23MB). Here we use 64-bit functions which allow us to convert upto one exabyte (1152921504606846976 Bytes) what does not mean we may be able to download something higher than 2GB ...

- Add new (page) list

Opens a new results listview.

- Remove current list

Closes the current list when the Multi-Lists option is active. If the current list is the only one, nothing will happen.

- Clear current list

Removes all contents from the current list.

- Load results from disk

Loads a previously saved results list from disk into the listview.

- Save results to disk

Saves the current search results to disk. Only the columns required to download or to create a GiFTMui's cache entry are saved, the availability field will obviously be inaccurate if you load the list some day(s) later (or even some minutes/hours later)

- Downloading »

- Add all sources: Scans the search results for identical files and adds them as sources. You can define how many sources to add at once from the preferences window.
- Check if exists locally: Checks if the desired file has already been downloaded before. At which paths to check are defined on the downcheck settings.

- Select »

- All: Select all entrys on the current list.
- None: Deselect all entrys on the current list.
- Toggle: Toggles the status of all items in the current list. Selected entrys becomes deselected and vice versa.
- By Pattern: Opens a tiny window allowing you to specify a name pattern for files to be selected and a cycle gadget that determines where to search for this pattern. Valid options are File (name), MIME (type), User, Node, Comment, Title, Album and Artist. Clicking the "Go!" button perform the selection inserting the matches on a new list. This pattern allows to use regular expressions.
- Max Sources: Search the list for the entry with the highest number of sources, and auto-select such entry.

- Browse 'user' shares list

Request the shares list of the user under the active entry. This option is only available for networks which support user browsing (eg: OpenFT)

- BAN xx.xx.xx.xx

This option is available for FastTrack and Gnutella only. It will add the shown IP to the banlist (for FastTrack) or hosttiles.txt (Gnutella) files which contains lists of banned IPs (by spam, fakes, etc). You can ban a single user or a whole (super)node.

- Where is this file from?

This is an external service provided by www.sharemonkey.com where the AMIGIFT project is affiliated to. When you use it, we'll use openurl.library to redirect you to the ShareMonkey website where you could found addtional info about the selected entry on the results listview, you'll find several places where to legally buy [online] the file or the album where it is.
Note: Please support AMIGIFT by clicking on it as many times as you can. (and buy something as it's the way we are rewarded) :-)

Info bar

Advanced Search Panel

$Id: index.php,v 2.0 2009/08/06 22:47:32 diegocr Exp $