Glyphous

All-in-one clipboard manager, emoji picker, and character map for GNOME.

Features

Clipboard Manager

• Supports text, code, images, files, links, and colors
• Open at mouse pointer or text cursor position
• Pin favorite items
• Group items with 9 colored tags
• Customizable clipboard actions
• Incognito mode

Emoji Picker

• Browse and search the full Unicode emoji set
• Skin tone selector
• Recently used emojis
• Copy emoji or insert directly

Character Map

• Browse Unicode character categories
• Search by name or codepoint
• Recently used characters
• Copy character or codepoint

Installation

The extension requires the following dependencies for full functionality:

• Libgda 5.0 or 6.0 with SQLite support
• GSound

Install dependencies

Distro	Command
Fedora	sudo dnf install libgda libgda-sqlite
Arch Linux	sudo pacman -S libgda6
Ubuntu/Debian	sudo apt install gir1.2-gda-5.0 gir1.2-gsound-1.0
openSUSE	sudo zypper install libgda-6_0-sqlite typelib-1_0-Gda-6_0 typelib-1_0-GSound-1_0

One-line Install / Update

curl -fsSL https://raw.githubusercontent.com/supSugam/glyphous/main/install.sh | bash

This downloads the latest release, installs it, and prints next steps. Run the same command again at any time to update.

After installing:

1. Log out and log back in (required for first install on Wayland)
2. Enable the extension:

   gnome-extensions enable glyphous@supsugam.github.com

   Or open the Extensions app and toggle Glyphous on.

From Source

1. Install prerequisites:
   • Make
   • Node.js
   • pnpm
   • jq
2. Clone the repository:

   git clone --recurse-submodules https://github.com/supSugam/glyphous
   cd glyphous

3. Install dependencies and build:

   pnpm install
   make install

4. Log out and log back in.
5. Enable the extension:

   gnome-extensions enable glyphous@supsugam.github.com

Configuration

Open extension settings via the panel indicator, Extension Manager, or:

gnome-extensions prefs glyphous@supsugam.github.com

Shortcuts

Key shortcuts for common actions. Most can be customized in extension settings.

Description	Shortcut
Open Clipboard Dialog	Super Shift V
Open Emoji Picker	Super Ctrl V
Toggle Incognito Mode	Super Ctrl Shift V
Copy Item	Enter / Space
Run Default Action	Ctrl Enter / Space
Pin Item	Ctrl S
Delete Item	Delete (hold Shift to force delete)
Navigation	Tab / ↑ / ↓ / ← / → / Home / End
Jump to Item	Ctrl 0...9
Toggle Pinned Search	Alt
Cycle Item Type	Ctrl Tab / Shift Ctrl Tab
Cycle Item Tag	Ctrl ` / Shift Ctrl `

DBus

Name: org.gnome.Shell.Extensions.Glyphous Path: /org/gnome/Shell/Extensions/Glyphous

Method	Arguments	Description
Toggle		Show or hide the clipboard dialog
Show		Show the clipboard dialog
Hide		Hide the clipboard dialog
ClearHistory	all:   if true, clears all history;   if false, clears unpinned/untagged items	Clear clipboard history

Examples

gdbus call --session \
    --dest org.gnome.Shell.Extensions.Glyphous \
    --object-path /org/gnome/Shell/Extensions/Glyphous \
    --method org.gnome.Shell.Extensions.Glyphous.Toggle

gdbus call --session \
    --dest org.gnome.Shell.Extensions.Glyphous \
    --object-path /org/gnome/Shell/Extensions/Glyphous \
    --method org.gnome.Shell.Extensions.Glyphous.ClearHistory false

Known Limitations

• Blur my Shell dragging latency: When moving the clipboard dialog while Blur my Shell is enabled, the blurred backdrop texture may visually trail behind the dialog frame. This occurs because the dialog is an in-process GNOME Shell Clutter actor (St.Widget), whereas Blur my Shell schedules its multi-pass shader texture repaints asynchronously via GLib.idle_add on the main loop. If this visual latency is undesirable, you can exclude Glyphous in Blur my Shell's popup whitelist settings.

Contributing

See CONTRIBUTING.md for more information.

Acknowledgments

Glyphous is a fork of Copyous by Boerde Einar, which itself is a full rewrite of Pano.

License

This project is licensed under the GNU General Public License v3 or later. See LICENSE for details.