# 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/avinashkarhana/clipShare",
"name": "clipShare",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "clipboardSync clipboard sync share encrypted secure clipShare",
"author": "Avinash Karhana",
"author_email": "avinashkarhana1@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b8/72/574072b2c65e14ead566f77e4daa6fcb8fcb1bc1185569a9ad86ef357583/clipshare-0.1.5.tar.gz",
"platform": null,
"description": "# clipShare\n[![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)\n\n*Check the PyPi Package [here](https://pypi.org/project/clipShare/)*\n\nA single TCP server/client bundle that allows you to sync your clipboard between systems.\n\n## Features\n1. Sync clipboard between systems.\n2. Has a Web UI. `Server IP:Port` or `ngrok-tunnel-host`\n - To view clipboard on mobile devices.\n - To sync clipboard if not using the Python client.\n2. Advertise the server on the local network.\n3. Authentication using passcode. (Passcode should be shared via some external safe channel)\n5. Scan for servers on the local network.\n6. The same script can be used as a server or client.\n7. Encrypted communication for clipboard sharing with AES Encryption (Key should be shared via some external safe channel)\n\n## Installation\n\n pip install clipShare\n\n## Usage\n\n Usage: \n clipShare [... OPTIONS]\n \n\n Options:\n -h, --help Show this help message and exit\n -s, --server [SERVER_PORT_NUMER], --server [SERVER_PORT_NUMER]\n Run as server on the specified port.\n -c, --client SERVER_IP:SERVER_PORT_NUMBER, --client SERVER_IP:SERVER_PORT_NUMBER\n Run as a client, that connects to specified server IP and port.\n -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\n -a, --advertise Enable Advertising server on the local network.\n -n, --name Name of the server to be advertised.\n -p, --passcode Passcode for authentication.\n -ep, --encryption-password Encryption password for data transfer.\n -toh, --tcp-over-https Enable TCP over HTTPS for ngrok tunnel.\n -d, --debug Enable debug mode.\n\n Examples:\n clipShare -s 5000\n clipShare -s 5000 -d\n clipShare -s 5000 -a\n clipShare -s 5000 -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd\n clipShare -s 5000 -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd -t -a -d\n clipShare -c 192.168.0.1:8080\n clipShare -c -d\n clipShare -c -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd\n clipShare -c \"abc.com\" -toh -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd\n clipShare -c \"abc.com:120\" -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd\n clipShare -c -d -p RandomPasscode -ep 5up3rS3cu3_3ncrY9t1on_P45sw0rd\n\n\n## Do you Want to help me to work more on Open-Source Projects like this?\n<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.\n\nOr use other sponsoring methods if you like.\n",
"bugtrack_url": null,
"license": "LGPLv2.1",
"summary": "Sync clipboard between devices",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/avinashkarhana/clipShare"
},
"split_keywords": [
"clipboardsync",
"clipboard",
"sync",
"share",
"encrypted",
"secure",
"clipshare"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "30659ab919c012877914b1f8eaee71a44376e7d633b1632fb4b08467e97998f8",
"md5": "5b0c58c5c57534bf02c3dfaea8034ae3",
"sha256": "a14efcebeac257294ad2667584db9393f63885df184f6703ca4636f960996953"
},
"downloads": -1,
"filename": "clipShare-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5b0c58c5c57534bf02c3dfaea8034ae3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 146905,
"upload_time": "2024-05-15T17:36:41",
"upload_time_iso_8601": "2024-05-15T17:36:41.092801Z",
"url": "https://files.pythonhosted.org/packages/30/65/9ab919c012877914b1f8eaee71a44376e7d633b1632fb4b08467e97998f8/clipShare-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b872574072b2c65e14ead566f77e4daa6fcb8fcb1bc1185569a9ad86ef357583",
"md5": "b7457b058c085b4cf8b0d558edf8b0cc",
"sha256": "5eafb8507fd32237075d9cc10755cb6a5914fe9f4a2ea48cff4b1a203305151b"
},
"downloads": -1,
"filename": "clipshare-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "b7457b058c085b4cf8b0d558edf8b0cc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 148962,
"upload_time": "2024-05-15T17:36:43",
"upload_time_iso_8601": "2024-05-15T17:36:43.133119Z",
"url": "https://files.pythonhosted.org/packages/b8/72/574072b2c65e14ead566f77e4daa6fcb8fcb1bc1185569a9ad86ef357583/clipshare-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-15 17:36:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "avinashkarhana",
"github_project": "clipShare",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "clipshare"
}