Utility Library to Access and Manipulate the Default System Clipboard

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Hammy 792eda1c53 Add more Javadocs		3 years ago
src/main/java/me/goudham	Add more Javadocs	3 years ago
.gitignore	Update .gitignore	3 years ago
Dockerfile	Add Dockerfile	3 years ago
Jenkinsfile	Update codecov token	3 years ago
LICENSE	Initial commit	3 years ago
README.md	Add Installation section	3 years ago
pom.xml	Update description of library	3 years ago

README.md

MyClipboard

Utility Library to Access and Manipulate the Default System Clipboard

About

The inspiration for this project came from my frustration of macOS not having clipboard history built-in unlike Windows. This library will allow you to access the system clipboard and manipulate it.

Configuration

TODO

Windows / *Unix

This approach differs from the macOS section below as Windows/*Unix properly notify the program with global clipboard events. This allows for a more event-driven approach as lostOwnership() is triggered whenever the clipboard has lost ownership - clipboard has new content within it - and the contents can be observed by multiple consumers.

macOS

Unlike the aforementioned event-driven approach, macOS unfortunately is not very good at notifying the program if the system clipboard has changed. To query the system clipboard contents, we need to employ a polling schedule. I have chosen 350ms to ensure that images and large files can be copied over as well as reducing the load on the CPU.

Contributing

TODO

Installation

Latest Stable Version:

Be sure to replace the VERSION key below with the one of the versions shown above!

Maven

<!-- https://mvnrepository.com/artifact/me.goudham/MyClipboard -->
<dependency>
    <groupId>me.goudham</groupId>
    <artifactId>MyClipboard</artifactId>
    <version>VERSION</version>
</dependency>

Gradle

repositories {
    mavenCentral()
}

dependencies {
    // https://mvnrepository.com/artifact/me.goudham/MyClipboard
    implementation group: 'me.goudham', name: 'MyClipboard', version: 'VERSION'
}