Difference between revisions of "Usage Shared Files"
From AMule Project FAQ
(=General=) |
(Copy-edit) |
||
| Line 10: | Line 10: | ||
Remember that a shared file is: | Remember that a shared file is: | ||
| − | * | + | *any file in the directories you are sharing (see [[Usage Preferences|Preferences]]); |
| − | * | + | *any file you have [[complete]]d and is still in the [[Incoming dir]]ectory; or |
| − | * | + | *any file you are downloading that has already a [[chunk]] completed (only the completed chunks are shared). |
== Usage == | == Usage == | ||
There are three things you can do from this window: | There are three things you can do from this window: | ||
| − | * | + | *see the properties of any shared file that you highlight; |
| − | * | + | *see the statistics of any shared file that you highlight; and |
| − | + | *manage your [[share]]d [[file]]s. | |
=== Files properties === | === Files properties === | ||
| − | The window has a big box listing all the files you are sharing. | + | The window has a big box listing all of the files you are sharing. |
http://www.amule.org/dev-up/window_sharefiles2.jpg | http://www.amule.org/dev-up/window_sharefiles2.jpg | ||
| − | + | The properties of your shared files and statistics on them appear in this list: | |
| − | *'''Filename''' is the file | + | *'''Filename''' is the name of a file; |
| − | *'''Size''' is | + | *'''Size''' is its total size; |
| − | *'''Type''' is | + | *'''Type''' is its media type; |
| − | *'''Priority''' is | + | *'''Priority''' is its currently set [[priority|upload priority]] |
| − | *'''FileID''' is | + | *'''FileID''' is its [[hash]]; |
| − | *'''Requests''' shows the number of requests for | + | *'''Requests''' shows the number of requests for a file in the current session and, in parentheses, the total number of requests for that file your client has ever recieved (explained further in the [[Usage_Shared_Files#Files statistics|statistics]] section); |
| − | *'''Accepted Requests''' shows the number of times you have uploaded parts of this file in the current session and, in | + | *'''Accepted Requests''' shows the number of times you have uploaded parts of this file in the current session and, in parentheses, the total number of times you have ever uploaded parts of this file (explained further in the [[Usage_Shared_Files#Files statistics|statistics]] section); |
| − | *'''Transferred Data''' shows the | + | *'''Transferred Data''' shows the number of bytes you have uploaded for this file in the current session and, in brackets, the total number of bytes you have ever uploaded of this file (explained further in the [[Usage_Shared_Files#Files statistics|statistics]] section); |
| − | *'''Obtained Parts''' shows the parts | + | *'''Obtained Parts''' shows the parts that other clients are known to have, shown in blue; the darker the blue, the more people have them); the parts that no client is known to have appear in red; |
| − | *'''Complete Sources''' shows an estimation of the | + | *'''Complete Sources''' shows an estimation of the number of clients who have the whole file; and |
| − | *'''Directory Path''' shows the directory | + | *'''Directory Path''' shows the directory in which the shared file is located. If a file is currently being downloaded, it will display ''[PartFile]'' |
You may want to read about [[Usage General#Lists|using lists]]. | You may want to read about [[Usage General#Lists|using lists]]. | ||
| Line 44: | Line 44: | ||
=== Managing files === | === Managing files === | ||
| − | By selecting a file (or files) in the shared files list and right-clicking it you can perform | + | By selecting a file (or files) in the shared files list and right-clicking it (option-click on the Mac) you can perform operations on it. |
http://www.amule.org/dev-up/window_sharefiles4.jpg | http://www.amule.org/dev-up/window_sharefiles4.jpg | ||
| Line 50: | Line 50: | ||
==== General ==== | ==== General ==== | ||
| − | + | The following operations are available: | |
| − | *'''Priority''' | + | *'''Priority''' allows you to set a priority to the file; |
| − | *'''Add Comment/Rating''' allows you to set a comment and/or rating | + | *'''Add Comment/Rating''' allows you to set a comment and/or rating (described later in this article) |
| − | *'''Rename''' allows you to rename the file on your local system | + | *'''Rename''' allows you to rename the file on your local system (described later); |
| − | *'''Get Razorback2's stats for this file''' opens a Razoback2's statistics page for that file on your web browser | + | *'''Get Razorback2's stats for this file''' opens a Razoback2's statistics page for that file on your web browser; |
*'''Copy ED2k link to clipboard''' copies the file's [[ed2k link]] to the clipboard | *'''Copy ED2k link to clipboard''' copies the file's [[ed2k link]] to the clipboard | ||
| − | *'''Copy ED2k link to clipboard (Source)''' copies the file's [[ed2k link]] to the clipboard adding you as a source to the link | + | *'''Copy ED2k link to clipboard (Source)''' copies the file's [[ed2k link]] to the clipboard, adding you as a source to the link, so that other [[client]]s who are downloading the file from that link will know you have that file from the very beginning and try to download it from you; |
| − | *'''Copy ED2k link to clipboard (Hostname)''' does the same as '''Copy ED2k link to clipboard (Source)''' but tries to resolve your hostname address instead of providing your IP | + | *'''Copy ED2k link to clipboard (Hostname)''' does the same as '''Copy ED2k link to clipboard (Source)''', but tries to resolve your hostname address instead of providing your IP (this option might be disabled if your hostname is not known); and |
| − | *'''Copy ED2k link to clipboard (AICH)''' copies the file's [[ed2k link]] to the clipboard | + | *'''Copy ED2k link to clipboard (AICH)''' copies the file's [[ed2k link]] to the clipboard and provides the [[AICH]] [[Root Hash]] in the link. |
==== Add a comment/rate ==== | ==== Add a comment/rate ==== | ||
| − | Files can have [[comment]]s and/or [[rate]]s. This helps other clients to | + | Files can have [[comment]]s and/or [[rate]]s. This helps other clients to estimate the quality (e.g., the resolution) of a file before completing its download. |
===== Comment ===== | ===== Comment ===== | ||
| Line 70: | Line 70: | ||
http://www.amule.org/dev-up/window_sharefiles5.jpg | http://www.amule.org/dev-up/window_sharefiles5.jpg | ||
| − | In this window you can enter some useful text (comment) for other [[user]]s downloading the same file | + | In this window you can enter some useful text (comment) for other [[user]]s who are downloading the same file. This text should be strictly related to the file and should comprise no more than 50 characters. |
http://www.amule.org/dev-up/window_sharefiles8.jpg | http://www.amule.org/dev-up/window_sharefiles8.jpg | ||
| Line 78: | Line 78: | ||
http://www.amule.org/dev-up/window_sharefiles9.jpg | http://www.amule.org/dev-up/window_sharefiles9.jpg | ||
| − | + | You can cancel your changes regarding the file's comment and/or rate by clicking '''Cancel'''. | |
http://www.amule.org/dev-up/window_sharefiles10.jpg | http://www.amule.org/dev-up/window_sharefiles10.jpg | ||
| − | When a file has a comment you will see a [[comment icon]] by | + | When a file has a comment, you will see a [[comment icon]] by its name. |
===== Rate ===== | ===== Rate ===== | ||
| − | [[Rate]]s allow other users to get a | + | [[Rate]]s allow other users to get a rough idea of the quality of a file. You can rate the file by selecting what you think about the file in the rate menu in the comment/rate window. |
| − | + | ||
| − | You can rate the file by selecting what you think about the file in the rate menu in the comment/rate window. | + | |
http://www.amule.org/dev-up/window_sharefiles11.jpg | http://www.amule.org/dev-up/window_sharefiles11.jpg | ||
| Line 94: | Line 92: | ||
You might want to read about [[rate|rate values]]. | You might want to read about [[rate|rate values]]. | ||
| − | Changes will not apply until you click the '''Apply''' button or press the ENTER key in the keyboard, as it has been explained before. | + | Changes will not apply until you click the '''Apply''' button or press the ENTER key in the keyboard, as it has been explained before. Again, you can cancel your changes regarding a comment and/or rating by clicking '''Cancel''', as above. |
| − | + | ||
| − | Again, you can cancel your changes regarding | + | |
==== Rename ==== | ==== Rename ==== | ||
| − | This allows you to rename the files on your storage device. | + | This allows you to rename the files on your storage device. When selecting to rename a file, the following window will appear: |
| − | + | ||
| − | When selecting to rename a file, the following window will appear: | + | |
http://www.amule.org/dev-up/window_sharefiles6.jpg | http://www.amule.org/dev-up/window_sharefiles6.jpg | ||
| − | Here you | + | Here, you will need to enter in the text box your new name for the file (it will intially have the original filename); by clicking '''OK''' after entering the new name, it will be instantly changed. |
http://www.amule.org/dev-up/window_sharefiles12.jpg | http://www.amule.org/dev-up/window_sharefiles12.jpg | ||
| − | By clicking '''Cancel''' you will | + | By clicking '''Cancel''' you will retain the existing name. |
http://www.amule.org/dev-up/window_sharefiles13.jpg | http://www.amule.org/dev-up/window_sharefiles13.jpg | ||
| Line 116: | Line 110: | ||
=== Files statistics === | === Files statistics === | ||
| − | Once you select a file you can take a look at the statistics below: | + | Once you select a file, you can take a look at the statistics below: |
http://www.amule.org/dev-up/window_sharefiles3.jpg | http://www.amule.org/dev-up/window_sharefiles3.jpg | ||
| − | This statistics display information about the popularity of your files and how | + | This statistics display information about the popularity of your files and how heavily they are requested. |
==== Session statistics ==== | ==== Session statistics ==== | ||
| Line 126: | Line 120: | ||
To the left of the box are the values corresponding to the current session: | To the left of the box are the values corresponding to the current session: | ||
| − | The first value displays the | + | The first value displays the number of clients who have requested the selected file(s) in the current [[session]]. |
http://www.amule.org/dev-up/window_sharefiles14.jpg | http://www.amule.org/dev-up/window_sharefiles14.jpg | ||
| − | The second value displays the | + | The second value displays the number of clients to whom you are actively [[upload]]ing the selected file(s) during the current session. |
http://www.amule.org/dev-up/window_sharefiles15.jpg | http://www.amule.org/dev-up/window_sharefiles15.jpg | ||
| − | The third value displays the | + | The third value displays the number of [[byte]] (or KB, or MB or TB) of the file(s) that have been uploaded during the current session. |
http://www.amule.org/dev-up/window_sharefiles16.jpg | http://www.amule.org/dev-up/window_sharefiles16.jpg | ||
| Line 140: | Line 134: | ||
==== Session percentages ==== | ==== Session percentages ==== | ||
| − | In the middle of the box you can see a graphical representation of the files corresponding percentage | + | In the middle of the box you can see a graphical representation of the files corresponding percentage among the other files for the values in the current session: |
| − | The first bar shows which percentage of requests the selected file(s) have | + | The first bar shows which percentage of requests the selected file(s) have received in the current session. |
http://www.amule.org/dev-up/window_sharefiles17.jpg | http://www.amule.org/dev-up/window_sharefiles17.jpg | ||
| − | The second bar shows which percentage of the active uploads during the current session have been uploading the selected file(s). | + | The second bar shows which percentage of the active uploads during the current session that have been uploading the selected file(s). |
http://www.amule.org/dev-up/window_sharefiles18.jpg | http://www.amule.org/dev-up/window_sharefiles18.jpg | ||
| Line 156: | Line 150: | ||
==== Total statistics ==== | ==== Total statistics ==== | ||
| − | To the right of the box are the total statistics, that is, since aMule was | + | To the right of the box are the total statistics, that is, since aMule was installed (or since the last time its configuration was reset): |
| − | The first value displays the | + | *The first value displays the number of clients who have requested the selected file(s). |
http://www.amule.org/dev-up/window_sharefiles20.jpg | http://www.amule.org/dev-up/window_sharefiles20.jpg | ||
| − | The second value displays the | + | *The second value displays the number of clients to whom you have [[upload]]ed parts of the selected file(s). |
http://www.amule.org/dev-up/window_sharefiles21.jpg | http://www.amule.org/dev-up/window_sharefiles21.jpg | ||
| − | The third value displays the | + | The third value displays the number of bytes (or KB, MB or TB) of the file(s) that have been uploaded. |
http://www.amule.org/dev-up/window_sharefiles22.jpg | http://www.amule.org/dev-up/window_sharefiles22.jpg | ||
| Line 172: | Line 166: | ||
=== Reload files === | === Reload files === | ||
| − | You can reload the list of shared files when external changes occur (files in some shared directory change, a download file has been renamed, files have been moved, ...). To do | + | You can reload the list of shared files when external changes occur (e.g., files in some shared directory change, a download file has been renamed, files have been moved, ...). To do this, just click on the button with two green arrows. |
http://www.amule.org/dev-up/window_sharefiles7.jpg | http://www.amule.org/dev-up/window_sharefiles7.jpg | ||
Revision as of 02:12, 29 December 2005
Contents
Description
The Shared Files window allows you to see and manage the files you are sharing.
It looks like this:
http://www.amule.org/dev-up/window_sharefiles1.jpg
Remember that a shared file is:
- any file in the directories you are sharing (see Preferences);
- any file you have completed and is still in the Incoming directory; or
- any file you are downloading that has already a chunk completed (only the completed chunks are shared).
Usage
There are three things you can do from this window:
- see the properties of any shared file that you highlight;
- see the statistics of any shared file that you highlight; and
- manage your shared files.
Files properties
The window has a big box listing all of the files you are sharing.
http://www.amule.org/dev-up/window_sharefiles2.jpg
The properties of your shared files and statistics on them appear in this list:
- Filename is the name of a file;
- Size is its total size;
- Type is its media type;
- Priority is its currently set upload priority
- FileID is its hash;
- Requests shows the number of requests for a file in the current session and, in parentheses, the total number of requests for that file your client has ever recieved (explained further in the statistics section);
- Accepted Requests shows the number of times you have uploaded parts of this file in the current session and, in parentheses, the total number of times you have ever uploaded parts of this file (explained further in the statistics section);
- Transferred Data shows the number of bytes you have uploaded for this file in the current session and, in brackets, the total number of bytes you have ever uploaded of this file (explained further in the statistics section);
- Obtained Parts shows the parts that other clients are known to have, shown in blue; the darker the blue, the more people have them); the parts that no client is known to have appear in red;
- Complete Sources shows an estimation of the number of clients who have the whole file; and
- Directory Path shows the directory in which the shared file is located. If a file is currently being downloaded, it will display [PartFile]
You may want to read about using lists.
Managing files
By selecting a file (or files) in the shared files list and right-clicking it (option-click on the Mac) you can perform operations on it.
http://www.amule.org/dev-up/window_sharefiles4.jpg
General
The following operations are available:
- Priority allows you to set a priority to the file;
- Add Comment/Rating allows you to set a comment and/or rating (described later in this article)
- Rename allows you to rename the file on your local system (described later);
- Get Razorback2's stats for this file opens a Razoback2's statistics page for that file on your web browser;
- Copy ED2k link to clipboard copies the file's ed2k link to the clipboard
- Copy ED2k link to clipboard (Source) copies the file's ed2k link to the clipboard, adding you as a source to the link, so that other clients who are downloading the file from that link will know you have that file from the very beginning and try to download it from you;
- Copy ED2k link to clipboard (Hostname) does the same as Copy ED2k link to clipboard (Source), but tries to resolve your hostname address instead of providing your IP (this option might be disabled if your hostname is not known); and
- Copy ED2k link to clipboard (AICH) copies the file's ed2k link to the clipboard and provides the AICH Root Hash in the link.
Add a comment/rate
Files can have comments and/or rates. This helps other clients to estimate the quality (e.g., the resolution) of a file before completing its download.
Comment
When adding a comment/rate, the following window will appear:
http://www.amule.org/dev-up/window_sharefiles5.jpg
In this window you can enter some useful text (comment) for other users who are downloading the same file. This text should be strictly related to the file and should comprise no more than 50 characters.
http://www.amule.org/dev-up/window_sharefiles8.jpg
By clicking the Clear button the text (comment) box will be cleared so you can write a new comment. Changes will not apply until you click the Apply button or press the ENTER key in the keyboard.
http://www.amule.org/dev-up/window_sharefiles9.jpg
You can cancel your changes regarding the file's comment and/or rate by clicking Cancel.
http://www.amule.org/dev-up/window_sharefiles10.jpg
When a file has a comment, you will see a comment icon by its name.
Rate
Rates allow other users to get a rough idea of the quality of a file. You can rate the file by selecting what you think about the file in the rate menu in the comment/rate window.
http://www.amule.org/dev-up/window_sharefiles11.jpg
You might want to read about rate values.
Changes will not apply until you click the Apply button or press the ENTER key in the keyboard, as it has been explained before. Again, you can cancel your changes regarding a comment and/or rating by clicking Cancel, as above.
Rename
This allows you to rename the files on your storage device. When selecting to rename a file, the following window will appear:
http://www.amule.org/dev-up/window_sharefiles6.jpg
Here, you will need to enter in the text box your new name for the file (it will intially have the original filename); by clicking OK after entering the new name, it will be instantly changed.
http://www.amule.org/dev-up/window_sharefiles12.jpg
By clicking Cancel you will retain the existing name.
http://www.amule.org/dev-up/window_sharefiles13.jpg
Files statistics
Once you select a file, you can take a look at the statistics below:
http://www.amule.org/dev-up/window_sharefiles3.jpg
This statistics display information about the popularity of your files and how heavily they are requested.
Session statistics
To the left of the box are the values corresponding to the current session:
The first value displays the number of clients who have requested the selected file(s) in the current session.
http://www.amule.org/dev-up/window_sharefiles14.jpg
The second value displays the number of clients to whom you are actively uploading the selected file(s) during the current session.
http://www.amule.org/dev-up/window_sharefiles15.jpg
The third value displays the number of byte (or KB, or MB or TB) of the file(s) that have been uploaded during the current session.
http://www.amule.org/dev-up/window_sharefiles16.jpg
Session percentages
In the middle of the box you can see a graphical representation of the files corresponding percentage among the other files for the values in the current session:
The first bar shows which percentage of requests the selected file(s) have received in the current session.
http://www.amule.org/dev-up/window_sharefiles17.jpg
The second bar shows which percentage of the active uploads during the current session that have been uploading the selected file(s).
http://www.amule.org/dev-up/window_sharefiles18.jpg
The third bar shows which percentage of the bytes transfered during the current session correspond to the selected file(s).
http://www.amule.org/dev-up/window_sharefiles19.jpg
Total statistics
To the right of the box are the total statistics, that is, since aMule was installed (or since the last time its configuration was reset):
- The first value displays the number of clients who have requested the selected file(s).
http://www.amule.org/dev-up/window_sharefiles20.jpg
- The second value displays the number of clients to whom you have uploaded parts of the selected file(s).
http://www.amule.org/dev-up/window_sharefiles21.jpg
The third value displays the number of bytes (or KB, MB or TB) of the file(s) that have been uploaded.
http://www.amule.org/dev-up/window_sharefiles22.jpg
Reload files
You can reload the list of shared files when external changes occur (e.g., files in some shared directory change, a download file has been renamed, files have been moved, ...). To do this, just click on the button with two green arrows.
http://www.amule.org/dev-up/window_sharefiles7.jpg
Overview
| http://www.amule.org/dev-up/window_sharefiles23.jpg | |
| Number | Description |
| 1 | Shared files list |
| 2 | Shared file |
| 3 | Reload shared files list |
| 4 | File statistics |
| 5 | Transfered bytes of selected file(s) in current session |
| 6 | Times parts of the selected file(s) has been uploaded in current session |
| 7 | Times the selected file(s) has been requested in current session |
| 8 | Percentage of times the selected file(s) has been requested |
| 9 | Percentage of times parts of the selected file(s) has been uploaded |
| 10 | Percentage of transfered bytes of selected file(s) |
| 11 | Transfered bytes of selected file(s) ever |
| 12 | Times parts of the selected file(s) has been uploaded ever |
| 13 | Times the selected file(s) has been requested ever |
| http://www.amule.org/dev-up/window_sharefiles24.jpg | |
| Number | Description |
| 1 | Rate file quality |
| 2 | Comment on the file |
| 3 | Apply changes |
| 4 | Clear comment box |
| 5 | Close the window ignoring changes |
| http://www.amule.org/dev-up/window_sharefiles25.jpg | |
| Number | Description |
| 1 | New file name |
| 2 | Cancel changes and close window |
| 3 | Rename file |
| http://www.amule.org/dev-up/window_sharefiles26.jpg | |
| Number | Description |
| 1 | Set file(s) upload priority |
| 2 | Add comment and/or rating to the file |
| 3 | Rename file |
| 4 | Get statistics from razorback2 about file |
| 5 | Copy file's ed2k link to clipboard |
| 6 | Copy file's ed2k link to clipboard with source |
| 7 | Copy file's ed2k link to clipboard with hostname (might not be available) |
| 8 | Copy file's ed2k link to clipboard with AICH root hash |
