From 321f06eb160a06a4ad14bc49c2324aaad92c70ce Mon Sep 17 00:00:00 2001 From: Slack Coder Date: Wed, 18 May 2022 08:51:50 -0500 Subject: README: elaborate for non-programmers --- README.md | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index bcf014d..4fd6f5f 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,46 @@ # Send Over HTTP -Share a file with someone nearby over HTTP using a QR Code printed to the terminal. +Share a file with someone on your local network using QR Code. Inspired by the android app [Share Via HTTP](https://github.com/marcosdiez/shareviahttp). -## Usaage +## Benefits + + - Files are shared directly over the local network. An internet connection is + not required. + - Others can receive the file without installing any special applications. + +## Downsides + + - Others may be able to see the file as the file transfer is not encrypted. + - Some networks, at bars and cafes, will block connecting to others. + +## Usage ``` -go run ./cmd/send-over-http --help +send-over-http --help # Usage of send-over-http [target] # # target - file or directory to share (default: .) # ``` +## Requirements + + - [Golang](go.dev) + +## Install + +You can install the project using Golang's standard install process from the +projects root directory. + +``` +# from the +go install ./cmd/send-over-http +``` + +Or you can build the command into the project's root directory. + +``` +go build ./cmd/send-over-http +``` -- cgit v1.2.3