Difference between revisions of "Usage Shared Files"
Vollstrecker (Talk | contribs) m (Added Language selection) |
|||
(22 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
+ | <center> | ||
+ | '''English''' | | ||
+ | [[Usage_Shared_Files-fr|Français]] | ||
+ | </center> | ||
+ | |||
[[Usage aMule|Back to Index]] | [[Usage aMule|Back to Index]] | ||
Line 7: | Line 12: | ||
It looks like this: | It looks like this: | ||
− | http://www.amule.org/dev-up/ | + | http://www.amule.org/dev-up/window_sharefiles1.jpg |
+ | |||
+ | 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 [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] completed (only the completed chunks are shared). | ||
== Usage == | == Usage == | ||
− | There are | + | 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 === |
− | 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/ | + | 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 [[priority|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 [[Usage_Shared_Files#Files statistics|statistics]] section) Tip: You can toggle the order of the files by either the first or the second number by clicking on the tab once or twice. | ||
+ | *'''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 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 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 [[Usage General#Lists|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/ | + | http://www.amule.org/dev-up/window_sharefiles4.jpg |
==== 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 | + | *'''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 ===== |
When adding a comment/rate, the following window will appear: | When adding a comment/rate, the following window will appear: | ||
− | http://www.amule.org/dev-up/ | + | 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/ | + | 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. | 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/ | + | 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/ | + | 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 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 | |
− | + | ||
− | http://www.amule.org/dev-up/ | + | |
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: |
− | + | 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/ | + | http://www.amule.org/dev-up/window_sharefiles12.jpg |
− | + | By clicking '''Cancel''' you will retain the existing name. | |
− | http://www.amule.org/dev-up/ | + | http://www.amule.org/dev-up/window_sharefiles13.jpg |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
=== 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/ | + | 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 111: | Line 125: | ||
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/ | + | 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/ | + | 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/ | + | http://www.amule.org/dev-up/window_sharefiles16.jpg |
==== 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/ | + | 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/ | + | 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). | 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/ | + | http://www.amule.org/dev-up/window_sharefiles19.jpg |
==== 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/ | + | 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/ | + | 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/ | + | 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 == | == Overview == | ||
− | |||
{| | {| | ||
− | |+ | + | |+ Shared Files window |
+ | |colspan=2| http://www.amule.org/dev-up/window_sharefiles23.jpg | ||
+ | |- | ||
| '''Number''' || '''''Description''''' | | '''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'' | ||
+ | |} | ||
+ | |||
+ | {| | ||
+ | |+ Add friend window | ||
+ | |colspan=2| 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'' | ||
+ | |} | ||
+ | |||
+ | {| | ||
+ | |+ Add friend window | ||
+ | |colspan=2| http://www.amule.org/dev-up/window_sharefiles25.jpg | ||
+ | |- | ||
+ | | '''Number''' || '''''Description''''' | ||
+ | |- | ||
+ | | 1 || ''New file name'' | ||
+ | |- | ||
+ | | 2 || ''Cancel changes and close window'' | ||
+ | |- | ||
+ | | 3 || ''Rename file'' | ||
+ | |} | ||
+ | |||
+ | {| | ||
+ | |+ Add friend window | ||
+ | |colspan=2| 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'' |
|} | |} | ||
<center>[[Usage aMule|Back to Index]]</center> | <center>[[Usage aMule|Back to Index]]</center> |
Latest revision as of 15:32, 25 September 2008
English | Français
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) Tip: You can toggle the order of the files by either the first or the second number by clicking on the tab once or twice.
- 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 |