Skip to content

feat: add Clipper clipboard workspace - #348

Draft
blackbartblues wants to merge 5 commits into
noctalia-dev:mainfrom
blackbartblues:agent/add-clipper-plugin
Draft

feat: add Clipper clipboard workspace#348
blackbartblues wants to merge 5 commits into
noctalia-dev:mainfrom
blackbartblues:agent/add-clipper-plugin

Conversation

@blackbartblues

@blackbartblues blackbartblues commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Plugin

  • Id: blackbartblues/clipper
  • New plugin
  • Update to an existing plugin (version bumped in plugin.toml)

What it does

Clipper provides a fullscreen clipboard workspace with searchable and typed cliphist history, image thumbnails, persistent pinned clips, and freely positioned sticky notecards. It can use an isolated database or an existing global cliphist database, and its paste action restores the window that was focused before the panel opened.

The plugin ships a bar widget, panel, singleton service, Control Center shortcut, English source translations, complete IPC coverage, tests, README, and a store thumbnail.

Core dependency

This is intentionally a draft while its Noctalia core dependencies are reviewed:

This PR adds the matching community manifest-validator schema and boolean validation for decorated, including regression tests. That keeps CI able to validate the plugin while the runtime support is reviewed separately in core.

External dependencies

  • cliphist: stores, lists, decodes, deletes, and clears clipboard history.
  • wl-copy: copies history and pinned payloads back to the Wayland clipboard.
  • wl-paste: runs the private database's text and image watchers.
  • wtype: sends the paste shortcut after focus restoration.
  • hyprctl: captures and restores focus on Hyprland.
  • niri: captures and restores focus on niri.
  • nc: communicates with the MangoWC IPC socket.

Only the compositor-specific command for the active session is used. The plugin makes no network requests. It writes its private database, pins, notes, and bounded thumbnail cache to the Noctalia plugin data directory, and exports requested notes to ~/Documents/Clipper.

Testing

  • Tested on Niri
  • Tested on Hyprland
  • Tested on Sway
  • Tested on another compositor:
  • Noctalia version tested against: v5.0.0-beta.8-36-g8403cb987adf-dirty
  • Plugin API level: 27

Checks performed:

  • lua tests/service_parser_test.lua
  • lua tests/service_global_database_test.lua
  • noctalia plugins lint clipper — 0 errors, 0 warnings
  • Community validator unit suite — 47 tests passed
  • Full repository manifest validation — 93 plugin manifests passed
  • Runtime service IPC: refresh dispatched successfully with the panel closed
  • Global database safety: the clear button is omitted and both wipe and IPC clear are rejected without spawning cliphist
  • Manual panel testing covered history filters and pagination, text/image thumbnails, pin/copy/paste/delete, notecard editing/autosave/color/export/overlap/z-order/free movement, settings, private/global database selection, and focus restoration on Hyprland

Screenshots / Videos

Clipper workspace

Clipper panel screenshot

Checklist

  • The directory name matches the part of id after the / in plugin.toml exactly.
  • It ships plugin.toml, README.md, thumbnail.webp, and translations/en.json.
  • README.md follows the
    README template, documents
    every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
  • I created thumbnail.webp with the thumbnail generator.
  • version follows semver and is bumped in this PR; plugin_api is the oldest API level this plugin requires.
  • Every non-English translation in this PR uses a locale supported by Noctalia core, and I can read, write, and
    understand that language well enough to review and maintain it (no unreviewed machine/LLM translations).
  • I did not edit catalog.toml; CI generates it.
  • This PR touches exactly one plugin directory.

Code review attestation

Plugins run as trusted, unsandboxed Luau in the user's session. Confirm:

  • The code is readable and not obfuscated, minified, or generated.
  • It does not download and execute remote code.
  • Every network call, filesystem write, and spawned process is something the description above accounts for.
  • I have the right to publish this code under the license declared in plugin.toml.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant