docs: mention MIME preference usage in README

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I3bda3397f0350f27523b419bd079f8756a6a6964
This commit is contained in:
raf 2026-01-23 23:10:58 +03:00
commit 5c8591b2e5
Signed by: NotAShelf
GPG key ID: 29D95B64378DB4BF

View file

@ -275,6 +275,30 @@ entry has expired from history.
> This behavior only applies when the watch daemon is actively running. Manual > This behavior only applies when the watch daemon is actively running. Manual
> expiration or deletion of entries will not clear the clipboard. > expiration or deletion of entries will not clear the clipboard.
### MIME Type Preference for Watch
`stash watch` supports a `--mime-type` (short `-t`) option that lets you
prioritise which MIME type the daemon should request from the clipboard when
multiple representations are available.
- `any` (default): Request any available representation (current behaviour).
- `text`: Prefer text representations (e.g. `text/plain`, `text/html`).
- `image`: Prefer image representations (e.g. `image/png`, `image/jpeg`) so that
image copies from browsers or file managers are stored as images rather than
HTML fragments.
Example: prefer images when running the watch daemon
```bash
stash watch --mime-type image
```
This is useful when copying images from browsers or file managers where the
clipboard may offer both HTML and image representations; selecting `image` will
ask the compositor for image data first. Most users will be fine using the
default value (`any`) but in the case your browser (or other applications!)
regularly misrepresent data, you might wish to prioritize a different type.
### Options ### Options
Some commands take additional flags to modify Stash's behavior. See each Some commands take additional flags to modify Stash's behavior. See each