Difference between revisions of "Usage Shared Files"

From AMule Project FAQ
Jump to: navigation, search
 
m (Added Language selection)
 
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
<center>
 +
'''English''' |
 +
[[Usage_Shared_Files-fr|Fran&ccedil;ais]]
 +
</center>
 +
 
[[Usage aMule|Back to Index]]
 
[[Usage aMule|Back to Index]]
  
 
== Description ==
 
== Description ==
  
−
The Shared Files window allows you to see and manage the files you are sharing.
+
The Shared Files window allows you to see and manage the [[shared file|files you are sharing]].
  
 
It looks like this:
 
It looks like this:
  
−
http://www.amule.org/dev-up/window_shared1.jpg
+
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 two main things you can do from this window:
+
There are three things you can do from this window:
−
*Manage your shared files
+
*see the properties of any shared file that you highlight;
−
*See your shared file's statistics
+
*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 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 [[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 ===
 
=== 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
  
−
http://www.amule.org/dev-up/window_shared2.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 [[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 (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 [[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 =====
 +
 
 +
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 [[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
 +
 
 +
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 =====
 +
 
 +
[[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
 +
 
 +
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. 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 ===
 
=== 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_shared3.jpg
+
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 [[upload]]ing 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 [[upload]]ed 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 ==
 
== Overview ==
  
−
http://www.amule.org/dev-up/window_shared
 
 
{|
 
{|
−
|+ Quick Reference
+
|+ 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

Back to Index

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

Shared Files window
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
Add friend window
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
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
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
Back to Index
Retrieved from "http://wiki.amule.org/t/index.php?title=Usage_Shared_Files&oldid=23911"