Support

Pasket has no main window. It lives in the menu bar, watches the clipboard while it runs, and opens the history panel when you launch it.

1. Launch Pasket from Applications. It is a menu-bar app: the basket icon appears in the menu bar and the history panel opens. There is no Dock icon while the panel is open; Settings adds one temporarily.
2. Allow clipboard access when macOS asks. Pasket reads the clipboard to save what you copy. If you decline, collection cannot work; the panel offers a button that opens System Settings.
3. Grant Accessibility only if you want automatic paste. Without it, Return and Paste still copy the item; you paste it yourself with Command + V.

macOS may ask for clipboard access the first time Pasket reads a new item, not at launch. If the prompt was dismissed, the panel says access is denied and offers a button that opens System Settings.

Closing the panel leaves Pasket running and collecting. Quit from the menu bar to stop both; launching it again does not import whatever is already on the clipboard.

Pasket has no default global shortcut. Choose one in Settings → Keyboard shortcuts; that combination toggles the panel from any app. You can change it later. If another app already owns the combination, pick a different one; Settings shows an error if registration fails. The search field takes focus whenever the panel opens; type to search the complete saved content or source app, or use the type selector to show text, images, files, links, or emails.

Search text clears every time the panel opens. The type filter can persist for a while instead; the interval is in Settings → History panel → Remember type filter, from Never to Until Pasket quits.

Arrow keys and row clicks change the selected entry without moving focus out of search, so you can keep typing. Return, double-click, or Paste copies the complete item; when Pasket can deliver it, the panel closes and the paste goes to the app you came from. Escape closes the panel; if a menu is open, Escape closes that first and returns focus to search.

The panel borrows keyboard focus without bringing Pasket forward, so the app you were typing in keeps its caret. If you switch apps or reopen history before the paste is delivered, the pending paste is cancelled. If nothing arrives, press Escape and then Command + V in the target app.

Return, double-click, and Paste all try to deliver the item for you. That delivery is the only reason Pasket asks for Accessibility: it posts Command + V to the application that was frontmost when the panel opened. Pasket does not monitor keystrokes or read other apps’ content.

Without the permission, the item is still copied. The panel shows a System Settings… button; grant access, then reopen history from the app where you want to paste and choose the item again. A permission change never replays an earlier paste.

Delivery is cancelled if the target app quits or stops being active, if you switch apps, if you reopen history, or if the clipboard changes before the event is sent. Holding Return or a shortcut modifier delays delivery for up to one second.

Pasket never changes the system setting for you. The button asks macOS or opens System Settings; the choice stays with you.

While Pasket is running and collecting, it checks the pasteboard every 350 milliseconds. Copies made and replaced between checks can be missed. It does not import the clipboard when it starts or resumes, and it does not replay copies made while paused.

Pause from the status light in the panel footer or from the menu bar. The pause survives a relaunch; quitting stops collection.

Items marked concealed, transient, or auto-generated are skipped; password managers and similar apps use those markers. Not every app marks sensitive content, though, so a password can be saved like any other text. Delete the entry, and pause collection if you need to.

Collection limits are 2,000 characters of text, 20 MiB per image, and 100 files per copy. An over-limit item is skipped with a notice, never truncated. History is local to this Mac; there is no account or sync.

By default Pasket keeps up to 2,026 entries, 50 MiB of text, 500 MiB of images and thumbnails, and 60 days of history. Settings → History shows all four, and each can be set to Unlimited.

Edits are drafts until Apply. If applying would delete anything, Pasket shows the entry count and estimated storage and asks again; Cancel keeps the draft, while Apply and Delete commits. Restore Defaults also changes only the draft.

Cleanup runs at startup, after history writes, every hour while running, and after waking from sleep, even while collection is paused. It removes expired entries first, then the oldest text, then the oldest images, then the oldest remaining entries. Copying an entry renews its age. Deleting an entry, or choosing … → Delete All Entries…, cannot be undone; neither deletes original files.

After an upgrade that adds limits, if adopting the defaults would delete anything, Pasket asks you to review before it does; automatic cleanup stays off until you apply.

Pasket stores a reference to a copied file, not the file: its path, name, size when known, and a bookmark. When macOS grants it, that bookmark is read-only and scoped to the file; Pasket does not ask for folder-wide access.

If the original is deleted or can no longer be read, the entry says “File unavailable” and cannot be copied. Copy the original again or delete the entry. Deleting history never deletes originals.

An image file’s preview is generated from the original, so it disappears with it and the row falls back to a placeholder icon. Images copied as image data, such as screenshots, are saved as PNG with a thumbnail.

Up to 100 files can be recorded in one copy; larger groups are skipped with a notice.

Open Settings with Command + comma or from the menu bar to change the bindings. There is no default global shortcut; here is how each one starts:

Show history

No default. Choose a global shortcut in Settings; it can be changed later.

Open Settings

Command + comma by default. It can be changed or cleared.

Delete Selected Item

No default. It works only in the history panel, removes one entry per press, and must differ from the other two. It needs Command, Control, or Option.

A new shortcut needs at least one of Command, Control, or Option, and Pasket rejects a combination already used by another Pasket shortcut. The history shortcut starts unassigned; choose one in Settings. The other two can be cleared. If registration fails, Settings shows the error.

The deletion shortcut works only while the history panel is open and removes one entry per press. Backspace and Delete always edit the search, even when it is empty; they never delete history.

The basket icon is not in the menu bar.

Pasket may not be running, or macOS may have hidden the icon behind the menu bar’s overflow. Launch it from Applications. Closing the panel does not quit Pasket; use Quit Pasket in the menu bar to stop collection.

No shortcut opens history.

Pasket ships without a global shortcut. Set one in Settings → Keyboard shortcuts. If you already did, check that Pasket is running; another app may own the combination, so choose a different one. If registration failed, Settings shows the error.

New copies are not saved.

Collection may be paused, clipboard access may be denied, or the item may be marked concealed, transient, or auto-generated. Text over 2,000 characters, images over 20 MiB, and groups over 100 files are skipped with a notice.

Return copies the item but does not paste it.

Automatic paste needs Accessibility permission. Grant it, then reopen history from the app where you want to paste and choose the item again. Switching apps, reopening history, or changing the clipboard cancels a pending paste.

A file entry says File unavailable.

The original was moved, deleted, or is no longer readable. Copy the original again, or delete the entry. Pasket stores a reference, not the file.

History disappeared after I changed the limits.

Cleanup removes the oldest entries to stay under the new limits, and deletion cannot be undone. Review the confirmation before applying a smaller limit.

Only the start of a long item is shown.

A row shows up to 120 characters and the preview shows 500. The complete item is saved and copied, and search uses all of it.

Pasket asks about unsaved changes when quitting.

A database write failed. Cancel to keep Pasket open and use Retry in the panel, or Quit Without Saving if you accept the loss. Check free disk space first.

Search cannot find an entry.

Search matches the complete saved text, but a type filter can hide results. Click Reset or return to All Types, then search again.

Pasket has no report sender and sends no logs. Include your macOS version, what kind of item you copied and from which app, the exact message you saw, and what you expected. A screenshot of the panel or Settings is useful.

Please do not send passwords or other sensitive clipboard contents. A description of the item’s type and source app is enough.

What Pasket stores, what it never sends, and why it asks for Accessibility at all: the privacy policy answers those in full.

Write to acehinnnqru@gmail.com with “Pasket support” in the subject, and include your macOS version and the steps that led to the problem.