Skip to content

Add emoji-picker: emoji & Unicode symbol browser panel - #500

Closed
liamwh wants to merge 1 commit into
noctalia-dev:mainfrom
liamwh:emoji-picker-plugin
Closed

Add emoji-picker: emoji & Unicode symbol browser panel#500
liamwh wants to merge 1 commit into
noctalia-dev:mainfrom
liamwh:emoji-picker-plugin

Conversation

@liamwh

@liamwh liamwh commented Aug 27, 2026

Copy link
Copy Markdown

Plugin

  • Id: liamwh/emoji-picker
  • New plugin
  • Update to an existing plugin (version bumped in plugin.toml)

What it does

A Raycast-inspired emoji and Unicode symbol browser: fuzzy search over
~4,000 entries (CLDR names + keywords, plus curated symbol aliases so
"euro" ranks € above 💶), category browsing, a Frequently Used section
ranked by recency-decayed frequency, and copy-on-Enter. Three panel
entries (wide, desktop, compact) share one script and differ only
in surface size, so a binding can match the display; the grid tier is
derived from the focused output's logical width.

External dependencies

None. The optional paste_command setting (empty by default) runs a
shell command the user configures; the plugin ships no injection
machinery of its own and spawns nothing unless that setting is filled.

Testing

  • Self-contained Luau suite (stock luau CLI, no host needed):
    python3 tests/build_test.py --out /tmp/t.luau && luau /tmp/t.luau
    86 passed, 0 failed (symbol/emoji ranking, literal-character
    queries, browse/keyboard model, Enter-copies-and-closes, dataset
    pre-lowering contract, CPU-budget smoke: 0.43 ms average per search
    against the 25 ms host budget).

  • python3 .github/workflows/scripts/validate-plugins.py — clean.

  • Daily-driven on the author's machine as the local variant this was
    ported from; the thumbnail is a live screenshot of the panel.

  • Tested on Niri

  • Tested on Hyprland

  • Tested on Sway

  • Tested on another compositor:

  • Noctalia version tested against: v5.0.0-beta.9

  • Plugin API level: 28

Screenshots / Videos

thumbnail.webp (created with the thumbnail generator from a live
screenshot of the panel). Happy to attach a typing-and-selecting video
on request.

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

  • 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.

Notes for reviewers

Dataset provenance (committed data, not generated code):
assets/emoji.json is a data table generated deterministically from
pinned Unicode sources by tools/emoji-list-gen.py (shipped alongside,
docstring documents the exact inputs): CLDR 47 English annotations +
annotationsDerived (names, keywords), Unicode 16.0 emoji-test.txt (RGI
set, ordering, categories), Unicode 16.0 UnicodeData.txt (formal symbol
names). Data sources are Unicode-licensed; generator and plugin code are
MIT. The dataset ships pre-indexed (lowered names/keywords/aliases,
pre-built search blob) so full-dataset per-keystroke search stays inside
the host's CPU budget — the tests assert this.

Behaviour accounting: network — none; filesystem writes — one,
<pluginDataDir>/usage.json (pick counts + timestamps for Frequently
Used; deleting it resets recents); processes — none by default, only the
optional user-configured paste_command.

Works on stock Noctalia: no patched-shell capabilities required or
relied on.

Disclaimer: AI-assisted tooling was used.

Raycast-inspired picker: fuzzy search over ~4,000 emoji and Unicode
symbols (CLDR names + keywords, symbol aliases), category browsing, a
frequently-used section ranked by recency-decayed frequency, and
copy-on-Enter. Three panel entries (wide/desktop/compact) share one
script so a binding can match the display. Optional paste_command
setting runs a user-configured command after the copy instead of
shipping compositor-specific injection machinery.
@github-actions

Copy link
Copy Markdown
Contributor

This pull request was automatically closed because its description no longer contains
every part of the pull request template
that this repository requires.

Missing:

  • the template marker line <!-- noctalia-pr-template:v1 -->
  • the ## Plugin heading
  • the ## What it does heading
  • the ## External dependencies heading
  • the ## Checklist heading
  • the ## Code review attestation heading
  • the - **Id:** field
  • the - **Noctalia version tested against:** field
  • the - **Plugin API level:** field
  • the checklist entry: Update to an existing plugin (version bumped in plugin.toml)
  • the checklist entry: Tested on Niri
  • the checklist entry: Tested on Hyprland
  • the checklist entry: Tested on Sway
  • the checklist entry: Tested on another compositor:
  • the checklist entry: The directory name matches the part of id after the / in plugin.toml exactly.
  • the checklist entry: It ships plugin.toml, README.md, thumbnail.webp, and translations/en.json.
  • the checklist entry: README.md follows the README template, documents every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
  • the checklist entry: I created thumbnail.webp with the thumbnail generator.
  • the checklist entry: version follows semver and is bumped in this PR; plugin_api is the oldest API level this plugin requires.
  • the checklist entry: 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).
  • the checklist entry: I did not edit catalog.toml; CI generates it.
  • the checklist entry: This PR touches exactly one plugin directory.
  • the checklist entry: The code is readable and not obfuscated, minified, or generated.
  • the checklist entry: It does not download and execute remote code.
  • the checklist entry: Every network call, filesystem write, and spawned process is something the description above accounts for.
  • the checklist entry: I have the right to publish this code under the license declared in plugin.toml.
  • at least one checked compositor testing entry

Please add the items listed above back to the description, keeping their exact wording, then
reopen the pull request. Reopening re-runs this check. Draft pull requests may leave boxes
unchecked. Before a pull request is ready for review, exactly one plugin type, at least one
tested compositor, and every item under Checklist and Code review attestation must be checked.

@github-actions github-actions Bot closed this Aug 27, 2026
@liamwh

liamwh commented Aug 27, 2026

Copy link
Copy Markdown
Author

Superseded by #502 (same branch; re-opened as a fresh PR with the required template after the initial description was missing required sections). The thumbnail was also regenerated with the official generator in 7043992.

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