Changing GetTor Message Body
GetTor body needs to be temporary changed to let users know we're working on it, instead of just sending out the long, useless help message. Something like this perhaps:
Service under maintenance! Please try again later, or use one of the following mirrors to download the latest version of Tor Browser Bundle or Pluggable Transport:
https://www.oignon.net/dist/torbrowser/ http://tor.dont-know-me.at/dist/torbrowser/ https://www.torservers.net/mirrors/torproject.org/dist/torbrowser/ http://torproject.ph3x.at/dist/torbrowser/ http://cyberside.net.ee/tor/torbrowser/
Need help? Please contact our support team at help@rt.torproject.org We're ready to answer your questions in English, Farsi, Arabic, Spanish, French and Chinese.
Activity
A new message should include information on how to download from this dist/torbrowser link. Users are frequently confused by this page. A new message should explain how to use language codes, where on the page the Pluggable Transports Browser is, which file type the need to download and probably also a link to the docs/verifying-signatures.html.en page. I would be write such a message.
Here is a new Gettor response message I drafted:
Hello. This is the "GetTor" robot.
Currently the Tor Browser is too large to be shipped over email. You can download the Tor Browser from one of the following mirrors:
https://www.oignon.net/dist/torbrowser/ https://tor.beme-it.de/dist/torbrowser/ https://www.torservers.net/mirrors/torproject.org/dist/torbrowser/ http://torproject.ph3x.at/dist/torbrowser/ http://tor.dont-know-me.at/docs/verifying-signatures.html.en
This page has many links for many languages. Choose the package that ends with your language's language code.
_ar عربى _de Deutsch _en English _es español _fa فارسی _fr français _it Italiano _ko 한국어 _nl Nederlands _pl język polski _pt português _ru Русский язык _vi Tiếng Việt _zh 官話
You also need to choose the right file type for your operating system.
*.exe Windows *.zip Mac OS *.tar.gz Linux
Pluggable Transports Browsers (for users under heavy internet censorship) are at the bottom of the page.
You may also want to verify the contents of your package. To verify your browser, download the package you need, then download the file that has the same name, but ends with the *.asc file extension. This is the file's signature. You can read instruction on one of these pages [ENGLISH ONLY!]:
https://www.oignon.net/docs/verifying-signatures.html.en https://tor.beme-it.de/docs/verifying-signatures.html.en https://www.torservers.net/mirrors/torproject.org/docs/verifying-signatures.html.en http://torproject.ph3x.at/docs/verifying-signatures.html.en http://tor.dont-know-me.at/docs/verifying-signatures.html.en
SUPPORT
If you have any questions or it doesn't work, you can contact a human at this support email address: help@rt.torproject.org
mttp's suggested text is great but as we're about to start distributing dropbox links, I thought I'd give it a try to make a few changes...
- I've split the message in two parts. "Help Message" and "Download Links".
- Previously we had a long list of commands. I thought it's confusing, and it'd be better if we only get the OS name and return all 3 related bundles (32bit, 64bit and PT).
- Added an explicit note for Chinese and Iranian users to make sure they get the right bundle.
- Removed mirror links, till we can make it smarter and return exact download link, as they only confuse users for now.
Although I tried to do my best it may still have errors, please go ahead and rephrase if needed. Just keep it minimal and simple pls.
Help Message
Hello there! This is the "GetTor" robot. I'm here to help you download the latest Tor Browser Bundle. Please reply to this message with one of the options below: Windows Linux Mac OS X And I'll send you download instructions quickly. Tip: Choose "Windows" if you're not sure.Download instruction
Hello again! Thank you for your request. Here are the "requested-os" download links: Tor Browser Bundle: ------------------- 32bit - https://link-to-dropbox-32bit (Download this one, if you're not sure) Signature: https://link-to-dropbox-32bit.asc 64bit - https://link-to-dropbox-64bit Signature: https://link-to-dropbox-64bit.asc Pluggable Transport Bundle: --------------------------- https://link-to-dropbox-PT-TBB Signature: https://link-to-dropbox-PT-TBB.asc Tip: If you're from Iran, China or under heavy censorship, you need Pluggable Transport Bundle. * Bridge: --------- You may still need a few bridges to connect to Tor network. Here are some: bridge 0.0.0.0:1234 bridge 0.0.0.0:1234 bridge obfs2 0.0.0.0:1234 bridge obfs3 0.0.0.0:1234 To get more bridges, visit https://bridges.torproject.org/bridges or simply send an email to bridges@torproject.org. Just make sure you have "Get bridges" in the body of your message. Verify Your Bundle: --------------------- It is essential to check if you have downloaded the right version. This has been explained in step-by-step details in Tor Short-user-manual which is attached to this email. Support ------- Still need help? If you have any questions, trouble connecting to Tor network or need to talk to a human, please contact our support team at help@rt.torproject.org We're ready to answer your queries in English, Farsi, Chinese, Arabic, French and Spanish.*Bridge section shows our "ideal" future model. for now we have to put this one instead:
In order to get a list of bridges, please visit https://bridges.torproject.org/bridges or simply send an email to bridges@torproject.org. Just make sure you have "Get bridges" in the body of your message.For the help message, I suggest we replace "Mac OS X" with "OS X" and/or "OSX". The new keyword is shorter and users are less likely to spell it wrong.
For the download instructions, I suggest we put instructions (get TBB for Windows if you're not sure, but if you're in Iran or China or Syria or some other place with heavy censorship, get PTTBB) before the download links. The section about verifying the bundle should quickly explain that this is what the .asc files are for, and ideally should also be placed before the download links. The section about bridges should explain how to use them, and also point out that most of them won't work with the normal TBB.
My suggestion for the instructions email:
Hello again! Thank you for your request. Here are the "requested-os" download links: Tor Browser Bundle: ------------------- 32bit - !https://link-to-dropbox-32bit (Download this one, if you're not sure) Signature: !https://link-to-dropbox-32bit.asc 64bit - !https://link-to-dropbox-64bit Signature: !https://link-to-dropbox-64bit.asc Q: How do I run the Tor Browser Bundle? (if requested-os == "windows") Double click the package you downloaded, extract it to a location of your choosing, go to that location and you will find a folder called Tor Browser, inside it you can find the launcher "Start tor browser.exe". (if requested-os == "mac") extract the .zip file (should be in your Downloads folder), double click the .app file. (if requested-os == "Linux") torproject.org/linux-installation-manual Q: The green bar fails to complete to 100%, what should I do? You will need to add these bridges to be able to connect to the Tor network: - Open Vidalia control panel>Settings> (Check) "My ISP blocks connection to the Tor network". - Start adding bridges one by one (without the "bridge" word) : bridge !0.0.0.0:1234 bridge !0.0.0.0:1234 - Press OK> Restart Vidalia/Tor =========================================== #If all of the above fail do the following: =========================================== Pluggable Transport Bundle: --------------------------- !https://link-to-dropbox-PT-TBB Signature: !https://link-to-dropbox-PT-TBB.asc You may still need a few bridges to connect to Tor network: - Open Vidalia control panel>Settings> (Check) "My ISP blocks connection to the Tor network". - Start adding bridges one by one (without the "bridge" word) : bridge obfs2 !0.0.0.0:1234 bridge obfs3 !0.0.0.0:1234 - Press OK> Restart Vidalia/Tor To get more bridges, visit !https://bridges.torproject.org/bridges or simply send an email to bridges@torproject.org. Just make sure you have "Get bridges" in the body of your message. Verify Your Bundle: ------------------- It is essential to check if you have downloaded the right version. This has been explained in step-by-step details in Tor Short-user-manual which is attached to this email. Support: -------- Still need help? If you have any questions, trouble connecting to Tor network or need to talk to a human, please contact our support team at help@rt.torproject.org We're ready to answer your queries in English, Farsi, Chinese, Arabic, French and Spanish.I think we should revisit this and change the current template, which is pretty basic (it doesn't even have signature verification message). What do you think about adding the instructions for use (install), signature verification, and use of bridges and pluggable transports as attachments? This way the user would receive a short email with three attachments. Other idea that comes to mind is add a message like this: "If you don't trust the cloud service, then you must check the integrity of Tor Browser after you have downloaded it". I'll add a template idea later tonight.
Here is an idea:
Hello again! Thank you for your request. We strongly recommend you to verify the integrity of the downloaded files, specially if you don't trust the cloud service or you think your communications are being tampered. There is a mini-guide attached to this email explaining how to do this step-by-step. Here are the "requested-os" download links for Tor Browser: ------------------------------------------------------------------------------- [Dropbox] Tor Browser (32/64-bit) https://www.dropbox.com/s/0p4oew8w2u7vzv2/torbrowser-install-4.0.1_en-US.exe?dl=1 Tor Browser signature (32/64-bit) https://www.dropbox.com/s/y68hhrk378lygn4/torbrowser-install-4.0.1_en-US.exe.asc?dl=1 Tor Browser checksum (32/64-bit) e41078c34785e6834657d008d0c2b0b671b793b5cbc67ebc60e8d55735504a10 Key fingerprint: 8738 A680 B84B 3031 A630 F2DB 416F 0610 63FE E659 ------------------------------------------------------------------------------- To run Tor Browser please follow the steps described in the install guide attached to this email. We have also attached a mini-guide explaining how to use and request bridges, as well as pluggable transports. You should follow these steps if you live in a highly censored place and/or you want to hide the fact that you are connecting to Tor network. Still need help? If you have any questions, trouble connecting to Tor network or need to talk to a human, please contact our support team at help@rt.torproject.org We're ready to answer your queries in English, Farsi, Chinese, Arabic, French and Spanish.There has been some work on integrating other cloud services, so it's possible that when we actually update this message there will be even more text to add. With that in mind, I've developed the idea of attaching files to the point of creating separate text files for each of the cloud providers, in addition to the other instruction guides. The body of the message would look something like this:
Hello there! Thank you for your request. Attached to this email you will find the following files: dropbox-links.txt: Links to download Tor Browser from Dropbox. gdrive-links.txt: Links to download Tor Browser from Google Drive. github-links.txt: Links to download Tor Browser from GitHub. verify-integrity.txt: Instructions on how to verify the integrity of the downloaded Tor Browser. install-guide.txt: Instructions on how to install/run Tor Browser. bridges.txt: Instructions on how to use/request bridges. After you download Tor Browser from one of the available options, we strongly recommend you verify the integrity of the downloaded files. That's the best way to be sure that you received the correct files. For that purpose, please follow the verify-integrity.txt guide. To install/run Tor Browser, please follow the attached install-guide.txt. After that, it is possible that you still need some bridges to connect to the Tor network. In that case, just follow the bridges.txt guide. Still need help? If you have any questions, trouble connecting to the Tor network or need to talk to a human, please contact our support team at help@rt.torproject.org We're ready to answer your queries in English, Farsi, Chinese, Arabic, French and Spanish. -- The GetTor teamAny/all feedback is welcome!
Trac:
Status: new to needs_review(We are reviving this again, as a part of the new GetTor code ilv is working on and that has been deployed.)
We have been discussing an updated version of the GetTor message body to make it more concise by removing redundant and complicated information. A sample template follows; discussions are welcome and encouraged.
Initial email:
Hi! This is the GetTor robot. I am here to help you download the latest Tor Browser Bundle. Please reply to this message with one of the options below: windows linux osx mirrors I will then send you the download instructions. If you are unsure, just send a blank reply to this message.Follow-up email:
You requested Tor Browser for $PLATFORM. You will need only one of the links below to download the bundle. If a link does not work for you, try the next one. <links> Signatures (Skip this section if you are not an advanced user.) <links> Support Still need help? If you have any questions, trouble connecting to Tor network, or need to talk to a human, please contact our support team at: help@rt.torproject.orgThe next part is figuring out how to display the links so that users can get what they want by reading minimum text. (Right now, GetTor is serving Google Drive, Dropbox and GetTor links.)
Trac:
Severity: N/A to Normal
Sponsor: N/A to N/AMore discussion follows in #17424 (moved) and #17425 (moved).
Updated texts:
Hi! This is the GetTor robot. I am here to help you download the latest version of Tor Browser. Please reply to this message with one of the options below: windows linux osx mirrors I will then send you the download instructions. If you are unsure, just send a blank reply to this message.You will need only one of the links below to download Tor Browser for $PLATFORM. If a link does not work for you, try the next one. Download from... Provider-1: <link-1> Provider-2: <link-2> Signatures ---------- This is an optional step for advanced users. To verify that the Tor Browser you downloaded has not been tampered with, please follow the steps outlined in the verification guide. <links>what is to do here? needs-review => above texts need to be reviewed? or does it need a PR for http://jqs44zhtxl2uo6gk.onion/gettor.git/
Trac:
Reviewer: N/A to N/A
Status: needs_review to needs_information#28232 (moved) now groups GetTor working areas.
Trac:
Parent: N/A to #28232 (moved)
Trac:
Parent: #28232 (moved) to N/A
Okay now that we've finally pushed some changes to the messages for #23226 (moved), i think it's safe to close this ticket. It was a huge tracking ticket for a major overhaul, but now it makes more sense to track individual additional feature requests separately.
Trac:
Status: new to closed
Resolution: N/A to fixedmentioned in issue #9821 (moved)
mentioned in issue #16385 (moved)
mentioned in issue #20659 (moved)
mentioned in issue #23225 (moved)
mentioned in issue #23226 (moved)
mentioned in issue #27148 (moved)
mentioned in issue tpo/anti-censorship/gettor-project/trac#16385 (closed)
