Opened 15 months ago

Last modified 6 months ago

#24231 needs_review defect

users looking for Tor Browser uninstall instructions should find the correct ones

Reported by: catalyst Owned by: traumschule
Priority: Medium Milestone: website redesign
Component: Webpages/Website Version:
Severity: Normal Keywords:
Cc: Actual Points:
Parent ID: #14686 Points:
Reviewer: Sponsor:

Description

It's too easy for users who are trying to uninstall Tor Browser on macOS to find https://www.torproject.org/docs/tor-doc-osx.html.en#uninstall and try to follow its instructions (which won't usually work). The FAQ text at https://www.torproject.org/docs/faq.html.en#HowUninstallTor that links to it also could use improvement. There might be similar ambiguous/misleading instructions elsewhere; I haven't exhaustively checked.

Child Tickets

TicketStatusOwnerSummaryComponent
#22611needs_reviewlindaMake TB uninstall instructions more detailed in FAQWebpages/Website
#23922needs_reviewtraumschuleThe Uninstalling page does not mention the TorBrowser-Data directory on OSXCommunity/Tor Browser Manual

Change History (5)

comment:1 Changed 15 months ago by boklm

The Tor Browser manual also has uninstall instructions (with #23922 for adding the OSX specific part):
https://tb-manual.torproject.org/en-US/uninstalling.html

Maybe all those pages could be updated to point to the Tor Browser manual.

comment:2 Changed 11 months ago by hiro

Milestone: website redesign

comment:3 Changed 6 months ago by traumschule

Parent ID: #14686

comment:4 Changed 6 months ago by traumschule

Owner: set to traumschule
Status: newassigned

I guess the FAQ should be the canonical place to link all other sources to uninstall Tor:

Uninstall Tor

Uninstall Tor Browser

  • Link to the uninstall section of the tb-manual and add missing information (#23922)
  • Check if ~/Browser/start-tor-browser --unregister-app is sufficient (and open an issue towards the tbb team if not):
    if [ "$register_desktop_app" -eq -1 ]; then
            if [ -e "$HOME/.local/share/applications/start-tor-browser.desktop" ]; then
                    rm -f "$HOME/.local/share/applications/start-tor-browser.desktop"
                    update-desktop-database "$HOME/.local/share/applications/"
                    printf "Tor Browser has been removed as a user desktop app (from ~/.local/share/applications/)\n"
            else
                    printf "Tor Browser does not appear to be a desktop app (not present in ~/.local/share/applications/)\n"
            fi
            exit 0
    fi
    

Comments in #23922 note that also ~/Library/Application Support/TorBrowser-Data/ needs to be removed:

On OSX, the Tor Browser profile is stored in the directory TorBrowser-Data next to the Tor Browser directory.
The Uninstalling page in the manual is mentioning the Tor Browser directory, however it does not mention the TorBrowser-Data directory that some users might want to remove too.
We should also mention that if the Tor Browser application is in the Applications folder, the directory to remove is ~/Library/Application Support/TorBrowser-Data/

#22611 has a patch waiting for review:

< https://github.com/pastly/webwml/compare/macos-tb-uninstall
On Windows and Linux, Tor Browser does not install itself in the classic
sense of applications. You just simply delete the folder or directory named "Tor
Browser" and it is removed from your system. On macOS, you drag the Tor Browser
application icon from the "Applications" folder to the trash as you would to
uninstall any other application; however, you must also delete the
<code>~/Library/Application Support/TorBrowser-Data</code> directory. To get to
it, press cmd-shift-g while in Finder and copy/paste that directory into the
box that appears.

This patch looks like a good start. I would also mention that Cmd-Shift-G pops up a window with the prompt "Go to the folder:" and if it doesn't do that, they should try going through the appropriate menu items in Finder ("Go" -> "Go to Folder…"). (We had one user who had remapped their keyboard shortcuts so that Cmd-Shift-G didn't work.)
Also, navigating directly to that folder in Icon or List view won't allow them to directly delete that directory; they'll have to go up a level, which they may or may not know how to do.

comment:5 Changed 6 months ago by traumschule

Status: assignedneeds_review
Note: See TracTickets for help on using tickets.