Skip to content
master
Switch branches/tags
Go to file
Code

libclipboard Linux/OS X Build Status Win32 Build status

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