Lightweight cross-platform clipboard library
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
include
samples
src
test
third_party
.appveyor.yml
.gitignore
.gitmodules
.travis.yml
CMakeLists.txt
Doxyfile
LICENSE
README.md
cmake_uninstall.cmake.in
libclipboard.pc.in

README.md

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