# hop

quick file upload to remote server via rsync.

## installation

hop is macos-only (uses pbcopy for clipboard, macos screenshot/record tools).

```bash
bun install
bun run build

# move the binary to your path
install hop /usr/local/bin/
```

## configuration

on first run, hop will create a config file at `~/.config/hop/config.json`:

```json
{
  "server": "user@domain.tld",
  "remotePath": "/var/www/",
  "baseUrl": "https://domain.tld"
}
```

edit this file with your server details.

## usage

```
hop - quick file upload to remote server via rsync

usage: hop [options] <file>

options:
  -h, --help                show this help message and exit
  -v, --verbose             enable verbose output
  -k, --keep-filename       keep original filename (don't hash)
  -f, --filename <name>     use custom filename
  -s, --screenshot          capture fullscreen and upload
  -sr, --screenshot-region  capture region/window and upload
  -r, --record              record screen (silent)
  -ra, --record-audio       record with microphone audio
```

output:
```
✓ uploaded file.png to https://domain.tld/hash.png
```

the url is also copied to your clipboard automatically.

## features

- **sha256 hash-based filenames** - content-addressable storage with 7-character hashes
- **rsync upload with progress** - visual spinner showing upload progress
- **detailed error messages** - human-readable rsync error codes (permission denied, connection failed, etc.)
- **automatic clipboard copy** - url copied to clipboard on macos (via pbcopy)
- **verbose mode** - debug rsync issues with `-v` flag