Options.Advanced

From Shareaza Wiki
Revision as of 14:32, 18 October 2009 by Ocexyz (talk | contribs) (→‎Search: Added Search.GeneralThrottle description upon Ryo explanation at forum)
Jump to navigation Jump to search
  Languages:

[[::Options.Advanced|English]] • [[::Options.Advanced/de|Deutsch]] • [[::Options.Advanced/es|Español]] • [[::Options.Advanced/fr|Français]] • [[::Options.Advanced/he|עברית]] • [[::Options.Advanced/it|Italiano]] • [[::Options.Advanced/nl|Nederlands]] • [[::Options.Advanced/pl|Polski]] • [[::Options.Advanced/pt|Português]] • [[::Options.Advanced/ru|Русский]] • [[::Options.Advanced/zh-hant|‪中文(繁體)]]

e

Advanced

These settings should only be changed if you know what you are doing. The default settings are optimal for most people.

File:Settings advanced.png

Up to date as of version 2.2.1.0

Bandwidth

This section allows a user to edit bandwidth limiting functions for different aspects of the program. Setting an element ensures that the bandwidth used by that feature does not exceed the value specified. Units are in Kilobits per Second and, if set to zero, symbolizes infinity (unlimited).

Bandwidth.HubIn Default: 0 Kb/s (Unlimited) Limits the incoming bandwidth for the network connections when you are in Hub Mode.

Bandwidth.HubOut Default: 0 Kb/s (Unlimited) Limits the outgoing bandwidth for the network connections when you are in Hub Mode.

Bandwidth.HubUploads Default: 40 Kb/s Limits your upload speed when you are in Hub Mode so that you will be a better hub.

Bandwidth.LeafIn Default: 0 Kb/s (Unlimited) Limits the incoming bandwidth for the network connections when you are in Leaf Mode.

Bandwidth.LeafOut Default: 0 Kb/s (Unlimited) Limits the outgoing bandwidth for the network connections when you are in Leaf Mode.

Bandwidth.PeerIn Default: 0 Kb/s (Unlimited) Limits the incoming bandwidth for the network connections when you are in legacy Peer Mode. You will probably never have to change this unless you know what Peer mode is.

Bandwidth.PeerOut Default: 0 Kb/s (Unlimited) Limits the outgoing bandwidth for the network connections when you are in legacy Peer Mode. You will probably never have to change this unless you know what Peer mode is.

Bandwidth.Request Default: 32 Kb/s Defines the limit for requests made to other clients from the local machine including Transfer Requests, Search Requests, and other messages not directly related to a persistent Hub, Leaf, or Peer connection.

Bandwidth.UdpOut Default: 0 Kb/s (Unlimited) Defines the limit for UDP traffic from the local machine. UDP traffic is used primarily for the G2 network when performing iterative-walk searches to search the entire G2 network. This kind of traffic has a limit primarily because some Internet providers and/or hardware will not handle more than a certain amount of UDP traffic per second or drop the packets if the connection bottlenecks because of its unreliable and low-priority nature. Setting this limit lower may make your connection to the G2 network more efficient if you are experiencing inefficiency due to dropped UDP packets.

BitTorrent

This section pertains to settings used with the BitTorrent network and BitTorrent file transfers only.

