It's not always possible to set all configurations from the GUI, especially ontheDaemonortheWebInterface.Thisguidewilltrytogiveanoverviewofhowandwhatyoucanchange.Forthelocationofthesefiles,lookattheConfigurationFilespage.Note:Theclientshouldbeclosedbeforemakingchanges,otherwisesettingswillberevertedtoit's previous state.SomeofTransmission's behavior can also be customized via EnvironmentVariables.+++Options+++Bandwidthalt-speed-enabled:Boolean(default=false,aka'Turtle Mode')Note:Clickingthe"Turtle"intheguiwhentheschedulerisenabled,willonlytemporarilyremovethescheduledlimituntilthenextcycle.alt-speed-up:Number(KB/s,default=50)alt-speed-down:Number(KB/s,default=50)speed-limit-down:Number(KB/s,default=100)speed-limit-down-enabled:Boolean(default=false)speed-limit-up:Number(KB/s,default=100)speed-limit-up-enabled:Boolean(default=false)upload-slots-per-torrent:Number(default=14)Blocklistsblocklist-url:String(default=?http://www.example.com/blocklist)blocklist-enabled:Boolean(default=false)FilesandLocationsdownload-dir:String(default=defaultlocations)incomplete-dir:String(default=defaultlocations)Directorytokeepfilesinuntiltorrentiscomplete.incomplete-dir-enabled:Boolean(default=false)Whenenabled,newtorrentswilldownloadthefilestoincomplete-dir.Whencomplete,thefileswillbemovedtodownload-dir.preallocation:Number(0=Off,1=Fast,2=Full(slowerbutreducesdiskfragmentation),default=1)rename-partial-files:Boolean(default=true)Postfixpartiallydownloadedfileswith".part".start-added-torrents:Boolean(default=true)Starttorrentsassoonastheyareadded.trash-original-torrent-files:Boolean(default=false)Deletetorrentsaddedfromthewatchdirectory.umask:Number(default=18)Setstransmission's file mode creation mask. See?theumask(2)manpageformoreinformation.Userswhowanttheirsavedtorrentstobeworld-writablemaywanttosetthisvalueto0.Bearinmindthatthejsonmarkuplanguageonlyacceptsnumbersinbase10,sothestandardumask(2)octalnotation"022"iswritteninsettings.jsonas18.watch-dir:Stringwatch-dir-enabled:Boolean(default=false)Watchadirectoryfortorrentfilesandaddthemtotransmission.Note:Whenwatch-dir-enabledistrue,onlythetransmission-daemon,transmission-gtk,andtransmission-qtapplicationswillmonitorwatch-dirfornew.torrentfilesandautomaticallyloadthem.Misccache-size-mb:Size(default=4),inmegabytes,toallocateforTransmission'smemorycache.ThecacheisusedtohelpbatchdiskIOtogether,soincreasingthecachesizecanbeusedtoreducethenumberofdiskreadsandwrites.Defaultis2ifconfiguredwith--enable-lightweight.dht-enabled:Boolean(default=true)Enable?DistributedHashTable(DHT).encryption:Number(0=Preferunencryptedconnections,1=Preferencryptedconnections,2=Requireencryptedconnections;default=1)?Encryptionpreference.EncryptionmayhelpgetaroundsomeISPfiltering,butatthecostofslightlyhigherCPUuse.lazy-bitfield-enabled:Boolean(default=true)MayhelpgetaroundsomeISPfiltering.?Vuzespecification.lpd-enabled:Boolean(default=false)Enable?LocalPeerDiscovery(LPD).message-level:Number(0=None,1=Error,2=Info,3=Debug,default=2)Setverbosityoftransmissionmessages.pex-enabled:Boolean(default=true)Enable?PeerExchange(PEX).prefetch-enabled:Boolean(default=true).Whenenabled,TransmissionwillhinttotheOSwhichpiecedatait's about to read from disk in order to satisfy requestsfrompeers.OnLinux,thisisdonebypassingPOSIX_FADV_WILLNEEDto?posix_fadvise().OnOSX,thisisdonebypassingF_RDADVISEto?fcntl().Thisdefaultstofalseifconfiguredwith--enable-lightweight.scrape-paused-torrents-enabled:Boolean(default=true)script-torrent-done-enabled:Boolean(default=false)Runascriptattorrentcompletion.script-torrent-done-filename:String(default="")Pathtoscript.utp-enabled:Boolean(default=true)Enable?MicroTransportProtocol(µTP)Peersbind-address-ipv4:String(default="0.0.0.0")Wheretolistenforpeerconnectionsbind-address-ipv6:String(default="::")Wheretolistenforpeerconnectionspeer-congestion-algorithm:String.Thisisdocumentedon?http://www.pps.jussieu.fr/~jch/software/bittorrent/tcp-congestion-control.html.peer-limit-global:Number(default=240)peer-limit-per-torrent:Number(default=60)peer-socket-tos:String(default="default")Setthe?Type-Of-Service(TOS)parameterforoutgoingTCPpackets.Possiblevaluesare"default","lowcost","throughput","lowdelay"and"reliability".Thevalue"lowcost"isrecommendedifyou're using a smart router, and shouldn'tharminanycase.PeerPortpeer-port:Number(default=51413)peer-port-random-high:Number(default=65535)peer-port-random-low:Number(default=1024)peer-port-random-on-start:Boolean(default=false)port-forwarding-enabled:Boolean(default=true)Enable?UPnPor?NAT-PMP.Queuingdownload-queue-enabled:Boolean(default=true)Whentrue,Transmissionwillonlydownloaddownload-queue-sizenon-stalledtorrentsatonce.download-queue-size:Number(default=5)Seedownload-queue-enabled.queue-stalled-enabled:Boolean(default=true)Whentrue,torrentsthathavenotshareddataforqueue-stalled-minutesaretreatedas'stalled'andarenotcountedagainstthequeue-download-sizeandseed-queue-sizelimits.queue-stalled-minutes:Number(default=30)Seequeue-stalled-enabled.seed-queue-enabled:Boolean(default=false)Whentrue.Transmissionwillonlyseedseed-queue-sizenon-stalledtorrentsatonce.seed-queue-size:Number(default=10)Seeseed-queue-enabled.RPCrpc-authentication-required:Boolean(default=false)rpc-bind-address:String(default="0.0.0.0")WheretolistenforRPCconnectionsrpc-enabled:Boolean(default=true)rpc-password:Stringrpc-port:Number(default=9091)rpc-url:String(default=/transmission/.Addedinv2.2)rpc-username:Stringrpc-whitelist:String(Comma-delimitedlistofIPaddresses.Wildcardsallowedusing'*'.Example:"127.0.0.*,192.168.*.*",Default:"127.0.0.1")rpc-whitelist-enabled:Boolean(default=true)Schedulingalt-speed-time-enabled:Boolean(default=false)Note:Whenenabled,thiswilltogglethealt-speed-enabledsetting.alt-speed-time-begin:Number(default=540,inminutesfrommidnight,9am)alt-speed-time-end:Number(default=1020,inminutesfrommidnight,5pm)alt-speed-time-day:Number/bitfield(default=127,alldays)Startwith0,thenforeachdayyouwanttheschedulerenabled,add:Sunday:1(binary:0000001)Monday:2(binary:0000010)Tuesday:4(binary:0000100)Wednesday:8(binary:0001000)Thursday:16(binary:0010000)Friday:32(binary:0100000)Saturday:64(binary:1000000)Examples:Weekdays:62(binary:0111110)Weekends:65(binary:1000001)AllDays:127(binary:1111111)idle-seeding-limit:Number(default=30)StopseedingafterbeingidleforNminutes.idle-seeding-limit-enabled:Boolean(default=false)ratio-limit:Number(default=2.0)ratio-limit-enabled:Boolean(default=false)EnvironmentVariablesUserscansetenvironmentalvariablestooverrideTransmission's default behavior andfordebugging.Transmission-SpecificVariablesIfTRANSMISSION_HOMEisset,Transmissionwilllookthereforitssettingsinsteadofinthedefaultlocation.IfTRANSMISSION_WEB_HOMEisset,TransmissionwilllooktherefortheWebInterfacefiles,suchasthejavascript,html,andgraphicsfiles.IfTR_CURL_VERBOSEisset,debugginginformationforlibcurlwillbeenabled.Moreinformationaboutlibcurl's debugging mode ?is available here.TR_DEBUG(undocumented).IfTR_DEBUG_FDissettoaninteger,thatintegeristreatedasa?filedescriptorandveryverbosedebugginginformationiswrittentoit.Forexample,hereishowtoturnondebuggingandsaveittoafilenamed"runlog"whenrunningTransmissionfromabashshell:$exportTR_DEBUG_FD=2$transmission2>runlogIfTR_DHT_VERBOSEisset,thenTransmissionwilllogalloftheDHT's activitiesinexcrutiatingdetailtostandarderror.StandardVariablesUsedByTransmissionIfTRANSMISSION_WEB_HOMEisnotset,non-MacplatformswilllookfortheWebInterfacefilesinXDG_DATA_HOMEandinXDG_DATA_DIRSasdescribedin?theXDGBaseDirectorySpecification.XDG_DATA_HOMEhasadefaultvalueof$HOME/.local/share/.IfTRANSMISSION_HOMEisnotset,Unix-basedversionsofTransmissionwilllookfortheirsettingsin$XDG_CONFIG_HOME/transmission/.XDG_CONFIG_HOMEhasadefaultvalueof$HOME/.config/.IfHOMEisset,it's used in three ways:bytheXDGvariables,asdescribedaboveIfTRANSMISSION_HOMEisnotset,Mac-basedversionsofTransmissionwilllookfortheirsettingsin$HOME/Library/ApplicationSupport/Transmission$HOME/Downloadsisthedefaultdownloaddirectory.StandardVariablesUsedByOtherToolsTransmissionusesthe?libcurllibraryforhttp-andhttps-basedtrackerannouncesandscrapes.Transmissiondoesn't support proxies, but libcurl itselfhonors?ahandfulofenvironmentvariablestocustomizeitsproxybehavior.
Last edit: cfp p2p 2013-11-04
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
From
https://trac.transmissionbt.com/wiki/EditConfigFiles
https://trac.transmissionbt.com/wiki/EditConfigFiles#Options
and
https://trac.transmissionbt.com/wiki/EnvironmentVariables
Last edit: cfp p2p 2013-11-04