0ct0pu5/meli-terminal-mail-client
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

contrib/README.md: elaborate a bit about mailto

Browse source 
Elaborate on the necessary steps to make the mailto scheme handler
scripts work.

Signed-off-by: Manos Pitsidianakis <manos@pitsidianak.is>
This commit is contained in:
Manos Pitsidianakis 2024-12-05 12:08:13 +02:00
parent 2e900be698
commit 07812d2c85
No known key found for this signature in database
GPG key ID: 7729C7707F7E09D0
1 changed files with 24 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
contrib/README.md
View file

@ -20,14 +20,31 @@ on our issue tracker!
## Using `meli` for `mailto:` links
To use `meli` to open `mailto:` links from your browser place the `mailto-meli` and `mailto-meli-expect` into `/usr/bin`
(or `.local/bin`, and adjust the path in the script accordingly). Then set `mailto-meli` as program to open `mailto` links
in your browser.
To use `meli` to open `mailto:` links from your browser place the [`mailto-meli`](./mailto-meli) and [`mailto-meli-expect`](./mailto-meli-expect) scripts into `/usr/bin`
(or `.local/bin`, and adjust the path in the script accordingly).
E.g. in Firefox this can be done under
Ensure all scripts are executable by your user account, if not set the permissions accordingly:
```text
Settings -> Applications -> Content-Type: mailto.
```sh
chmod u+x /path/to/mailto-meli
```
Note that you need to have the [`expect`](https://en.wikipedia.org/wiki/Expect) binary installed for this to work.
and
```sh
chmod u+x /path/to/mailto-meli-expect
```
Then set `mailto-meli` as program to open `mailto` links
in your browser.
E.g. in Firefox this can be done under "Settings" (`about:preferences`) which you can access from the menu button or `Edit -> Settings`.
```text
General -> Applications -> Content-Type: mailto.
```
You can test that it works by clicking the system menu entry `File -> Email link...`.
_NOTE_: that you need to have the [`expect`](https://en.wikipedia.org/wiki/Expect) binary installed for this to work.
`expect` is a scripting language used for interactive with interactive terminal applications like `meli`.