feat: Color Picker plugin (#12)

* feat: add color picker panel (WIP - render bug) * docs: update README and add thumbnail * fix: rgb and hex options label key * fix: current swatch not loading on open * Modify plugin.toml metadata for color picker Updated plugin metadata fields including tags. --------- Co-authored-by: Lemmy <studio@quadbyte.net>
2026-07-14 23:42:37 -04:00
parent a6ea5ec9ed
commit 273700dad3
8 changed files with 932 additions and 0 deletions
@@ -0,0 +1,69 @@
+# Color Picker
+
+A screen color picker for Noctalia v5, built on top of [hyprpicker](https://github.com/hyprwm/hyprpicker).
+
+## Plugin
+
+| Field   | Value |
+| ------- | ----- |
+| ID      | `oldirtty/color_picker` |
+| Entries | Service: `service`; bar widget: `widget`; panel: `panel` |
+
+## Requirements
+
+Install `hyprpicker`
+
+- [hyprpicker](https://github.com/hyprwm/hyprpicker)
+
+## Installation
+
+The headless `service` triggers `hyprpicker` with arguments set in the plugin's settings.
+
+Widget controls:
+
+| Action      | Behavior |
+| ----------- | -------- |
+| Left click  | Open plugin's panel. |
+| Right click | Sample a color directly, without opening the panel. |
+
+Panel controls:
+
+| Action      | Behavior |
+| ----------- | -------- |
+| Click bigger swatch | Open color picker dialog. |
+
+## Usage
+
+- **Left-click** the bar widget to open the panel.
+- **Right-click** the bar widget to sample a color directly, without opening the panel.
+- Inside the panel, click any recent color swatch to select it, or edit the HEX/RGB/HSL fields directly or click the bigger swatch to open color picker dialog.
+- Colors picked during a panel session are added to history when the panel closes.
+
+## Settings
+
+| setting                      | type     | default     | description |
+| ---------------------------- | -------- | ----------- | ----------- |
+| `hyprpicker-format`          | `select` | `"hex"`     | Default color format to copy to clipboard (`hex` or `rgb`). |
+| `hyprpicker-lowercase`       | `bool`   | `false`     | Outputs the hexcode in lowercase. |
+| `swatch-radius`              | `int`    | `8`         | Corner radius of the history swatches and current-color preview. |
+| `hyprpicker-no-zoom`         | `bool`   | `false`     | Turns off the magnifying zoom lens while picking. |
+| `hyprpicker-scale`           | `int`    | `10`        | Zoom lens magnification, from `1` to `10`. |
+| `hyprpicker-radius`          | `int`    | `100`       | Zoom lens circle radius in pixels, from `1` to `1000`. |
+| `hyprpicker-disable-preview` | `bool`   | `false`     | Turns off the live color preview while picking. |
+| `hyprpicker-cursor`          | `bool`   | `false`     | Includes the cursor in the frozen screen preview. |
+| `glyph`                      | `glyph`  | `"palette"` | Glyph |
+
+## IPC
+
+Runs `hyprpicker` with the arguments given in plugin's settings.
+
+```bash
+noctalia msg panel-toggle oldirtty/color_picker:panel
+
+# Sample a color without opening the panel
+noctalia msg plugin oldirtty/color_picker:service all pick
+```
+
+## Notes
+
+- There is a known behavior where invoking `hyprpicker` through the plugin's background service imposes a timeout. The picker will close prematurely if a color is not selected within a certain timeframe, rather than staying open indefinitely waiting for a click.