July 2021 - tor-commits - lists.torproject.org

[manual/develop] updated android manual
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit 1b0c225de990d60de433d367dc5e0f2b935756cc Author: championquizzer <joydeep09(a)gmail.com> Date: Tue Dec 15 16:22:08 2020 +0530 updated android manual Signed-off-by: championquizzer <joydeep09(a)gmail.com> --- assets/static/images/android-censored.png | Bin 74940 -> 177136 bytes assets/static/images/android-configure.png | Bin 69892 -> 237088 bytes assets/static/images/android-connect.png | Bin 69965 -> 239210 bytes assets/static/images/android-new-identity.png | Bin 105151 -> 263142 bytes assets/static/images/android-provide-a-bridge.png | Bin 109572 -> 159176 bytes assets/static/images/android-provided-a-bridge.png | Bin 98794 -> 142112 bytes assets/static/images/android-security-settings.gif | Bin 1345090 -> 714378 bytes assets/static/images/android-select-a-bridge.png | Bin 109560 -> 150983 bytes assets/static/images/android-selected-a-bridge.png | Bin 124065 -> 162159 bytes content/mobile-tor/contents.lr | 12 ++++++------ 10 files changed, 6 insertions(+), 6 deletions(-) diff --git a/assets/static/images/android-censored.png b/assets/static/images/android-censored.png index 43faa8d..40d9961 100644 Binary files a/assets/static/images/android-censored.png and b/assets/static/images/android-censored.png differ diff --git a/assets/static/images/android-configure.png b/assets/static/images/android-configure.png index c457cca..d02a14e 100644 Binary files a/assets/static/images/android-configure.png and b/assets/static/images/android-configure.png differ diff --git a/assets/static/images/android-connect.png b/assets/static/images/android-connect.png index 8a6c1db..021ca27 100644 Binary files a/assets/static/images/android-connect.png and b/assets/static/images/android-connect.png differ diff --git a/assets/static/images/android-new-identity.png b/assets/static/images/android-new-identity.png index 69f9f9c..8961b8b 100644 Binary files a/assets/static/images/android-new-identity.png and b/assets/static/images/android-new-identity.png differ diff --git a/assets/static/images/android-provide-a-bridge.png b/assets/static/images/android-provide-a-bridge.png index 5241821..c048fb1 100644 Binary files a/assets/static/images/android-provide-a-bridge.png and b/assets/static/images/android-provide-a-bridge.png differ diff --git a/assets/static/images/android-provided-a-bridge.png b/assets/static/images/android-provided-a-bridge.png index 754f2cd..a2606ba 100644 Binary files a/assets/static/images/android-provided-a-bridge.png and b/assets/static/images/android-provided-a-bridge.png differ diff --git a/assets/static/images/android-security-settings.gif b/assets/static/images/android-security-settings.gif index de2f796..f34c689 100644 Binary files a/assets/static/images/android-security-settings.gif and b/assets/static/images/android-security-settings.gif differ diff --git a/assets/static/images/android-select-a-bridge.png b/assets/static/images/android-select-a-bridge.png index c322898..75a10d6 100644 Binary files a/assets/static/images/android-select-a-bridge.png and b/assets/static/images/android-select-a-bridge.png differ diff --git a/assets/static/images/android-selected-a-bridge.png b/assets/static/images/android-selected-a-bridge.png index 2a1cb9d..6e0d456 100644 Binary files a/assets/static/images/android-selected-a-bridge.png and b/assets/static/images/android-selected-a-bridge.png differ diff --git a/content/mobile-tor/contents.lr b/content/mobile-tor/contents.lr index e2f9bfa..e3724bd 100644 --- a/content/mobile-tor/contents.lr +++ b/content/mobile-tor/contents.lr @@ -76,8 +76,8 @@ If you are on a relatively fast connection, but this text seems to get stuck at If you know that your connection is censored, you should select the settings icon. Tor Browser will take you through a series of configuration options. -The first screen asks if access to the Tor network is blocked or censored on your connection. -If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, tap the switch. +The first screen will tell you about the status of the Tor Network abd provide you the option to configure a Bridge ('Config Bridge'). +If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, tap on 'Config Bridge'. You will then be taken to the [Circumvention](../circumvention) screen to configure a pluggable transport. ### CIRCUMVENTION @@ -86,12 +86,12 @@ Bridge relays are Tor relays that are not listed in the public Tor directory. Bridges are useful for Tor users under oppressive regimes, and for people who want an extra layer of security because they're worried somebody will recognize that they are contacting a public Tor relay IP address. To use a pluggable transport, tap on the settings icon when starting Tor Browser for the first time. -The first screen asks if access to the Tor network is censored on your connection. Tap on the switch to toggle it. +The first screen tells you about the status of the Tor network. Tap on 'Config Bridge' to configure a bridge. <img style="max-width:300px" class="col-md-6" src="../../static/images/android-censored.png" alt="Censored internet on Tor Browser for Android"> The next screen provides the option to either use a built-in bridge or custom bridge. -With the "Select a bridge" option, you will have two options: "obfs4" and "meek-azure". +With the "Use a Bridge" option, you will have two options: "obfs4" and "meek-azure". <img style="max-width:300px" class="col-md-6" src="../../static/images/android-select-a-bridge.png" alt="Select a bridge on Tor Browser for Android"> @@ -125,7 +125,7 @@ You can modify the security level by following given steps: * Tap on a button of 3 vertical dots in URL bar. * Scroll down and tap on "Security Settings". -* You can now select an option from the security level slider. +* You can now select an option i.e. Standard, Safer or Safest. ### UPDATING @@ -217,4 +217,4 @@ Download Onion Browser from the [App Store](https://itunes.apple.com/us/app/onio ### Tor Browser for Windows Phone -There is currently no supported method for running Tor on Windows Phone. +There is currently no supported method for running Tor on older Windows Phones but in case of the newer Microsoft-branded/promoted phones, same steps on [Tor Browser on Android](#tor-browser-for-android) can be followed.

