hand transfers

P2P file transfers between devices.

Synopsis

hand transfers list
hand transfers get <transfer_id>
hand transfers download <device_id> <dest_path> --source-share <ID> --files <IDs>
hand transfers upload <device_id> --source-share <ID> --dest-share <ID> --files <IDs>
hand transfers copy <source_device> <target_device> --source-share <ID> --dest-share <ID> --files <IDs>
hand transfers cancel <transfer_id>
hand transfers restart <transfer_id>
hand transfers delete <transfer_id>
hand transfers clear

Subcommands

transfers list

List all transfers.

$ hand transfers list
ID                    STATUS          FILES        SIZE       PROG   SPEED
---------------------------------------------------------------------------------
transfer-001...       completed         5/5     125.3 MB     100%   -
transfer-002...       transferring      3/10     45.2 MB      30%   12.5 MB/s
transfer-003...       failed            0/8          -         0%   -

transfers get <transfer_id>

Get detailed information about a transfer.

$ hand transfers get transfer-002
ID: transfer-002...
Status: transferring
Direction: download

Devices:
  Source: device-456... (alice@example.com)
  Target: device-789... (you@example.com)

Shares:
  Source Share: share-abc...
  Dest Share: share-xyz...
  Dest Path: downloads/

Progress:
  Files: 3/10 (30.0%)
  Bytes: 45.2 MB / 150.5 MB (30.0%)
  Speed: 12.5 MB/s
  Elapsed: 3s

Files (10):
  document.pdf (2.5 MB) - completed
  photo.jpg (5.1 MB) - completed
  video.mp4 (100 MB) - transferring (45%)
  ...

transfers download

Download files from a remote device to a local path.

Option	Description
`--source-share <ID>`	Source share on the remote device
`--files <IDs>`	Comma-separated file IDs to download

$ hand transfers download device-123 /tmp/downloads \
    --source-share share-456 \
    --files "file1,file2,file3"
Transfer started: transfer-004...

transfers upload

Upload files to a remote device.

$ hand transfers upload device-123 \
    --source-share share-local \
    --dest-share share-remote \
    --files "file1,file2"
Transfer started: transfer-005...

transfers copy

Copy files between two remote devices.

$ hand transfers copy device-source device-target \
    --source-share share1 \
    --dest-share share2 \
    --files "file1,file2"
Transfer started: transfer-006...

transfers cancel <transfer_id>

Cancel an active transfer.

$ hand transfers cancel transfer-002
Transfer cancelled

transfers restart <transfer_id>

Restart a failed or cancelled transfer.

$ hand transfers restart transfer-003
Transfer restarted

transfers delete <transfer_id>

Delete a transfer record.

$ hand transfers delete transfer-001
Transfer deleted

transfers clear

Clear all completed and failed transfer records.

$ hand transfers clear
Cleared 5 transfers

Transfer States

Status	Description
`pending`	Transfer created, waiting to start
`connecting`	Establishing P2P connection
`transferring`	Actively transferring files
`completed`	All files transferred successfully
`failed`	Transfer failed (can be restarted)
`cancelled`	Transfer was cancelled

Examples

Download from a shared folder

# Discover shares from contact
hand discovery shares friend@example.com

# List files in the share
hand files list <share_id>

# Download specific files
hand transfers download <device_id> ~/Downloads \
    --source-share <share_id> \
    --files "file-001,file-002"

# Monitor progress
hand transfers get <transfer_id>

Monitor and manage transfers

# List all transfers
hand transfers list

# Check details of active transfer
hand transfers get <transfer_id>

# Cancel if needed
hand transfers cancel <transfer_id>

# Clean up old transfers
hand transfers clear