Opened 5 years ago

Last modified 3 years ago

#9036 needs_review defect

Changing GetTor Message Body

Reported by: mrphs Owned by: sukhbir
Priority: Medium Milestone:
Component: Applications/GetTor Version:
Severity: Normal Keywords:
Cc: Sherief Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description

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@…
We're ready to answer your questions in English, Farsi, Arabic, Spanish, French and Chinese.

######

Child Tickets

TicketStatusOwnerSummaryComponent
#16385closedilvImprove links' messageApplications/GetTor
#17424closedilvImprove GetTor LinksApplications/GetTor
#17425newilvImprove GetTor Signature SectionApplications/GetTor

Attachments (1)

verifying-signatures-guide.txt (1.9 KB) - added by ilv 3 years ago.

Download all attachments as: .zip

Change History (19)

comment:1 Changed 5 years ago by Jason

I have replied several tickets complaining about the 'too large' message. They don't think we already know the issue and are trying to fix it.

comment:2 in reply to:  1 Changed 5 years ago by sukhbir

Replying to Jason:

I have replied several tickets complaining about the 'too large' message. They don't think we already know the issue and are trying to fix it.

We are going to fix this very soon (most probably within this week).

comment:3 Changed 5 years ago by sukhbir

We should just resort to distributing the Dropbox links (and later GDrive), because GetTor is pretty much broken anyways. So the above message (in the description) and Dropbox links seems to be a good thing to do for now.

comment:4 Changed 5 years ago by mttp

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.

comment:5 Changed 5 years ago by mttp

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@…

comment:6 Changed 5 years ago by mrphs

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.

comment:7 Changed 5 years ago by mrphs

update from weasel: we should replace bridges@torproject with bridges@bridges[dot]tpo

Last edited 5 years ago by mrphs (previous) (diff)

comment:8 Changed 5 years ago by runa

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.

comment:9 Changed 5 years ago by Sherief

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.

comment:10 Changed 4 years ago by Sherief

Cc: Sherief added

comment:11 Changed 4 years ago by ilv

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.

comment:12 Changed 4 years ago by ilv

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.

comment:13 Changed 3 years ago by ilv

Status: newneeds_review

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 team

Any/all feedback is welcome!

Changed 3 years ago by ilv

comment:14 Changed 3 years ago by ilv

Attached is a proposal for the verifying signatures guide. Please review it.

comment:15 Changed 3 years ago by cypherpunks

First two links in the message above are DEAD. Furthermore, those links also appear in the translated versions of the message as translated in the Transifex website that the Tor project works with.

comment:16 Changed 3 years ago by sukhbir

Severity: Normal

(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.org

The 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.)

comment:17 Changed 3 years ago by sukhbir

More discussion follows in #17424 and #17425.

comment:18 Changed 3 years ago by sukhbir

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>
Note: See TracTickets for help on using tickets.