Skip to content

Commit

Permalink
Quick embed of youtube demonstration and some extra content.
Browse files Browse the repository at this point in the history
  • Loading branch information
nuvious committed Jul 23, 2024
1 parent 24c89bc commit 7ce67d0
Showing 1 changed file with 27 additions and 4 deletions.
31 changes: 27 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,17 @@
# UPNPsuedographia
# UPNPseudograph

A detailed overview is available in a whitepapaer in [markdown](Whitepaper.md) and [pdf](Whitepaper.pdf) formats.

## Demonstration

[![UPNPseudograph](https://img.youtube.com/vi/BKqg3oSyqzU/0.jpg)](https://www.youtube.com/watch?v=BKqg3oSyqzU)

## Dependencies

Clone the repository:

```bash
git clone https://github.com/nuvious/UPNPseudograph.git
cd UPNPseudograph
```

This project uses Pillow which requires external libraries:
Expand All @@ -27,7 +32,7 @@ sudo apt-get install -y \
You can then install the python requirements:

```bash
pip install .
pip install UPNPseudograph
```

## Usage
Expand Down Expand Up @@ -59,6 +64,25 @@ to interact with. It will receive messages and commands from the C2.
upnpseudograph --preferred-device=upnpseudograph.upnp.RokuDevice
```

### Interacting with Agent

After a device is cloned you will receive a prompt to interact with other agents:

```bash
Control Panel:
m:[MESSAGE] - Send a message
f:[FILE_PATH] - Send file
g:[FILE_PATH] - Gets a file from an agent (c2 only)
c:[COMMAND] - Execute a command (c2 only)
l - List agents
q - quit

Enter command:m:hello
0 192.168.1.42
Select agent to send to or type c to cancel:0
Message queued for 192.168.1.42
```

### Other Arguments

There are other arguments you can pass in depending on preference:
Expand All @@ -68,7 +92,6 @@ There are other arguments you can pass in depending on preference:
|--disable-passthrough|By default passthrough is enabled forwarding all requests to the cloned device to the actual device to help minimize an unintentional denial of service. This flag disables that functionality.|
|--search-frequency|Sets the number of seconds to search for other agents. Default is 30 seconds.|


# References

https://quimby.gnus.org/internet-drafts/draft-cai-ssdp-v1-03.txt
Expand Down

0 comments on commit 7ce67d0

Please sign in to comment.