Version 44 (modified by gaba, 19 months ago) (diff)



GetTor is a program that presents alternative methods to download Tor Browser, especially when access to Tor Project's official website and mirrors is blocked. For now, the only available method is SMTP (email).

You can check Usage to know how to use it, Design to have an insight of how it works, Roadmap to see what's coming, Ideas to see some crazy and not so crazy stuff that could be implemented, Outreach to know about collaboration with other projects/communities, and Tickets to have a glimpse of the development progress.

Have you found a bug? Please, fill a ticket.

Current Development

GetTor is in continuous development. You can find the latest code on this repository. If you have any doubts, suggestions, or feedback, please don't hesitate on contact the GetTor team:

GetTor team Contact PGP key
ilv ilv[@]torproject dot org 4096R/540BFC0E
hiro hiro[@]torproject dot org

GetTor's status reports:

February 2015, March 2015, April 2015, May 2015, June 2015, July 2015, August 2015.


Stuff in (light) development:

SMTP channel

  • Improve content of emails
  • Enable requests for more locales (English only for now) #3921
    • Return locale version and English message when email is sent to gettor+locale@tpo
    • Return locale version and translated message when email is sent to gettor+locale@tpo
  • Deliver the latest version of Tor Browser #12502 #14744

Distributions channels

  • Deploy XMPP channel #12819
    • Research and (if possible) implement OTR communication.
  • Finish Twitter channel
  • Research more channels! (e.g. p2p) #9071 #8542

Cloud services

  • Integrate Google Drive #13779 #10692
  • More tests and then integrate Github #14835
  • Automate the upload of latest Tor Browser to the various services integrated #14744
  • Research more services!
    • Special interest in nice services that are not blocked in mainland China #14114


Here are some nice ideas that could be implemented in the near future (in no specific order):

If you open a ticket for one of these ideas, please add its number next to the idea it belongs. Thank you.

  • The future of GetTor
  • Enable the 'mirrors' keyword and return the parsed content of tpo/getinvolved/mirrors.html.en. It would be very helpful to send the direct link for download. #16716
  • Enable the 'sha256 checksums' and return dist.tpo/torbrowser/version/sha256sums.txt #3980
  • Create a nice way to test GetTor #1593
  • Create some kind of bot that makes daily requests to GetTor to check what channels are up.
  • Make a nice and beautiful page that explains what is GetTor, why it exists, and how to use it (including key verification).
  • Improve stats. What other numbers could we get?

Here are some thoughts that need research, and might be nice ideas to implement if we figure out how:

  • Change from generating responses on request by static responses.
  • Can we provide Tor Browser via DuckDuckGo?
  • Distribute MAR files. Does this actually makes sense? #13781
  • Use encryption to circumvent deep packet inspection and cloud service awareness. #13878
  • Sign outgoing emails. Would this be useful, or it would just add complexity to the message?
  • Receive PGP public keys and reply with encrypted content.

Feel free to add your own idea.


There are lots of projects and communities out there that share part or all of the goals of GetTor. We might even find time to collaborate with some of them.

  • Tor2web: ilv has collaborated with Tor2web in the implementation of a GetTor feature. See their wiki for more details.
  • DuckDuckGo: ilv is currently learning how to make instant answers and see if we could do something nice related to GetTor goals.


Ticket Summary Status Owner
#19693 Portuguese (pt_PT) translation to GetTor assigned emmapeel
#22011 Implement telegram bot for gettor assigned alwayslivid
#31339 GitHub blocked in Iran affecting gettor circumvention assigned hiro
#31982 Make sure GetTor info pages and repositories are self-consistent and clear assigned hiro
#34350 Stop logging all successful databse queries in GetTor merge_ready cohosh
#27330 @get_tor on twitter not responding needs_review hiro
#3781 Write a spec for GetTor new
#3862 gettor should automatically include bridges in its answer new
#9071 Gettor should be able to send torrents/magnet URIs new sukhe
#13878 Use encryption to circumvent deep packet inspection and cloud service awareness new
#17212 Request other applications with GetTor new
#17214 Check integrity of uploaded files periodically new
#19951 Allow to get Tor bundles and bridges via bitmessage new
#19952 Allow to get Tor bundles and bridges via Tox new
#20116 Get @get_tor twitter account verified new
#20770 Support Tor Browser Alpha new
#21382 Implementing a GetTor FaceBook Messenger Bot new
#22664 Check for existing bundles in dropbox and handle them accordingly new
#25887 OneDrive new
#27148 GetTor: add support for HTML/multipart new
#27972 GetTor IPFS Provider new
#28231 Provide more Gettor distribution methods new
#28232 Revive GetTor new
#28233 Translate GetTor messages new
#28284 Arabic version for Gettor new
#28340 Package gettor for Debian new
#30247 Understand GetTor usage new
#31377 Create a GetTor survival guide new
#32716 Understand where gettor distribution providers are blocked new
#33036 Revive Twitter responder new
#33122 GetTor should provide download links even if email request is invalid new
#33185 Create a pipeline for gettor statistics new
#33836 Require Twisted 20.3.0 in gettor's requirements.txt new
#33893 Track down old GetTor mirrors and decide what to do with them new
#34058 Make sure gettor logs are scrubbed of personal info new
#34060 Errors thrown in Gettor if "To:" address field doesn't match gettor@tp.o new
#34253 GetTor should set In-Reply-To when responding to email new
#34300 Ensure GetTor's email unit tests are properly formatted new
#34423 Implement GetTor for mobile users new
#10692 GetTor needs official two-factor-enabled dropbox and google accounts reopened

Add ticket