1 0

[manual/develop] typo correction
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit 301d620c9e04c8da25022edf725568127780a170 Author: championquizzer <joydeep09(a)gmail.com> Date: Wed Dec 16 19:39:45 2020 +0530 typo correction --- content/mobile-tor/contents.lr | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/mobile-tor/contents.lr b/content/mobile-tor/contents.lr index e3724bd..020b372 100644 --- a/content/mobile-tor/contents.lr +++ b/content/mobile-tor/contents.lr @@ -76,7 +76,7 @@ If you are on a relatively fast connection, but this text seems to get stuck at If you know that your connection is censored, you should select the settings icon. Tor Browser will take you through a series of configuration options. -The first screen will tell you about the status of the Tor Network abd provide you the option to configure a Bridge ('Config Bridge'). +The first screen will tell you about the status of the Tor Network and provide you the option to configure a Bridge ('Config Bridge'). If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, tap on 'Config Bridge'. You will then be taken to the [Circumvention](../circumvention) screen to configure a pluggable transport.

1 0

[manual/develop] instructions to make file executable via terminal
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit 55b7d0ceb92ab6e3834bd4fb0b64cdeea49168e5 Author: championquizzer <championquizzer(a)gmail.com> Date: Tue Jan 19 19:02:22 2021 +0530 instructions to make file executable via terminal --- content/installation/contents.lr | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/installation/contents.lr b/content/installation/contents.lr index 2739dd8..732b241 100644 --- a/content/installation/contents.lr +++ b/content/installation/contents.lr @@ -42,10 +42,10 @@ For GNU/Linux: 4. When the download is complete, extract the archive with the command `tar -xf [TB archive]` or by using an archive manager. -5. You'll need to tell your GNU/Linux that you want the ability to execute shell scripts from the graphical interface. +5. You'll need to tell your GNU/Linux that you want the ability to execute shell scripts from the graphical interface or the command line. Navigate to the newly extracted Tor Browser directory. Right click on `start-tor-browser.desktop`, open Properties or Preferences and change the permission to allow executing file as program. - Double-click the icon to start up Tor Browser for the first time. + On the terminal from inside the Tor Browser directory you may also execute `chmod +x start-tor-browser.desktop` to make the file executable. Double-click the icon to start up Tor Browser for the first time. 6. Alternatively, from inside the Tor Browser directory, you can also start from the command line by running:

1 0

