2023-11-13 14:33:28 +00:00
|
|
|
# reader
|
|
|
|
|
|
|
|
|
|
Reader environment as the default_dispvm in Qubes OS.
|
|
|
|
|
|
|
|
|
|
## Table of Contents
|
|
|
|
|
|
|
|
|
|
* [Description](#description)
|
|
|
|
|
* [Installation](#installation)
|
|
|
|
|
* [Usage](#usage)
|
|
|
|
|
* [Credits](#credits)
|
|
|
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
|
|
Create a disposable template for reading documents and viewing images called
|
|
|
|
|
"dvm-reader". It is designated to be the "default_dispvm", because of this,
|
|
|
|
|
there is no "netvm", but if you assign one, you will get networking as the
|
|
|
|
|
necessary packages will be installed in the template.
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
- Top:
|
|
|
|
|
```sh
|
|
|
|
|
qubesctl top.enable reader
|
2024-01-31 13:42:17 +00:00
|
|
|
qubesctl --targets=tpl-reader,dvm-reader state.apply
|
2023-11-13 14:33:28 +00:00
|
|
|
qubesctl top.disable reader
|
2023-12-20 20:24:43 +00:00
|
|
|
qubesctl state.apply reader.appmenus
|
2023-11-13 14:33:28 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- State:
|
|
|
|
|
<!-- pkg:begin:post-install -->
|
|
|
|
|
```sh
|
|
|
|
|
qubesctl state.apply reader.create
|
|
|
|
|
qubesctl --skip-dom0 --targets=tpl-reader state.apply reader.install
|
2024-01-31 13:42:17 +00:00
|
|
|
qubesctl --skip-dom0 --targets=dvm-reader state.apply reader.configure
|
2023-12-20 20:24:43 +00:00
|
|
|
qubesctl state.apply reader.appmenus
|
2023-11-13 14:33:28 +00:00
|
|
|
```
|
|
|
|
|
<!-- pkg:end:post-install -->
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
The intended usage of this qube is a receiver of incoming files that the call
|
|
|
|
|
originator/client did no trust to open in its environment. When you run
|
|
|
|
|
`qvm-open-in-dvm` from a qube and it is using the global preferences default
|
|
|
|
|
`default_dispvm`, it will open the file to be read in a disposable based on
|
|
|
|
|
`dvm-reader`.
|
|
|
|
|
|
2024-01-12 18:47:52 +00:00
|
|
|
By default, there is no `netvm`, thus allowing you to set the networking chain
|
|
|
|
|
you want before the disposable makes a connection.
|
|
|
|
|
|
2023-11-13 14:33:28 +00:00
|
|
|
## Credits
|
|
|
|
|
|
|
|
|
|
- [Unman](https://github.com/unman/shaker/tree/main/reader)
|
