gerhobbelt / libclipboard

Lightweight cross-platform clipboard library

libclipboard

A cross-platform clipboard library.

Currently supported actions

• Checking clipboard data ownership
• Clearing clipboard
• Retrieving/setting text (UTF-8)

Supported platforms

• Windows
• Linux (X11)
• OS X (Cocoa)

Platforms to be supported in the future

• Linux (Wayland) (maybe)

Requirements

• cmake
• gtest & g++ >= 4.7 (optional; for unit testing)
• libxcb-dev (for Linux/X11)
• pthreads (for Linux/X11)

Building

Quickstart

git clone https://github.com/jtanx/libclipboard
cd libclipboard
cmake .
make -j4
sudo make install        (optional)

Building test module and samples

cd libclipboard
git submodule init
git submodule update
git clean -dxf            (if you had a previous build)
cmake .
make check -j4

To add SOVERSION to the library (i.e. libclipboard.so.1), configure with

cmake -DLIBCLIPBOARD_ADD_SOVERSION=ON

To build a shared library instead of a static library

cmake -DBUILD_SHARED_LIBS=ON

To build the library using the stdcall calling convention

cmake -DLIBCLIPBOARD_USE_STDCALL=on

To force the build of a particular backend, choose one of

cmake -DLIBCLIPBOARD_FORCE_WIN32=on
cmake -DLIBCLIPBOARD_FORCE_X11=on
cmake -DLIBCLIPBOARD_FORCE_COCOA=on

Note: This setting has only been tested for compiling the X11 backend on Windows.

To uninstall

sudo make uninstall