Troubleshooting

#The Finder right-click menus are missing

Check these in order. The first one is by far the most common, and it is not something either you or Klippster can switch off.

#You are in iCloud Drive — including Desktop and Documents

Inside iCloud Drive the Finder right-click menus do not appear. Neither do they inside Dropbox or OneDrive folders. These are File Provider domains, and macOS reserves the contextual menu inside them for the provider that owns the folder; it does not call third-party Finder extensions there at all.

Two ways round it, both shipped:

• Right-click → Services, which carries the same four actions: Paste Clipboard Here, Copy to Clipboard as…, Convert with Klippster… and Edit with Klippster…. Services are dispatched by macOS itself and work everywhere the extension cannot reach. They cannot show a format list inside the menu the way the normal submenus do, so each one opens Klippster's format chooser instead and you pick there.
• ⌘⇧V and ⌘⇧C, which work everywhere as well — they never go through the Finder extension.

If the Services rows are not listed at all, open System Settings → Keyboard → Keyboard Shortcuts → Services and make sure they are ticked.

#Private Mode is on

In Private Mode, Klippster disappears from Finder's right-click menu completely — not just the clipboard entries, but Copy to Clipboard as and Convert to as well, which act on a file rather than the clipboard.

That is deliberate rather than an oversight: building the menu is what reads the clipboard, so there is no version of it that could be shown without reading. The menu-bar icon is hollow while Private Mode is on. The two shortcuts keep working, because they read the clipboard only at the moment you ask them to.

#Klippster is not in /Applications

macOS only loads a Finder Sync extension from an app installed there. Running it from ~/Downloads gets you a working menu-bar app with no Finder menus and no explanation. Move it and restart the app.

#The extension is not enabled

System Settings → General → Login Items & Extensions → Finder extensions, and switch Klippster on.

#A single entry saying it could not read its settings

That is the extension failing safe rather than guessing. Klippster and its Finder extension keep the Private Mode switch in shared storage, and macOS asks for permission before one can read the other's data. When that read does not succeed the extension cannot tell whether Private Mode is on, so it does not look at your clipboard at all and offers to open Klippster instead. Opening Klippster retries the read, and the permission dialog arrives with Klippster's own explanation of what is being shared.

#A keyboard shortcut does nothing

#The format I want is not in the menu

This is by design rather than a fault. Klippster only offers formats that can represent what you actually have — an image offers PNG and not Markdown, because there is no sensible Markdown rendering of a screenshot.

Two things worth checking before concluding a format is missing:

• What is really on the clipboard. Copying from a web page often puts HTML on the pasteboard, not Markdown, which changes the offered list.
• Whether the app that copied it set a type at all. Some apps only ever write plain text, in which case plain text is genuinely all there is.

If a clip was detected as the wrong kind, you can override the format per clip in Clipboard History. If the conversion simply does not exist yet, a Format Pack can add it.

#Clipboard History is not recording

In order of likelihood:

1. It is off. It does not start on its own, and an unanswered first-run prompt counts as no.
2. The source app marked the copy concealed or transient. Klippster honours that flag without exception. This is why passwords never appear.
3. The source app is on the exclusion list — the built-in password managers, plus anything you added yourself.

There is no way to override 2 or 3 for a specific copy, and that is deliberate.

#Markdown came out as literal # characters

The content was not detected as Markdown — it was treated as plain text, and plain text containing a # is rendered faithfully as a #.

Detection uses Apple's swift-markdown on the pasteboard content. If you copied from somewhere that supplies rich text or HTML as the preferred type, that type wins. Copy the raw source instead, or override the format on the clip in Clipboard History and convert from there.

#Activation problems

#The claim link does nothing when clicked

The link uses the klippster-license:// scheme, which only works if Klippster is installed on the Mac you clicked it on and has registered the scheme. If nothing happens, the browser is telling you it found no handler.

Use the activation key instead — Settings → Klippster Pro — which needs no URL scheme at all.

#The success page says "Payment is still processing"

Stripe has not confirmed the payment yet, which happens with slower payment methods. Nothing is lost and no action is needed: the licence email is sent as soon as the confirmation arrives.

#Reinstalling from scratch

If something is wrong in a way none of the above covers:

#Still stuck

support@klippster.app. What helps most: your macOS version, the Klippster version from the menu bar, and what you copied before the thing that went wrong — that last one is usually the answer.