============================
📋 Clipboard Indicator
============================

.. image:: https://raw.githubusercontent.com/andyholmes/gnome-shell-extensions-badge/eb9af9a1c6f04eb060cb01de6aeb5c84232cd8c0/get-it-on-ego.svg?sanitize=true
   :target: https://extensions.gnome.org/extension/779/clipboard-indicator/
   :width: 180
   :alt: Get it on GNOME Extensions

The most popular, reliable and feature-rich clipboard manager for GNOME with
over **1M** downloads.

|Screenshot|

.. |Screenshot| image:: ./screenshot.png
  :width: 400
  :alt: A screenshot of the clipboard manager, showing clipboard history including images

This extension is also packaged by the community for many popular Linux distros
— search your package manager.

🧰 Features:
----------------

- Highly customizable
- Supports both text and images
- Allows pinning items to top
- Includes a "private" mode
- Has configurable shortcuts
- Keyboard control

In-Menu Keyboard Controls
^^^^^^^^^^^^^^^^^^^^^^^^^^

- Use arrows to navigate
- :code:`v` to paste directly from menu
- :code:`p` to pin item
- :code:`<Delete>` to delete an item

📦 Install from source
----------------

Installation via git is performed by cloning the repo into your local gnome-shell extensions directory (usually :code:`~/.local/share/gnome-shell/extensions/`)::

    $ git clone https://github.com/Tudmotu/gnome-shell-extension-clipboard-indicator.git <extensions-dir>/clipboard-indicator@tudmotu.com

After cloning the repo, the extension is practically installed yet disabled. In order to enable it, run the following command::

    $ gnome-extensions enable clipboard-indicator@tudmotu.com


✅ GNOME Version Support
--------------------------
Depending on your GNOME version, you will need to install the following
Clipboard Indicator versions:

* GNOME 45 and above:

  * Use latest version

* GNOME 42-44

  * v47

* GNOME 40-41

  * v39

* GNOME <40

  * v37

⌨️ Contributing
----------------
Contributions to this project are welcome.

Please follow these guidelines when contributing:

- If you want to contribute code, your best bet is to look for an issue with the label "Up for grabs"
- DO NOT open unsolicited PRs unless they are for updating translations
- Look at the list of previous PRs before you open a PR, if your PR conflicts with another, it will be rejected
- If you have a feature idea, open an issue and discuss it there before implementing. DO NOT open a PR as a platform for discussion

Note: I have very little time to maintain this project, so expect long (months) of response time. Apologies in advance.