-
Notifications
You must be signed in to change notification settings - Fork 72
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update readme and add link to APK binary
- Loading branch information
Showing
1 changed file
with
20 additions
and
15 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,28 +1,33 @@ | ||
| # clipper | ||
| Simple android app to interact with system clipboard service via adb shell | ||
| # Clipper | ||
| Simple app to interact with Android system clipboard service via adb shell one liners. | ||
|
|
||
| # Installation | ||
| Download the [application apk](https://github.com/majido/clipper/releases/download/v1.1/clipper-1.1.apk) and manually install application on your android device. | ||
|
|
||
| # Usage | ||
| Assuming you have already installed the app, connect to your emulator or phone using adb shell. | ||
| Invoke clipper service using an intent. The intent's *Action* can be either "get" or "set". When setting the clipboard value, pass your string as an *Extra* parameter. | ||
| First start the service. You can do this either by opening the application or using the following commands on ADB shell | ||
| $ adb shell | ||
| # am startservice ca.zgrs.clipper/.ClipboardService | ||
|
|
||
| * supported actions | ||
| 1. get: print the value in clipboard into logs (TODO: print the value on standard output) | ||
| 2. set: sets the clipboard content to the string passed via extra parameter "text" | ||
| * supported extras | ||
| 1. text: The text that you want to be copied in the clipboard | ||
|
|
||
| Usage example using broadcast intent: | ||
| Once service is started you can invoke clipper service by broadcasting intents. | ||
| The intent's *Action* can be either "get" or "set". When setting the clipboard value, pass your string as an *Extra* parameter. | ||
|
|
||
| * Supported actions | ||
| 1. **get**: print the value in clipboard into logs (TODO: print the value on standard output) | ||
| 2. **set**: sets the clipboard content to the string passed via extra parameter "text" | ||
| * Supported extras | ||
| 1. **text**: The text that you want to be copied in the clipboard | ||
|
|
||
| Usage example using broadcast intent: | ||
|
|
||
| # adb shell | ||
| # am broadcast -a clipper.set -e text "this can be pasted now" | ||
| # am broadcast -a clipper.get | ||
|
|
||
|
|
||
| # Installation | ||
| Build using maven. | ||
|
|
||
| 1. update pom.xml and set your android home | ||
| # Building | ||
| Build using maven | ||
| 1. update pom.xml and set ANDROID_HOME in enviroment. | ||
| 2. build: `mvn package` | ||
| 3. deploy:`mvn android:deploy` | ||
|
|