Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vyskocilm/qrget

Easy to use privacy oriented cloudless file sharing
https://github.com/vyskocilm/qrget

cloudless file-sharing golang golang-application laptop-phone phone qrcode tablet transfer-files

Last synced: about 2 months ago
JSON representation

Easy to use privacy oriented cloudless file sharing

Awesome Lists containing this project

README

        

# qrget [![TravisCI](https://travis-ci.org/vyskocilm/qrget.svg?branch=master)](https://travis-ci.org/vyskocilm/qrget) [![Go Report Card](https://goreportcard.com/badge/github.com/vyskocilm/qrget)](https://goreportcard.com/report/github.com/vyskocilm/qrget) [![GolangCI](https://golangci.com/badges/github.com/vyskocilm/qrget.svg)](https://golangci.com/r/vyskocilm/qrget) [![license](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg?style=flat)](https://raw.githubusercontent.com/vyskocilm/qrget/master/LICENSE)

Simple PC/Laptop phone/tablet file sharing tool using QR Codes and HTTP protocol.
No external tools on your mobile device are needed, no setup of Bluetooth or
missing NFC (I am watching you Xiaomi) or USB cables required.

## Installation
Go to [Release page](https://github.com/vyskocilm/qrget/releases/latest) and grab the binary `qrget.linux.amd64`. That's it!

Right now there is no support for other platforms, add [new issue](https://github.com/vyskocilm/qrget/issues) or fill [pull reuqest](https://github.com/vyskocilm/qrget/pulls) if you need to.

## How it works

```
._________________. FILE .__________________.
|.---------------.| ----------------------------> |.----------------.|
|| .____. || .________. || .:' ||
|| | QR | || FILE |.------.| || __ :'__ ||
|| |code| || ----> || AN || || .'`__`-'__``. ||
|| |____| || || DRO || || :__________.-' ||
||_______________|| || ID || || :_________: ||
/.-.-.-.-.-.-.-.-.\ || || || :_________`-; ||
/.-.-.-.-.-.-.-.-.-.\ ||______|| jgs `.__.-.__.' ||
/.-.-.-.-.-.-.-.-.-.-.\ .--------. ||________________||
/______/__________\___o_\ DrS Phone + || | | ||
\_______________________/ Camera .------------------.
Desktop/Laptop Tables + camera
^
|
^ \ | / ^
| \ | / |
| \ | / |
| __\____|___/__ |
.-------------- /__o__o__o__o__\ --------------.
\______________/
WiFi
```

1. Your phone/tablet MUST be connected to same WiFi as Laptop
2. Your phone/tablet MUST have camera
3. Your phone/tablet MUST have QR code Reader
4. You run application `go run main.go`
5. You open QR Code `download.png`
6. Use QR Code Reader on your mobile device to download the file

## How it works really

It is stupid simple. `qrcode` generates and encodes URL to download the file
with WLAN address of main computer and run HTTP server serving that file. QR
Code reader decodes URL and open web browser to download the file.

1. Run qrget
```
./qrget README.md
```
2. It shows QQ code

![QR code](https://raw.githubusercontent.com/vyskocilm/qrget/master/doc/screenshot.png)

3. You open it using your phone and download

![Download](https://raw.githubusercontent.com/vyskocilm/qrget/master/doc/phone.png)

## Credits
* [ASCII Art Laptop](http://ascii.co.uk/art/laptop)
* [ASCII Art Apple logo](https://www.asciiart.eu/computers/apple)