Introducing sharing: A CLI Tool for Cross-Platform File and Clipboard Sharing

1. Overview

sharing is a command‑line tool that shares directories, files, and clipboard contents from a computer to iOS or Android devices without requiring a separate client application.

2. Installation

Source code is hosted at https://github.com/parvardegr/sharing. The tool runs on a Node.js runtime and can be installed globally with npm:

npm install -g easy-sharing

3. Features

Share directories and files

Share clipboard contents

Receive files

Basic authentication support

SSL support

4. Basic usage

Share a file or directory: sharing /path/to/file-or-directory Scan the generated QR code with a phone; both devices must be on the same Wi‑Fi network, or specify a public IP with the --ip flag:

sharing --ip your-public-ip-address /path/to/file-or-directory

Browse the directory on the phone and download the desired items.

macOS users should invoke the easy-sharing binary instead of sharing.

5. Additional commands and options

$ sharing --help
Usage:
• Share file or directory
  sharing /path/to/file-or-directory

• Share clipboard
  sharing -c

• Receive file
  sharing /destination/directory --receive

• Share with Basic Authentication
  sharing /path/to/file-or-directory -U user -P password

Options:
  --version               Show version number
  --debug                 Enable debugging logs
  -p, --port              Change default port
  --ip                    Your machine public IP address
  -c, --clipboard         Share clipboard
  -t, --tmpdir            Clipboard temporary files directory
  -w, --on-windows-native-terminal Enable QR‑Code support for Windows native terminal
  -r, --receive           Receive files
  -q, --receive-port      Change receive default port
  -U, --username          Set basic authentication username (default: "user")
  -P, --password          Set basic authentication password
  --help                  Show help