# 
Copyous - Clipboard Manager
[](./LICENSE)
[](https://github.com/boerdereinar/copyous/releases/latest)
[](https://extensions.gnome.org/extension/8834/copyous/)
## 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)
[
](https://extensions.gnome.org/extension/8834/copyous/)
### From Latest GitHub Release
1. Download the latest release from [Releases](https://github.com/boerdereinar/copyous/releases).
2. Install extension:
```shell
gnome-extensions install -f ~/Downloads/copyous@boerdereinar.dev.zip
```
3. Restart the session by logging out.
4. Enable the extension in [Extension Manager](https://flathub.org/en/apps/com.mattjakeman.ExtensionManager) or by running the following command:
```shell
gnome-extensions enable copyous@boerdereinar.dev
```
### From Source
1. Install the following prerequisites:
- Make
- Node.js
- [pnpm](https://pnpm.io/installation)
2. Clone the repository:
```shell
git clone --recurse-submodules https://github.com/boerdereinar/copyous
cd copyous
```
3. Build and install the extension:
```shell
pnpm install
```
4. Restart the session by logging out.
5. Enable the extension in [Extension Manager](https://flathub.org/en/apps/com.mattjakeman.ExtensionManager) or by running the following command:
```shell
gnome-extensions enable copyous@boerdereinar.dev
```
## Configuration
You can open the extension settings either through the panel indicator, [Extension Manager](https://flathub.org/en/apps/com.mattjakeman.ExtensionManager) or by running the following command:
```shell
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
```shell
gdbus call --session \
--dest org.gnome.Shell.Extensions.Copyous \
--object-path /org/gnome/Shell/Extensions/Copyous \
--method org.gnome.Shell.Extensions.Copyous.Toggle
```
```shell
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](./CONTRIBUTING.md) for more information.
## Acknowledgments
Copyous is a full rewrite of [Pano](https://github.com/oae/gnome-shell-pano).
## License
This project is licensed under the **GNU General Public License 3 or Later**.