neo/README.md

37 lines
972 B
Markdown

# Neo
A simple C2 for [Matrix](https://matrix.org/) homeservers, inspired by [DiscordGo](https://github.com/emmaunel/DiscordGo)
## Setup
You'll need an account on a Matrix server to use for the bot.
In `src/main.nim`, modify the config values with your account and server.
Example config:
```nim
const
username: string = "neo"
password: string = "password123"
server: string = "matrix.org"
roomId: string = "!bsafgr3AAmy8gHdrcy:matrix.org"
usePwnboard: bool = true
pwnboardUrl: string = "https://pwnboard.win/pwn"
pwnboardToken: string = "pwnboard-token-here"
```
## Building
If it isn't already installed you'll need to install [Nim](https://nim-lang.org/install.html).
```bash
# Install dependencies
nimble install strenc
# Compile (outputs to ./neo)
nim c -d:ssl -d:release -o:neo src/main
```
## Bot Usage
Commands:
- `!ping {ip pattern}`
- `!command {ip pattern} {command}`
- `!kill {ip pattern}`
IP pattern example: `10.1.*.4`