PairDrop/docs/how-to.md

How-To

Send directly from share menu on iOS

I created an iOS shortcut to send images, files, folder, URLs
or text directly from the share-menu https://routinehub.co/shortcut/13990/

Send directly from share menu on Android

The Web Share Target API is implemented.

When the PWA is installed, it will register itself to the share-menu of the device automatically.

Send directly via command-line interface

Send files or text with PairDrop via command-line interface.
This opens PairDrop in the default browser where you can choose the receiver.

Usage

pairdrop -h

Send files or text with PairDrop via command-line interface.
Current domain: https://pairdrop-dev.onrender.com/

Usage:
Open PairDrop:		pairdrop
Send files:		pairdrop file1/directory1 (file2/directory2 file3/directory3 ...)
Send text:		pairdrop -t "text"
Specify domain:		pairdrop -d "https://pairdrop.net/"
Show this help text:	pairdrop (-h|--help)

This pairdrop-cli version was released alongside v1.10.0

Setup

Download the bash file: pairdrop-cli/pairdrop.

Linux

1. Download the latest pairdrop-cli.zip from the releases page
2. Unzip the archive to a folder of your choice e.g. /usr/local/bin/pairdrop-cli/
3. Make sure the bash file /usr/local/bin/pairdrop-cli/pairdrop is executable. Otherwise, use chmod +x pairdrop
4. Add absolute path of the folder to PATH variable to make pairdrop available globally by executing export PATH=$PATH:/usr/local/bin/pairdrop-cli/

Mac

1. add bash file to /usr/local/bin

Windows

1. Download the latest pairdrop-cli.zip from the releases page
2. Put file in a preferred folder e.g. C:\Program Files\pairdrop-cli
3. Search for and open Edit environment variables for your account
4. Click Environment Variables…
5. Under System Variables select Path and click Edit...
6. Click New, insert the preferred folder (C:\Program Files\pairdrop-cli), click OK until all windows are closed
7. Reopen Command prompt window

Requirements

As Windows cannot execute bash scripts natively, you need to install Git Bash. Then, you can also use pairdrop-cli from the default Windows Command Prompt
by using the shell file instead of the bash file: pairdrop.sh -h which then itself executes
pairdrop-cli (the bash file) via the Git Bash.

Send multiple files and directories directly from context menu on Windows

Registering to open files with PairDrop

It is possible to send multiple files with PairDrop via the context menu by adding pairdrop-cli to Windows Send to menu:

1. Download the latest pairdrop-cli.zip from the releases page
2. Unzip the archive to a folder of your choice e.g. C:\Program Files\pairdrop-cli\
3. Copy the shortcut send with PairDrop.lnk
4. Hit Windows Key+R, type: shell:sendto and hit Enter.
5. Paste the copied shortcut into the directory
6. Open the properties window of the shortcut and edit the link field to point to send-with-pairdrop.ps1 located in the folder you used in step 2:
   "C:\Program Files\PowerShell\7\pwsh.exe" -File "C:\Program Files\pairdrop-cli\send-with-pairdrop.ps1"
7. You are done! You can now send multiple files and directories directly via PairDrop:

context menu > Send to > PairDrop

Requirements

As Windows cannot execute bash scripts natively, you need to install Git Bash.

Send multiple files and directories directly from context menu on Ubuntu using Nautilus

Registering to open files with PairDrop

It is possible to send multiple files with PairDrop via the context menu by adding pairdrop-cli to Nautilus Scripts menu:

1. Download the latest pairdrop-cli.zip from the releases page
2. Unzip the archive to a folder of your choice e.g. /usr/local/bin/pairdrop-cli/
3. Copy the shell file send-with-pairdrop.sh to /home/<user>/.local/share/nautilus/scripts/
4. Edit the shell file and edit the variable pathToPairDropCli to point to the pairdrop-cli executable from step 2 (e.g. /usr/local/bin/pairdrop-cli/pairdrop)
5. Make sure the shell file /home/<user>/.local/share/nautilus/scripts/send-with-pairdrop.sh is executable. Otherwise, use chmod +x send-with-pairdrop.sh
6. You are done! You can now send multiple files and directories directly via PairDrop:

context menu > Scripts > send-with-pairdrop.sh

File Handling API

The File Handling API was implemented, but it was removed as default file associations were overwritten (#17, #116 #190) and it only worked with explicitly specified file types and not with directories at all.

< Back