Copyous - Clipboard Manager

Features

• Supports text, code, images, files, links, characters and colors.
• Can be opened at mouse pointer or text cursor
• Pin favorite items
• Group items with 9 colored tags
• Customizable clipboard actions
• Highly customizable

Installation

For the extension to work optimally you need to install the following dependencies:

• Libgda 5.0 or 6.0 with SQLite support
• GSound

Install Libgda and GSound

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

From Gnome Extensions (Recommended)

From Latest GitHub Release

1. Download the latest release from Releases.
2. Install extension:

   gnome-extensions install -f ~/Downloads/copyous@boerdereinar.dev.zip
   

3. Restart the session by logging out.
4. Enable the extension in Extension Manager or by running the following command:

   gnome-extensions enable copyous@boerdereinar.dev
   

From Source

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

   git clone --recurse-submodules https://github.com/boerdereinar/copyous
   cd copyous
   

3. Build and install the extension:

   pnpm install
   

4. Restart the session by logging out.
5. Enable the extension in Extension Manager or by running the following command:

   gnome-extensions enable copyous@boerdereinar.dev
   

Configuration

You can open the extension settings either through the panel indicator, Extension Manager or by running the following command:

gnome-extensions prefs copyous@boerdereinar.dev

Shortcuts

The most common shortcuts are listed below. Some can be customized in the extension settings. You can also find a complete list of all available shortcuts there.

Description	Shortcut
Open Clipboard Dialog	Super Shift V
Toggle Incognito Mode	Super Shift Ctrl 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.Copyous Path: /org/gnome/Shell/Extensions/Copyous

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.Copyous \
    --object-path /org/gnome/Shell/Extensions/Copyous \
    --method org.gnome.Shell.Extensions.Copyous.Toggle

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

Contributing

See CONTRIBUTING.md for more information.

Acknowledgments

Copyous is a full rewrite of Pano.

License

This project is licensed under the GNU General Public License 3 or Later.