mirror of
https://github.com/ben-grande/qusal.git
synced 2024-12-25 23:49:39 -05:00
102 lines
2.5 KiB
Markdown
102 lines
2.5 KiB
Markdown
# browser
|
|
|
|
Browser environment in Qubes OS.
|
|
|
|
## Table of Contents
|
|
|
|
* [Description](#description)
|
|
* [Installation](#installation)
|
|
* [Choose your browser](#choose-your-browser)
|
|
* [Usage](#usage)
|
|
|
|
## Description
|
|
|
|
Create environment for browsing. By default it creates a disposable template
|
|
called "dvm-browser", so when clicking the icon/launcher, it opens a
|
|
disposable qube. If you want to save your session, you can also clone the
|
|
template and create app qubes.
|
|
|
|
Default browser to install is Chromium, but you can choose to install Chrome,
|
|
Firefox, Firefox-ESR, Mullvad-Browser, W3M or Lynx.
|
|
|
|
## Installation
|
|
|
|
- Top:
|
|
```sh
|
|
sudo qubesctl top.enable browser
|
|
sudo qubesctl --targets=tpl-browser,dvm-browser state.apply
|
|
sudo qubesctl top.disable browser
|
|
sudo qubesctl state.apply browser.appmenus
|
|
```
|
|
|
|
- State:
|
|
<!-- pkg:begin:post-install -->
|
|
```sh
|
|
sudo qubesctl state.apply browser.create
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install
|
|
sudo qubesctl --skip-dom0 --targets=dvm-browser state.apply browser.configure
|
|
sudo qubesctl state.apply browser.appmenus
|
|
```
|
|
<!-- pkg:end:post-install -->
|
|
|
|
### Choose your browser
|
|
|
|
Instead of running the state `browser.install`, you can select which browser
|
|
to install:
|
|
|
|
- Chromium:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-chromium
|
|
```
|
|
|
|
- Chrome:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-chrome
|
|
```
|
|
|
|
- Firefox:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-firefox
|
|
```
|
|
|
|
- Firefox-ESR:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-firefox-esr
|
|
```
|
|
|
|
- Mullvad-Browser:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-mullvad-browser
|
|
```
|
|
|
|
|
|
- W3M:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-w3m
|
|
```
|
|
|
|
- Lynx:
|
|
```sh
|
|
sudo qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-lynx
|
|
```
|
|
|
|
Do not forget to sync the `appmenus`:
|
|
```sh
|
|
sudo qubesctl state.apply browser.appmenus
|
|
```
|
|
|
|
## Usage
|
|
|
|
Open a disposable qube simply by clicking on the desktop application
|
|
`dvm-browser (dvm): Browser`.
|
|
|
|
If you want to use a permanent browser session, create an app qube based on
|
|
`tpl-browser`.
|
|
|
|
If you are forwarding URLs from other qubes via `qvm-open-in-(d)vm`, you might
|
|
want to set your preferred browser as the default browser in `tpl-browser`
|
|
targeting the desired desktop file:
|
|
```sh
|
|
xdg-settings set default-web-browser firefox-esr.desktop
|
|
```
|