Some Internet Service Providers (ISPs) throttle peer-to-peer traffic, and even block it completely on well known peer-to-peer ports. If your ISP is listed on this page, it is likely you will experience these issues.
-
Transmission's encryption feature may overcome some ISP throttling. Checking the 'Ignore unencrypted peers' box (Preferences -> Peers) also may improve your speed further, at the expense of losing some potential peers in the swarm. Changing the port Transmission uses may help if the ISP targets particular ports.
-
-
Ultimately, the speed you get depends on the quality of the peers you are downloading from. If they have dial up connections, you are only going to be able to download at dial up speeds.
- Furthermore, if there are few seeds and many peers, more people will be fighting for the same scarce pieces which will slow things down.
- Best results are achieved when the torrent has more seeds than peers.
-
-
-
Why isn't my torrent downloading at all?
-
-
Often this is because the tracker is down, and thus Transmission is unable to interact with other peers. If this is the case, enabling DHT (trackerless torrents) (Preferences -> Peers) might help for public torrents.
-
If there are no seeders in the swarm, and all the other peers have sent you what they have, you (and everyone else) will not be able to complete the download, and your speed will drop to zero.
-
Torrents take a while to get going and so may not download much (if at all) initially. Most torrents are downloading at some rate after 15 or so minutes.
-
-
-
Transmission crashed, what should I do?
-
-
Post the crash log on the support forums so that the issue can be fixed as quickly as possible. Crash logs are held in ~/Library/Logs/CrashReporter/.
-
If your torrents' progress are incorrect when you reopen Transmission (e.g. they are starting from 0%) then you should manually recheck them. Click here for instructions.
-
-
-
What do the colors mean in the pieces box?
-
-
Blue: we have this piece - lighter shades of blue (progress only) indicate incomplete pieces
- Green: connected peers have this piece (available only) - the darker the green, the more there are
- White: no connected peers have this piece (available) or we do not have any of this piece (progress)
-
-
-
-
What are seeds/peers/leechers?
-
-
Peers are people you are connected to. If they have the whole file and are only uploading, they are referred to as a 'seeder'. If they only have part of the torrent, and are downloading and uploading, they are referred to as a 'leecher'.
-
-
-
What is the ratio shown during seeding?
-
-
This shows your upload/download ratio. 1.00 means you have uploaded as much as you have downloaded, 2.00 means you have uploaded twice the amount you have downloaded, etc.
-
-
-
What are 'Magnet links'?
-
-
Magnet links contain a torrent's hash, or unique identifier, as well as a tracker address, allowing a torrent to be added without downloading a torrent file.
-
-
What do the stats in the Activity tab of the Inspector mean?
-
-
Have is the sum of verified and unverified data. The Verified amount, in brackets, is how much checksum-verified data you have downloaded.
- Downloaded is all the data you have downloaded.
- Uploaded is all of the data you have uploaded.
- Failed DL is data that failed our checksum test and needs to be downloaded again.
- Ratio is the ratio of download data to uploaded data.
-
-
-
What does the 'Tracker' tab mean in the Inspector?
Nightlies are releases on the bleeding edge of development. They normally contain new features and bugfixes, but are not officially supported (although you are more than welcome to discuss them on the Transmission forums). You can try one out here.
+
Some Internet Service Providers (ISPs) throttle peer-to-peer traffic, and even block it completely on well known peer-to-peer ports. If your ISP is listed on this page, it is likely you will experience these issues.
+
Transmission's encryption feature may overcome some ISP throttling. Checking the 'Ignore unencrypted peers' box (Preferences → Peers) also may improve your speed further, at the expense of losing some potential peers in the swarm. Changing the port Transmission uses may help if the ISP targets particular ports.
+
+
Ultimately, the speed you get depends on the quality of the peers you are downloading from. If they have dial up connections, you are only going to be able to download at dial up speeds. Furthermore, if there are few seeds and many peers, more people will be fighting for the same scarce pieces which will slow things down. Best results are achieved when the torrent has more seeds than peers.
+
+
+
Why isn't my torrent downloading at all?
+
+
+
Often this is because the tracker is down, and thus Transmission is unable to interact with other peers. If this is the case, enabling DHT (trackerless torrents) (Preferences → Peers) might help for public torrents.
+
If there are no seeders in the swarm, and all the other peers have sent you what they have, you (and everyone else) will not be able to complete the download, and your speed will drop to zer.
+
Torrents take a while to get going and so may not download much (if at all) initially. Most torrents are downloading at some rate after 15 or so minutes.
+
+
Transmission crashed, what should I do?
+
+
Post the crash log on the support forums so that the issue can be fixed as quickly as possible. Crash logs are held in ~/Library/Logs/CrashReporter/.
+
If your torrents' progress are incorrect when you reopen Transmission (e.g. they are starting from 0%) then you should manually recheck them. Click here for instructions.
+
+
+
What do the colors mean in the pieces box?
+
+
Blue: we have this piece - lighter shades of blue (progress only) indicate incomplete pieces
+ Green: connected peers have this piece (available only) - the darker the green, the more there are
+ White: no connected peers have this piece (available) or we do not have any of this piece (progress)
+
+
+
+
What are seeds/peers/leechers?
+
+
Peers are people you are connected to. If they have the whole file and are only uploading, they are referred to as a 'seeder'. If they only have part of the torrent, and are downloading and uploading, they are referred to as a 'leecher'.
+
+
What is the ratio shown during seeding?
+
+
This shows your upload/download ratio. 1.00 means you have uploaded as much as you have downloaded, 2.00 means you have uploaded twice the amount you have downloaded, etc.
+
+
What are 'Magnet links'?
+
+
Magnet links contain a torrent's hash, or unique identifier, as well as a tracker address, allowing a torrent to be added without downloading a torrent file.
+
+
What do the stats in the Activity tab of the Inspector mean?
+
+
Have is the sum of verified and unverified data. The Verified amount, in brackets, is how much checksum-verified data you have downloaded.
+ Downloaded is all the data you have downloaded.
+ Uploaded is all of the data you have uploaded.
+ Failed DL is data that failed our checksum test and needs to be downloaded again.
+ Ratio is the ratio of download data to uploaded data.
+
+
+
What does the 'Tracker' tab mean in the Inspector?
Nightlies are releases on the bleeding edge of development. They normally contain new features and bugfixes, but are not officially supported (although you are more than welcome to discuss them on the Transmission forums). You can try one out here.
+
+
+
diff --git a/macosx/TransmissionHelp/html/Index2.html b/macosx/TransmissionHelp/html/Index2.html
index f2dd357fd..044540732 100644
--- a/macosx/TransmissionHelp/html/Index2.html
+++ b/macosx/TransmissionHelp/html/Index2.html
@@ -13,7 +13,7 @@
Make sure Transmission's port is forwarded. Port forwarding makes it easier for others to connect to you, which therefore increases your speed.
-
-
If your router supports NAT-PMP, UPnP, or you have Apple AirPort, Transmission can do this automatically; just tick the checkbox in Preferences -> Network.
+
+
If your router supports NAT-PMP, UPnP, or you have Apple AirPort, Transmission can do this automatically; just tick the checkbox in Preferences → Network.
-
-
Make sure you cap your upload speed, so that it isn't flooded. A good rule of thumb is about 60-70% of your maximum upload bandwidth. This can be adjusted in Preferences -> Bandwidth, or in real time using the Action menu.
-
+
+
Make sure you cap your upload speed, so that it isn't flooded. A good rule of thumb is about 60-70% of your maximum upload bandwidth. This can be adjusted in Preferences → Bandwidth, or in real time using the Action menu.
+
eg. If your upload connection is 256 Kilobits/sec, then you should cap it at 21 KB/sec ((256 / 8) * 0.66 = 21).
-
-
Queue your transfers. Transmission's queue preferences are located in Transfers -> Management.
+
+
Queue your transfers. Transmission's queue preferences are located in Transfers → Management.
Remember, your download speed is proportional to how fast you upload. If there are many transfers running, then each transfer will only receive a small proportion of your upload bandwidth, reducing their respective download speeds.
To avoid spreading your upload too thinly, a good rule of thumb is to have at least 128 KBit/sec of upload bandwidth for every torrent you wish to run simultaneously.
-
-
+
+
eg. If your upload bandwidth is 256 KBit/sec, then you should only have two (256/128 = 2) downloading transfers in the queue.
If Transmission crashes, you may want to manually recheck your files to both verify that the download has not been corrupted, and to ensure that the download continues where it left off, and does not start over.
-
If Transmission crashes, you may want to manually recheck your files to both verify that the download has not been corrupted, and to ensure that the download continues where it left off, and does not start over.
-
-
Transmission is a BitTorrent client. It is used for peer to peer filesharing over the internet. BitTorrent is a fast way of transferring files, because everyone who downloads must also upload to others. This means speeds are only limited by the number of people connected to a given torrent - the more people the better!
+
+
+
+
How do I use it?
+
+
+
Download your file's associated 'torrent file' (extension .torrent). These are commonly found at 'tracker' websites.
+
Once you have the torrent file, drag it into Transmission - downloading should start immediately.
+
You can pause and resume transfers at any time, so long as the files remain in your download folder.
+
It is good etiquette to share or 'seed' the file for a while (ie leave it uploading) once your download is complete.
+
You can use Transmission's action menu, the individual torrent menu, as well as the Inspector to adjust download and seeding preferences on the fly.
Yes, you can share a file or folder by dragging it into Transmission. Alternatively, click 'Create' in the toolbar, and choose your file.
+
When the dialog box appears, enter your tracker address (or addresses), comments, and private status.
+
You can change the torrent filename, as well as where it will be saved to, by clicking 'Change'.
+
Once you are done, click 'Create'. Transmission will automatically optimize the torrent file for what you are sharing.
+
+
+
Can I schedule my transfers?
+
+
+
Yes, by using 'Speed Limit Mode'. Simply go to Preferences → Bandwidth, and then set both the speed you would like Transmission to be limited to, as well as the period of time you would like the limits applied.
+
When Speed Limit Mode is enabled, the turtle will be illuminated in blue.
+
+
+
Can I queue my transfers?
+
+
+
Yes, you can queue seeding and/or downloading transfers via Preferences → Transfers → Management.
+
The queue system is very simple: You start and pause transfers as usual, but if you're over the queue limit starting a transfer will instead make it "Waiting to download..."
+
You can force a transfer to start by holding down option and clicking the orange resume button, or by using the Transfers menu item "Resume Selected Without Wait".
+
+
+
How can I organize my torrents?
+
+
+
Transmission allows you to sort your torrents by various criteria. Choose "Sort Transfers By" in the View menu, as well as the Action menu.
+
You can also filter your torrents by their activity state. Simply enable the Filter bar in the View menu.
+
Transmission allows you to group torrents by color labels. Groups can be assigned upon adding a transfer to the list by establishing rules in Preferences → Groups. Groups can be manually changed with Transfers → Group and by dragging transfers to different groups in the main window (when "Use Groups" is enabled in the View menu).
+
These groups can be used as sorting and filtering criteria. Add, remove, and modify groups in Preferences → Groups. Groups can also be used for choosing the data location when adding transfers - this location is also set in the Groups preference window tab.
+
+
+
Where can I find more detailed information on my torrents?
+
+
+
Click the Inspector icon, or simply double-click any transfer in the main window.
+
The inspector gives you:
+
+
Statistics on the torrent and files you are downloading
+
Information about the peers and trackers you are connected to
+
Options to fine-tune your bandwidth allocation
+
+
+
+
+
Can I choose to download specific files?
+
+
+
Yes, either upon opening a torrent, or once it has started. When you open a multi-file torrent, a detailed Open window will appear, allowing you to select specific files.
+
For transfers which are already running, double click them to open the Inspector, and then click the 'Files' tab. Simply check the boxes next to the files you want to download (the default is all of them).
+
You can even set a priority (high, normal, or low) to each file, if you want some to finish faster than others. To do so, use the selector that appears next to the checkboxes.
+
If the window doesn't appear when opening a torrent, ensure that "Display options window" is checked in Preferences → Transfers → Adding.
+
+
+
+
-
-
-
-
-
-
-
Welcome to Transmission!
-
-
Transmission is a BitTorrent client. It is used for peer to peer filesharing over the internet. BitTorrent is a fast way of transferring files, because everyone who downloads must also upload to others. This means speeds are only limited by the number of people connected to a given torrent - the more people the better!
-
-
-
-
-
-
How do I use it?
-
-
-
-
-
-
Download your file's associated 'torrent file' (extension .torrent). These are commonly found at 'tracker' websites.
-
Once you have the torrent file, drag it into Transmission - downloading should start immediately.
-
You can pause and resume transfers at any time, so long as the files remain in your download folder.
-
It is good etiquette to share or 'seed' the file for a while (ie leave it uploading) once your download is complete.
-
You can use Transmission's action menu, the individual torrent menu, as well as the Inspector to adjust download and seeding preferences on the fly.
-
Yes, you can share a file or folder by dragging it into Transmission. Alternatively, click 'Create' in the toolbar, and choose your file.
-
When the dialog box appears, enter your tracker address (or addresses), comments, and private status.
-
You can change the torrent filename, as well as where it will be saved to, by clicking 'Change'.
-
Once you are done, click 'Create'. Transmission will automatically optimize the torrent file for what you are sharing.
-
-
-
-
-
-
-
-
Can I schedule my transfers?
-
-
-
-
-
-
Yes, by using 'Speed Limit Mode'. Simply go to Preferences -> Bandwidth, and then set both the speed you would like Transmission to be limited to, as well as the period of time you would like the limits applied.
-
When Speed Limit Mode is enabled, the turtle will be illuminated in blue.
-
-
-
-
-
-
-
-
Can I queue my transfers?
-
-
-
-
-
-
Yes, you can queue seeding and/or downloading transfers via Preferences -> Transfers -> Management.
-
The queue system is very simple: You start and pause transfers as usual, but if you're over the queue limit starting a transfer will instead make it "Waiting to download..."
-
You can force a transfer to start by holding down option and clicking the orange resume button, or by using the Transfers menu item "Resume Selected Without Wait".
-
-
-
-
-
-
-
-
-
How can I organize my torrents?
-
-
-
-
-
-
Transmission allows you to sort your torrents by various criteria. Choose "Sort Transfers By" in the View menu, as well as the Action menu.
-
You can also filter your torrents by their activity state. Simply enable the Filter bar in the View menu.
-
Transmission allows you to group torrents by color labels. Groups can be assigned upon adding a transfer to the list by establishing rules in Preferences -> Groups. Groups can be manually changed with Transfers -> Group and by dragging transfers to different groups in the main window (when "Use Groups" is enabled in the View menu).
-
These groups can be used as sorting and filtering criteria. Add, remove, and modify groups in Preferences -> Groups. Groups can also be used for choosing the data location when adding transfers - this location is also set in the Groups preference window tab.
-
-
-
-
-
-
-
-
-
Where can I find more detailed information on my torrents?
-
-
-
-
-
-
Click the Inspector icon, or simply double-click any transfer in the main window.
-
The inspector gives you:
-
-
Statistics on the torrent and files you are downloading
-
Information about the peers and trackers you are connected to
-
Options to fine-tune your bandwidth allocation
-
-
-
-
-
-
-
-
-
-
-
Can I choose to download specific files?
-
-
-
-
-
-
Yes, either upon opening a torrent, or once it has started. When you open a multi-file torrent, a detailed Open window will appear, allowing you to select specific files.
-
For transfers which are already running, double click them to open the Inspector, and then click the 'Files' tab. Simply check the boxes next to the files you want to download (the default is all of them).
- You can even set a priority (high, normal, or low) to each file, if you want some to finish faster than others. To do so, use the selector that appears next to the checkboxes.
-
If the window doesn't appear when opening a torrent, ensure that "Display options window" is checked in Preferences -> Transfers -> Adding.
-
The Micro Transport Protocol (µTP) is a protocol designed to reduce latency and network congestion. Transfers are automatically slowed down when they are interfering with other applications. This feature is compatible with all other µTP-compatible clients.
-
-
-
Why do I see a red dot and 'Port is closed'?
-
-
You haven't port forwarded correctly. Port forwarding opens a port in your firewall or router so that incoming connections from the outside world can be made with Transmission. If the port is forwarded, other people in the torrent can see you, thus increasing your potential number of connections, which more importantly, might increase the speed of your download.
-
You need to port forward if you share your internet connection with a router, or if your broadband modem is a router itself. In most cases Transmission can do this automatically, see this page for instructions on port forwarding.
+
The Micro Transport Protocol (µTP) is a protocol designed to reduce latency and network congestion. Transfers are automatically slowed down when they are interfering with other applications. This feature is compatible with all other µTP-compatible clients.
+
+
+
Why do I see a red dot and 'Port is closed'?
+
+
You haven't port forwarded correctly. Port forwarding opens a port in your firewall or router so that incoming connections from the outside world can be made with Transmission. If the port is forwarded, other people in the torrent can see you, thus increasing your potential number of connections, which more importantly, might increase the speed of your download.
+
You need to port forward if you share your internet connection with a router, or if your broadband modem is a router itself. In most cases Transmission can do this automatically, see this page for instructions on port forwarding.
Peer Exchange (PEX) is a method of discovering new peers via other peers, rather than the tracker. It allows Transmission to attach to the swarm much quicker.
- PEX is automatically disabled for privately tracked torrents. The feature is compatible with both Vuze and µTorrent peers.
-
+
Peer Exchange (PEX) is a method of discovering new peers via other peers, rather than the tracker. It allows Transmission to attach to the swarm much quicker. PEX is automatically disabled for privately tracked torrents. The feature is compatible with both Vuze and µTorrent peers.
What is the 'distributed hash table'?
-
The Distributed Hash Table (DHT) allows peers to be obtained without connecting to the tracker. This allows transfers to continue even if trackers are unreachable.
- It is another way that Transmission can attach to the swarm quicker. DHT is automatically disabled for privately tracked torrents.
-
+
The Distributed Hash Table (DHT) allows peers to be obtained without connecting to the tracker. This allows transfers to continue even if trackers are unreachable. It is another way that Transmission can attach to the swarm quicker. DHT is automatically disabled for privately tracked torrents.
What is encryption?
-
Transmission encrypts the connections it makes with other peers when necessary, using the RC4 cipher. The implementation is compatible with other clients such as Vuze and µTorrent. It is always enabled, however you can set Transmission (Preferences -> Peers) to prefer encrypted peers or to ignore unencrypted peers completely.
-
Note that the latter option may make Transmission unconnectable in some swarms. The encryption feature does not mean your session is secure or anonymous, it is merely a way to avoid the traffic shaping measures some ISPs have implemented.
+
Transmission encrypts the connections it makes with other peers when necessary, using the RC4 cipher. The implementation is compatible with other clients such as Vuze and µTorrent. It is always enabled, however you can set Transmission (Preferences → Peers) to prefer encrypted peers or to ignore unencrypted peers completely.
+
Note that the latter option may make Transmission unconnectable in some swarms. The encryption feature does not mean your session is secure or anonymous, it is merely a way to avoid the traffic shaping measures some ISPs have implemented.
What are 'connections'?
-
Global maximum connections (Preferences -> Peers) is the total number of peers that Transmission will connect to across all of your transfers. Connections per torrent can also be adjusted here, as well as in the Inspector.
-
It is recommended that these values are left at their default setting, as allowing too many connections will severely hinder web browsing and other online activities, as well as possibly crashing your router. Increase this value at your own risk!
-
-
-
-
Recommended settings:
-
-
Global maximum connections: 200
-
Maximum connections for new transfers: 60
-
-
-
-
-
What is a blocklist?
-
-
Transmission can block specific peers by utilizing a blocklist. An internet address for a blocklist file containing a list of IP addresses can be entered (Preferences -> Peers) and configured to auto-update weekly. Blocklists can also be manually added into ~/Library/Application Support/Transmission.
-
The internet address may be to a text file or compressed file. Most standard compression formats are supported, including ZIP.
-
+
Global maximum connections (Preferences → Peers) is the total number of peers that Transmission will connect to across all of your transfers. Connections per torrent can also be adjusted here, as well as in the Inspector.
+
It is recommended that these values are left at their default setting, as allowing too many connections will severely hinder web browsing and other online activities, as well as possibly crashing your router. Increase this value at your own risk!
+
+
Recommended settings:
+
+
Global maximum connections: 200
+
Maximum connections for new transfers: 60
+
+
+
+
+
What is a blocklist?
+
+
Transmission can block specific peers by utilizing a blocklist. An internet address for a blocklist file containing a list of IP addresses can be entered (Preferences → Peers) and configured to auto-update weekly. Blocklists can also be manually added into ~/Library/Application Support/Transmission.
+
The internet address may be to a text file or compressed file. Most standard compression formats are supported, including ZIP.
-
+
diff --git a/macosx/TransmissionHelp/html/pffirewall.html b/macosx/TransmissionHelp/html/pffirewall.html
index 7bf39e70a..474c92cc7 100644
--- a/macosx/TransmissionHelp/html/pffirewall.html
+++ b/macosx/TransmissionHelp/html/pffirewall.html
@@ -1,36 +1,31 @@
-
-
-
- Configuring the Mac OS X Firewall
-
-
-
Upon opening Transmission for the first time, a Mac OS X dialog box should appear asking if you will allow Transmission to receive incoming connections. Click Accept.
-
If this doesn't happen, you can add Transmission to the firewall manually:
-
-
-
Open System Prefs -> Security -> Firewall. Make sure "Set access for specific services and applications" is selected.
-
Click the "+" button and select Transmission from your Applications folder.
-
Make sure the pull down menu is set to "Allow incoming connections".
-
Upon opening Transmission for the first time, a Mac OS X dialog box should appear asking if you will allow Transmission to receive incoming connections. Click Accept.
+
If this doesn't happen, you can add Transmission to the firewall manually:
+
+
+
Open System Prefs → Security → Firewall. Make sure "Set access for specific services and applications" is selected.
+
Click the "+" button and select Transmission from your Applications folder.
+
Make sure the pull down menu is set to "Allow incoming connections".
+
+
+
diff --git a/macosx/TransmissionHelp/html/pfrouter.html b/macosx/TransmissionHelp/html/pfrouter.html
index eeaef266c..f9b10075d 100644
--- a/macosx/TransmissionHelp/html/pfrouter.html
+++ b/macosx/TransmissionHelp/html/pfrouter.html
@@ -1,76 +1,74 @@
-
-
-
-
- Port Forwarding a Router
-
-
-
If you are using a router, it is probably OK to disable the OS X firewall, as you are already being protected by the router. To disable the firewall, open System Prefs -> Security -> Firewall. Click Stop.
-
-
To forward a port in your router manually:
-
-
-
-
Find out what your IP address is. You can find your computer's IP address by going to System Prefs -> Network, double-clicking on your connection (for instance, Built-in Ethernet), and clicking the TCP/IP tab. It's probably something like 192.168.1.100, or 10.0.1.2.
-
Open Transmission, go to preferences, and enter a number for the port. It is recommended you pick a random number between 49152 and 65535. Let's use 50001 for now. Then quit Transmission.
-
Go into your router configuration screen. Normally this is done via your web browser using the address 192.168.0.1 etc.
- Note: Apple's AirPort uses an application called 'AirPort Utility' to configure it.
-
Find the port forwarding (sometimes called port mapping) screen. While the page will be different for each router generally you will enter something similar to the following:
-
-
-
For 'Application' type 'Trans'.
-
For 'Start Port' and 'End Port' type in the port you chose in Step 2. eg 50001.
-
For Protocol, choose Both.
-
For IP address, type in your IP address you found in Step 1. eg 10.0.1.2.
-
Check Enable.
-
Click save settings.
-
-
-
For more comprehensive instructions specific to your router, click here and choose your router from the list.
-
-
-
-
If you find yourself having to change your router settings all the time, a static IP address might be beneficial.
-
-
-
What is a static IP?
-
-
A static IP is when your computer is assigned an IP address which does not change. This can be helpful if you have a laptop or have multiple computers on your network. While it makes things a bit simpler, you don't have to have a static IP for BitTorrent or Port Forwarding to work.
-
A dynamic IP address assigned by your wireless router for example will most likely not change unless you reboot your computer, or leave and rejoin the network. Thus, having a static IP isn't really necessary, especially if your router supports UPnP.
-
-
-
How do I get a static IP address?
-
-
-
-
Go to System Prefs -> Network, double-click on your connection (for instance, Built-in Ethernet), and click the TCP/IP tab.
-
Write down the IP, Subnet Mask and Router addresses.
-
Go to your router 'status' page via your web browser (AirPort Admin Utility if you are using an AirPort BS), and write down the DNS Server addresses. Alternatively, you can enter your router's internal IP (e.g. 192.168.0.1). This is sometimes quicker, as it refers to the router instead of the server.
-
Then, return to the TCP/IP page in System Prefs.
-
Choose "Manually" from the Configure IPv4 drop down menu.
-
Enter the IP address you wish to have, eg 192.168.0.100, or 10.0.1.100. It should be of a similar format to the IP address you found in step 2, with only the last number changing.
- Note: You cannot have a static IP address that's within the DHCP range. Thus it is recommended that you make the last digit of your address large enough to discount this possibility, like we have done in our examples.
-
Fill in the other boxes using the addresses you wrote down in steps 2 and 3.
-
Click 'Apply Now'.
-
-
-
-
+
+
Port Forwarding a Router
+
+
If you are using a router, it is probably OK to disable the OS X firewall, as you are already being protected by the router. To disable the firewall, open System Prefs → Security → Firewall. Click Stop.
+
+
To forward a port in your router manually:
+
+
+
+
Find out what your IP address is. You can find your computer's IP address by going to System Prefs → Network, double-clicking on your connection (for instance, Built-in Ethernet), and clicking the TCP/IP tab. It's probably something like 192.168.1.100, or 10.0.1.2.
+
Open Transmission, go to preferences, and enter a number for the port. It is recommended you pick a random number between 49152 and 65535. Let's use 50001 for now. Then quit Transmission.
+
Go into your router configuration screen. Normally this is done via your web browser using the address 192.168.0.1 etc.
+ Note: Apple's AirPort uses an application called 'AirPort Utility' to configure it.
+
Find the port forwarding (sometimes called port mapping) screen. While the page will be different for each router generally you will enter something similar to the following:
+
+
+
For 'Application' type 'Trans'.
+
For 'Start Port' and 'End Port' type in the port you chose in Step 2. eg 50001.
+
For Protocol, choose Both.
+
For IP address, type in your IP address you found in Step 1. eg 10.0.1.2.
+
Check Enable.
+
Click save settings.
+
+
+
For more comprehensive instructions specific to your router, click here and choose your router from the list.
+
+
+
+
If you find yourself having to change your router settings all the time, a static IP address might be beneficial.
+
+
+
What is a static IP?
+
+
A static IP is when your computer is assigned an IP address which does not change. This can be helpful if you have a laptop or have multiple computers on your network. While it makes things a bit simpler, you don't have to have a static IP for BitTorrent or Port Forwarding to work.
+
A dynamic IP address assigned by your wireless router for example will most likely not change unless you reboot your computer, or leave and rejoin the network. Thus, having a static IP isn't really necessary, especially if your router supports UPnP.
+
+
+
How do I get a static IP address?
+
+
+
+
Go to System Prefs → Network, double-click on your connection (for instance, Built-in Ethernet), and click the TCP/IP tab.
+
Write down the IP, Subnet Mask and Router addresses.
+
Go to your router 'status' page via your web browser (AirPort Admin Utility if you are using an AirPort BS), and write down the DNS Server addresses. Alternatively, you can enter your router's internal IP (e.g. 192.168.0.1). This is sometimes quicker, as it refers to the router instead of the server.
+
Then, return to the TCP/IP page in System Prefs.
+
Choose "Manually" from the Configure IPv4 drop down menu.
+
Enter the IP address you wish to have, eg 192.168.0.100, or 10.0.1.100. It should be of a similar format to the IP address you found in step 2, with only the last number changing.
+ Note: You cannot have a static IP address that's within the DHCP range. Thus it is recommended that you make the last digit of your address large enough to discount this possibility, like we have done in our examples.
+
Fill in the other boxes using the addresses you wrote down in steps 2 and 3.
+
Click 'Apply Now'.
+
+
+
+
+
diff --git a/macosx/TransmissionHelp/html/portforward.html b/macosx/TransmissionHelp/html/portforward.html
index d12e61f38..83dd645b5 100644
--- a/macosx/TransmissionHelp/html/portforward.html
+++ b/macosx/TransmissionHelp/html/portforward.html
@@ -1,2 +1,38 @@
-
Port Forwarding FAQ
If your router supports NAT-PMP, UPnP, or you have Apple AirPort, Transmission can map its port automatically. Most routers manufactured since 2001 have this feature.
Open Transmission.
Go to Preferences -> Network, and check 'Automatically map port'.
If you get a green dot and 'Port is Open' then you have successfully port forwarded!
If you get a red dot and the message 'Port is closed', click here.
If you don't have a compatible router, it is simple to forward Transmission's port manually. For instructions click here.
If you don't use a router, and your modem is directly connected to your computer, you'll need to open Transmission's port in the Mac OS X firewall. For instructions click here.
Note: It is highly recommended you enable the Mac OS X firewall if you are not using a router.
Keep in mind that many DSL modems also function as routers, so port forwarding may still be necessary, even though your computer is directly connected to the modem.
If your router supports NAT-PMP, UPnP, or you have Apple AirPort, Transmission can map its port automatically. Most routers manufactured since 2001 have this feature.
+
+
+
Open Transmission.
+
Go to Preferences → Network, and check 'Automatically map port'.
+
If you get a green dot and 'Port is Open' then you have successfully port forwarded!
+
If you get a red dot and the message 'Port is closed', click here.
+
+
+
+
If you don't have a compatible router, it is simple to forward Transmission's port manually. For instructions click here.
+
If you don't use a router, and your modem is directly connected to your computer, you'll need to open Transmission's port in the Mac OS X firewall. For instructions click here.
Note: It is highly recommended you enable the Mac OS X firewall if you are not using a router.
+
Keep in mind that many DSL modems also function as routers, so port forwarding may still be necessary, even though your computer is directly connected to the modem.
Transmission has a web interface which can be used to monitor and manage your transfers over the internet. Other applications, such as transmission-remote, can also control Transmission. If you want to use the web interface, or another remote control application, check 'Enable remote access'. Leave this option unchecked if you are only going to be managing your transfers on your local machine.
For security purposes, you can password protect access to Transmission, as well as restrict access to a trusted list of external IP addresses. To add an address to the list, click the + button.
You can view the web interface on your local computer by clicking the 'Launch web interface' button. To view it on a remote location:
-
+
Open your web browser
In the address bar, enter "http://localip:port/transmission/web/", where:
localip is the IP address of the computer Transmission is running on.
-
port is the port specified in Preferences -> Remote.
+
port is the port specified in Preferences → Remote.
Yes. To add trackers to a currently running torrent, go to Inspector -> Tracker, and click the plus button (+). To remove them, click minus button (-). Multiple trackers can also be added to torrent files you create. Each newly-added tracker will be placed in a new tier.
+
Yes. To add trackers to a currently running torrent, go to Inspector → Tracker, and click the plus button (+). To remove them, click minus button (-). Multiple trackers can also be added to torrent files you create. Each newly-added tracker will be placed in a new tier.
What is 'Tier 1', 'Tier 2', etc?
@@ -29,7 +28,7 @@
What does 'announce' mean?
-
When Transmission announces, it is updating its presence to the tracker and asking for more peers. This happens periodically, at the discretion of the tracker, however can be manually invoked via Transfers menu >> Update Tracker.
+
When Transmission announces, it is updating its presence to the tracker and asking for more peers. This happens periodically, at the discretion of the tracker, however can be manually invoked via Transfers menu → Update Tracker.
If your port is still not open, even after you have enabled automatic port forwarding, here are some tips you can use which may get it working.
-
+
If you are still having problems, open the Message Log (in the Window menu) and post the debug output on the support forums.
Pause your torrents
@@ -32,7 +31,7 @@
Post the resultant output
-
+
UPnP
@@ -42,13 +41,13 @@
DMZ mode is disabled.
The port has not already been forwarded manually.
-
+
AirPort
If you have an Apple AirPort, make sure NAT-PMP is enabled.
-
-
+
+
Open AirPort Utility (located in /Applications/Utilities)
Select your base station, and then choose Manual Setup from the Base Station menu. Enter the base station password if necessary.
@@ -56,7 +55,7 @@
Click "Update".
-
+
@@ -68,10 +67,10 @@
For example, your network might resemble the following: ADSL modem/router --> AirPort extreme --> MacBook.
If you have multiple routers in your home network (such as in the example above), you have two options. The easiest way is to turn one of the routers into 'Bridge mode' which means you then only have to configure one device rather than all of them. So, in our above example, we would set the AirPort extreme to 'Bridge'. See your router's help documentation for instructions.
-
+
The second way is to map Transmission's port on all of the devices on your network.
Transmission can only automatically port map the router the computer is directly connected to. Any others in between this router and your modem will have to be forwarded manually. For detailed instructions, click here.
-
+
Finally make sure the OS X firewall is either disabled, or you have allowed Transmission's port.
The firewall can cause the port to remain closed, even if it has been successfully mapped by the router(s).
Torrent files contain information about the actual file you want to download, and connect you to the swarm of peers sharing it.
-
-
Transmission can watch a certain folder (eg your Safari download folder) for torrent files and then open them automatically via Preferences -> Transfers -> General.
-
By default, Transmission deletes the original torrent file upon opening. If you remove a transfer, in order to resume it you will need to reopen the original torrent file in Transmission.
- Simply choose 'Save Torrent File As…' from the File menu before deletion to avoid having to download the torrent file again.
-
-
Once your download is complete, you can set a default ratio to automatically seed to, and then pause.
- This can be adjusted in Preferences -> Transfers -> Management, or in real time using the Action menu.
-
+
Transmission can watch a certain folder (eg your Safari download folder) for torrent files and then open them automatically via Preferences → Transfers → General.
+
+
By default, Transmission deletes the original torrent file upon opening. If you remove a transfer, in order to resume it you will need to reopen the original torrent file in Transmission. Simply choose 'Save Torrent File As…' from the File menu before deletion to avoid having to download the torrent file again.
+
+
Once your download is complete, you can set a default ratio to automatically seed to, and then pause. This can be adjusted in Preferences → Transfers → Management, or in real time using the Action menu.
+
Both seeding and downloading transfers can be queued, and Transmission can skip over stalled transfers, in order to maximise queuing efficiency.
- Queuing can be configured in Preferences -> Transfers -> Management.
+ Queuing can be configured in Preferences → Transfers → Management.
