Metadata-Version: 2.1
Name: clipShare
Version: 0.1.4
Summary: Sync clipboard between devices
Home-page: https://github.com/avinashkarhana/clipShare
Author: Avinash Karhana
Author-email: avinashkarhana1@gmail.com
License: LGPLv2.1
Keywords: clipboardSync clipboard sync share encrypted secure clipShare
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: Flask
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
Classifier: Natural Language :: English
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flask
Requires-Dist: Flask-SocketIO
Requires-Dist: python-socketio
Requires-Dist: pyclip
Requires-Dist: pyperclip
Requires-Dist: pycryptodome
Requires-Dist: requests
Requires-Dist: pyngrok
Requires-Dist: netifaces2
Requires-Dist: zeroconf

# clipShare
[![Publish Python Package to PyPi](https://github.com/avinashkarhana/clipShare/actions/workflows/python-publish.yml/badge.svg)](https://github.com/avinashkarhana/clipShare/actions/workflows/python-publish.yml)

*Check the PyPi Package [here](https://pypi.org/project/clipShare/)*

A single TCP server/client bundle that allows you to sync your clipboard between systems.

## Features
1. Sync clipboard between systems.
2. Has a Web UI. `Server IP:Port` or `ngrok-tunnel-host`
    - To view clipboard on mobile devices.
    - To sync clipboard if not using the Python client.
2. Advertise the server on the local network.
3. Authentication using passcode. (Passcode should be shared via some external safe channel)
5. Scan for servers on the local network.
6. The same script can be used as a server or client.
7. Encrypted communication for clipboard sharing with AES Encryption (Key should be shared via some external safe channel)

## Installation

    pip install clipShare

## Usage

    Usage: 
        clipShare [... OPTIONS]
        

    Options:
        -h, --help                      Show this help message and exit
        -s, --server [SERVER_PORT_NUMER], --server [SERVER_PORT_NUMER]
                                        Run as server on the specified port.
        -c, --client SERVER_IP:SERVER_PORT_NUMBER, --client SERVER_IP:SERVER_PORT_NUMBER
                                        Run as a client, that connects to specified server IP and port.
        -t, --serve-on-ngrok-tunnel     Enable Serve on ngrok tunnel. This option requires ngrok authtoken to be present in {current_dir}/ngrok-auth-token.txt
        -a, --advertise                 Enable Advertising server on the local network.
        -n, --name                      Name of the server to be advertised.
        -p, --passcode                  Passcode for authentication.
        -ep, --encryption-password      Encryption password for data transfer.
        -toh, --tcp-over-https          Enable TCP over HTTPS for ngrok tunnel.
        -d, --debug                     Enable debug mode.

    Examples:
        clipShare -s 5000
        clipShare -s 5000 -d
        clipShare -s 5000 -a
        clipShare -s 5000 -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd
        clipShare -s 5000 -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd -t -a -d
        clipShare -c 192.168.0.1:8080
        clipShare -c -d
        clipShare -c -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd
        clipShare -c "abc.com" -toh -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd
        clipShare -c "abc.com:120" -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd
        clipShare -c -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd


## Do you Want to help me to work more on Open-Source Projects like this?
<a href="https://www.buymeacoffee.com/avinashkarhana" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a> so that I can get one more sleepless night to work on this kind of stuff.

Or use other sponsoring methods if you like.
