[Pkg-privacy-commits] [torbrowser-launcher] 297/476: updated readme, and split out build instructions to BUILD.md
Ximin Luo
infinity0 at moszumanska.debian.org
Sat Aug 22 13:21:47 UTC 2015
This is an automated email from the git hooks/post-receive script.
infinity0 pushed a commit to branch debian
in repository torbrowser-launcher.
commit a84589699cde10664753af01cfde7ad5e1ef1f88
Author: Micah Lee <micah at micahflee.com>
Date: Thu Jul 31 14:56:56 2014 -0700
updated readme, and split out build instructions to BUILD.md
---
BUILD.md | 30 ++++++++++++++++++++++++++++++
README.md | 44 +++-----------------------------------------
2 files changed, 33 insertions(+), 41 deletions(-)
diff --git a/BUILD.md b/BUILD.md
new file mode 100644
index 0000000..074344d
--- /dev/null
+++ b/BUILD.md
@@ -0,0 +1,30 @@
+# Building Tor Browser Launcher
+
+First, clone the repository:
+
+ git clone https://github.com/micahflee/torbrowser-launcher.git
+ cd torbrowser-launcher
+
+Then install dependencies, build a package, and install:
+
+### Debian, Ubuntu, Linux Mint, etc.
+
+ sudo apt-get install build-essential python-all python-stdeb python-gtk2 python-psutil python-twisted python-lzma wmctrl gnupg fakeroot xz-utils
+ ./build_deb.sh
+ sudo dpkg -i deb_dist/torbrowser-launcher_*.deb
+
+Optionally you can install python-pygame if you want to play a modem sound while Tor Browser is launching.
+
+### Red Hat, Fedora, CentOS, etc.
+
+ sudo yum install python-psutil python-twisted wmctrl gnupg fakeroot rpm-build
+ ./build_rpm.sh
+ sudo yum install dist/torbrowser-launcher-*.rpm
+
+Optionally you can install pygame if you want to play a modem sound while Tor Browser is launching.
+
+### Run without installing
+
+Install the dependencies: sadly, not all of them are available in virtualenv, so you will need to install (some of) them system-wide.
+Then, you can run: `TBL_SHARE=share ./torbrowser-launcher`
+
diff --git a/README.md b/README.md
index 03eff3a..1679f33 100644
--- a/README.md
+++ b/README.md
@@ -5,42 +5,14 @@ Tor Browser Launcher is intended to make the Tor Browser Bundle (TBB) easier to
* Downloading the most recent version of TBB for you, in your language and for your architecture
* Automatically updating (while preserving your bookmarks and preferences)
* Verifying the TBB's [GnuPG signature](http://www.gnupg.org/gph/en/manual/x135.html)
+* Includes AppArmor profiles to make a Tor Browser compromise not as bad
* Adding a "Tor Browser" application launcher to your desktop environment's menu
+* Optionally playing a modem sound when you open Tor Browser (because Tor is so slow)
-If you use Ubuntu, you can install it now from my PPA (see "Installing in Ubuntu" below). [Soon](https://github.com/micahflee/torbrowser-launcher/issues/31) it will be in Debian. To install it in any other distribution, follow the "Quick Start" instructions.
+If you use Ubuntu, you can install it now from my PPA (see "Installing in Ubuntu" below). Tor Browser Launcher will be included in the main Ubuntu repository in 14.10, and is included is Debian Jessie. To install it in any other distribution, see the [build instructions](/BUILD.md).
You might want to check out the [security design doc](/security_design.md).
-## Quick Start
-
-First, clone the repository:
-
- git clone https://github.com/micahflee/torbrowser-launcher.git
- cd torbrowser-launcher
-
-Then install dependencies, build a package, and install:
-
-### Debian, Ubuntu, Linux Mint, etc.
-
- sudo apt-get install build-essential python-all python-stdeb python-gtk2 python-psutil python-twisted python-lzma wmctrl gnupg fakeroot xz-utils
- ./build_deb.sh
- sudo dpkg -i deb_dist/torbrowser-launcher_*.deb
-
-Optionally you can install python-pygame if you want to play a modem sound while Tor Browser is launching.
-
-### Red Hat, Fedora, CentOS, etc.
-
- sudo yum install python-psutil python-twisted wmctrl gnupg fakeroot rpm-build
- ./build_rpm.sh
- sudo yum install dist/torbrowser-launcher-*.rpm
-
-Optionally you can install pygame if you want to play a modem sound while Tor Browser is launching.
-
-### Run without installing
-
-Install the dependencies: sadly, not all of them are available in virtualenv, so you will need to install (some of) them system-wide.
-Then, you can run: `TBL_SHARE=share ./torbrowser-launcher`
-
## Installing in Ubuntu
I've created a PPA where I'm maintaining torbrowser-launcher binaries. You can install in an Ubuntu-based distribution like this:
@@ -49,13 +21,3 @@ I've created a PPA where I'm maintaining torbrowser-launcher binaries. You can i
sudo apt-get update
sudo apt-get install torbrowser-launcher
-## Enabling AppArmor Profiles
-
-AppArmor is a Linux kernel hardening technology that lets you confine specific programs to only use specific resources. For example, if you visit a website that exploits a bug in the Tor Browser to get arbitrary code execution, the attacker won't be able to access files in ~/.gnupg. Here's how you turn on the AppArmor profiles for Tor Browser Launcher and for the programs bundled in the TBB.
-
- sudo apt-get install apparmor-utils
- sudo aa-enforce /etc/apparmor.d/usr.bin.torbrowser-launcher
- sudo aa-enforce /etc/apparmor.d/torbrowser.start-tor-browser
- sudo aa-enforce /etc/apparmor.d/torbrowser.Browser.firefox
- sudo aa-enforce /etc/apparmor.d/torbrowser.Tor.tor
-
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-privacy/packages/torbrowser-launcher.git
More information about the Pkg-privacy-commits
mailing list