[manual/develop] Fix #61
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit a48c1218c35adbcb69fe9250251a7c9b7a98c1a2 Author: gus <gus(a)torproject.org> Date: Tue Jan 19 14:44:31 2021 -0500 Fix #61 --- content/bridges/contents.lr | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/bridges/contents.lr b/content/bridges/contents.lr index 0ecbc90..9512b1b 100644 --- a/content/bridges/contents.lr +++ b/content/bridges/contents.lr @@ -21,8 +21,8 @@ Other pluggable transports, like meek, use different anti-censorship techniques Because bridge addresses are not public, you will need to request them yourself. You have a few options: - * Visit https://bridges.torproject.org/ and follow the instructions, or - * Email bridges(a)torproject.org from a Gmail, or Riseup email address + * Visit [https://bridges.torproject.org/](https://bridges.torproject.org) and follow the instructions, or + * Email [bridges@torproject.org](mailto:bridges@torproject.org) from a Gmail, or Riseup email address * Use MOAT to fetch bridges from within Tor Browser. ### USING MOAT

1 0

[manual/develop] Merge branch 'fix-issue-79'
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit 20eb0897a0abb5dd88df666a4e9d2e1cfcd30ebd Merge: a48c121 bdb7053 Author: gus <gus(a)torproject.org> Date: Thu Jan 21 20:23:37 2021 -0500 Merge branch 'fix-issue-79' content/mobile-tor/contents.lr | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)

1 0

[manual/develop] Updating the 'Known Issues' page
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit a0fec7e7590995676d4ab6599868f658c32c52f6 Author: championquizzer <championquizzer(a)gmail.com> Date: Fri Jan 29 14:47:59 2021 +0530 Updating the 'Known Issues' page --- content/known-issues/contents.lr | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/content/known-issues/contents.lr b/content/known-issues/contents.lr index b4243d8..4e86957 100644 --- a/content/known-issues/contents.lr +++ b/content/known-issues/contents.lr @@ -12,11 +12,14 @@ body: * Tor needs your system clock (and your time zone) set to the correct time. -* The following firewall software have been known to interfere with Tor and may need to be temporarily disabled: +* Antivirus or malware protection blocking users from accessing Tor Browser. Sometimes these also pop up with [false positives regarding malware and/or vulnerabilities](https://support.torproject.org/tbb/antivirus-false-positiv…. You can read more about this on our [Support Portal](https://support.torproject.org/tbb/tbb-10/). The following antivirus and firewall software have been known to interfere with Tor and may need to be temporarily disabled: * Webroot SecureAnywhere * Kaspersky Internet Security 2012 * Sophos Antivirus for Mac * Microsoft Security Essentials + * Avast Antivirus + +* VPNs also tend to interfere with Tor and need to be disabled. We also do not recommend using VPN and Tor together unless you're an advanced user who knows how to configure both in a way that doesn't compromise your privacy. You can find more detailed information about Tor + VPN at our [wiki](https://trac.torproject.org/projects/tor/wiki/doc/TorPlusVPN). * Videos that require Adobe Flash are unavailable. Flash is disabled for security reasons. @@ -24,10 +27,10 @@ body: * The Tor Browser package is dated January 1, 2000 00:00:00 UTC. This is to ensure that each software build is exactly reproducible. -* To run Tor Browser on Ubuntu, users need to execute a shell script. Open "Files" (Unity's explorer), open Preferences → Behavior Tab → Set "Run executable text files when they are opened" to "Ask every time", then click OK. +* Issues with making Tor Browser as your [default browser](https://support.torproject.org/tbb/tbb-32/). -* Tor Browser can also be started from the command line by running the following command from inside the Tor Browser directory: +* If Tor Browser was working before and is not working now (especially after a re-install or an update), your system may have been hibernating. A reboot of your system, in that case, will solve the issue. - `./start-tor-browser.desktop` +* Tor won't start on Windows when the [folder path contains non-ascii characters](https://gitlab.torproject.org/tpo/core/tor/-/issues/10416). * BitTorrent [is not anonymous over Tor](https://blog.torproject.org/bittorrent-over-tor-isnt-good-idea).

1 0

[manual/develop] Adding 'can't upload with TBA' to Known Issues
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit bdb705344b67c1e398629c833497a685807ad081 Author: championquizzer <championquizzer(a)gmail.com> Date: Thu Jan 21 23:23:11 2021 +0530 Adding 'can't upload with TBA' to Known Issues --- content/mobile-tor/contents.lr | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/mobile-tor/contents.lr b/content/mobile-tor/contents.lr index 020b372..65f08f4 100644 --- a/content/mobile-tor/contents.lr +++ b/content/mobile-tor/contents.lr @@ -188,7 +188,8 @@ At the moment, there are some features which are not available in Tor Browser fo * You can't see your Tor circuit. [#25764](https://gitlab.torproject.org/tpo/applications/torbutton/-/issues/25764) * Tor Browser for Android does not connect when moved to the SD Card. [#31814](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/31814) -* You can't take screenshots while using Tor Browser for Android. [#27987](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/27987) +* You can't take screenshots while using Tor Browser for Android. [#27987](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/27987) +* Can't upload files with Tor Browser for Android. [#40283](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/40283) ### More about Tor on mobile devices

1 0

[manual/develop] Merge branch 'fix-issue-59'
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit 947ac4a780237ac187a6124c621375009c4a1506 Merge: 55b7d0c cd6b71b Author: gus <gus(a)torproject.org> Date: Tue Jan 19 14:03:43 2021 -0500 Merge branch 'fix-issue-59' content/downloading/contents.lr | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)

1 0

[manual/develop] Merge branch 'fix-issue-78'
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit d34132ca7abda4368e81987e310bd82a450edfda Merge: 5d690ae f545adf Author: gus <gus(a)torproject.org> Date: Wed Feb 3 13:46:13 2021 -0500 Merge branch 'fix-issue-78' content/troubleshooting/contents.lr | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-)

