qusal/salt/utils/tools/helpers/README.md
Ben Grande a67c6c6815
fix: receive Xfce configuration from dotfiles
The run-terminal program is not Qubes or Qusal specific and even could
be in the dotfiles, but Xfce helpers.rc depends on it to get any
available application.

For: https://github.com/ben-grande/dotfiles/pull/1
2025-02-27 11:47:57 +01:00

61 lines
955 B
Markdown

# helpers
Add helper scripts.
## Table of Contents
* [Description](#description)
* [Installation](#installation)
* [Usage](#usage)
## Description
Wrappers that help run applications available, either being terminals,
browsers, file manager or mail user agents. It is possible to try a specific
program by setting environment variables specific to each helper.
## Installation
* Top:
```sh
sudo qubesctl top.enable utils.tools.helpers
sudo qubesctl --targets=TARGET state.apply
sudo qubesctl top.disable utils.tools.helpers
```
* State:
<!-- pkg:begin:post-install -->
```sh
sudo qubesctl --skip-dom0 --targets=TEMPLATEVMS,APPVMS state.apply utils.tools.helpers
```
<!-- pkg:end:post-install -->
## Usage
Open a terminal:
```sh
run-terminal
```
Open a browser:
```sh
run-browser https://example.org
```
Open mail user agent program:
```sh
run-mail
```
Open file manager on a specific directory:
```sh
run-file-manager ~/
```