Clipcell

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Acknowledgments

About The Project

A simple wayland native GUI clipboard manager, with support for text and image preview.

(back to top)

Getting Started

Prerequisites

• libpng
• freetype2
• libxkbcommon
• libmagic
• wayland (obviously)
• wl-clipboard

Configuration

1. Configuration In suckless fashion configuring the clipboard is done only through the src/config.h file. To keep everything minimal and not bloat the project with unnecessary fontconfig dependencies a path to the font that is to be used should be set in the config file, by default it being /usr/share/fonts/koruri/Koruri-Regular.ttf.

Installation

1. Just a simple

   sudo make install

   should install clipcelld and clipcell to /usr/bin.

(back to top)

Usage

The clipboard entries are stored in a shared memory file, created by the server. The client does not run if the file does not exist.

1. To store clipboard entries just run the server like so:

   wl-paste --watch clipcelld store

   This shall be called once per session in your config.

2. To delete the saved clipboard entries (including the shm file) run:

   clipcelld reset

3. Once the server has created a shm file, the client can simply be run as such:

   clipcell | wl-copy

(back to top)

Roadmap

• Ability to render any type of image (not just png)
• Better font rendering
• Mouse scrolling

(back to top)

Acknowledgments

• foot - For teaching me about timers
• cliphist - For inspiring this project

(back to top)