mirror of
https://github.com/ben-grande/qusal.git
synced 2024-12-26 16:09:47 -05:00
383c840f2f
Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent.
114 lines
2.5 KiB
Markdown
114 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
|
|
```
|
|
|
|
* 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
|
|
```
|