BitTorrent.AutoSeed Default: 0 (False) This feature is not completed yet (so it doesn't work at all). When it is completed, if set to true, BitTorrent downloads there were being seeding when the program was quit, will be reseeded automatically when the program is restarted.

BitTorrent.BandwidthPercentage Default: 80% Shareaza will attempt to allocate this percentage of your upload speed to BitTorrent uploads.

BitTorrent.DefaultTrackerPeriod Default: 5 m Defines how often Shareaza contacts the tracker if the tracker doesn't specify how often it should be contacted. Trackers default settings often specify to BT Clients to requery every 30 minutes. (the tracker controls how often this happens). This setting should be 5 minutes, and it is very unwise to change it.

BitTorrent.LinkPing Defuault: 45 s Defines the timeout period between keep-alive pings on a BitTorrent connection. These pings are used to ensure the remote host that the local host is still persistent in an active connection.

BitTorrent.LinkTimeout Default: 180 s Defines the timeout period before Shareaza drops an active connection if it has not yet received a LinkPing from the remote host (see above).

BitTorrent.MaxTrackerRetry Default: 3 Sometimes a tracker doesn't respond because it is busy. Shareaza will retry it up to X times in short order (at least within a half minute for each attempt) in an announce cycle. This value probably shouldn't be increased from 3.

BitTorrent.RandomPeriod Default: 30 s

BitTorrent.RequestLimit Default: 128 KB Defines the maximum request size (chunk size) allowed by a remote host when it makes a file transfer request.

BitTorrent.RequestPipe Default: 4 Defines the number of concurrent BitTorrent requests that Shareaza will accept at any given time.

BitTorrent.RequestSize Default: 16 KB Defines the size requested by the local host when making file transfer requests to remote hosts. It should not be changed.

BitTorrent.SourceExchangePeriod Default: 10 m Defines the timeout period between source exchanges for BitTorrent downloads.

BitTorrent.StandardPeerID Default: 1 (True) Shareaza will follow the current method of fashioning a peer id to include user-agent information, rather than using all pseudo-random bytes.

BitTorrent.TorrentCodePage Default: 0 (use system's code page) Shareaza will assume, for torrents that have no encoding key, and are not using a unicode character set (utf-8), that the name and path keys shall be interpreted using your system's code page. Users may wish to change this value to a specific windows code page. It is most useful for correctly displaying certain interface elements within Shareaza, but it will not affect how the files are saved. An arbitrary example: if you have windows set to use Korean (code page 949), Chinese encoded torrents (using code page 950, traditional chinese) may not display correctly in the interface. If so, you may wish to change from the Default setting to 950. One might also commonly encounter Japanese (932) or Simplified Chinese (936) torrents.

BitTorrent.TorrentExtraKeys Default: 1 (True) If true, Shareaza will be able to read the encoding key, if present, and the path.utf-8 key and name.utf-8 key, if present.

BitTorrent.TorrentIgnoreErrors Default:0 (False) If true, Shareaza will be able to reseed BitTorrents whose .torrent files contain corrupted name or path keys.

BitTorrent.TrackerKey Default: 1 (True) For trackers that support the Key tracker protocol extension, it allows Shareaza to use a random key in the announces.

BitTorrent.UploadCount Default: 4 Defines the maximum number of upload slots for BitTorrent hosts who make file requests. BitTorrent does not use a queueing system, therefore this is the maximum number of BitTorrent hosts Shareaza will allow connections from at any given time. This can reasonably be raised (but not too high) for those with fast connections and capable computers.

Community

Settings for Chat.

Community.ChatFilterED2K Default: 1 (True) Allows Shareaza to filter known common spam messages, using the messagefilter.dat file, from an ed2k chat window.

Connection

This section provides options for tweaking TCP connection options from within Shareaza.

Connection.ConnectThrottle Default: 0 ms

DeleteUPnPPorts Default: 1 (True) Delete the UPnP port forwarding rules as Shareaza is quit. When Shareaza is started again, they will be reformed. The setting is recommended to be left at the default.

Connection.DetectConnectionLoss Default: 1 (True) Shareaza can sometimes detect when the internet connection is lost, and so alter its behaviour.

Connection.DetectConnectionReset Default: 0 (False)

Connection.ForceConnectedState Default: 1 (True) Detects whether internet explorer is set to offline mode, and if it is, attempts to set it to online mode.

Connection.IgnoreOwnIP Default: 1 (True) Ignore your own IP address. Can prevent Shareaza from getting confused and trying to download from itself. This setting is mostly for cosmetic purposes though.

Connection.RequireForTransfers Default: 1 (True) Dictates whether a network connection to the appropriate network (Gnutella, eDonkey, etc.) is required to be established and maintained in order for uploads or downloads to take place from sources on that network. Setting this to false allows transfers to occur using a certain protocol even if no network connection with that protocol is established. Even if set to false, there are limits to this setting's effect.

Connection.SendBuffer Default: 2048 Defines the amount of data required to accumulate before a packet is sent to a host unless the packet is flushed from the buffer (forced to be sent). Alternately, also limits the packet size to the buffer size specified. Units are in bytes.

Connection.SkipWANIPSetup Default: False A UPnP setup option.

Connection.SkipWANPPPSetup Default: False A UPnP setup option.

Connection.SlowConnect Default: 0 (False) ~~Red:The default value is 1 when Windows XP SP2 or similar environment is detected (and only if IgnoreXPsp2 is 0).~~ This setting is of interest to windows XP users. If set to true, and the user has told Shareaza to try to connect to more than one network, Shareaza try to connect to one network successfully before then trying the next network. Shareaza will also wait, after the user has told it to connect, to start downloads. This is a response to the limitation in XP service pack 2 on outgoing half-open connections.

Connection.TimeoutTraffic Default: 140 s Defines the amount of time Shareaza will wait after connecting to a host before dropping it if the host has not transmitted any traffic. Setting this too low could prevent connections to network hosts.

Discovery

This section of options configures how Shareaza behaves when making requests to host discovery services.

Discovery.AccessThrottle Deafault: 60 m Defines the timeout period between discovery service requests when performing the bootstrap discovery queries.

Discovery.BootstrapCount Default: 10 Defines the number of discovery services queried when connecting or reconnecting to the G1 or G2 networks. This occurs when you first start Shareaza if you have it set to connect to Gnutella on startup.

Discovery.CacheCount Default: 50 Defines the maximum number of caches held in the discovery services window.

Discovery.DefaultUpdate Default: 60 m Defines the timeout between queries to a discovery service to update the host cache. These are performed at the specified interval as long as Shareaza is connected or attempting to connect to a Gnutella network.

Discovery.FailureLimit Default: 2 Defines the maximum number of failures allowed from requests to the same discovery service before dropping that discovery service from the discovery cache.

Discovery.Lowpoint Default: 10 Defines the minimum number of host discovery services to keep in the host discovery services cache.

Discovery.UpdatePeriod Default: 30 m

Downloads

These options configure the way Shareaza handles download requests and file transfers from remote hosts.

Downloads.AllowBackwards Default: 1 (True) If true, this option allows Shareaza to request data in reverse order and download from sources who send data in reverse order.

Downloads.AutoClear Default:0 (False) If true, Shareaza automatically cleans up the downloads window of completed files.

Downloads.BufferSize Default: 80 KB Defines the buffer size allocated for each file transfer connection from remote hosts. Larger buffers allow data to be read from the Windows network buffers more quickly so that more data can be received if the connection becomes bottlenecked due to high CPU usage at the local host. Once the buffer is full, data requests to remote hosts will be paused until there is more space available in the buffer. This option may be used to handle large amounts of download bandwidth with mid-grade computers which cannot consistently handle the stress of high-speed connections.

Downloads.ChunkSize Default: 512 KB Defines the default file transfer request size in Kilobytes. When TigerTree hashing data is available, Shareaza will ignore this setting and make requests which are the same size as TigerTree verification chunks. This setting does not affect the total amount of data that can be downloaded from a remote host in a single active connection, but there will be a small pause between chunks if more than one is requested sequentially from a single remote host.

Downloads.ChunkStrap Default: 128 KB Defines the amount of data Shareaza will attempt to download from the beginning of the file before downloading from other parts of the file. The ChunkStrap setting is important to provide Shareaza with enough header data in most files for an accurate preview before the download is completed. It does not affect downloading from other parts of the file if the beginning is unavailable and will not slow down the file transfer in any way. If a file cannot be previewed because there is not enough header data to determine the properties of the file, setting this to a larger value may make previews of that type of file more convienient.

Downloads.ClearDelay Default: 30 s Defines the amount of time Shareaza will wait before clearing a completed (and verified or unverified if possible) download from the window if the AutoClear option is checked in the context menu of the downloads window of the Transfers tab. This option in no way affects the downloaded file.

Downloads.ConnectThrottle Default: 250 ms How long Shareaza will wait before establishing another connection. Increasing this setting can help to ease the stress on devices like routers which have a set number of connections that they can keep track of at once. 100 ms means 10 connections per second. It can be safely be increased to at least 1000 ms.

Downloads.FlushSD Default: 1 (True)

Downloads.MaxConnectingSources Default: ~~Red:It depends on the connection speed, however on Windows 9x-ME is always 16.~~ ~~Red:If Windows XP SP2 or similar environment is detected (only if IgnoreXPsp2 is 0) default value is 8.~~ Controls the number of simultaneous download connections in the connecting state. This is useful for users of Windows XP SP 2 because there is a new limit on the number of connections in the connecting state.

Downloads.MaxFileSearches Default: ~~Red:It depends on the connection speed, however on Windows 9x-ME is always 0.~~

Downloads.MaxReviews Default: 64

Downloads.Metadata Default: 1 (True) If true, Shareaza will retrieve descriptive metadata with file downloads.

Downloads.MinSources Default: 1 Defines the minimum number of sources a file must have to prevent Shareaza from issuing automatic hash queries to find more sources for that file.

Downloads.NeverDrop Default: 0 (False) If true, Shareaza will never drop a source for a download under any circumstances. Typically, Shareaza will drop sources which return errors, repeated busy messages, or timeouts. This option can be used under controlled circumstances to retry hosts which may not always be available, but should be used with discretion to avoid corrupting the alternate-sources mesh on the Gnutella networks and causing slow transfer response from download entries. It is normally quite safe to keep it false since Shareaza can always rediscover valid source from alternate source exchange, or when requerying hubs or ed2k servers for sources.

Downloads.PushTimeout Default: 45 s Defines the timeout period for Shareaza to wait before giving up on a host it has asked to respond to a push request. The clock starts after the push request is sent to the remote host. Lowering this setting may make network operations more stable on 9x machines, but lessens the chance that hosts will respond in time to push requests, even if they are able to do so.

Downloads.RequestHash Default: 0 (False) When this is enabled, it will force Shareaza to create a URL to a client requesting a resource by using a known hash if a QueryHit is returned which doesn't supply the URL to the resource.

Downloads.RequestHTTP11 Default: 1 (True) If true, Shareaza will make requests to other clients using HTTP/1.1 as defined by RFC 2616.

Downloads.RequestURLENC Default: 1 (True) If true, Shareaza sends the query url in an encoded form (for compatibility): all the special chars are changed to %xx where xx is the hex number of the ASCII value of the character.

Downloads.RetryDelay Default: 600 s Defines the starting timeout period that Shareaza waits before retrying a busy or otherwise unavailable source. This period is doubled with every unsuccessful request until the timeout becomes greater than the StarveTimeout. It isn't wise to change this value.

Downloads.SaveInterval Default: 60 s Time between updates of SD files. This ensures that you will not lose your progress in the event of a crash but has the side effect that it might cause increased disk activity.

Downloads.SearchPeriod Default: 120

Downloads.ShowPercent Default: 0 (False) If true, Shareaza will display a green bar at the top of each download's transfer progress indicator which estimates the completed percentage of the file. This is useful for a graphical linear comparison of completed percentages as usually swarmed files are downloaded in dispersed chunks, making actual progress difficult to determine.

Downloads.SortColumns Default: 1 (True) If set to true, it allows simple sorting in the downloads window by clicking on column headers. Disabled by default as it may be CPU intensive, and may cause confusion.

Downloads.SortSources Default: 1 (True)

Downloads.SparseThreshold Default: 8 MB Defines the minimum file size of a download for Shareaza to create the incomplete holder for it as a "sparse" file on NTFS volumes. Sparse files help conserve space by compressing areas of the file with no data and can be helpful with large downloads while they are still incomplete. This option does not affect files created on or moved to non-NTFS volumes.

Downloads.StaggardStart Default: 0 (False) Setting this to 1 (True) makes Shareaza wait until one connection to a particular source is dealt with (either enqueued, downloading or dropped) before trying to initiate another connection to a different source. This will slow down the rate at which download connections will be formed, but may be of assistance to those with cranky routers.

Downloads.StarveGiveup Default: 3 h

Downloads.StarveTimeout Default: 45 m Defines the minimum retry timeout a download is required to reach before becoming "starved." Downloads which become starved will not be accessed again during the active session unless the user forces them manually.

Downloads.VerifyFiles Default: 1 (True) If true, Shareaza will verify downloads using SHA1, ED2K, MD4/5, and other hashing algorithms if the hashes are available on the network. Turning this option off may save processor power when downloads are completed, but will increase the risk of downloading a corrupted file. It is recommended that this option be left on.

Downloads.VerifyTiger Default: 1 (True) If true, Shareaza will verify downloads using TTH (Tiger Tree Hashing) if the TTH information is available on the network. Turning this option off may save processor power during and after the download, but will increase the risk of downloading a corrupted file. It is recommended that this option be left on.

eDonkey

This section pertains to settings used with the eDonkey network and eDonkey file transfers only.

eDonkey.DequeueTime Default: 60 m Defines the maximum amount of time to wait for a client in your ed2k upload queue to call back before its position is dropped and forgotten about.

eDonkey.EndGame Default: 1 (True) Allow requests to more sources in the finishing stages of an ed2k download.

eDonkey.ExtendedRequest Default: 1 (True) If true, Shareaza will use ed2k extended request.

eDonkey.FastConnect Default:1 (True) If servers often give you lowid, even though you ought to be accepting incoming connections, setting this to False may help.

eDonkey.ForceHighID Default:0 (False)

eDonkey.FrameSize Default: 10 KB

eDonkey.GetSourcesThrottle Default: 8 h

eDonkey.LearnNewServers Default: 1 (True) If true, Shareaza will keep an updated host cache of eDonkey servers to connect with.

eDonkey.LearnNewServersClient Default: 0 (False) If false, Shareaza will not try to update its server list when connecting to an ed2k peer. This is to help prevent spam in the server list.

eDonkey.MagnetSearch Default: 1 (True)

eDonkey.MaxShareCount Default: 1000 The maximum number of files that will be sent in to the eD2K server and thus the maximum number of files that will be shared on eD2K. This can be used if a server is rejecting you for sharing too many files which bogs the server down.

eDonkey.MinServerFileSize Default: 0 MB

eDonkey.PacketThrottle Default: 500 ms Defines time between successive upload packets being sent.

eDonkey.QueryFileThrottle Default: 60 m

eDonkey.QueryGlobalThrottle Default: 1000 ms Defines the timeout period Shareaza waits before querying the next eDonkey server if the minimum number of desireable search results has not been reached.

eDonkey.QueryServerThrottle Default: 2 m Defines the timeout period Shareaza waits before sending the next query to any connected eDonkey servers.

eDonkey.QueueRankThrottle Default: 120 s

eDonkey.ReAskTime Default: 29 m

eDonkey.RequestPipe Default: 3

eDonkey.RequestSize Default: 90 KB Defines the download size Shareaza requests from remote hosts.

eDonkey.SourceThrottle Default: 1000 ms Limits the rate packets are sent.

eDonkey.StatsGlobalThrottle Default: 30 m

eDonkey.StatsServerThrottle Default: 7 d

eDonkey.TagNames Default: 1 (True)

Gnutella

This section pertains to settings used with all Gnutella networks and Gnutella file transfers only.

Gnutella.BlockBlankClients Default: 1 (True) Allows Shareaza to disallow connections to Gnutella clients that do not advertize a User Agent.

Gnutella.ConnectFactor Default: 4x Defines the agressiveness with which Shareaza connects to the Gnutella network. This number is multiplied by the number of desired host connections which are not yet filled to provide the number of hosts to try at a time while attempting to connect to the Gnutella network. The connections are performed independent of one another, and are neither FIFO nor LIFO in nature. Rather, as soon as a slot is available, another connection is attempted unless the desired number of connections have been reached, in which case the extra connections are dropped.

Gnutella.HitsPerPacket Default: 64 Defines the maximum number of results to return to a single query from a remote host, no matter how many entries in the local library match the query. This setting is designed to avoid flooding a host with all possible matches, instead returning a random set with each query. It also saves processing time on the local host because the search can bail out when it reaches the specified number of results.

Gnutella.HostCacheCount Default: 1024 Defines the maximum number of hosts to keep in the Gnutella host cache. The oldest or least accessed hosts are dropped from the list when new ones are added.

Gnutella.MaxHits Default: 64 See Gnutella.HitsPerPacket.

Gnutella.MaxResults Default: 100

Gnutella.RouteCache Default: 10 m Defines the timeout period before a route in the route cache is dropped if it has not been accessed in the specified time.

Gnutella.SpecifyProtocol Default: False

Gnutella1

This section pertains to settings used with the original Gnutella network and Gnutella file transfers only.

Gnutella1.DefaultTTL Default: 5 Defines the default Time-To-Live (TTL) of outgoing Gnutella 1 packets.

Gnutella1.EnableGGEP Default: 1 (True) If true, Shareaza utilizes the Gnutella Generic Extension Protocol when interfacing with Gnutella 1.

Gnutella1.HostExpire Default: 2 d (2 days) Removes older Gnutella Ultrapeers that may not be up anymore.

Gnutella1.MaxHostsInPongs Default: 10

Gnutella1.MaximumPacket Default: 65535 Defines the maximum allowed packet size in bytes. The default is set at the numeric limit for a typical 2-byte unsigned integer and may only be lowered with the current code.

Gnutella1.MaximumQuery Default: 256

Gnutella1.MaximumTTL Default: 10 Defines the maximum Time-To-Live (TTL) Shareaza will allow forwarded Gnutella 1 messages to contain.

Gnutella1.PacketBufferSize Default: 64 Defines the number of packets Shareaza will reserve space for in the packet buffer. Larger numbers may allow Shareaza to drop less overall packets in cases where network packets are seen to surge and wane regularly.

Gnutella1.PacketBufferTime Default: 60 s Defines the maximum amount of time Shareaza will wait before discarding a packet in the packet buffer if it has not yet been processed. Raising this timeout will give packets more time to be processed, lowering it will discard them more quickly.

Gnutella1.PingFlood Default: 3 s Defines the minimum allowed time between pings from a remote host before Shareaza ignores the host as a ping flood. Raising this limit may ignore hosts that are not actually flooding, while lowering it may not catch enough ping flooders.

Gnutella1.PingRate Default: 15 s

Gnutella1.PongCache Default: 10 s Defines the maximum amount of time Shareaza will wait before discarding a pong in the pong cache if it has not yet been processed.

Gnutella1.PongCount Default: 10

Gnutella1.QueryHitUTF8 Default: 0 (False)

Gnutella1.QuerySearchUTF8 Default: 0 (False)

Gnutella1.QueryThrottle Default: 20 m Defines the amount of time Shareaza will wait before sending another query to a specific connected Gnutella 1 client. Lower values will send queries more often, higher values will send queries less often. It is generally accepted to keep the value above 20 minutes to avoid flooding the network with query traffic. (This is a global throttle which controls all queries to a specific connected client.)

Gnutella1.RequeryDelay Default: 45 m Defines the amount of time Shareaza will wait before sending the same query again. Lower values will send queries more often, higher values will send queries less often. It is generally accepted to keep the value above 45 minutes to avoid flooding the network with query traffic. (This is a search-specific throttle which affects the retransmission of that query to any connected clients.)

Gnutella1.SearchTTL Default: 4 Defines the Time-To-Live (TTL) of outgoing search packets on the Gnutella 1 network.

Gnutella1.StrictPackets Default: 0 (False)

Gnutella1.TranslateTTL Default: 2

Gnutella1.VendorMsg Default: 1 (True) If true, Shareaza displays Vendor Messages with or in place of HTTP status codes.

Gnutella2

This section pertains to settings used with the Gnutella2 (G2) network and Gnutella2 file transfers only.

Gnutella2.EnableAlways Default: 1 (True) Sets whether or not Gnutella2 will always be enabled.

Gnutella2.HAWPeriod Default: 300 s

Gnutella2.HostCurrent Default: 10 m (minutes) Shareaza queries only hosts that have been recently seen.

Gnutella2.HostExpire Default: 0 d (days) Zero indicates the a G2 hub in the host cache shall not expire.

Gnutella2.HubHorizonSize Default: 128

Gnutella2.KHLHubCount Default: 50 Defines the number of hubs that Shareaza will cache in the G2 Host Cache.

Gnutella2.KHLPeriod Default: 60 s Defines the timeout period before sending out the next KHL.

Gnutella2.PingRelayLimit Default: 10 Maximum:30 Used when in hub mode only. Defines the maximum number of neighbouring nodes to send a ping relay marker to.

Gnutella2.QueryGlobalThrottle Default: 125 ms Defines the amount of time Shareaza will wait before sending another query to any connected Gnutella 2 clients. Lower values will send queries more often, higher values will send queries less often. While the G2 protocol is much less sensetive to the drawbacks of searching, it is generally accepted to keep the value above 200 milliseconds to avoid flooding any connected hosts with query traffic. (This is a global throttle which controls all queries to all connected clients.)

Gnutella2.QueryHostDeadline Default: 600 s

Gnutella2.QueryHostThrottle Default: 120 s Defines the amount of time Shareaza will wait before sending another query to the same host. Lower values will send queries more often, higher values will send queries less often. It is generally accepted to keep the value above 120 seconds to avoid flooding a host with query traffic. (This is a global throttle which controls all queries to a specific connected client.)

Gnutella2.QueryLimit Default: 2400

Gnutella2.RequeryDelay Default: 4 h Defines the amount of time Shareaza will wait before automatically sending an active search.

Gnutella2.UdpBuffers Default: 512 Defines the number of slots allocated for incoming and outgoing UDP packets in the UDP packet buffer. Larger numbers may allow Shareaza to drop less overall UDP packets in cases where network packets are seen to surge and wane regularly.

Gnutella2.UdpGlobalThrottle Default: 1

Gnutella2.UdpInExpire Default: 30 s Defines the maximum amount of time Shareaza will wait before discarding a packet in the incoming UDP packet buffer if it has not yet been processed. Raising this timeout will give packets more time to be processed, lowering it will discard them more quickly.

Gnutella2.UdpInFrames Default: 256

Gnutella2.UdpMTU Default: 500 Defines the Maximum Transmission Unit (MTU) size for UDP packets. 500 is the recommended value for best compatibility with ATM switched networks which carry traffic on the Internet in-between the source and destination hosts.

Gnutella2.UdpOutExpire Default: 26 s Defines the maximum amount of time Shareaza will wait before discarding a packet in the outgoing UDP packet buffer if it has not yet been processed. Raising this timeout will give packets more time to be processed, lowering it will discard them more quickly. Setting this value too low will drop packets on slower connections.

Gnutella2.UdpOutFrames Default: 256

Gnutella2.UdpOutResend Default: 6 s Defines the amount of time Shareaza will wait before resending the last UDP transmission if it does not receive an expected acknowledgement from the remote host.

Interface

Interface.LowResMode Default: 0 (False) Allows users with very little or low-resolution screens to see menus and options (GUI).

Library

This section configures the behavior of items in the Shareaza Library system.

Library.HashWindow Default: 0 (False) Show a little pop-up window near the system tray indicating Shareaza is hashing files. Disabled by default because of a possible display bug.

Library.HighPriorityHashing Default: 20 MB/s How quickly to hash files when hash faster is chosen in the library settings.

Library.LowPriorityHashing Default: 2 MB/s How quickly to hash files when hash slower is chosen in the library settings.

Library.MaxMaliciousFileSize Default: 1024 Bytes Warn users when there are more than 4 duplicates of files under this size in their library.

Library.QueryRouteSize Default: 20 This setting determines the size of the Query Routing Table which Shareaza sends to hubs and ultrapeers. The size is measured as 2{{box|x bits, so 2}}20 is a table 1,048,576 bits (or 131,072 bytes) large. The larger the table, the fewer queries you will receive for files you do not have, however you will have to upload and maintain the table for every hub and ultrapeer you connect with. 2{{box|20 is recommended as a good balance.

Library.SourceExpire Default: 1440 m Defines the amount of time for Shareaza to wait before discarding discovered alternate sources for files in the library.

Library.SourceMesh Default: 1 (True)

Library.ThumbSize Default: 96 Defines the square pixel size for thumbnails served to G2 clients who wish to view the remote thumbnail for a video or image file. 96 pixels is the recommended setting. Units are pixels of one edge of a square.

Library.TigerHeight Default: 9 Defines the depth level of Tiger-Tree hashing data provided by the local host to remote hosts wishing to verify files by Tiger-Tree Hashing. Larger numbers provide more detailed hashing data, but the data will take up more space on the disk and, thus, take longer to transfer to clients who request it. It is best not to change this setting.

Library.VirtualFiles Default:1 (True) If true, Shareaza will omit the tags of mp3s when hashing files in your library, and it will only advertize and share these virtual files with others. There are good reasons for setting this to false, to not strip tags. This setting, once Shareaza is updated, will only be configurable in the advanced options, whereas in 2.1.0.0 it was configurable in the uploads settings (the strip tag metadata setting). BE AWARE of this.

Library.WatchFoldersTimeout Default: 10 s (seconds)

Media Player

Media Player settings

MediaPlayer.ShortPaths Default: False Some players cannot handle unicode path names, but do work when given DOS file names (8.3 file names).

razacore

These settings pertain to the core engine of Shareaza and its interoperation with the other modules that form the basis for the application.

razacore.Debug Default: 0 (False) If true, Shareaza will display extra debugging information in the System window as it performs normal operations. While it may make the window harder to read as things scroll by much more quickly, it will not affect the operation of the program or the longevity of uptime in any way unless combined with the option below.

razacore.DebugLog Default: 0 (False) If true, Shareaza will log all events that occur to a logfile called "shareaza.log" in data folder that is normally here "C:\Documents and Settings\[Windows user name]\Application Data\Shareaza\Data". This option dumps a large amount of data into the file, so it can grow to be very large very quickly. It is recommended that this option remain disabled unless troubleshooting information is being gathered for a specific reason. The log is (mostly) encoded UTF-16, some portions are UTF-8.

razacore.DiskSpaceStop Default: 25 M Don't fill up the entire hard drive: pause downloads at this point.

razacore.DiskSpaceWarning Default: 500 M When Shareaza starts up it will check to make sure you have X amount of free space and if not it pops up a warning.

razacore.HashIntegrity Default: 1 (True)

razacore.MaxDebugLogSize Default: 10 MB

razacore.MinTransfersRest Default: 15 ms

razacore.UpdateCheck Default: 1 (True) Will check, on occasion, whether an update is available.

Search

These options configure the behavior of searches and search results at the application layer.

Search.AdvancedPanel Default: 1 (True)

Search.GeneralThrottle Default: 200 It is minimum time, in milliseconds, of delay between the same search requests to prevent hub/server hammering.

Search.HighlightNew Default: 1 (True) When conducting a new search while still retaining the display of old results, Shareaza will hightlight new search results

Search.MaxPreviewLength Default: 20 KB Defines the maximum allowable size for preview images served to remote hosts when they request a preview thumbnail.

Search.MonitorQueue Default: 128 Defines the maximum number of searches to display in the scrolling search monitor. This list behaves in a FIFO manner.

Search.SchemaTypes Default: 1 (True) If true, search results are filtered based on file extensions defined in schemas, if schemas are not available. This setting is dubious, at least it should allow to organize newly downloaded files in the Library based on the extension.

Search.ShowNames Default: 1 (True) If true, Shareaza displays detected client names of hosts in search results instead of their IP addresses. The IP addresses can still be seen by hovering over the host to see the popup tooltip window. If false, the search window will not show the nicks of the clients that come up in a search, but show their ip address. This is useful to detect spam results.

Search.SpamFilterThreshold Default: 20% Percentage of hits with spam characteristics needed to trigger a file to be seen as suspicious.

Uploads

These options configure the way Shareaza makes uploads and handles file transfer requests from remote hosts.

Uploads.AllowBackwards Default: 1 (True) If true, this option allows Shareaza to send data in reverse order and upload to sources who want to receive data in reverse order.

Uploads.AutoClear Default: 0 (False) If false, Shareaza keeps a list of completed upload events (to a certain number).

Uploads.ClampdownFactor Default: 20% The percentage of total upload limit reserved for each upload slot (calculated from average or maximim, depending on the setting).

Uploads.ClampdownFloor Default: 8 Kb/s Defines the amount of speed a slot must sustain before another slot is open. So if you have it set to 8kb/s (1KB/s) which means that if someone is downloading from you at LOWER than 1KB/s or 8kb/s then another slot will open and Shareaza will keep doing it until you have all your slots open.

Uploads.ClearDelay Default: 30 s Defines the amount of time Shareaza will wait before clearing a completed or inactive upload from the window if the "AutoClear" option is checked in the context menu of the Uploads window of the Transfers tab. This option in no way affects the upload transfer.

Uploads.DynamicPreviews Default: 1 (True)

Uploads.FreeBandwidthFactor Default: 15% Percentage of Bandwidth that has to be available before a new upload slot is opened. Related to Uploads.FreeBandwidthValue. Shareaza will use the condition which becomes true first.

Uploads.FreeBandwidthValue Default: 20 Kb/s Absolute value of Bandwidth that has to be available before a new upload slot is opened. Related to Uploads.FreeBandwidthFactor. Shareaza will use the condition which becomes true first.

Uploads.PreviewQuality Default: 40% Defines the quality of preview images served to remote hosts who request a preview thumbnail for an image or video file. Lower numbers will yeild smaller file sizes and faster transfers, but less detailed images.

Uploads.PreviewTransfers Default: 3 Defines the maximum number of transfers allocated for preview images served to remote hosts who request a preview thumbnail for an image or video file. Raising this number will allow more users to download preview thumbnails at once, but will increase the potential bandwidth usage as a result. The same setting is used to limit Library browsing at the same time.

Uploads.QueuePollMax Default: 120 s Defines the maximum amount of time Shareaza will wait before dropping a queued remote host if it has not sent another file transfer request while waiting in a queue line. Setting this to larger values may keep queue positions open longer than necessary in most cases. Setting it to smaller values may not give hosts enough time to resend file transfer requests and may unnecessarily drop hosts from the queue line.

Uploads.QueuePollMin Default: 45 s Defines the minimum amount of time remote hosts must wait before sending a queued file transfer request without being dropped from the queue line. This value gets smaller and smaller as the remote host moves to the front of the queue, governed by the local host. Setting this to smaller values will allow remote hosts to query for their queue positions more often, but use more bandwidth. Setting it to larger values will force remote hosts to wait longer before querying for queue positions or they will be dropped from the queue. This value may not exceed Uploads.QueuePollMax.

Uploads.RewardQueuePercentage Default: 10%

Uploads.RotateChunkLimit Default: 1024 KB This setting will ensure that a user you are uploading to finishes a chunk before you stop uploading to rotate to the next user. This allows the other user to verify that chunk and, in turn, share the chunk through partial file sharing. Changing this setting is not recommended.