From 5c8591b2e53eea200eb7a5c2668609292e757105 Mon Sep 17 00:00:00 2001 From: NotAShelf Date: Fri, 23 Jan 2026 23:10:58 +0300 Subject: [PATCH] docs: mention MIME preference usage in README Signed-off-by: NotAShelf Change-Id: I3bda3397f0350f27523b419bd079f8756a6a6964 --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/README.md b/README.md index 72ea591..faabc1c 100644 --- a/README.md +++ b/README.md @@ -275,6 +275,30 @@ entry has expired from history. > This behavior only applies when the watch daemon is actively running. Manual > 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 Some commands take additional flags to modify Stash's behavior. See each