pySendCast 0.0.1

A pure Python cross-platform program to send and receive data over local area network(LAN) with on-the-fly gzip streaming and broadcasting

pySendCast

A pure Python cross-platform program to send and receive data over local area network(LAN) with on-the-fly gzip streaming and broadcasting

How to install

pip install pySendCast

How to use

python send.py <files...>
  sends without PIN
python send.py <-p|--pin> <files...>
  sends with newly generated PIN
python send.py <-up|--userpin> <user PIN> <files...>
  sends with user specified PIN

python recv.py
  receives without PIN
python recv.py <user PIN>
  receives with user specified PIN
python recv.py <n|new|g|gen>
  receives with newly generated PIN

How to use with usecases

1. General usecase : send two files without PIN. The First non-PIN receiver on network takes the file

• Sender

$ python send.py a.txt b.txt

• Receiver

$ python recv.py

• Sender

$ python send.py a.txt b.txt
sending to : ('192.168.0.11', 18902)
sending a.txt
sending b.txt
$ _

• Receiver

$ python recv.py
extracting a.txt (23 bytes)
extracting a.txt done (23 bytes, 0.0000413 seconds, 0.557163 MB/s)
extracting b.txt (27 bytes)
extracting b.txt done (27 bytes, 0.0000405 seconds, 0.666000 MB/s)
$ _

In this case, receiver can be running before the sender sends

2. generated PIN usecase : send with newly generated PIN. receiver must know PIN to receive the file (be aware that its stream itself is not securely encrypted.)

• Sender

$ python send.py -p a.txt b.txt
generated PIN : 3061

• Receiver

$ python recv.py 3061

• Sender

$ python send.py -p a.txt b.txt
generated PIN : 3061
sending to : ('192.168.0.11', 18902)
sending a.txt
sending b.txt
$ _

• Receiver

$ python recv.py 3061
extracting a.txt (23 bytes)
extracting a.txt done (23 bytes, 0.0000413 seconds, 0.557163 MB/s)
extracting b.txt (27 bytes)
extracting b.txt done (27 bytes, 0.0000405 seconds, 0.666000 MB/s)
$ _

In this case, receiver cannot be running before the sender sends

3. user PIN usecase : send with user PIN. receiver must know PIN to receive the file (be aware that its stream itself is not securely encrypted.)

• Sender

$ python send.py -up 9999 a.txt b.txt
user PIN : 9999

• Receiver

$ python recv.py 9999

• Sender

$ python send.py -up 9999 a.txt b.txt
user PIN : 9999
sending to : ('192.168.0.11', 18902)
sending a.txt
sending b.txt
$ _

• Receiver

$ python recv.py 9999
extracting a.txt (23 bytes)
extracting a.txt done (23 bytes, 0.0000413 seconds, 0.557163 MB/s)
extracting b.txt (27 bytes)
extracting b.txt done (27 bytes, 0.0000405 seconds, 0.666000 MB/s)
$ _

In this case, receiver can be running before the sender sends

4. receiver generated PIN usecase : send with receiver created user PIN. sender must know PIN to send the file (be aware that its stream itself is not securely encrypted.)

• Receiver

$ python recv.py n
generated PIN : 2342

• Sender

$ python send.py -up 2342 a.txt b.txt
user PIN : 2342
sending to : ('192.168.0.11', 18902)
sending a.txt
sending b.txt
$ _

• Receiver

$ python recv.py n
generated PIN : 2342
extracting a.txt (23 bytes)
extracting a.txt done (23 bytes, 0.0000413 seconds, 0.557163 MB/s)
extracting b.txt (27 bytes)
extracting b.txt done (27 bytes, 0.0000405 seconds, 0.666000 MB/s)
$ _

In this case, receiver can be running before the sender sends

special usecase

• send/recv from Android
  • using Termux

Security note

The receiver takes any gzip tar stream from port number 18902. Becuase this stream is not encrypted, it can be captured with network tools or can be easily targeted for hacking. Any responses from security issues are not taken by developer.