pySendCast 0.0.2

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 -m pySendCast send [file or messages...]
  sends without PIN.
python -m pySendCast send <-p|--pin> [file or messages...]
  sends with newly generated PIN
python -m pySendCast send <-up|--userpin> <user PIN> [file or messages...]
  sends with user specified PIN

file or message can be any of

• nothing : check up each other's ip address
• file path : send and receive files with glob searching (ex. *.py)
• url : receiver opens default web browser with it
• message : simple text messages

python -m pySendCast recv
  receives without PIN
python -m pySendCast recv <user PIN>
  receives with user specified PIN
python -m pySendCast recv <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 -m pySendCast send a.txt b.txt

• Receiver

$ python -m pySendCast recv

• Sender

$ python -m pySendCast send a.txt b.txt
192.168.0.11
sending a.txt
sending b.txt
$ _

• Receiver

$ python -m pySendCast recv
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 -m pySendCast send -p a.txt b.txt
generated PIN : 3061

• Receiver

$ python -m pySendCast recv 3061

• Sender

$ python -m pySendCast send -p a.txt b.txt
generated PIN : 3061
192.168.0.11
sending a.txt
sending b.txt
$ _

• Receiver

$ python -m pySendCast recv 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 -m pySendCast send -up 9999 a.txt b.txt
user PIN : 9999

• Receiver

$ python -m pySendCast recv 9999

• Sender

$ python -m pySendCast send -up 9999 a.txt b.txt
user PIN : 9999
192.168.0.11
sending a.txt
sending b.txt
$ _

• Receiver

$ python -m pySendCast recv 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 -m pySendCast recv n
generated PIN : 2342

• Sender

$ python -m pySendCast send -up 2342 a.txt b.txt
user PIN : 2342
192.168.0.11
sending a.txt
sending b.txt
$ _

• Receiver

$ python -m pySendCast recv 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.