1 0

[manual/develop] Adding information on how to view Tor logs
by gus＠torproject.org 09 Jul '21

09 Jul '21

commit f545adfb19ea395f909d29c6274089b9de5798fd Author: championquizzer <championquizzer(a)gmail.com> Date: Wed Feb 3 16:32:32 2021 +0530 Adding information on how to view Tor logs --- content/troubleshooting/contents.lr | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/content/troubleshooting/contents.lr b/content/troubleshooting/contents.lr index ec70570..40ce060 100644 --- a/content/troubleshooting/contents.lr +++ b/content/troubleshooting/contents.lr @@ -18,11 +18,28 @@ You should be able to start browsing the web using Tor Browser shortly after run If Tor Browser doesn’t connect, there may be a simple solution. Try each of the following: * Your computer’s system clock must be set correctly, or Tor will not be able to connect. -* Make sure another Tor Browser is not already running. If you’re not sure if Tor Browser is running, restart your computer. +* Make sure another Tor Browser or instance of 'Tor' is not already running on your system. If you’re not sure if Tor Browser is running, restart your computer. * Make sure that any antivirus program you have installed is not preventing Tor from running. You may need to consult the documentation for your antivirus software if you do not know how to do this. -* Temporarily disable your firewall. +* Temporarily disable your firewall. +* If Tor Browser was working before and is not working now your system may have been hibernating. A reboot of your system will solve the issue. * Delete Tor Browser and install it again. If updating, do not just overwrite your previous Tor Browser files; ensure they are fully deleted beforehand. +### VIEW TOR LOGS + +In most cases, taking a look at the Tor logs can be helpful in diagnosing the issue. If you’re having trouble connecting, an error message may appear and you can select the option to "copy Tor log to clipboard". Then paste the Tor log into a text file or other document. + +If you don't see this option and you have Tor Browser open, you can navigate to the hamburger menu ("≡"), then click on "Preferences", and finally on "Tor" in the side bar. At the bottom of the page, next to the "View the Tor logs" text, click the button "View Logs...". + +Alternatively, on GNU/Linux, to view the logs right in the terminal, navigate to the Tor Browser directory and launch the Tor Browser from the command line by running: + +`./start-tor-browser.desktop --verbose` + +or to save the logs to a file (default: tor-browser.log) + +`./start-tor-browser.desktop --log [file]` + +More information on this can be found on the [Support Portal](https://support.torproject.org/connecting/connecting-2/). + ### IS YOUR CONNECTION CENSORED? If you still can’t connect, your Internet Service Provider might be censoring connections to the Tor network. Read the [Circumvention](/circumvention) section for possible solutions.

1 0