# CloudClip

**Repository Path**: mirrors_skywind3000/CloudClip

## Basic Information

- **Project Name**: CloudClip
- **Description**: Your own clipboard in the cloud, copy and paste text with gist between systems !!
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-19
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CloudClip

Your own clipboard in the cloud, copy and paste text with gist. Inspired by pbcopy/pbpaste from Mac OS X.

## Tutorial

Copy text on a remote system to the cloud:

    echo "Hello, Cloud Clipboard" | cloudclip -c

Paste on a local system from the cloud:

    cloudclip -p

And you will see the text coppied from the remote system:

    Hello, Cloud Clipboard

Same access token and gist id must be setup before copy/paste, see below


## Installation

Clone the repository from github:

```bash
git clone https://github.com/skywind3000/CloudClip.git
```

Add repository path to your `$PATH`:

For linux, add these line at the bottom of your `.bashrc`:

    export PATH="/path-to-cloud-clip:$PATH"

For Windows:

Manully setup the PATH in your control panel. 

## Documentation

usage: python cloudclip.py <operation> [...]
operations:

```bash
-i <token> [id]  Initialize token and id, create a new gist if id is empty
-c [name]      Takes the standard input and places it in the cloud
-p [name]      Read content from cloud and output to standard output
-l             List information of the gist
-e             Clean the clipboard
```

A github access token is needed before everything, you can generate a new one from: https://github.com/settings/tokens

Create a new gist with "-i token" on your own PC, remember the gist id. then use "-i token id" on a remote one which you may exchange data with.

## Aliases

For convenience, two aliases can be created:

```bash
alias cloudcopy='python /path/to/cloudclip.py -c'
alias cloudpaste='python /path/to/cloudclip.py -p'
```

## Requirement

* Python 2
* [requests](http://www.python-requests.org/en/master/)

Install requests with pip:

    pip install requests

## Credit

TODO