Skip to content

Latest commit

 

History

History
174 lines (128 loc) · 6.36 KB

README.md

File metadata and controls

174 lines (128 loc) · 6.36 KB

ClipShare

ClipShare - Desktop

Share Clipboard and Files. Copy on one device. Paste on another device.

ClipShare is a lightweight and cross-platform tool for clipboard sharing. ClipShare enables copying text, files, and images on one device and pasted on another. ClipShare is simple and easy to use while being highly configurable. This is the desktop client of ClipShare that connects to a server running on the other machine to share copied text, files, and images.

Download

Server Download the server from GitHub Releases.
Mobile Client Download the mobile client app from apt.izzysoft.de/fdroid or from GitHub Releases.
Desktop Client Download the desktop client app (this repository) from GitHub Releases.

Table of Contents


How to Use

GUI client

The GUI client provides a web interface similar to the mobile client app. The client app acts as a bridge to use the web interface. To use the client in this web GUI mode, you need to run the client program.

  • You can run the client from a terminal or by double-clicking on the program (if the file manager supports executing programs in that way).
  • When the client starts, it will not display any visible window or produce any output.
  • Once the client starts, open a web browser (ex: Google Chrome, Microsoft Edge, Firefox, or any modern web browser) and visit http://localhost:8888/. This should open the ClipShare client web app.
  • Using the GUI client is same as using the mobile client except the desktop client uses the Send File button to send both copied files and folders.
  • To use the desktop client to send copied text or files, copy the text or files you want to send (just like you would copy them to paste somewhere else). Then press the correct Send button on the web app (either Send Text or Send File). Then you can paste them on the machine that runs the ClipShare server.
  • To use the desktop client to receive copied text, image, or files, copy the text or files on the machine that runs the ClipShare server. Then press the correct Get button on the web app (either Get Text, Get Image, or Get File). Then you can paste them on the machine that runs the client.
  • If something goes wrong, it will create a client_err.log file. That file will contain what went wrong.

Build from Source

Note: If you prefer using the pre-built binaries from Releases, you can ignore this section and follow the instructions in the How to Use section.

Build tools

Compiling ClipShare needs the following tools,

  • gcc
  • make
Linux

On Linux, these tools can be installed with the following command:

  • On Debian-based or Ubuntu-based distros,

    sudo apt-get install gcc make

  • On Redhat-based or Fedora-based distros,

    sudo yum install gcc make

  • On Arch-based distros,

    sudo pacman -S gcc make
Windows

On Windows, these tools can be installed with MinGW.
In an MSYS2 environment, these tools can be installed using pacman with the following command:

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-make

You may need to rename (or copy) the <MSYS2 directory>/mingw64/bin/mingw32-make.exe to <MSYS2 directory>/mingw64/bin/make.exe before running the command make

Dependencies

Linux

The following development libraries are required.

  • libc

  • libx11

  • libxmu

  • libunistring

  • libmicrohttpd

    They can be installed with the following command:

  • On Debian-based or Ubuntu-based distros,

    sudo apt-get install libc6-dev libx11-dev libxmu-dev libunistring-dev libmicrohttpd-dev

  • On Redhat-based or Fedora-based distros,

    sudo yum install glibc-devel libX11-devel libXmu-devel libunistring-devel libmicrohttpd-devel

  • On Arch-based distros,

    sudo pacman -S libx11 libxmu libunistring libmicrohttpd

    glibc should already be available on Arch distros. But you may need to upgrade it with the following command. (You need to do this only if the build fails)

    sudo pacman -S glibc
Windows

The following development libraries are required.

In an MSYS2 environment, these tools can be installed using pacman with the following command:

pacman -S mingw-w64-x86_64-libunistring

However, installing libmicrohttpd from GNU is recommended. You can download the library from https://ftpmirror.gnu.org/libmicrohttpd/libmicrohttpd-latest-w32-bin.zip and extract the files in it to correct include and library directories in the MSYS2 environment.


Compiling

  1. Open a terminal / command prompt / Powershell in the project directory

    This can be done using the GUI or the cd command.

  2. Run the following command to make the executable file

    make

    This will generate the executable named clip-share-client (or clip-share-client.exe on Windows).