Torrent health

From VuzeWiki

Each torrent gets assigned a health status showing its status using colors. The health reflects the connection status of that torrent. Typically, all your torrent while have the same status after a while, but that may depend on the swarm size etc. The important part is that the "best" status you reach tells you most about the correctness of your network settings. The goal is reach green health .

The "smiley" icon can be seen e.g. in Library, in My torrents, in torrent details etc. If you do not have the smiley visible by default, you can add the Health column to the table by using Column setup.

My Library view in Vuze interface:

The explanations for different colors shown for the smileys can be found through "About Health" command in Help menu:

If you get light/dark red error smileys, you should check the torrent's details for possible error messages, which might help you in solving the possible problem.

Health	What Azureus says	Side effects	How to fix	Notes
Grey	The torrent is not running. It is either "queued" or "stopped"	No upload or download for that torrent	See: TorrentsQueued	Don't try to run more torrents than your bandwidth can cater for. See Good settings
Red	You are not connected to any other peers or seeds	No upload or download for that torrent	See Red Health and also check the torrent details for possible error messages (See below)	None
Blue	While downloading, this means the tracker is down. While uploading, it means you are not connected to any peers	Slow downloads / No upload	There is little you can do if the tracker is down. Do not click Update Tracker, it will not help, and may cause more problems for the tracker itself. If you have DHT enabled and the UDP port opened (See: PortForwarding) then you can still find other clients through DHT.	None
Yellow	This means you are connecting to some peers/seeds. However, if torrents are always yellow (as opposed to green), you may have a NAT problem which is stopping you from getting 'Remote' connections.	Slow downloads	See: PortForwarding	Your ISP may also be blocking: All data on certain ports (you need to pick a random port and possibly change it every now and then. See Port is blacklisted for more information) All BitTorrent data (you need a new ISP)
Green	This means you have both local and remote connections, the tracker is up and life is good.	None	Fix what?	None
Dark red	Something is seriously wrong with the torrent. Vuze can't keep it active.	No download or upload	Check the error messages. (See below)	None

Note: Some small torrents will never attain green status, simply because there are no remote connections to connect to. For example, if there is only one active peer in addition to you, and you manage to connect to him first, then there is nobody to contact you, and the status will remain yellow.

[edit] Possible errors

[edit] Invalid passkey

One of the most typical errors you may receive is that of "Invalid passkey" or "Unauthorized torrent". You may receive them, if you try to use such .torrent files, which use a private tracker. If you have not received the .torrent file directly from the private tracker web site, it is possible that the private tracker will reject your connection attempt as it is not your personalised copy of that torrent. (The torrent has been created for somebody else, who has then shared it with you either directly or by uploading it to an index site where you have then found it.)

[edit] Data missing

You have maybe moved files outside Vuze, or transferred existing settings to a new computer, or something like that. In any case, Vuze does not find the torrent's data files where it expects.

It gives you angry dark red health icon and the Error message in "Error: Data Missing <directory name>". Vuze should offer you the option to "Change Data Directory" in the torrent's context menu. Use it to point the torrent to the correct place for the data files.